abb_ros2学习笔记：在RViz2中显示ABB机器人模型的完整链路

这是abb_ros2学习笔记系列的第2篇，主题是让ABB机器人模型出现在RViz2窗口中。上篇我把源码编译和驱动包结构理了一遍，这次实际操作后发现，“显示机器人”这短短四个字背后藏着一条完整的链路：URDF模型从xacro生成，加载到robot_description参数；robot_state_publisher订阅参数后计算每个关节的tf；joint_state_publisher按一定频率发布关节状态；RViz2拿到这些数据后在场景里渲染出机械臂模型。任何一个环节出问题，屏幕上都是空白或者残缺的模型。这篇笔记我打算直接从安装启动讲起，再用一次完整实操展示让IRB 120出现在RViz2里的具体命令和配置，最后把我踩过的坑整理成一份排查列表。写给自己备忘，也希望能帮到正在学习abb_ros2的朋友。

1. abb_ros2项目回顾：搞懂手上这套驱动包

1.1 为什么PickNikRobotics的abb_ros2值得学

ABB是目前工业机器人里占有率很高的品牌，但官方对ROS2的支持一直比较克制。PickNikRobotics这个开源组织维护的abb_ros2，是社区里用得比较广的ABB ROS2方案，它把ABB控制器的RWS通信能力、ros2_control硬件抽象和URDF模型打包在一起，让我可以不依赖厂商商业软件就去学习和验证整体的机器人软件栈。对我来说特别有价值的一点是：它支持多款机型，从最常见的IRB 120、IRB 1100到中型的IRB 1600、IRB 2400，再到IRB 4600、IRB 6700等，仓库里都提供了对应的模型和配置，学习曲线可以覆盖很广的型号范围。

你在阅读时如果发现某个型号没有，也别急着抱怨，ABB的型号太多，开源社区维护者不可能全部覆盖。排查逻辑是一样的，后面我会讲怎么调整。

1.2 与显示链路相关的三个子包

克隆下来的abb_ros2仓库，与“显示机器人”这件事直接相关的子包主要有三个。

第一个是abb_resources。这个包存放着所有机型的xacro/URDF文件、meshes网格文件以及部分颜色材质定义，是显示模型的素材来源。很多新手直接去改这里的URDF，结果改错了还没法还原。我的建议是尽量不要手工改动，除非你完全清楚xacro宏展开的规则。

第二个是abb_ros2主包。它提供launch入口和控制器配置文件，正常情况下你不用手动去碰URDF，直接launch它就能带动整个显示链路。如果你用ros2 pkg list | grep abb看到了abb_ros2，就说明主包已经正确装进环境了。

第三个是abb_hw。这是基于ros2_control的硬件接口层，它决定了模型关节状态是来自真实机器人还是来自仿真。我们显示机器人时几乎总会把use_fake_hw置为true，让关节状态由软件模拟产生，避免在没有真实机器人的情况下让控制器等待RWS连接而卡死。理解这三个包的分工，我再去看launch、xacro、yaml这些文件时就不会迷路。

1.3 显示链路在整个学习路线里的位置

很多初学者觉得“显示”只是为了截图好看，其实它是整个ROS2机器人开发的地基。URDF是模型的地图，tf是地图上物体的定位，JointState是地图上所有关节的角度，这三样东西同时准备好，MoveIt2、轨迹规划、避障、仿真验证才有数据可以依赖。

类比来说，URDF就是一份详细的家装图纸，robot_state_publisher就是照着图纸把柜子装起来的师傅，joint_state_publisher是给柜子抽屉装上把手的工人，RViz2则是装修好的样板房。图纸没画全、师傅装错位置或者抽屉没装把手，最后样板房都展示不出来。

显示模型的链路打通之后，后续接ros2_control的真实控制器、接MoveIt2进行运动规划，都是在同一套数据链路里加新的模块，不会推倒重来。这也是为什么我建议宁可在这个步骤多花时间，也要把原理吃透。

2. 环境准备：源码编译与依赖补齐

2.1 版本怎么选

我演示用的环境是Ubuntu 22.04 + ROS2 Humble。如果你只有Ubuntu 20.04，装ROS2 Foxy也行，abb_ros2对Humble/Foxy都有对应的适配，launch文件的差异不大。但有一个前提建议：ROS2发行版别太新，直接用最新版本有时会碰到ros2_control接口变更，导致编译时需要自己改代码。选Long Term Support版本最稳，Humble是目前最省心的选择。

2.2 从克隆到编译的完整过程

先创建workspace并拉取源码：

mkdir -p ~/abb_ws/src cd ~/abb_ws/src git clone https://github.com/PickNikRobotics/abb_ros2.git

