机器人 / 系统课时

加载 ROS 环境并设置通信域

加载 ROS 环境并设置通信域

本课把已安装的 ROS 2 加载到当前终端,并用 ROS_DOMAIN_ID 将不同实验隔离。完成两个终端的发现测试后,你将能区分环境未加载、通信域不一致和节点发现异常,而不必一遇到“看不到节点”就重装 ROS 2。

学习目标

  • 正确加载 ROS 2 的环境脚本,检查发行版和命令是否可用。
  • 理解 ROS_DOMAIN_ID 的作用域,并为一组节点配置相同的域编号。
  • 用两个终端验证同域可发现、异域不可发现,并定位常见误配置。

加载当前终端的 ROS 2 环境

以下命令适用于 Ubuntu 24.04、ROS 2 Jazzy、Bash,前提是已安装 ROS 2。若使用 Ubuntu 22.04 上的 Humble,应将路径中的 jazzy 替换为 humble;源码安装则使用实际安装目录中的环境脚本。

bash
# 检查发行版,并验证消息接口可查询
source /opt/ros/jazzy/setup.bash
printf 'ROS_VERSION=%s\nROS_DISTRO=%s\n' "$ROS_VERSION" "$ROS_DISTRO"
ros2 interface show example_interfaces/msg/String | grep -Fx 'string data'

预期输出:

text
ROS_VERSION=2
ROS_DISTRO=jazzy
string data

最后一行说明 example_interfaces/msg/String 接口可查询,且包含一个 string 类型的 data 字段。加载脚本还会配置命令和包搜索路径。source 只影响当前 Shell 及之后由它启动的进程:新开的终端必须重新加载,已经运行的节点也不会因另一个终端执行 source 而改变环境。Bash 对应 setup.bash,Zsh 应使用 setup.zsh。

设置独立的 DDS 通信域

ROS 2 通常通过 DDS 自动发现同域节点。未设置时默认使用域 0;多个机器人、实验组共用网络时,可选择 0~101 范围内未被占用的整数。本例用 21 作为实验域,22 作为对照域;域编号只是发现隔离条件,不提供身份认证或加密。

bash
# 在将要启动 ROS 2 节点的终端中设置
export ROS_DOMAIN_ID=21
printf 'ROS_DOMAIN_ID=%s\n' "$ROS_DOMAIN_ID"

预期输出:

text
ROS_DOMAIN_ID=21

export 让随后启动的节点继承域编号,但不会改变已启动节点的域。如果希望现有节点切换到 22,应停止该节点、修改环境变量后重新启动;仅在另一个终端修改变量没有效果。

同域节点可相互发现、不同通信域彼此隔离

在两个终端验证节点发现

先确认安装了 demo_nodes_cpp 示例包(Jazzy 的 Desktop 安装通常包含它;若没有,可安装 ros-jazzy-demo-nodes-cpp)。终端 A 设置域 21,启动不断发布 /chatter 的节点,并保持运行:

bash
# 终端 A:保持此进程运行
source /opt/ros/jazzy/setup.bash
export ROS_DOMAIN_ID=21
ros2 run demo_nodes_cpp talker

预期输出(持续出现):

text
[INFO] [<TIME>] [talker]: Publishing: 'Hello World: 1'
[INFO] [<TIME>] [talker]: Publishing: 'Hello World: 2'

终端 B 也加载环境并设为域 21,用不依赖 CLI 后台 daemon 的查询确认发现了 /talker。--spin-time 3 给 DDS 三秒时间完成发现:

bash
# 终端 B:与终端 A 位于同一域
source /opt/ros/jazzy/setup.bash
export ROS_DOMAIN_ID=21
ros2 node list --no-daemon --spin-time 3

预期输出(若同域还有其他节点,也可能有其他行):

text
/talker

终端 A 不要退出。在终端 B 改成域 22,再检查能否发现域 21 的 /talker:

bash
# 终端 B:只改变后续命令所用的域
export ROS_DOMAIN_ID=22
ros2 node list --no-daemon --spin-time 3 | grep -Fx '/talker' || echo 'NOT_FOUND'

预期输出:

text
NOT_FOUND

NOT_FOUND 是最后的 Shell 检查语句打印的,不是 ROS 2 的报错。如果域 22 中恰好还有其他同名 /talker,这条名称检查会误判;在共享实验室应先选无人使用的域,或给测试节点指定独特名称。实验结束后在终端 A 按 Ctrl+C 停止发布者。

固定设置与排查异常

若每次打开新 Bash 终端都要使用同一发行版,可将 source /opt/ros/jazzy/setup.bash 放入 ~/.bashrc,检查避免重复。固定实验室域时也可加入 export ROS_DOMAIN_ID=21;若经常切换项目,建议只自动加载 ROS 2,在每个终端手动设置域,避免无意间混入其他机器人的实验。

当查询结果不符合预期时,按以下顺序检查:

  1. 提示 ros2: command not found:确认环境脚本路径存在,并在当前终端执行 source;不要用 bash /opt/ros/jazzy/setup.bash 替代,因为子进程不会把变量带回父 Shell。
  2. 两个终端的域不同:分别检查 echo "$ROS_DOMAIN_ID";未设置代表默认域 0。核对后重启目标节点,不能只修改已经运行的节点所在终端。
  3. 同域仍无法发现:确认发布者进程仍在、机器间网络可达、DDS 发现范围与防火墙允许相关通信。跨机器时同域是必要条件但并不保证连通。
  4. 普通 ros2 node list 结果滞后:ROS 2 CLI 的 daemon 可能使用旧的发现配置。在对应域下执行 ros2 daemon stop 后重查,或像本例一样使用 --no-daemon --spin-time 3。

最终的验收标准是:同域终端能列出正在运行的 /talker,异域终端无法发现该实验节点。调换域后重新启动节点,观察结果应随之改变。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加载 ROS 环境并设置通信域

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通