Skip to content

Commit b6a49ad

Browse files
committed
Update README
1 parent 18a46f1 commit b6a49ad

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

README.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,13 @@ source ./install/local_setup.sh
3131

3232
### Launch preview
3333

34+
Start the driver:
3435
```bash
3536
ros2 launch robotiq_hande_driver gripper_controller_preview.launch.py use_fake_hardware:=true
36-
# In other terminal
37+
```
38+
39+
Send a command to the gripper in another terminal:
40+
```bash
3741
ros2 action send_goal /gripper_action_controller/gripper_cmd control_msgs/action/GripperCommand \
3842
"command:
3943
position: 0.0
@@ -106,10 +110,12 @@ ros2 launch robotiq_hande_driver gripper_controller_preview.launch.py \
106110
You can also start `socat` manually, for example:
107111
```bash
108112
socat pty,link=/tmp/ttyUR,raw,ignoreeof,waitslave tcp:192.168.1.2:54321
109-
> [!WARNING]
110-
> Do not use both the `use_tool_communication:=true` flag for the **ur_driver** and the `create_socat_tty:=true` flag for the **robotiq_hande_driver**!
111-
> Both options will invoke the `socat` command to create the `/tmp/ttyUR` virtual serial port.
112-
> However, the initialization of the Hand-E driver may suffer from a race condition: **the tty link must exist before initialization**.
113+
```
114+
115+
> [!WARNING]
116+
> Do not use both the `use_tool_communication:=true` flag for the **ur_driver** and the `create_socat_tty:=true` flag for the **robotiq_hande_driver**!
117+
> Both options will invoke the `socat` command to create the `/tmp/ttyUR` virtual serial port.
118+
> However, the initialization of the Hand-E driver may suffer from a race condition: **the tty link must exist before initialization**.
113119
> It is recommended to use the provided `create_socat_tty` option.
114120
115121
## Integration with (other) robots
@@ -122,11 +128,11 @@ Next, include this Xacro file in your main robot description tree at the appropr
122128

123129
An example of including it in a robot Xacro can be found [here](https://github.com/AGH-CEAI/aegis_ros/blob/humble-devel/aegis_description/urdf/aegis.xacro).
124130

125-
The included robotiq_hande_gripper macro automatically sets up the `<ros2_control>` block pointing to the Robotiq Hand-E driver plugin. This ensures that your robot can control the gripper via the standard ROS 2 control interfaces.
131+
The included robotiq_hande_gripper macro automatically sets up the `<ros2_control>` block pointing to the Robotiq Hand-E driver plugin. This ensures that your robot can control the gripper via the standard ROS 2 control interfaces.
126132

127133
You can easliy dig into the `ros2_control` concepts with [its documentation](https://control.ros.org/rolling/doc/ros2_control/doc/index.html#concepts). There is also a [plenty of examples](https://control.ros.org/humble/doc/ros2_control_demos/doc/index.html#examples)
128134

129-
> [!IMPORTANT]
135+
> [!IMPORTANT]
130136
> The `robotiq_hande_driver` currently provides only a **hardware component** (i.e. _hardware interface_) to control the fingers' joints.
131137
132138
The included `robotiq_hande_gripper` macro automatically sets up the `<ros2_control>` block pointing to the Robotiq Hand-E driver plugin. This ensures that your robot can control the gripper via the standard ROS 2 control interfaces, including the gripper action controller and joint state broadcaster, without additional manual plugin configuration.

0 commit comments

Comments
 (0)