机器人 / 系统课时
用 ros_gz_bridge 桥接数据
用 ros_gz_bridge 桥接数据
让 Gazebo 的激光、里程计和仿真时钟进入 ROS 2,并把速度命令送回模拟底盘。完成后,你可以核对话题方向、消息类型、发布频率和机器人运动,判断桥接是否满足导航闭环的输入输出要求。
学习目标
- 根据 Gazebo 实际话题配置四条单向桥接规则。
- 用 ROS 2 命令验证消息类型、时钟与数据频率。
- 下发一组速度指令,并根据现象定位断流原因。
确认仿真话题与依赖
以下操作适用于 Ubuntu 24.04、ROS 2 Jazzy 和 Gazebo Harmonic。先启动一个带激光雷达和 DiffDrive 系统的机器人世界,并在 Gazebo 中取消暂停。桥接器只转换已存在的数据,不会自动创建传感器或驱动插件。
如尚未安装桥接组件,打开终端执行:
# 使用 Jazzy 对应的 Gazebo 集成包
sudo apt update
sudo apt install -y ros-jazzy-ros-gz
source /opt/ros/jazzy/setup.bash
ros2 pkg executables ros_gz_bridge | grep parameter_bridge
mkdir -p "$HOME/robot_bridge"预期输出的关键行:
ros_gz_bridge parameter_bridge在 Gazebo 仍运行的终端环境中核对话题及类型:
gz topic -l
gz topic -i -t /scan
gz topic -i -t /odom
gz topic -i -t /cmd_vel预期话题列表节选(仅在按示例命名时):
/clock
/scan
/odom
/cmd_vel查询详情时,对应消息分别应为 gz.msgs.LaserScan、gz.msgs.Odometry 和 gz.msgs.Twist。实际 Gazebo 默认话题常带 /model/机器人名/ 或传感器长路径,应按查询结果修改下文 gz_topic_name,不能直接假定它们叫 /scan。
明确四条桥接方向
Gazebo 的雷达与里程计是数据源,ROS 2 是接收方;/clock 也只从仿真流向 ROS 2。速度恰好相反,由 ROS 2 发布 /cmd_vel,经桥接到 Gazebo 的 DiffDrive 订阅端。不需要把这四条链路统一设成双向,否则可能产生回流或重复发布。

图中的 /scan 和 /odom 为感知、定位输入,/clock 负责时间基准,/cmd_vel 才是执行控制。ROS 2 中需要仿真时间的 Nav2 节点应设置 use_sim_time: true;仅桥接 /clock 不会自动替所有节点修改该参数。
写入 YAML 桥接配置
将以下内容保存为 ~/robot_bridge/bridge.yaml。示例假设 Gazebo 已提供同名 /scan、/odom、/clock 和 /cmd_vel;如果使用 DiffDrive 默认命名,须替换相应 Gazebo 端名称。
# /clock 只允许从 Gazebo 进入 ROS 2
- ros_topic_name: /clock
gz_topic_name: /clock
ros_type_name: rosgraph_msgs/msg/Clock
gz_type_name: gz.msgs.Clock
direction: GZ_TO_ROS
qos_profile: CLOCK
- ros_topic_name: /scan
gz_topic_name: /scan
ros_type_name: sensor_msgs/msg/LaserScan
gz_type_name: gz.msgs.LaserScan
direction: GZ_TO_ROS
qos_profile: SENSOR_DATA
- ros_topic_name: /odom
gz_topic_name: /odom
ros_type_name: nav_msgs/msg/Odometry
gz_type_name: gz.msgs.Odometry
direction: GZ_TO_ROS
# 控制命令只能从 ROS 2 发送到 Gazebo
- ros_topic_name: /cmd_vel
gz_topic_name: /cmd_vel
ros_type_name: geometry_msgs/msg/Twist
gz_type_name: gz.msgs.Twist
direction: ROS_TO_GZGZ_TO_ROS 与 ROS_TO_GZ 是桥接器接受的方向值;CLOCK 和 SENSOR_DATA 分别指定时钟、传感器适用的 QoS。配置格式可参照 Gazebo Harmonic 官方桥接说明。
运行桥接并核对频率
先创建目录、保存 YAML,再在另一个终端启动桥接进程;该终端应保持运行:
source /opt/ros/jazzy/setup.bash
ros2 run ros_gz_bridge parameter_bridge --ros-args -p config_file:="$HOME/robot_bridge/bridge.yaml"预期结果:进程持续运行而不是立即退出,桥接日志显示已建立映射;若 YAML 尚未保存或路径错误,会报无法加载配置文件。以下命令在新终端执行:
source /opt/ros/jazzy/setup.bash
ros2 topic type /clock
ros2 topic type /scan
ros2 topic type /odom
ros2 topic type /cmd_vel预期输出依次为:
rosgraph_msgs/msg/Clock
sensor_msgs/msg/LaserScan
nav_msgs/msg/Odometry
geometry_msgs/msg/Twist观察激光频率;Ctrl+C 结束后,将话题换成 /odom 重复测量:
ros2 topic hz /scan预期输出的关键行如下,<HZ> 是实时测量值:
average rate: <HZ>若激光在 SDF 中将 update_rate 设为 10,且仿真接近实时,通常应读到约 10 Hz;里程计的速率由 DiffDrive 的 odom_publish_frequency 决定,例如设为 20 就应接近 20 Hz。里程计频率可在另一个终端用 ros2 topic hz /odom 按相同方法检查。时钟检查命令如下:
ros2 topic echo /clock --once预期输出的结构如下,<TIME> 与 <NANOSEC> 是动态数值:
clock:
sec: <TIME>
nanosec: <NANOSEC>仿真播放时反复运行可看到时钟向前推进;暂停仿真后时间会停止变化。
下发速度并定位异常
确认机器人前方无遮挡、Nav2 控制器暂未同时发布 /cmd_vel,再发 20 条、10 Hz 的短距离前进命令。这里使用 Jazzy 常见的非时间戳 geometry_msgs/msg/Twist 接口。
ros2 topic pub --rate 10 --times 20 /cmd_vel geometry_msgs/msg/Twist '{linear: {x: 0.15}, angular: {z: 0.0}}'预期控制台先出现 publisher: beginning loop,随后逐条打印 publishing #1 至 publishing #20 及消息内容。理论上以 0.15 m/s 持续约 2 秒可前进约 0.3 m,实际位移取决于仿真步长、加速度限制和轮地接触。完成后发送零速,避免底盘保持上一条命令:
ros2 topic pub --rate 10 --times 10 /cmd_vel geometry_msgs/msg/Twist '{linear: {x: 0.0}, angular: {z: 0.0}}'预期控制台同样显示 publisher: beginning loop 和 10 次发布,机器人应停止,/odom 中的位姿在行驶时应变化。排查时按顺序判断:Gazebo 端无 /scan,检查传感器系统及是否暂停;Gazebo 有数据而 ROS 无数据,核对 gz_topic_name、消息类型和 QoS;有 /cmd_vel 但车不动,检查 Gazebo DiffDrive 订阅的话题和是否有其他控制源覆盖;有 /odom 却无法给 Nav2 定位,继续检查消息中的 frame_id、child_frame_id 与 TF 是否一致。桥接 /odom 不等于自动发布 odom 到 base_link 的 TF,导航还需要相应变换发布者。