有些版本的仓库在clone之后还需要vcs import拉取第三方依赖，比如ros2_control、ros2_controllers、moveit2等。仓库里会带一个repos文件，具体看一下README里的Dependencies部分。如果repos文件就在仓库根目录，命令是：

cd ~/abb_ws/src/abb_ros2 vcs import < .repos

vcs import会把依赖的源码仓库也clone到src目录。如果你的网络状态不理想，clone过程可能会中断，多试几次或者选一个网络通畅的时间段重新拉取，别在clone阶段就把耐心耗尽。

然后安装系统依赖：

cd ~/abb_ws rosdep install --from-paths src --ignore-src -r -y

如果某个依赖没有出现在rosdep数据库里，手动安装可能更省事，尤其ros2_control全家桶，直接用apt装反而比源码编译更不容易出问题：

sudo apt install ros-humble-ros2-control ros-humble-ros2-controllers

编译：

colcon build --symlink-install source install/setup.bash

用--symlink-install的好处是python脚本和launch文件会以软链接方式出现在install目录，后续改launch或者python代码不用重新编译，对学习阶段非常友好。

2.3 编译时的典型报错

最常见的编译失败是缺少ros2_control相关包，报错信息通常类似Could NOT find ros2_control。这时候别急着怀疑代码，先检查ros2_control和ros2_controllers是否已经在环境中。Humble的ros2_control版本较新，如果从源码把abb_ros2的所有依赖一股脑import进来，再用colcon build，有时会出现依赖版本冲突的提示。我的建议是优先用apt安装ros2_control全家桶，再编译abb_ros2，这样最省心。

另一个容易踩的坑是moveit相关依赖缺失。实际上纯显示模型不需要MoveIt2，但如果launch文件里某个import引用了moveit相关模块，编译或运行时就会报ImportError。不想安装全套MoveIt2的话，可以先看看是不是launch里默认触发了moveit的加载，学习阶段可以手动打开没有moveit引用的display.launch.py。当然，直接装上MoveIt2也可以，后面迟早要用。

2.4 安装完成后先验证一下

ros2 pkg list | grep abb

输出里能看到abb_ros2、abb_msgs、abb_resources等包名，说明编译安装成功。这一步很快，但很多人会跳过，等launch报错才回头查安装问题。我建议再加上一句source /opt/ros/humble/setup.bash && source ~/abb_ws/install/setup.bash，确认当前终端的环境变量能正确找到这些包。

3. 显示链路拆解：URDF到RViz2之间发生了什么

3.1 一切从robot_description参数开始

RViz2显示的模型并不来自某个文件，而是从robot_description全局参数里读到的URDF字符串。所以launch的第一步工作，就是把xacro文件展开成完整的URDF，再把它load到参数服务器。这个工作原理直接影响后面排查：如果模型没显示，先确认robot_description是否为空。

ros2 param get /robot_state_publisher robot_description | head -n 200

如果输出里能看到<robot name="abb_irb120">之类的标签，说明URDF已经加载成功；如果这里输出为空，说明URDF加载环节已经失败，根本不用去动RViz2。

3.2 robot_state_publisher在链路里干什么

robot_state_publisher订阅robot_description参数，根据URDF里每个joint的类型和当前角度，计算相邻link之间的tf变换，并以tf2的形式广播出去。它在待机状态下会以固定频率不停地发布消息，这也是RViz2里TF显示面板能画出参考坐标系的原因。缺少这个节点，模型即使看起来有网格显示，也会处于一个没有坐标关系的悬浮状态。

3.3 joint_state_publisher的角色

joint_state_publisher负责发布JointState消息，里面是6个关节（或者更多，取决于机器人型号）的名称和角度值。在纯显示场景下，它从参数里的initial_joint_positions读取初始角度，发布到/joint_states话题。robot_state_publisher订阅这个话题，用其中的角度去驱动tf计算。也就是说，没有joint_state_publisher，模型会摆成一个静止的、可能是默认角度的状态；有它加上GUI滑杆，你可以实时拖动关节，看模型随之运动。

3.4 use_fake_hw参数为什么如此重要

如果use_fake_hw为false，abb_hw会尝试连接真实ABB控制器的RWS服务，连接不上就进入等待状态，关节状态就不会更新。而把use_fake_hw置为true后，硬件接口运行在simulated mode，内部会周期性生成关节状态，相当于把一个假控制器接到了ROS2控制框架里。

这里有一个容易混淆的点：use_fake_hw不等同于gazebo仿真，它只是让ros2_control的硬件接口在本地模拟关节运动，没有动力学和物理仿真。显示机器人够用，做轨迹验证也够用，但要做碰撞检测或力控，还需要额外接入仿真环境。很多初学者以为开了use_fake_hw就等于有了物理仿真，后面做规划测试时就会发现机器人不吃重力那一套。

3.5 RViz2的渲染逻辑

