Skip to content

Tool Usage for AIRBOT Pro#

In this tutorial, we introduce several functions for AIRBOT Pro, including:

  • Basic functions control: Supply simple control interface for AIRBOT Pro.

  • Zero calibration: Use for position calibration when control service notices to make calibration.

  • Params checking: Checking parameters of your AIRBOT Pro which may supply useful message when meeting problems.

  • Keyboard control: Enable to control AIRBOT Play through your keyboard.

  • Sync following: Allow one AIRBOT Play to run following another synchronously.

Warning
  1. Confirm you have setup both your hardware and software correctly based on our guideline, and your hardwares are power on successfully (the light strip of hardware control panel should be on).
  2. The firmware has been upgraded to latest.
  3. The robot will move to a specific pose during starting process, being too close to robot's workspace may be very dangerous.

Basic functions#

Connect rebot#

  1. Plug on the power cable the robotic arm will display white flashing light effect.
  2. After inside system getting ready, the light effect will change into white constant, then your AIRBOT Pro is permitted to operate.
  3. Use a network cable to connect the computer to the robot.
  4. Change the cable connection ip address of the computer to 192.168.254.11
  5. Run ping 192.168.254.10 to check whether the robot is successfully connected

Launch robot#

  1. Keep pressing the button on the hardware control panel for 2 seconds, the light effect would change into yellow waving for system checking. Or just use launch_robot method of class AirbotPlay in our SDK.
  2. If everything is OK, the light effect would turn into green waving then start moving to prepare pose. Please keep a safety distance and wait util it turns green constant.
  3. Then you can use following functions by buttons or our SDK.

Quickly control gripper#

Pressing the button at the end of the robotic arm (below the link between joint 5 and 6) shortly enable quickly open or close gripper. Note that only two fingers gripper(G2) is supported.

Demonstrate and replay#

  1. The robotic arm will enter ONLINE mode with green light effect since control service startup successfully. Keep pressing the button at the end of the robotic arm for nearly 2 seconds will enable you to enter DEMONSTRATE mode with blue light effect.
  2. Pressing the button on the hardware control panel on the base of robotic arm shortly will start recording following robot's states while the light effect turn into blue when in DEMONSTRATE mode.
  3. Back to DEMONSTRATE mode and stop recording at any time by shortly pressing the button at the hardware control panel.
  4. Keep pressing the button at the end for 2 seconds brings you back to ONLINE mode from DEMONSTRATE mode.
  5. Double-click the button at the end to enter OFFLINE mode with constant purple color light effect from ONLINE mode or DEMONSTRATE mode.
  6. When in OFFLINE mode, clicking the button on panel would drive your AIRBOT Play to the start point of recorded waypoints end with flashing purple color light effect.
  7. Press the button on panel again to start replaying your recorded waypoints with purple following light effect. A return action will be conducted until it reaches the start point after reaching the end of waypoints. Note that E2B will not replay during this period.
  8. During replaying, you can press the button on panel any time to stop or resume your replaying.

Exception recovery#

Sometimes the robotic arm may enter ERROR state because of incorrect using or our potential bugs with constant red light effect. Double-click the button on panel may help you to come back normal mode after clearing soft error.

Shutdown robot#

If you want to stop your operation, just keep pressing the button on the Base Board for 2 seconds or just use shutdown_robot method of class AirbotPlay in our SDK then the robot will go back to hard zero pose. Keep a safety distance and wait util the light effect turn white constant.

# example
from airbot_py.airbot_play import AirbotPlay
robot = AirbotPlay(ip="192.168.254.10")
robot.shutdown_robot()

Zero calibration#

You should follow this guideline to calibrate your zero position when control service throws a calibration requirement.

Warning
  1. Confirm you have setup both your hardware and software correctly based on our guideline, and your hardwares are power on successfully (the light strip of hardware control panel should be white constant).
  2. The firmware has been upgraded to latest.
  3. You have shutdown your launching process.

Calibration guideline#

  1. Prepare to maintain AIRBOT Play's position using your hands since it will fall down after running the calibration command.

  2. Run the calibration_robot method of class AirbotPlay in our SDK and the robotic arm will release motors' brakes. Pull the robotic arm to the position as shown following. The motor on joint 1 should be placed at the middle and the motors on joint 2 and 3 should be placed at the lowest hardware limitation position. Others motors are not need to move except for previous condition can't be meet. Pose for position calibration

  3. Run the calibration_confirm method of class AirbotPlay in our SDK, the robotic arm would move to its hardware zero position. Wait util the light effect turn back white constant.

from airbot_py.airbot_play import AirbotPlay
robot = AirbotPlay(ip="192.168.254.10")
robot.calibrate_robot()
time.sleep(10)
calibrate_confirm()

Params check tool#

Warning
  1. Confirm you have setup both your hardware and software correctly based on our guideline, and your hardwares are power on successfully (the light strip of hardware control panel should be on).
  2. The firmware has been upgraded to latest.
  3. No other devices or processes are sending CAN message on CAN bus.
  1. Run the get_system_params method of class AirbotPlay in our SDK
# example
from airbot_py.airbot_play import AirbotPlay
robot = AirbotPlay(ip="192.168.254.10")
robot.get_system_params()

Keyboard control tool#

TBD

Sync following tool#

Warning
  1. Confirm you have launch at least two AIRBOT Pro and connect them using network cable to your LAN.
  2. Please keep master robotic arm (which is used to lead other arms to move) still when start following.
  3. You can set more than one slave arm but only one master.

  1. Need to use python sdk to start one control one, pro control pro is not supported for the time being.

  2. An example of the play Control pro is shown below.

Preconditions : play and pro control services need to be enabled

# example
def joint_follow_example():
    """
    Example of controlling AIRBOT Play following another robot's joint position.
    """
    master_robot = AirbotPlay(ip="192.168.254.10")
    slave_robot = AirbotPlay(port=50000)
    slave_robot.slave_mode(int(master_robot.params["ros_domain_id"]))
    slave_robot.follow_start()
    time.sleep(100000)
    slave_robot.follow_stop()