添加与配置传感器
传感器需要模型定义、负责更新的系统,以及通向接收程序的数据链路。每次添加一个传感器,确认测量正常后再继续。
工作环境
使用 Ubuntu 原生安装、WSL 或 Docker 中准备好的 Linux 终端。macOS 用户在 RDP 桌面内操作。编辑和编译都在该环境中完成;POSIM_WS 表示其工作空间。
选择集成位置
| 测量 | 模型中的位置 | 世界系统 / ROS 连接 |
|---|---|---|
| IMU | link/sensor type="imu" |
IMU 系统;将 gz.msgs.IMU 桥接为 ROS Imu |
| 水下相机 | RGBD 传感器与图像效果插件 | 带渲染器的 Sensors 系统及相机话题 |
| DVL | DVL 传感器与波束配置 | DVL 系统及随附的声学消息桥接 |
| 压力 | model 下的直接子插件 |
直接发布 ROS 压力与深度消息 |
| 海洋 GNSS | 机器人模型上的接收机插件 | Gazebo gz.msgs.Double_V 测量消息;接入 ROS 需要单独的适配器 |
| USBL | 收发机与应答器插件 | 匹配的声学标识及 ROS 接口 |
| 多波束声纳 | 连杆下的自定义传感器 | Sensors 渲染器、世界多波束系统及 CPU/WGPU/CUDA |
参考各页的 SDF 和参数表,并遵守插件位置要求:世界系统放在世界中,模型插件放在其作用的模型中。
为示例世界添加 IMU
打开创建世界中的 calm_water.sdf。在 <world> 下、与物理系统同级的位置添加:
<plugin filename="gz-sim-imu-system" name="gz::sim::systems::Imu"/>
在 pressure_station 模型的 <link name="base_link"> 内添加:
<sensor name="imu" type="imu">
<pose>0 0 0.1 0 0 0</pose>
<always_on>true</always_on>
<update_rate>20</update_rate>
<topic>/tutorial/imu</topic>
<imu/>
</sensor>
安装位姿相对于所属连杆,位置单位为米,旋转单位为弧度。更新频率使用仿真时间。观测点固定,因此角速度应接近零;加速度包含对重力的响应。
连接并查看数据
停止之前的世界,在终端 A 校验并重新启动:
gz sdf -k calm_water.sdf
gz sim -r calm_water.sdf
在加载了环境的 终端 B 启动桥接,并保持运行:
ros2 run ros_gz_bridge parameter_bridge \
'/tutorial/imu@sensor_msgs/msg/Imu[gz.msgs.IMU'
在以相同方式准备的 终端 C 查看测量值:
ros2 topic echo --no-daemon /tutorial/imu sensor_msgs/msg/Imu --once
确认时间戳、坐标系标识、角速度和加速度。去掉 --once 可持续查看,按 Ctrl+C 停止显示。完成后停止桥接和仿真器。ROS 终端与话题解释了如何共享运行环境。
改变更新频率
将 update_rate 从 20 改为 5,重新启动世界和桥接。相邻时间戳间隔应从约 0.05 秒变为 0.2 秒仿真时间。按实际时间计算的接收频率还取决于实时因子和传输过程。
相机应一起检查分辨率、视场角及近远裁剪距离。扫描传感器应检查波束几何和量程。移动传感器前,先确认所属连杆的坐标系和朝向。
核对集成结果
- 模型:有效的安装位姿、参数和唯一话题。
- 世界:所需系统,以及图像传感器使用的渲染器。
- ROS:桥接方向、消息类型、坐标系和 QoS。
- 数据:持续更新的时间戳,以及对受控场景变化的响应。