7.6 Sensor Data

7.6 Sensor Data

7.6.1 Overview

A3 is equipped with a wide range of sensors, including cameras and IMUs. For the exact sensor locations, refer to the component descriptions in the overview section of this document.

We provide ROS2 topic interfaces for raw frame data from each sensor, all using standard ROS2 message types. Instead of listing each interface individually, this section provides a unified topic description table together with notes on the intrinsic and extrinsic parameter files and their usage.

7.6.2 Sensor Topic Interfaces

Topic NameMessage TypeSensor ModelData StreamResolutionFrame Rate
/hal/head_left_fisheye_camera/streamfoxglove_msgs::msg::CompressedVideoLeft head fisheye H265Color image (color) h265 encoded1920*153630FPS
/hal/head_rear_fisheye_camera/streamfoxglove_msgs::msg::CompressedVideoRear head fisheye H265Color image (color) h265 encoded1920*153630FPS
/hal/head_right_fisheye_camera/streamfoxglove_msgs::msg::CompressedVideoRight head fisheye H265Color image (color) h265 encoded1920*153630FPS
/hal/head_stereo_left_fisheye_camera/streamfoxglove_msgs::msg::CompressedVideoLeft eye of head stereo camera H265Color image (color) h265 encoded2400*180030FPS
/hal/head_stereo_right_fisheye_camera/streamfoxglove_msgs::msg::CompressedVideoRight eye of head stereo camera H265Color image (color) h265 encoded2400*180030FPS
/hal/chest_front_d457_camera/streamfoxglove_msgs::msg::CompressedVideoFront chest depth camera H265Color image (color) h265 encoded1280*72030FPS
/hal/waist_front_d415_camera/streamfoxglove_msgs::msg::CompressedVideoFront waist depth camera H265Color image (color) h265 encoded1280*72030FPS
/hal/wrist_left_d405_camera/streamfoxglove_msgs::msg::CompressedVideoLeft wrist depth camera H265Color image (color) h265 encoded848*48030FPS
/hal/wrist_right_d405_camera/streamfoxglove_msgs::msg::CompressedVideoRight wrist depth camera H265Color image (color) h265 encoded848*48030FPS
/hal/head_stereo_left_fisheye_camera/rgbsensor_msgs::msg::ImageLeft slave camera of head stereo pairColor image (color)2400*180030FPS
/hal/head_stereo_right_fisheye_camera/rgbsensor_msgs::msg::ImageRight slave camera of head stereo pairColor image (color)2400*180030FPS
/hal/head_left_fisheye_camera/rgbsensor_msgs::msg::ImageLeft head fisheyeColor image (color)1920*153630FPS
/hal/head_right_fisheye_camera/rgbsensor_msgs::msg::ImageRight head fisheyeColor image (color)1920*153630FPS
/hal/head_rear_fisheye_camera/rgbsensor_msgs::msg::ImageRear head fisheyeColor image (color)1920*153630FPS
/hal/chest_front_d457_camera/rgbsensor_msgs::msg::ImageFront chest depth cameraColor image (color)1280*72030FPS
/hal/waist_front_d415_camera/rgbsensor_msgs::msg::ImageFront waist depth cameraColor image (color)1280*72030FPS
/hal/wrist_left_d405_camera/rgbsensor_msgs::msg::ImageLeft wrist depth cameraColor image (color)848*48030FPS
/hal/wrist_right_d405_camera/rgbsensor_msgs::msg::ImageRight wrist depth cameraColor image (color)848*48030FPS
/hal/armpit_right_fisheye_camera/rgbsensor_msgs::msg::ImageRight armpit fisheye cameraColor image (color)1920*153630FPS
/hal/neck_middle_livox_lidar/pointcloudsensor_msgs::msg::PointCloud2LiDAR
/hal/neck_middle_livox_lidar/imufoxglove_msgs::msg::CompressedVideoNeck IMU sensor
/ros2/body_drive/pelvis_imu/datafoxglove_msgs::msg::CompressedVideoWaist IMU sensor
/ros2/body_drive/torso_imu/datafoxglove_msgs::msg::CompressedVideoChest IMU sensor

Camera Topic Publishing Modes

CameraTypeTopicNormal ModeData Collection Mode
Front headRGB/hal/head_front_left_fisheye_camera/imagePublishedPublished
Front headRGB/hal/head_front_right_fisheye_camera/imagePublishedPublished
Left stereoRGB/hal/head_stereo_left_fisheye_camera/rgbPublishedPublished
Left stereoH265/hal/head_stereo_left_fisheye_camera/streamPublishedPublished
Right stereoRGB/hal/head_stereo_right_fisheye_camera/rgbPublishedPublished
Right stereoH265/hal/head_stereo_right_fisheye_camera/streamPublishedPublished
Left headRGB/hal/head_left_fisheye_camera/rgbPublishedPublished
Left headH265/hal/head_left_fisheye_camera/streamPublishedPublished
Right headRGB/hal/head_right_fisheye_camera/rgbPublishedPublished
Right headH265/hal/head_right_fisheye_camera/streamPublishedPublished
Rear headRGB/hal/head_rear_fisheye_camera/rgbPublishedPublished
Rear headH265/hal/head_rear_fisheye_camera/streamPublishedPublished
Front waist D415RGB/hal/waist_front_d415_camera/rgbPublishedNot published
Front waist D415Depth/hal/waist_front_d415_camera/depthPublishedNot published
Front waist D415CompressedDepth/hal/waist_front_d415_camera/compressed_depthNot publishedPublished
Front waist D415H265/hal/waist_front_d415_camera/streamPublishedPublished
Front chest D457RGB/hal/chest_front_d457_camera/rgbPublishedNot published
Front chest D457Depth/hal/chest_front_d457_camera/depthPublishedNot published
Front chest D457CompressedDepth/hal/chest_front_d457_camera/compressed_depthNot publishedPublished
Front chest D457H265/hal/chest_front_d457_camera/streamPublishedPublished
Left wrist D405RGB/hal/wrist_left_d405_camera/rgbPublishedNot published
Left wrist D405Depth/hal/wrist_left_d405_camera/depthPublishedNot published
Left wrist D405CompressedDepth/hal/wrist_left_d405_camera/compressed_depthNot publishedPublished
Left wrist D405H265/hal/wrist_left_d405_camera/streamPublishedPublished
Right wrist D405RGB/hal/wrist_right_d405_camera/rgbPublishedNot published
Right wrist D405Depth/hal/wrist_right_d405_camera/depthPublishedNot published
Right wrist D405CompressedDepth/hal/wrist_right_d405_camera/compressed_depthNot publishedPublished
Right wrist D405H265/hal/wrist_right_d405_camera/streamPublishedPublished
Right armpit fisheyeRGB/hal/armpit_right_fisheye_camera/rgbPublishedNot published
Right armpit fisheyeH265/hal/armpit_right_fisheye_camera/streamPublishedPublished

Depth camera topics are published through the iceoryx backend by default, which can make them inconvenient to access. The following method adds the ros2 backend to their publishing configuration. Using /hal/chest_front_d457_camera/stream as an example:

  1. First, back up the corresponding configuration file on the ADU cp /agibot/software/v0/config/hal_depth_camera/hal_depth_camera_config.yaml /agibot/software/v0/config/hal_depth_camera/hal_depth_camera_config.yaml.bd
  2. Then edit the file and add ros2 to enable_backends for /hal/chest_front_d457_camera/stream under aimrt.channel.pub_topic_options, changing it from [iceoryx] to [iceoryx, ros2]
  3. Restart the robot