Skip to main content

Manipulator and Gripper

MAKE SURE YOU STRICTLY FOLLOW THE INSTRUCTIONS IN docs/LunarRover/Hardware Assembling and Debugging.md/Ethernet Connection with Realman Robot Manipulator

Manipulator Usage​

After connected the manipulator correctly according to docs.Hardware Assembling and Debugging, press the power button on both the 24V power cell and the manipulator itself.

  • Seeing the LED flashing blue first and then green means the manipulator is powered on and successfully initialized.

To run the manipulator without chassis, run:

ros2 launch rm_bringup rm_bringup.launch.py

Now you're able to see the rviz2 is up and correct joints states displayed.

IF NOT, YOU'RE FUCKED BY REALMAN :P

Gripper Usage​

BRING UP THE MANIPULATOR FIRST.

Then you should see a topic named /rm_driver/set_tool_voltage_cmd, which is used to set the voltage of the I/O at the frange of the manipulator.

ros2 topic pub --once /rm_driver/set_tool_voltage_cmd std_msgs/msg/UInt16 "{data: 2}"

Data 2 means 12V. And now you should see the gripper fingers opened and indicating gripper is ready.

Gripper allow 3 action modes

  1. Close with a fixed speed and stopped at the target force threshold. Current mode accepts 3 parameters:
ParameterDescriptionValue RangeNotes
speedThe speed of closing.1~1000Dimensionless
forceThe target force threshold.1~1000Every 1 value represents 0.0015kg
blockBlock or not?true or false

Example command:

ros2 topic pub --once /rm_driver/set_gripper_pick_cmd rm_ros_interfaces/msg/Gripperpick "{speed: 200, force: 200, block: true}"

Subscribe for command result, and value could be true or false, error code will printed in manipulator driver terminal

ros2 topic echo /rm_driver/set_gripper_pick_result
  1. Close with a fixed speed, stopped at the target force threshold. After stopped, IF THE FORCE BELOW THRESHOLD AGAIN, it will close continuously untile the force is above the threshold. Current mode accepts 3 parameters:
ParameterDescriptionValue RangeNotes
speedThe speed of closing.1~1000Dimensionless
forceThe target force threshold.1~1000Every 1 value represents 0.0015kg
blockBlock or not?true or false

Example command:

ros2 topic pub --once /rm_driver/set_gripper_pick_on_cmd rm_ros_interfaces/msg/Gripperpick "{speed: 200, force: 200, block: false}"

Subscribe for command result, and value could be true or false, error code will printed in manipulator driver terminal

ros2 topic echo /rm_driver/set_gripper_pick_on_result
  1. Action to target position with a fixed speed. Current mode accepts 2 parameters:
ParameterDescriptionValue RangeNotes
positionTarget position.1~10001 refers to 0mm, 1000 refers to 70mm
blockBlock or not?true or false

Example command:

ros2 topic pub --once /rm_driver/set_gripper_position_cmd rm_ros_interfaces/msg/Gripperset "{position: 200, block: true}"

Subscribe for command result, and value could be true or false, error code will printed in manipulator driver terminal

ros2 topic echo /rm_driver/set_gripper_position_result