🦾 URDF/xacro 零基础全攻略
看懂 orion_6r_industrial_arm.urdf.xacro · 含可动机械臂演示
0. 这个页面讲什么
这个页面是配套 project_docs.html(ROS2 主教程)的进阶专题,专门拆解项目里那台机械臂的"身份证"——描述文件。
📖 你将学会:
- URDF / xacro / SDF 三者到底什么关系(别再混淆)
- 一台机械臂是怎么用一堆
<link>+<joint>拼出来的 - 拖动滑块实时看每个关节怎么动(第 4 节有演示)
- 怎么把 xacro 展开成纯 URDF 喂给 Gazebo
🟢 绿色框 = 小贴士 | 🟠 橙色框 = 易错点 | ▶ = 可折叠细节
💡 先认人:项目里的描述文件是
urdf/orion_6r_industrial_arm.urdf.xacro(Orion 6R 工业六轴臂)。6R = 6 个旋转关节。配套还有逐行注释版:docs/orion_6r_industrial_arm.teaching.xacro。1. URDF / xacro / SDF 到底什么关系
一句话
xacro 不是格式,是"写 URDF 的模板工具"。它给 URDF 加上变量、宏、数学运算,写完后用 xacro 命令"展开",得到纯 URDF。
orion....urdf.xacro ← 你写的模板(变量+宏)
│
│ xacro 命令展开
▼
arm.urdf ← 纯 URDF(Gazebo/Rviz/MoveIt 吃这个)
│
▼
仿真器 / 预览器 渲染
三者对比
| xacro | URDF | SDF | |
|---|---|---|---|
| 本质 | 模板/宏语言(生成器) | 机器人描述格式 | 仿真场景描述格式 |
| 属于 | URDF 的工具 | ROS 官方 | Gazebo / OSRF |
| 能描述 | 单个机器人 | 单个机器人 | 机器人+世界+光照+多机器人 |
| 谁吃它 | xacro 命令 | Rviz、MoveIt | Gazebo 仿真器 |
💡 记忆口诀:xacro 造 URDF,URDF 喂 Rviz/MoveIt,SDF 喂 Gazebo。URDF 进 Gazebo 时会被悄悄转成 SDF;想描述"世界"(地面、灯光、其它物体)就得直接写 SDF(项目里的
.world 文件就是 SDF)。⚠️ 常见误区:很多人以为
.xacro 文件能直接拖进 Gazebo——不行。必须先用 xacro 命令展开成 .urdf(ROS2 launch 通常会自动帮你做)。2. 文件骨架:自上而下 7 个部分
把整份 xacro 拆开看就是这个结构。记住这个顺序,看任何机器人描述文件都不慌:
<robot name="orion_6r_industrial_arm">
─── 第1部分:参数 (xacro:arg) ──── 启动时可覆盖的开关
<xacro:arg name="use_ros2_control" default="true"/>
─── 第2部分:变量 (xacro:property) ──── 全局常量(臂长、PI 等)
<xacro:property name="upper_arm_length" value="0.95"/>
─── 第3部分:材质 (material) ──── 颜色预设,后面复用
<material name="service_orange"><color rgba="1 0.43 0.03 1"/></material>
─── 第4部分:宏 (xacro:macro) ──── 把重复 XML 封装成"函数"
<xacro:macro name="box_inertial" params="...">...</xacro:macro>
─── 第5部分:机器人本体 ──── 一堆 link + 一堆 joint(核心)
<link name="base_link">...</link>
<joint name="joint_1" type="revolute">...</joint>
─── 第6部分:Gazebo 标签 ──── 仿真专属(摩擦、传感器)
<gazebo reference="base_link">...</gazebo>
─── 第7部分:ros2_control ──── 告诉控制器怎么驱动关节
<ros2_control> ... </ros2_control>
</robot>
3. 关节运动链:从脚到指尖的家谱
核心思想URDF 把机器人看成"一棵树":每个 link(连杆)是节点,每个 joint(关节)是父子之间的连线。子连杆会跟着父关节一起动。
base_footprint ← 地面参考点(空)
└─[fixed]─ base_link ← 混凝土底座
└─[joint_1 绕Z]─ shoulder_yaw_link ← 肩(左右转)
├─[fixed]─ scan_camera ← 扫描相机
└─[joint_2 绕Y]─ upper_arm_link ← 大臂
└─[joint_3 绕Y]─ forearm_link ← 小臂
└─[joint_4 绕X]─ wrist_roll_link
└─[joint_5 绕Y]─ wrist_pitch_link
└─[joint_6 绕X]─ wrist_flange → 夹爪 → tool0
└─[fixed]─ base_link ← 混凝土底座
└─[joint_1 绕Z]─ shoulder_yaw_link ← 肩(左右转)
├─[fixed]─ scan_camera ← 扫描相机
└─[joint_2 绕Y]─ upper_arm_link ← 大臂
└─[joint_3 绕Y]─ forearm_link ← 小臂
└─[joint_4 绕X]─ wrist_roll_link
└─[joint_5 绕Y]─ wrist_pitch_link
└─[joint_6 绕X]─ wrist_flange → 夹爪 → tool0
运动传递动画(节点依次点亮)
↓ 力/运动从底座 → 末端 逐级传递
两种关节类型
| type | 含义 |
|---|---|
fixed | 焊死,不动 |
revolute | 电机驱动旋转(有限位) |
axis 决定绕哪根轴转
0 0 1 = 绕Z(左右扫)0 1 0 = 绕Y(上下俯仰)1 0 0 = 绕X(自身翻滚)
4. 可动机械臂演示(拖滑块控制关节)
下面用 SVG 画了简化版 Orion 臂。拖动滑块看每个关节怎么动,点"自动演示"让它自己摆姿势。
0°
0°
0°
0°
0°
0°
50%
💡 小知识:
tool0(黄点)是机械臂的"末端参考点"。工业上所有任务(焊接、抓取、喷涂)都是描述"让 tool0 到达某位置"。从底座到 tool0 共 6 个旋转关节,所以叫"6R"。5. link 三件套:visual / collision / inertial
每个连杆通常写 3 类东西,理解了这 3 个就理解了 80% 的 URDF:
| 标签 | 给谁看 | 要不要简单 | 本例 |
|---|---|---|---|
<visual> | 给人眼(渲染) | 越精细越好,可多个拼外观 | 底座 7 个 visual 拼出螺栓/柱身 |
<collision> | 给物理引擎(碰撞) | 越简单越快,1 个就够 | 底座只要 2 块 box/cylinder |
<inertial> | 给物理引擎(动力学) | 必须有,否则仿真会塌 | 用 box_inertial 宏自动算 |
几何形状(geometry)3 种基本款
<!-- 长方体:size="长 宽 高"(米) -->
<box size="0.95 0.78 0.12"/>
<!-- 圆柱:radius=半径, length=高 -->
<cylinder radius="0.26" length="0.36"/>
<!-- 球体:radius=半径 -->
<sphere radius="0.1"/>
⚠️ 易错点:
rpy(roll/pitch/yaw)用弧度不是度!1.5708 = 90°,3.14159 = 180°。算错会直接把零件转飞。6. xacro 精华:宏(macro)与变量(property)
这是 xacro 比 URDF 强大的关键。看这段真实代码:
<!-- 1. 定义变量:臂长只在顶部写一次 -->
<xacro:property name="upper_arm_length" value="0.95"/>
<!-- 2. 定义宏:像函数,自动算长方体惯性 -->
<xacro:macro name="box_inertial" params="mass sx sy sz ox oy oz">
<inertial>
<mass value="${mass}"/>
<!-- ${...} 里能写数学表达式!长方体转动惯量公式 -->
<inertia ixx="${mass * (sy*sy + sz*sz) / 12.0}" .../>
</inertial>
</xacro:macro>
<!-- 3. 调用宏:一行代替几十行 -->
<xacro:box_inertial mass="168.0" sx="${upper_arm_length}" sy="0.26" .../>
💡 好处:所有连杆惯性参数都用同一套物理公式,不会算错;改臂长只改顶部一个数字,全文自动更新。
rgba 颜色:红绿蓝透明度
每个值 0~1,最后一个 1.0=不透明,0.35=半透明:
| 材质名 | rgba | 效果 |
|---|---|---|
| service_orange | 1.0 0.43 0.03 1.0 | 维修盖橙 |
| camera_blue | 0.02 0.12 0.30 1.0 | 相机蓝 |
| scan_cyan | 0.00 0.95 1.00 0.35 | 扫描光(半透明) |
7. Gazebo 仿真标签:摩擦、传感器
<gazebo reference="link名"> 是给某个连杆加仿真专属属性的——URDF 标准里没有这些,是 Gazebo 扩展的。
<gazebo reference="base_link">
<material>Gazebo/DarkGrey</material>
<mu1>1000</mu1> <!-- 摩擦系数 -->
<kp>10000000</kp> <!-- 接触刚度 -->
<kd>100</kd> <!-- 接触阻尼 -->
</gazebo>
💡 相机挂载:项目里在
orion_scan_camera_link 挂了 2 个传感器:① RGB 相机(15Hz)② 深度相机(10Hz)。通过 libgazebo_ros_camera.so 插件把图像发布到 ROS 话题 /camera/rgb/image_raw。文件里那些青色细长条(scan_cyan)是相机视野的可视化,让你一眼看出扫描范围。8. ros2_control:告诉控制器"怎么驱动关节"
整份文件最后也最"高级"的部分。它做一件事:把虚拟电机接到 ROS 2 控制器。
<!-- 条件判断:只有 use_ros2_control:=true 时才生成 -->
<xacro:if value="$(arg use_ros2_control)">
<ros2_control name="orion_6r_gazebo_system" type="system">
<hardware>
<!-- 用 Gazebo 当"假硬件" -->
<plugin>gazebo_ros2_control/GazeboSystem</plugin>
</hardware>
<joint name="joint_1">
<command_interface name="position"/> <!-- 能下"位置"指令 -->
<state_interface name="position"/> <!-- 能读当前位置 -->
<state_interface name="velocity"/> <!-- 能读当前速度 -->
</joint>
<!-- joint_2~6 + 3个夹爪关节 同理 -->
</ros2_control>
</xacro:if>
💡 翻译成人话:"我这套仿真用 Gazebo 当电机,9 个关节都能收位置指令、反馈位置和速度。" 这样 ROS 2 的
ros2_control 就能像控制真电机一样发"转到 30°"的命令。9. 展开 & 运行
把 xacro 展开成纯 URDF(最常用)
# 进入文件所在目录后:
$ xacro urdf/orion_6r_industrial_arm.urdf.xacro > orion_arm.urdf
# 检查展开结果是否合法:
$ check_urdf orion_arm.urdf
覆盖参数启动(条件判断的妙用)
# 不加载 ros2_control(纯展示用):
$ xacro arm.urdf.xacro use_ros2_control:=false > arm_simple.urdf
在 ROS 2 里启动仿真
$ cd ~/ros2_ws
$ colcon build --packages-select ur_fuelcap
$ source install/setup.bash
$ ros2 launch ur_fuelcap orion_arm_gazebo.launch.py
想在线预览?
展开后的 .urdf 可以贴到这些在线工具里实时看 3D:
- 🔗 URDF Viewer:https://gkjohnson.github.io/urdf-loaders/
- 🔗 Foxglove Studio:https://app.foxglove.dev/ (可拖动每个关节)