ROS 故障排除
修改原本可用的配置前,先检查数据是否更新,以及中间件和 QoS 是否匹配。
常见问题
No module named www_posim_ros:选择项目解释器。网页项目应使用.venv中的 Python 重新安装软件包。- 没有新遥测:检查世界是否运行、载具是否出现。话题名存在不能证明正在接收数据。
- 提示需要 ROS 2 直接控制:以该模式创建世界。
controller_busy:停止控制同一世界的其他程序,再重新运行。- 更换了世界或载具:重启程序以获取当前连接配置。
- 应用中的 ROS 工具失败:查看准备好的环境中的
~/.www-posim-ros/domain-76/client.log,必要时关闭并重新打开工具。
DDS、相机 QoS 与 WSLg
英文课程练习 Read WAM-V LiDAR and camera data with ROS会保存 Matplotlib 图像,不打开图形窗口。
DDS 负责传输 ROS 2 消息。Fast DDS 使用 rmw_fastrtps_cpp,Cyclone DDS 使用 rmw_cyclonedds_cpp。在准备好的 ROS 终端中检查:
python -c 'import rclpy; rclpy.init(); print(rclpy.utilities.get_rmw_implementation_identifier()); rclpy.shutdown()'
ros2 topic info /model/wamv/camera/compressed --verbose
应用管理的转发进程及其环境内的程序继承引擎中间件。修改已打开终端的环境变量,不会改变正在运行的转发进程。Reliable 订阅与转发器的 Reliable 相机和激光雷达发布端兼容。排查大型 JPEG 消息时,应核对 ROS 域、中间件和 QoS;仅看到话题名不能证明数据成功传输。
Reliable 发布端可以服务 Best Effort 订阅端;Best Effort 发布端无法满足要求 Reliable 的订阅端。更改前应检查发布端提供和订阅端要求的 QoS。里程计示例:
ros2 topic info /model/wamv/odometry --verbose
ros2 topic echo /model/wamv/odometry --once --qos-reliability best_effort
网站通过 WebSocket 传输消息,服务器和本地转发器使用独立的 DDS 域。高级配置见 ROS 中间件指南。
在独立安装的 Ubuntu/WSL ROS 环境中,应在启动连接器与传感器程序前安装并选择中间件:
sudo apt install ros-lyrical-rmw-cyclonedds-cpp
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export ROS_DOMAIN_ID=76
export ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST
使用 Fast DDS 时,安装 ros-lyrical-rmw-fastrtps-cpp,并设置 RMW_IMPLEMENTATION=rmw_fastrtps_cpp。切换前停止连接器和节点,执行 ros2 daemon stop,再从设置相同的终端重新启动。这些手动命令适用于独立 ROS 环境;入门练习使用应用准备好的工具即可。
如果 WSLg 中的 RViz 出现 Qt Wayland 父窗口或 xcb 平台错误,请确认 RViz 所在环境提供 WSLg 和图形依赖。可只对该进程尝试 X11:
QT_QPA_PLATFORM=xcb rviz2 -d session.rviz
将 session.rviz 替换为连接器生成的配置路径。QT_QPA_PLATFORM 仅作用于该图形命令;转发器和无窗口 Matplotlib 脚本不需要它。重新启动 RViz 不会创建 ROS 连接。请保持匹配的连接器运行,并单独确认新消息持续到达。