Skip to content

Commit 4eda38b

Browse files
committed
updated readme
1 parent c557d5f commit 4eda38b

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

aegis_grpc/README.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ The server is split into 2 services defined in [`proto_aegis_grpc.v1.robot_srvs`
9494
The "ROS-getters" are implemented in the [`RobotReadServiceImpl`](./include/aegis_grpc/robot_read_service.hpp) class as the following methods:
9595

9696
| Method name | Desc. | Impl. | gRPC Request | gRPC Response |
97-
|------------------------------------------------------------|------------------------------------------------------|-------|-------------------------|---------------------------------------------------------------------------------------------|
97+
| ---------------------------------------------------------- | ---------------------------------------------------- | ----- | ----------------------- | ------------------------------------------------------------------------------------------- |
9898
| `proto_aegis_grpc.v1.RobotReadService.GetAll` | Get all available robot data. || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.RobotObservation`](./proto_aegis_grpc/v1/robot_srvs.proto) |
9999
| `proto_aegis_grpc.v1.RobotReadService.GetRobotState` | Get consolidated robot state (pose, joints, wrench). || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.RobotState`](./proto_aegis_grpc/v1/robot_srvs.proto) |
100100
| `proto_aegis_grpc.v1.RobotReadService.GetRobotVision` | Get all camera images (scene, left, right). || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.RobotVision`](./proto_aegis_grpc/v1/robot_srvs.proto) |
@@ -119,8 +119,8 @@ The control bridge for MoveIt2 servo and planners are implemented in the [`Robot
119119
| ------------------------------------------------------------ | --------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
120120
| `proto_aegis_grpc.v1.RobotControlService.GotoJoints` | Plan & execute the MoveIt2 trajectory to a given joints target. || [`proto_aegis_grpc.v1.sensor_msgs.JointState`](./proto_aegis_grpc/v1/sensor_msgs.proto) | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
121121
| `proto_aegis_grpc.v1.RobotControlService.GotoPose` | Plan & execute the MoveIt2 trajectory to a given pose target. || [`proto_aegis_grpc.v1.geometry_msgs.Pose`](./proto_aegis_grpc/v1/geometry_msgs.proto) | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
122-
| `proto_aegis_grpc.v1.RobotControlService.GripperClose` | Closes the gripper. || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
123-
| `proto_aegis_grpc.v1.RobotControlService.GripperOpen` | Opens the gripper. || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
122+
| `proto_aegis_grpc.v1.RobotControlService.GripperClose` | Closes the gripper. || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
123+
| `proto_aegis_grpc.v1.RobotControlService.GripperOpen` | Opens the gripper. || `google.protobuf.Empty` | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
124124
| `proto_aegis_grpc.v1.RobotControlService.GripperSetPosition` | Set the gripper width. || [`proto_aegis_grpc.v1.robot_srvs.GripperSetPositionRequest`](./proto_aegis_grpc/v1/robot_srvs.proto) | [`proto_aegis_grpc.v1.robot_srvs.TriggerResponse`](./proto_aegis_grpc/v1/robot_srvs.proto) |
125125
| `proto_aegis_grpc.v1.RobotControlService.ServoJoint` | Servoing (w.r.t. joints). || [`proto_aegis_grpc.v1.control_msgs.JointJog`](./proto_aegis_grpc/v1/control_msgs.proto) | `google.protobuf.Empty` |
126126
| `proto_aegis_grpc.v1.RobotControlService.ServoTCP` | Servoing (w.r.t. TCP). || [`proto_aegis_grpc.v1.geometry_msgs.Twist`](./proto_aegis_grpc/v1/geometry_msgs.proto) | `google.protobuf.Empty` |
@@ -174,11 +174,21 @@ There is no hardcoded parameters, everything can be modified via ROS:
174174

175175
**Initialization parameters**
176176

177-
| Parameter | Type | Default | Units | Description |
178-
| -------------- | -------- | ----------------- | ----- | -------------------------------------------- |
179-
| `topic_pose` | `string` | `"/tcp_pose"` | - | Topic providing the TCP pose. |
180-
| `topic_wrench` | `string` | `"/wrench"` | - | Topic providing the force/torque (F/T) data. |
181-
| `topic_joints` | `string` | `"/joint_states"` | - | Topic providing joint state data. |
177+
| Parameter | Type | Default | Units | Description |
178+
| --------------------- | -------- | ------------------------------- | ----- | ------------------------------------------------ |
179+
| `ee_frame` | `string` | `"robotiq_hande_end"` | - | TF2 frame ID of the end-effector. |
180+
| `base_frame` | `string` | `"world"` | - | TF2 base frame ID for EE pose lookup. |
181+
| `topic_wrench` | `string` | `"/wrench"` | - | Topic providing force/torque (F/T) data. |
182+
| `topic_joints` | `string` | `"/joint_states"` | - | Topic providing joint state data. |
183+
| `topic_camera_scene` | `string` | `"/cam_scene/rgb/image_rect"` | - | Camera scene image topic. |
184+
| `topic_camera_right` | `string` | `"/cam_tool_right/image_color"` | - | Right tool camera image topic. |
185+
| `topic_camera_left` | `string` | `"/cam_tool_left/image_color"` | - | Left tool camera image topic. |
186+
| `target_image_width` | `int` | `64` | px | Target output image width in pixels. |
187+
| `target_image_height` | `int` | `64` | px | Target output image height in pixels. |
188+
| `enable_image_resize` | `bool` | `true` | - | Enable resizing images before sending over gRPC. |
189+
190+
>[!TIP]
191+
> The end-effector's TCP pose is obtained from the tf2 transform (using `ee_frame` and `base_frame`).
182192
183193
### Run and set examples
184194
The initialization params can be set via ROS 2 run or launch:

0 commit comments

Comments
 (0)