Common Robot Control Interfaces

Provides commonly used robot control interfaces, including moving to specified positions, IO control, program execution control, and servo power on/off control,Emergency stop.

Note:

• robot_type defaults to "C5A" .
• Optional values: C7A , C12A , C16A .

Robot End-effector Movement to Target Position

Interface Name

• gbt_interface/action/MoveToPose

Usage Method

Start service:

ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

Simulate sending target position request:

ros2 action send_goal /gbt_driver/move_to_pose gbt_interface/action/MoveToPose "{ x: 400.0, y: -200.0, z: 500.0, a: 100.0, b: 30.0, c: 110, vel: 1, acc: 1 }"

IO Read/Write

Note: Please configure the I/O mapping before using the I/O control function.

• Interface Name: gbt_interface/srv/IO
• Start Service:

ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

• Set IO Port Status:

ros2 service call /gbt_driver/service_server/io gbt_interface/srv/IO "{signal_type: 2, signal_port: 1, signal_value: 1, command: set}"

• Get IO Port Status:

ros2 service call /gbt_driver/service_server/io gbt_interface/srv/IO "{signal_type: 2, signal_port: 1, command: get}"

IO TYPE Table

Here’s the enum list formatted as an English markdown table:

Enum	Value	Description
DI	1	Signal Type
DO	2	Digital Input
UI	3	Digital Output
UO	4	Proprietary Input
RI	5	Proprietary Output
RO	6	Arm Input
GI	7	Arm Output
GO	8	Group Input
TAI	9	Wrist Analog Input
TDI	10	Wrist Digital Input
TDO	11	Wrist Digital Output
AI	12	Analog Input
AO	13	Analog Output

Program Execution Control

• Interface Name: gbt_interface/srv/ProgramControl
• Start Service:

ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

• Start Program:

ros2 service call /gbt_driver/service_server/program_control gbt_interface/srv/ProgramControl "{command: 'start', program_name: 'test'}"

To pause, resume or stop programs, replace the command parameter with:

• pause : Pause program
• resume : Resume program
• stop : Stop program

Servo Power Control

• Interface Name: gbt_interface/srv/Servo
• Start Service:

ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

• Servo Motor Power On:

ros2 service call /gbt_driver/service_server/servo_power gbt_interface/srv/Servo "{servo_on: true}"

To power off the servo motor, set servo_on parameter to false .

Emergency Stop

• Interface Name: gbt_interface/srv/EmergencyStop
• Interface Description: Controls the emergency stop state of the robotic arm
• Start Service:

  ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

• Usage Example:

  ros2 service call /gbt_driver/service_server/emergency_stop gbt_interface/srv/EmergencyStop "{}"

LED Switch

• Interface Name: gbt_interface/srv/LED
• Interface Description: This interface is used to control the LED status of the robotic arm
• Start Service:

  ros2 launch gbt_driver gbt_service_server.launch.py robot_type:=<robot_type>

• Usage Example:

  ros2 service call /gbt_driver/service_server/led gbt_interface/srv/LED "{led_on: true}"