ROS 终端与连接
www_posim_ros 软件包将本地 ROS 环境连接到正在运行的 WWW-POSIM 工作区。连接器接收经过身份验证的遥测数据,并在本地 ROS 域中发布标准 ROS 2 消息。使用 ROS 工具时,请保持连接器运行。
Gazebo 传感器→ HTTPS / WebSocket →www_posim_ros
连接器→ 本地 ROS 2 →ros2 topic · RViz
Python 程序
桌面版 ROS 终端
先启动世界,再从应用中打开 ROS 终端。终端会进入工作目录(初始为 Documents/WWW-POSIM),并准备应用的 ROS 环境。从应用打开的多个终端共享一个本地连接器。
在 macOS 上,终端会显示 WWW-POSIM 标题、准备状态和连接耗时。请等待 ROS connected 以及 ROS、Python 和连接器版本出现。彩色的 WWW-POSIM 提示符表示这是已准备好的环境。
选择在 VS Code 中打开,会同时打开该目录和 ros_vehicle_command.py,并准备 ROS 终端。运行控制程序的方法见控制桌面版工作区。打开 RViz 的选项会启动已安装的查看器。
在 Autopilot 模式下,ROS 工具只提供遥测。ros_vehicle_command.py 需要 ROS 2直接控制模式。切换模式时,请先解除载具武装,在工作区设置中复用已准备的地形,选择 ROS 2直接控制并重新启动世界。重新启动会重置仿真。已保存载具的控制模式固定在该版本中;如需更改,请使用内置载具或编辑已保存载具的副本。
已安装应用的 ROS 2直接控制面板也提供打开 ROS 终端和在 VS Code 中打开按钮。两者都使用应用中选定的工作目录。使用网站或本地启动功能不可用时,请选择 ROS 终端与 VS Code 指南。指南会在单独窗口中打开。
将 ROS 环境连接到网页工作区
在网站中启动自己的世界。按照 ROS 安装指南准备 ROS 2 Lyrical 和标准消息包。在 Ubuntu 或 WSL 终端中加载 ROS 并安装连接器:
source /opt/ros/lyrical/setup.bash
sudo apt install ros-lyrical-rmw-cyclonedds-cpp
python3 -m venv --system-site-packages .venv-ros
source .venv-ros/bin/activate
python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export ROS_DOMAIN_ID=76
export ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST
www-posim-connect --server https://www-posim.vercel.app/api --email YOU@example.com
根据提示输入密码,并保持该终端打开。在第二个终端中加载同一 ROS 配置和虚拟环境,并设置相同的三个环境变量。仅创建 Python 虚拟环境并不会安装 ROS 或 rclpy。
使用 Mac 应用自带的环境时,将加载 ROS 的命令替换为:
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
将 ROS 环境连接到桌面版工作区
启动桌面应用和世界。在准备好的 ROS 环境中,使用以下命令代替网站连接命令:
www-posim-connect --local --server http://127.0.0.1:3300/api
连接器使用应用当前的会话,不要求网站登录凭据。每个 ROS 域只运行一个连接器,不要在同一域中同时启动应用管理的连接器。如果独立的 WSL 发行版无法访问 Windows 应用的回环地址,请直接从应用打开 ROS 终端。
检查话题与实时数据
连接器就绪后,运行:
ros2 topic list
ros2 topic echo /model/wamv/odometry
确认消息持续到达,并且时间戳不断更新。按 Ctrl+C 停止显示。使用 BlueROV2 时,从列表中选择其里程计话题。列表中出现话题名称,并不能单独证明数据流已经接通。
如果没有数据,请检查世界是否正在运行,以及两个终端是否使用相同的 ROS 环境和域。另见 ROS 故障排除、控制网页工作区和控制桌面版工作区。