Tutorial: the sample arm with MoveIt 2¶
The v0.3 arm scenario (docs/design/robot-classes.md §4) on your machine: a 6-DoF arm in a
workcell, its motors on a 48 V bus, MoveIt 2 planning a pick-and-place cycle.
1. Start the workcell¶
ros2 launch lagrange_demos arm6_workcell.launch.py viewer:=true
The simulator loads arm6.urdf with arm6.overlay.yaml (six motors, the supply and a brake
resistor, thermal nodes), runs the controller manager at 1 kHz in lockstep, and spawns
joint_state_broadcaster, arm_controller and gripper_controller. The site’s air temperature
is the launch argument ambient (default 298.15 K); thermal runs only with one.
2. Run the cycle¶
ros2 run lagrange_demos pick_place --cycles 3
MoveIt plans each move to the named poses of demos/config/arm6_moveit/arm6.srdf and executes it
through arm_controller. In the viewer’s scopes, motor/elbow_motor/current_q and
bus/dc_48v/voltage follow the moves; decelerating lifts the bus above 48 V (the supply takes
nothing back; the brake resistor switches in above 56 V).
3. Heat it up¶
With motors that are too small for the duty (motors:=undersized) and the cycle repeated at
full speed, the shoulder’s winding heats until its derating limits torque and the trajectory
controller aborts a move on its tolerance:
ros2 launch lagrange_demos arm6_workcell.launch.py motors:=undersized rtf:=8
ros2 run lagrange_demos pick_place --cycles 300 # exits 3 when a move fails
Watch thermal/shoulder_lift_motor/temperature and /derating. With
electrical:=off (the ideal torque source) the same cycles all complete.
tools/ci/arm_scenario.sh runs both and checks them.