The Crane+ robot arm is a 4-DOF robotic manipulator with an additional 1-DOF gripper, giving a total of 5 controllable joints.
| Joint | Description |
|---|---|
| crane_plus_joint1 | Base rotation |
| crane_plus_joint2 | Shoulder |
| crane_plus_joint3 | Elbow |
| crane_plus_joint4 | Wrist |
| crane_plus_joint_hand | Gripper |
The arm is controlled through a custom ROS 2 driver using Dynamixel AX-12A servos.
GUI → ROS2 Topic → Driver Node → Dynamixel SDK → AX-12A Motors
Topics:
/crane_plus_commandMessage type:
sensor_msgs/msg/JointState/crane_plus_speedMessage type:
std_msgs/msg/Int32Open a terminal:
source ~/ros2_crane_ws/install/setup.bashStart the driver:
ros2 run crane_plus_driver driver_nodeExpected output:
Connected to Dynamixels on /dev/ttyACM1
Open a second terminal:
source ~/ros2_crane_ws/install/setup.bashLaunch the GUI:
ros2 run crane_plus_driver gui_nodeThe control panel should appear with:
- Joint sliders
- Speed slider
- Home Position button
- Pick Can button
- Confirm Grip button
- Place Can button
Example:
Move Joint 1 (base) by 0.5 radians:
ros2 topic pub --once /crane_plus_command sensor_msgs/msg/JointState \
"{name:['crane_plus_joint1'], position:[0.5]}"Example:
ros2 topic pub --once /crane_plus_command sensor_msgs/msg/JointState \
"{name:[
'crane_plus_joint1',
'crane_plus_joint2',
'crane_plus_joint3',
'crane_plus_joint4'
],
position:[
0.0,
0.5,
-1.0,
0.7
]}"Close gripper:
ros2 topic pub --once /crane_plus_command sensor_msgs/msg/JointState \
"{name:['crane_plus_joint_hand'], position:[-1.0]}"Open gripper:
ros2 topic pub --once /crane_plus_command sensor_msgs/msg/JointState \
"{name:['crane_plus_joint_hand'], position:[0.5]}"Note:
- Negative values close the gripper.
- Positive values open the gripper.
- Exact limits depend on the physical setup.
The GUI contains a speed slider.
The speed value is sent to:
/crane_plus_speedExample terminal command:
ros2 topic pub --once /crane_plus_speed std_msgs/msg/Int32 \
"{data:25}"Meaning:
| Value | Speed |
|---|---|
| 10 | Very slow |
| 25 | Recommended |
| 50 | Medium |
| 100 | Maximum |
The GUI provides direct control over every joint.
Each slider controls one servo:
- Joint 1 → Base rotation
- Joint 2 → Shoulder
- Joint 3 → Elbow
- Joint 4 → Wrist
- Joint Hand → Gripper
Current angle is displayed as:
45° (0.79 rad)
Moving a slider immediately publishes a command to the robot.
Press:
Home Position
The arm returns to:
Joint1 = 0°
Joint2 = 0°
Joint3 = 0°
Joint4 = 0°
Gripper = 0°
This is useful before beginning demonstrations.
The GUI contains a semi-automatic pickup sequence intended for classroom demonstrations.
The sequence is broken into multiple stages so the user can adjust the grip manually.
Press:
Pick Can
The arm moves to a predefined approach position.
Example pose:
Joint1 = 0°
Joint2 = 35°
Joint3 = -85°
Joint4 = 55°
Gripper = partially closed
The robot stops and waits.
Status:
Check grip then press Confirm Grip
At this stage the user may:
- Open the gripper slightly
- Close the gripper slightly
- Verify the can is secure
The gripper slider remains active.
This allows the operator to compensate for:
- Different can sizes
- Positioning errors
- Uneven grasping
Press:
Confirm Grip
The robot:
- Stores the current gripper position.
- Lifts the can upward.
- Maintains the grip angle chosen by the operator.
Status:
Can lifted. Press Place Can.
Press:
Place Can
The robot:
- Rotates Joint 1.
- Moves toward the placement position.
- Preserves the selected grip force.
Example:
Rotate 90°
Move above target
Lower arm
The robot automatically:
- Opens the gripper.
- Releases the can.
- Ends the sequence.
Status:
Can placed successfully.
The eventual competition goal is:
- Detect a soda can using a camera.
- Estimate the can position.
- Move automatically to the can.
- Grasp the can.
- Transport the can to a designated location.
Current status:
-
Manual joint control [COMPLETED]
-
Manual gripper control [COMPLETED]
-
Adjustable speed control [COMPLETED]
-
Semi-automatic pickup sequence [COMPLETED]
-
Vision-based can detection
-
Automatic target localization
-
Autonomous pick-and-place
View joint commands:
ros2 topic echo /crane_plus_commandView speed commands:
ros2 topic echo /crane_plus_speedList nodes:
ros2 node listList topics:
ros2 topic listCheck connected Dynamixels:
python3 scan_IDs.pyExpected result:
Found: 1
Found: 2
Found: 3
Found: 4
Found: 5
Robot Arm:
- RT Corporation Crane+
- 4 DOF arm
Servos:
- Dynamixel AX-12A
- Protocol 1.0
- 1 Mbps communication
Controller Interface:
- USB serial adapter
- Typical device:
/dev/ttyACM1Baudrate:
1000000
- Always start with the speed slider set low.
- Keep hands away from moving joints.
- Use Home Position before testing.
- Verify the gripper can securely hold the can before lifting.
- Tune pickup poses as necessary for your specific setup.
- Future improvements should focus on camera-based can detection and autonomous grasping.