4 Quick Start

In this chapter, we demonstrate how to use AimDK for secondary development on the AgiBot X2 by walking through building and running SDK sample programs and developing combined robot control programs.

• 4.1 Read the user guide to familiarize yourself with relevant terminology and safety precautions.
• 4.2 Choose a Development Mode
  • 4.2.1 Use SDK Directly on the Development Computing Unit (Quick Start; X2 Ultra and X2 Ultra(new version) Only)
  • 4.2.2 Container-Based Development on the Development Computing Unit (Recommended; X2 Ultra and X2 Ultra(new version) Only)
  • 4.2.3 Host PC / Computing Pack + Cross-Device Networking
• 4.3 Network connection
  • 4.3.1 X2 Ultra / X2 Ultra(new version)
  • 4.3.2 X2 EDU
• 4.4 Develop in a Container
  • 4.4.1 Prepare the Files
  • 4.4.2 Build the Image
  • 4.4.3 Start the Container
  • 4.4.4 Enter the Container
  • 4.4.5 Build and Run
• 4.5 Before Your First Run: Build the SDK
• 4.6 Run an Example Program
  • 4.6.1 Get the Robot’s Current State
  • 4.6.2 Control the Robot to Wave
• 4.7 Code Implementation
  • 4.7.1 Project Overview
  • 4.7.2 Add the Example to the Existing SDK Workspace
  • 4.7.3 Write the Control Code
  • 4.7.4 Build and Run
  • 4.7.5 Code Walkthrough
  • 4.7.6 Extensions and Optimization
  • 4.7.7 Troubleshooting
  • 4.7.8 Next Steps
  • 4.7.9 Summary

Caution

Notes about non-volatile user data:

• The disks in the robot would be reformatted during firmware upgrade/downgrade, please back up your data

• User data under $HOME(/home/agi, compatible path /agibot/data/home/agi) would survive in general

• Exception 1: DO NOT save data into $HOME/aimdk*, which are preserved and maintained by the system

• Exception 2: All data under $HOME would be moved to $HOME/.old_agi_home.bak (specific to v1.0 firmware flashing)

• BE CAREFUL of features like factory reset, which would forcibly erase all user data (including $HOME)