📚 课程目录第4章快速启动示例

4、快速启动示例：运行官方提供的Simple Robot示例，验证Bridge能否成功收发/scan与/cmd_vel话题

好，到了动手验证的时候了。

前面我们把环境搭好了，Bridge也配通了。但说实话，配通不等于能用。我见过不少团队，配置阶段一切正常，一跑实际数据就翻车。所以这一节，咱们直接拿官方自带的Simple Robot示例来跑一遍，看看/scan和/cmd_vel这两个最核心的话题到底能不能正常收发。

4.1 示例概览：我们要验证什么？

Simple Robot是Isaac Sim官方提供的一个最小化机器人仿真示例。它不复杂，但覆盖了仿真与ROS2通信的典型链路：

传感器输出：机器人发布/scan话题（激光雷达数据）
控制输入：机器人订阅/cmd_vel话题（速度指令）
Bridge中转：Isaac Sim通过ROS2 Bridge将仿真数据转为ROS2话题，同时接收外部指令驱动仿真

说白了，这就是一个闭环：仿真里的小车转起来，你就能在终端看到数据流。如果这一步通了，后面做复杂场景才有底气。

核心验证目标：

确认/scan话题有数据发布，且频率、帧结构正确
确认/cmd_vel话题能被仿真接收，并驱动机器人运动
确认Bridge节点无报错、无丢包

4.2 启动示例：三步走

我个人习惯把启动流程拆成三步，不容易乱。你跟着走一遍就行。

步骤一：启动Isaac Sim并加载Simple Robot

打开终端，进入Isaac Sim安装目录，执行：

./isaac_sim.sh --allow-root

等界面加载完成后，在菜单栏找到 Isaac Examples → ROS2 → Simple Robot，点击加载。你会看到一个带激光雷达的小车出现在场景中。

小提示：如果菜单里找不到，可以直接在Python脚本窗口运行：

exec(open('/isaac-sim/standalone_examples/api/omni.isaac.ros2_bridge/simple_robot.py').read())

这是我在项目里常用的备用方式，有时候菜单加载会卡住。

步骤二：启动ROS2 Bridge

在Isaac Sim的菜单栏中，点击 Window → Extensions → ROS2 Bridge，确保Bridge状态显示为 Connected。如果没连上，检查一下前面的配置步骤。

嗯，这里要注意：Bridge启动后，默认会发布/clock和/tf等基础话题。但/scan和/cmd_vel需要机器人开始运动后才会有数据。

步骤三：在ROS2终端验证话题

打开一个新的终端，先看看话题列表：

ros2 topic list

你应该能看到类似这样的输出：

/clock
/tf
/tf_static
/scan
/cmd_vel
/odom

如果/scan和/cmd_vel都在，说明Bridge已经成功把仿真话题暴露出来了。

4.3 验证/scan话题：激光雷达数据

接下来，我们看看/scan到底有没有数据。执行：

ros2 topic echo /scan

你会看到一长串数据不断刷新。关键字段包括：

字段	含义	典型值
`header.stamp`	时间戳	与仿真时间同步
`angle_min`	扫描起始角度	-3.14159 (rad)
`angle_max`	扫描结束角度	3.14159 (rad)
`ranges`	距离数组	360个浮点数
`intensities`	反射强度	通常全为0

你还可以用ros2 topic hz /scan查看发布频率。正常情况下应该是10Hz左右。如果频率忽高忽低，或者数据里全是inf，那就要检查一下激光雷达的配置了。

避坑指南：我曾经遇到过/scan话题有数据但全是inf的情况。查了半天，发现是仿真场景里没有添加任何障碍物。激光雷达扫出去全是无限远，数据自然无效。所以建议你在小车周围放几个立方体，再验证数据。

4.4 验证/cmd_vel话题：控制指令

光有传感器数据还不够，我们得确认仿真能接收外部控制指令。执行：

ros2 topic pub /cmd_vel geometry_msgs/msg/Twist "{linear: {x: 0.5, y: 0.0, z: 0.0}, angular: {z: 0.2}}" --once

这条命令会让小车以0.5m/s的速度前进，同时以0.2rad/s的速度转弯。你会在Isaac Sim的视口中看到小车开始移动。

如果想持续控制，可以用--rate 10参数：

ros2 topic pub /cmd_vel geometry_msgs/msg/Twist "{linear: {x: 0.5, y: 0.0, z: 0.0}, angular: {z: 0.0}}" --rate 10

这时候小车会一直往前走。你可以同时观察/scan数据的变化——随着小车移动，激光雷达测到的距离值也会实时更新。

小技巧：我个人习惯用ros2 topic echo /scan和ros2 topic pub /cmd_vel在两个终端同时跑。一边发指令，一边看传感器反馈，能直观感受到仿真与ROS2的实时交互。这种"所见即所得"的体验，对理解Bridge的工作原理很有帮助。

4.5 整体流程可视化

为了让你更清楚地理解整个数据流，我画了一张流程图：

4.6 常见问题与排查

验证过程中，你可能会遇到一些问题。我把常见的列出来：

现象	可能原因	解决方法
`/scan`话题不存在	Bridge未正确连接，或机器人未启动	检查Bridge状态，重新加载Simple Robot
`/scan`数据全是`inf`	场景中没有障碍物	在场景中添加立方体或墙壁
`/cmd_vel`发布后小车不动	话题名称或消息类型不匹配	用`ros2 topic info /cmd_vel`确认类型
Bridge频繁断开	网络延迟或端口冲突	检查防火墙，确保端口未占用

避坑指南：我曾经遇到过/cmd_vel发布后小车纹丝不动的情况。排查了半天，发现是geometry_msgs/msg/Twist的消息结构写错了——把linear写成了Linear。ROS2对大小写敏感，这种低级错误最容易让人抓狂。所以发布指令时，建议先ros2 interface show geometry_msgs/msg/Twist看一眼消息结构。

4.7 验证总结

到这里，你应该已经成功验证了/scan和/cmd_vel两个话题的收发。如果一切顺利，恭喜你——Isaac Sim与ROS2的通信链路已经跑通了。

这一步虽然简单，但它是后续所有复杂功能的基础。你想想看，如果连官方示例都跑不通，后面做自定义机器人、多传感器融合、导航规划，那基本就是空中楼阁。

我个人建议，把这个验证流程记下来，以后每次换环境、升级版本、或者换机器，都先跑一遍这个示例。它能帮你快速定位问题是出在仿真侧、Bridge侧还是ROS2侧。