RBQ SDK — ROS2 Overview
The RBQ ROS2 SDK (rbq_sdk/ros2/) provides a ROS 2 Humble interface to the RBQ robot, including robot state publishers, sensor data streams, vision topics, and a command subscriber.
What the ROS2 SDK provides
- Robot Control — Gait switching, posture commands, velocity control, auto-docking.
- Sensor Feedback — IMU, joint status, foot contact, battery state at 50 Hz.
- Vision Streaming — Front, rear, and bottom camera topics (RGB, IR, Depth, camera_info).
- RViz2 Visualization — URDF robot model with custom RViz panel for live commands.
System requirements
| Component | Requirement |
|---|---|
| OS | Ubuntu 22.04 |
| ROS 2 | Humble |
| Python | 3.8 / 3.9 / 3.10 |
Quick install
bash
# Install ROS Humble (first time) — https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html
sudo apt update && sudo apt install -y ros-humble-desktop \
python3-colcon-common-extensions python3-rosdep \
ros-humble-rmw-cyclonedds-cpp ros-humble-cyclonedds
sudo rosdep init && rosdep update
source /opt/ros/humble/setup.bash
# Install ROS dependencies
cd ros2
rosdep install --from-paths src -y --ignore-src
# Build
colcon build --symlink-installRun (simulation)
bash
source ros2/install/local_setup.bash
bash scripts/sim.bashRun (real robot)
bash
source ros2/install/local_setup.bash
bash scripts/start_ros_driver.bashROS2 SDK full documentation
For the complete topic reference, command examples, RViz setup, and DDS configuration see the full guide:
The full page covers:
- All gait state topics and command topics
- Low-level state topics (robot status, joint status, battery, foot states)
- High-level command (
rbq/motion/cmd_highLevel) with velocity ranges per gait - Navigation command (
rbq/motion/cmd_navigateTo) - Vision and camera topics
- PTZ camera control
- PDU power control
- RViz2 launch and visualization
- DDS domain / network configuration for developer PC ↔ robot communication
RViz2 Visualization
Visualize robot state, URDF model, and sensor data in real time — and send commands — via the RViz2 GUI panel.
bash
source ros2/install/local_setup.bash
bash scripts/start_rviz.bash
