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