RViz2之所以能看到机械臂，主要靠Display面板里的RobotModel和TF两个控件。RobotModel负责订阅robot_description参数并加载网格模型，TF负责决定你的Fixed Frame应该选谁。这里最容易犯的错误是Fixed Frame选了一个模型里不存在的坐标系，屏幕立刻变空。我一般在第一次打开RViz2后，会先把Fixed Frame手动改成base_link，再确认RobotModel的Description Topic指向/robot_description。这两步每次都做，基本上不会遇到白屏问题。

4. 实操记录：让IRB 120出现在RViz2里

4.1 先确认仓库里的模型文件

find src/abb_ros2 -name "*.xacro" | sort

常见的输出里有abb_irb120.xacro、abb_irb1200.xacro、abb_irb1600.xacro等。这次我用irb120来演示。注意，模型文件的实际路径在不同版本里也会变，可能在abb_resources/urdf也可能在abb_resources/models，总之先find一下准没错。找到之后，可以打开xacro文件开头看看有没有可配置参数，比如robot_ip、use_fake_hw之类。这个习惯能帮你快速判断launch到底要传哪些参。

4.2 启动display.launch.py

对于有现成display.launch.py的版本，最省事的命令是：

ros2 launch abb_ros2 display.launch.py robot_ip:=192.168.1.100 use_fake_hw:=true

如果launch文件不在abb_ros2主包，而是挂在abb_driver或其他子包里，就把包名换成实际的包名。启动后终端里会依次出现robot_state_publisher、joint_state_publisher、rviz2三个进程的日志。出现Setting up fake hw或类似字样的日志说明fake模式已经生效。如果你的launch不支持use_fake_hw参数，直接去掉它；但那样就必须保证电脑和真实ABB控制器在同一个局域网内，并且robot_ip是可达的。

4.3 如果没有现成launch，手动加载模型的兜底方案

仓库某些版本可能没有把display.launch.py直接放在显眼位置，或者你想更深地理解链路，可以用手动方案。先把xacro展开成URDF：

xacro $(ros2 pkg prefix abb_resources)/share/abb_resources/urdf/abb_irb120.xacro > ~/abb_irb120.urdf

再启动robot_state_publisher：

ros2 run robot_state_publisher robot_state_publisher --ros-args -p robot_description:="$(cat ~/abb_irb120.urdf)"

这个命令在bash里可以正常执行，但要注意双引号里的命令替换长度，如果URDF文本太大，部分shell可能截断。更保险的做法是把URDF路径写进yaml，用launch文件加载。学习阶段还是以launch为准，手动方案只是给你一个理解链路入口的抓手。

启动joint_state_publisher：

ros2 run joint_state_publisher joint_state_publisher

如果装了joint_state_publisher_gui，用这个替代上面，会弹出滑块界面，边拖边看模型，效果更直观：

ros2 run joint_state_publisher_gui joint_state_publisher_gui

最后启动RViz2：

ros2 run rviz2 rviz2

4.4 RViz2里的手动配置步骤

Launch里的RViz2一般已经配置好了，但手动启动时需要自己加RobotModel：

1. 打开RViz2后，左下角Displays面板里点Add，选择RobotModel，点击OK。
2. 在RobotModel的Description Topic里选/robot_description。
3. Global Options里的Fixed Frame改为base_link（或base，看你的URDF根坐标叫什么）。
4. 如果模型没显示，把RobotModel的Visual Enabled勾上，并把Alpha调成1。

这里还要加一个TF控件看看坐标系，不加也行，加了更容易观察关节运动时frame如何变化。TF控件添加方式和RobotModel类似，在Add面板里选TF即可。

4.5 显示成功后如何验证

看到IRB 120的静态模型出现在场景中心，只是第一步。打开joint_state_publisher_gui的滑块，拖到某个角度，模型应该会实时旋转。同时在终端运行：

ros2 topic hz /joint_states

能看到10Hz左右的消息频率，说明关节状态链路是通的。再跑一下tf树：

ros2 run tf2_tools view_frames

会生成一个frames.pdf，里面能看到base_link到tool0的完整tf链路。这一步对后续理解机械臂的坐标变换极有帮助，我强烈建议不要跳过。

5. 常见问题与排查实录

5.1 现象：RViz2里什么都没有

按优先级排查：

1. Fixed Frame选错了没？先试base_link。
2. robot_description参数是否为空？用ros2 param get确认。
3. robot_state_publisher是否在运行？ros2 node list里找。
4. xacro文件是否因为缺参数而静默失败？手动执行xacro，看能不能生成完整URDF。

大部分“什么都没有”的case都出在前两条。有一次我折腾了一下午，最后发现只是在RViz2中把Fixed Frame改成了world，而URDF里根本没有world这个坐标系。这种错误谁都会犯，不用羞愧。

5.2 现象：模型只有一半，或者某些连杆漂浮

