V3.1 Documentation and Interface Change Log

This document applies only to A3 software version 3.1.x. Currently, only a limited set of documentation is available. Additional content, including motion APIs, expression playback APIs, and motion control simulation, will be released later.

V3.1 Documentation Updates

V3.1 Interface Changes

The update log lists interface changes compared with V3.0, as well as other modifications that have a significant impact on secondary development. Incompatible changes are highlighted in bold.

1. Secondary Development Program Deployment
   • Added a wired robot connection method. Users can connect the robot to a local machine with this method for secondary development. For detailed connection steps, refer to the wired robot connection documentation.
2. Motion Control
   • Added a topic interface for robot waist control
   • Added a topic interface for robot neck control
3. Microphone Management
   • Added an RPC interface for switching between internal and external microphones
   • Added an RPC interface for querying microphone status
4. Resource Management
   • Added a Resource Management section. Users can create, delete, query, import, and export resources through this module to meet robot capability configuration and content customization needs. For detailed supported features, refer to the Resource Management documentation.
5. Sensor Data
   • Added topic interfaces for IMU and camera sensor data
6. System Status Retrieval
   • Added an RPC interface for querying BMS battery status
   • Added an RPC interface for querying emergency stop signal status
7. Interactive Secondary Development
   • Added usage documentation for the face recognition result Topic interface
8. Quick Start for Secondary Development
   • Corrected the Python virtual environment creation command in 6.1.3, changing python -m venv mydev to python3 -m venv mydev
   • Added 6.4 example for controlling robot motion
   • Added 6.5 example for robot TTS broadcast
9. System Status
   • Corrected the content in 7.7 System Status, updating the BMS status and emergency stop status descriptions from RPC interfaces to Topic interfaces
10. Interactive Secondary Development
    • Added LinkSoul related content

Issue Feedback Channel

If you encounter bugs in the secondary development interfaces, you can submit feedback through the following channel:

https://agirobot.feishu.cn/share/base/form/shrcnLP2tv9gzyrZ2tSDlm1Baif

Notes

This channel is only for questions and bug reports related to secondary development interfaces. For robot hardware failures, after-sales maintenance, or similar issues, please contact the relevant delivery, operations, or after-sales teams directly. Unrelated issues will not receive a response. Please describe the issue in detail in the form, preferably with reproducible steps. Reports with sufficient information and clear descriptions will be prioritized. Vague or overly general reports may be assigned lower priority or ignored. Please fill in all required information carefully. Tickets with inconsistent or casually entered information may be ignored. Each ticket should focus on a single issue or a single category of issues. Please do not combine multiple unrelated issues into one ticket, as this will significantly delay processing.