CLI Bringup & Teleoperation
This guide explains how to connect to the robot and use the command line to bring up the robot and operate it through teleoperation.
1. Connect to the Robot
-
Connect the robot and user PC to the same network.
-
Connect to the robot PC via SSH.
-
Enter the
ai_workercontainer (How to use container.sh):cd ~/ai_worker/docker./container.sh enter
2. Start the Zenoh Daemon
AI WORKER uses zenoh as RMW since version 2.0.0, so you need to bring up the Zenoh daemon before bringup the robot.
Please refer to the Zenoh Communication guide.
If Cyclo Manager is installed, the Zenoh daemon may already be running. In a separate robot PC terminal outside the container, check whether the zenoh_daemon container is running. If it is, you do not need to start the Zenoh daemon separately.
docker ps | grep zenoh_daemon
In the AI Worker container, run the following command to bring up the Zenoh daemon:
ros2 run rmw_zenoh_cpp rmw_zenohd
or alias:
zenohd
3. Bringup the Robot and Leader
Choose how to launch the robot and Leader. All-in-One starts both together; Separate Launches runs them in different terminals.
- All-in-One
- Separate Launches
These commands start an LG2 Leader with BG2/SG2, or an A1 Leader with W1/W2. For other combinations, select the Separate Launches tab.
Launching the programs does not start arm teleoperation. On A1, A2, and LG2, push both triggers forward together for 2 seconds, then release them, to start both arms. Repeat the action to pause both arms. See Operation Guide before starting.
To start both the Leader and Follower (BG2/SG2/W1/W2) simultaneously:
- W1
- W2
- BG2
- SG2
ros2 launch ffw_bringup ffw_f1_ai.launch.py
ros2 launch ffw_bringup ffw_f2_ai.launch.py
ros2 launch ffw_bringup ffw_bg2_ai.launch.py
ros2 launch ffw_bringup ffw_sg2_ai.launch.py
Or use the shortcut:
- W1
- W2
- BG2
- SG2
ffw_f1_ai
ffw_f2_ai
ffw_bg2_ai
ffw_sg2_ai
If you want to run the Leader and Follower separately in different terminals:
Wait for Follower initialization to finish before starting the Leader. The required teleoperation software starts with the Follower; no separate Cyclo launch command is needed.
- Launch the teleoperation
Follower:
- W1
- W2
- BG2
- SG2
ros2 launch ffw_bringup ffw_f1_follower_ai.launch.py
ros2 launch ffw_bringup ffw_f2_follower_ai.launch.py
ros2 launch ffw_bringup ffw_bg2_follower_ai.launch.py
ros2 launch ffw_bringup ffw_sg2_follower_ai.launch.py
Or use the shortcut:
- W1
- W2
- BG2
- SG2
ffw_f1_follower_ai
ffw_f2_follower_ai
ffw_bg2_follower_ai
ffw_sg2_follower_ai
Optional Parameters
You can customize the follower launch behavior with optional parameters: For other models, use their Follower launch file.
Disable Camera Launch
To run the system without launching the cameras, set the launch_cameras parameter to false:
ros2 launch ffw_bringup ffw_bg2_follower_ai.launch.py launch_cameras:=false
Disable Position Initialization
To start the system without initializing the position, set the init_position parameter to false:
ros2 launch ffw_bringup ffw_bg2_follower_ai.launch.py init_position:=false
Enable Automatic Camera Assignment
To automatically assign the connected RealSense cameras without manually configuring their serial numbers, set the auto_assign_cameras parameter to true:
ros2 launch ffw_bringup ffw_bg2_follower_ai.launch.py auto_assign_cameras:=true
W1/W2 use RealSense cameras for both the head and wrists, and automatic assignment is enabled by default.
Automatic camera assignment may not work on some older BG2 and SG2 models. If this occurs, set auto_assign_cameras:=false and use your existing manual camera configuration.
Combine Multiple Parameters You can use both parameters together:
ros2 launch ffw_bringup ffw_bg2_follower_ai.launch.py launch_cameras:=false init_position:=false
- Launch the teleoperation
Leader:
- A1
- A2
- LG2
ros2 launch ffw_bringup ffw_a1_leader_ai.launch.py
ros2 launch ffw_bringup ffw_a2_leader_ai.launch.py
ros2 launch ffw_bringup ffw_lg2_leader_ai.launch.py
Or use the shortcut:
ffw_lg2_leader_ai
Optional: Advanced Button Controls
All three Leaders use style:=default unless specified otherwise. To start and pause each arm separately and switch between Teleoperation mode and External control mode with the joystick buttons, add style:=advanced to the Leader launch command:
- A1
- A2
- LG2
ros2 launch ffw_bringup ffw_a1_leader_ai.launch.py style:=advanced
ros2 launch ffw_bringup ffw_a2_leader_ai.launch.py style:=advanced
ros2 launch ffw_bringup ffw_lg2_leader_ai.launch.py style:=advanced
Choose one Leader command; do not run the default and advanced commands together. If the Leader is already running, stop it before relaunching with a different style.
4. Operation Guide
Launching the programs does not start arm teleoperation. Follow the Operation Guide to start and control teleoperation.
5. Stop the Services
To stop a launch command, press Ctrl+C in the terminal where it is running. If the Follower and Leader were started separately, stop each command in its respective terminal.