Enable Robot Example - RethinkRobotics/sdk-docs GitHub Wiki

The enable robot example program will allow you to enable/disable/reset/stop the robot. You can also get the robot's current state. The robot must be enabled in order to control the motors.

• Basic Usage
• Overview
• Functions
• EStop and Robot State
• Troubleshooting

To Enable the robot:

$ rosrun baxter_tools enable_robot.py -e

To Disable the robot:

$ rosrun baxter_tools enable_robot.py -d

In order to control Baxter's arms, the robot must be put in the 'Enabled' state. Enabling the robot provides power to the joint motors, which are initially in the 'Disabled' state on start-up or after a serious error, such as an E-Stop (Emergency-Stop). The robot's 'State' can be checked with the enable_robot tool.

Note: If an error has occurred, the robot state may need to be reset (-r) before being enabled again.

To get help on enable_robot use the -h argument:

$ rosrun baxter_tools enable_robot.py -h

Help screen:

enable_robot.py [ARGUMENTS]

-h, --help      show this help message and edit
-s, --state     Print current robot state
-e, --enable    Enable the robot
-d, --disable   Disable the robot
-r, --reset     Reset the robot
-S, --stop      Stop the robot

To get the current robot state use -s:

$ rosrun baxter_tools enable_robot.py -s

enabled: False
stopped: False
error: False
estop_button: 0
estop_source: 0

The state output above indicates a normal (all-clear) status, as you would see after power-up. Once you enable the robot to control the arms, you should see the same status but with enabled: True.

Use -e to enable the robot.

$ rosrun baxter_tools enable_robot.py -e

The robot state enabled field should then switch to True.

Use -d to disable the robot.

$ rosrun baxter_tools enable_robot.py -d

The robot state enabled field should then switch to False.

Use -r to reset the robot after an error (if the robot state gives error: True).

$ rosrun baxter_tools enable_robot.py -r

This should clear the error field, setting it back to error: False.

Use -S (capital S) to stop the robot. This is similar to a "software" E-Stop.

$ rosrun baxter_tools enable_robot.py -S

This will disable the robot and also cause the stopped field and the error field to go True. You will need to reset the robot before enabling it again.

For more information about the E-Stop states and the robot state message, see: Robot State and EStop.

If your robot "fails to reset" when you run robot enable, the first thing to check is if the E-Stop is engaged:

$ rosrun baxter_tools enable_robot -s
enabled: False
stopped: True
error: True
estop_button: 1
estop_source: 1  

If the estop_button: field says '1', it means the E-Stop is engaged (from [baxter_core_msgs/AssemblyState][baxter_core_msgs-AssemblyState] message: uint8 ESTOP_BUTTON_PRESSED=1).
Disengage the E-Stop by twisting the red top until it 'pops'-up, then try resetting the robot.

$ rosrun baxter_tools enable_robot -r
$ rosrun baxter_tools enable_robot -e  

  [baxter_core_msgs-AssemblyState]: http://github.com/RethinkRobotics/baxter_common/blob/release-0.7.0/baxter_core_msgs/msg/AssemblyState.msg