这通常是mesh文件路径解析失败。URDF里的mesh filename如果使用package://相对路径，需要对应的包被正确install。用--symlink-install会缓解一部分问题；如果还是缺，可以打开URDF文件检查mesh路径，再用ros2 pkg prefix找到实际文件位置，看路径是否对得上。ABB的网格文件大多是STL格式，对路径大小写敏感，Linux下尤其容易踩坑。

5.3 现象：滑块拖不动，或者一动就弹回

在fake hardware模式下，joint_state_publisher的滑块是可以稳定保持角度的。如果出现拖不动，多半是use_fake_hw没有真正生效，或者controller_manager里的joint_state_broadcaster没有加载。用下面的命令检查controllers：

ros2 control list_controllers

正常情况下应该能看到joint_state_broadcaster处于active状态。如果列表为空，说明controller manager没有正确加载配置文件，检查launch中传入的controller yaml参数。这个现象我在第一次跑的时候特别困惑，后来发现是launch文件里控制器配置文件的路径写错了，导致controller_manager起来但一个controller都没加载。

5.4 现象：launch一启动robot_state_publisher就退出

检查有没有其它节点占用了robot_description参数。在一个环境里同时source多个workspace时，参数经常会被后来的会话覆盖。我遇到过一次，因为之前source了一个moveit相关workspace，导致robot_description被旧模型覆盖，robot_state_publisher读到错误的URDF后直接退出了。解决方式是确认当前workspace的install路径排在环境变量路径的前面，或者干脆开一个干净终端，先source abb_ws的install，再source其他workspace。顺序反了就会出现各种奇怪问题，实在不行，用--ros-args -p显式指定参数值。

5.5 现象：编译报错找不到包

分三种情况：

如果仓库依赖某个特定分支的ros2_control源码，就按README里的repos file来import，别用apt的版本强行混搭，容易接口不匹配。我自己曾经因为混合使用apt版和源码版ros2_control，出现过一个编译能过但运行崩溃的诡异问题，最后老老实实全部用apt才解决。学习阶段别追求“自己编译一切”，省时间才能更快看到成果。

5.6 排查命令速查

ros2 node list ros2 topic list ros2 topic hz /joint_states ros2 param get /robot_state_publisher robot_description | head -n 200 ros2 control list_controllers ros2 run tf2_tools view_frames

这几条命令对应链路里的节点、话题、参数、控制器、tf，几乎能覆盖显示阶段80%的排障需求。我习惯在遇到问题时先跑node list看有没有进程消失，再跑param get看URDF有没有加载，基本上能快速定位。如果你遇到的报错不在上面这个清单里，把终端日志完整贴出来搜，比盯着代码猜要快得多。

6. 显示之外：可以试着让模型动起来

6.1 用joint_trajectory_controller发一个轨迹

显示成功后，下一步可以绕开GUI滑块，用controller_manager直接发一条关节轨迹。在fake hardware模式下，joint_trajectory_controller通常已经配置好。先查看控制器状态：

ros2 control list_controllers

如果看到joint_trajectory_controller处于inactive，需要先激活：

ros2 control switch_controllers --activate joint_trajectory_controller

然后用ros2 action send_goal或RQT发一段关节位置，模型就会按时间插值运动。这块涉及ros2_control的知识，我会放到学习笔记第3篇里展开。这里只做预告：一旦显示链路打通，你就拥有了一套可以反复折腾的“假机器人”，这对理解控制器概念帮助巨大。

6.2 为什么我建议先啃透显示链路

我自己的学习体会是：显示链路是ROS2机器人开发里性价比最高的第一课。它把URDF、tf、param、topic、controller这几个ROS2核心概念压缩在一个可以看见结果的场景里。拖拽滑块看到机械臂动起来的那一刻，你对整个框架的信任感会建立起来，之后再学MoveIt2、学真实机器人驱动，都会顺畅很多。

如果后续想接真实ABB控制器，要注意RWS的IP、端口、用户权限等问题；但如果只是想玩通软件链路，use_fake_hw:=true足够你跑完一大段路了。

最后分享一个我这次卡得最久的细节：一开始我直接运行ros2 launch abb_ros2 display.launch.py，忘了加use_fake_hw:=true，结果模型始终不出现，ros2 topic list里也没有/joint_states。当时一度以为是launch文件有问题，后来看了日志才发现硬件接口一直在等待RWS连接。把参数加上之后，整个画面瞬间正常。现在回头看，这个参数是显示场景最容易忽略的开关，小白一定要记住它。

这一篇就写到这里。显示机器人只是起点，后面我打算继续整理abb_ros2与MoveIt2的运动规划配置，再记录连接真实ABB控制器的踩坑过程。如果你也在学这套驱动，欢迎留言交流，我们一起把这条链路啃透。