Skip to main content
Version: ROS 2 Jazzy

ROS 2 Platform API

note

Motor topic message types may differ based on the motor controller used by the platform.

Platform Topics

TopicMessage typePublisherDescriptionQoSPlatform
cmd_velgeometry_msgs/TwistStampedUserCommands the robot to drive at a velocitySystem DefaultAll
diagnosticsdiagnostics_msgs/DiagnosticArrayVarious nodesDiagnostic messages reported by various nodesSystem DefaultAll
joy_teleop/cmd_velgeometry_msgs/TwistStampedJoy nodeVelocity commands from joystick inputsSystem DefaultAll
joy_teleop/joysensor_msgs/JoyJoy nodeJoystick input statesSystem DefaultAll
platform/bms/statesensor_msgs/BatteryStateBattery nodeSystem battery stateSensor DataAll
platform/cmd_fansclearpath_platform_msgs/FansUserUser fans command requestSystem DefaultA300
platform/cmd_lightsclearpath_platform_msgs/LightsUserUser lighting command requestSystem DefaultA300, DX100, DX150, R100
platform/cmd_velgeometry_msgs/TwistStampedTwist Mux nodeResulting velocity commands from twist muxSystem DefaultAll
platform/dynamic_joint_statescontrol_msgs/DynamicJointStateControl nodePlatform dynamic joint stateSystem DefaultAll
platform/emergency_stopstd_msgs/BoolMCU nodeState of platform emergency stopSensor DataAll
platform/joint_statessensor_msgs/JointStateControl nodePlatform joint stateSystem DefaultAll
platform/motors/cmdclearpath_platform_msgs/Drive sensor_msgs/JointStateControl nodeCommand velocities to individual wheelsSensor DataAll
platform/motors/feedbackclearpath_platform_msgs/DriveFeedback clearpath_motor_msgs/LynxMultiFeedback clearpath_motor_msgs/PumaMultiFeedbackMCU or Motor Driver nodeFeedback from motor drive unitSensor DataAll
platform/motors/statusclearpath_motor_msgs/LynxMultiStatus clearpath_motor_msgs/PumaMultiStatusMotor Driver nodeStatus from motor drive unitSensor DataA300, DX100, DX150, R100
platform/odomnav_msgs/OdometryControl nodePlatform wheel odometrySystem DefaultAll
platform/odom/filterednav_msgs/OdometryEKF nodePlatform wheel odometry fused with IMU dataSystem DefaultAll
platform/wifi_connectedstd_msgs/BoolWireless Watcher nodeWi-Fi connected statusSystem DefaultAll
platform/wifi_statuswireless_msgs/ConnectionWireless Watcher nodeWi-Fi signal statusSystem DefaultAll
robot_descriptionstd_msgs/StringRobot State PublisherRobot descriptionTransient LocalAll
tftf2_msgs/TFMessageVarious nodesLink transformsSystem DefaultAll
tf_statictf2_msgs/TFMessageVarious nodesStatic link transformsTransient LocalAll
twist_marker_server/cmd_velgeometry_msgs/TwistStampedTwist Marker ServerVelocity commands from twist markerSystem DefaultAll
/rosoutrcl_interfaces/LogVarious nodesSystem LogsTransient LocalAll

Platform Actions

ServiceService typeServerDescriptionQoSPlatform
platform/motors/calibrateclearpath_motor_msgs/LynxCalibrateLynx Motor NodeCalibrate Lynx motor controllersSystem defaultA300
platform/motors/updateclearpath_motor_msgs/LynxUpdateLynx Motor NodeUpdate Lynx motor controllersSystem defaultA300

Platform Services

ServiceService typeServerDescriptionQoSPlatform
platform/pinout/aux_#clearpath_platform_msgs/SetPinoutPinout control nodeSet auxiliary output pin state to on/off/toggleSystem defaultA300, DX100, DX150
platform/pinout/gpo_#clearpath_platform_msgs/SetPinoutPinout control nodeSet general purpose output pin state to on/off/toggleSystem defaultA300
platform/pinout/user_pwr_ctrlstd_srvs/SetBoolPinout control nodeSet user power rail output to on/offSystem defaultA300