🦾 URDF/xacro 教学

🦾 URDF/xacro 零基础全攻略

看懂 orion_6r_industrial_arm.urdf.xacro · 含可动机械臂演示

← ROS2 零基础全攻略 返回主教程(UR5e 油罐车阀门对位项目)

0. 这个页面讲什么

这个页面是配套 project_docs.html(ROS2 主教程)的进阶专题,专门拆解项目里那台机械臂的"身份证"——描述文件。

📖 你将学会:

🟢 绿色框 = 小贴士 | 🟠 橙色框 = 易错点 | ▶ = 可折叠细节

💡 先认人:项目里的描述文件是 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 吃这个)
         │
         ▼
   仿真器 / 预览器 渲染

三者对比

xacroURDFSDF
本质模板/宏语言(生成器)机器人描述格式仿真场景描述格式
属于URDF 的工具ROS 官方Gazebo / OSRF
能描述单个机器人单个机器人机器人+世界+光照+多机器人
谁吃它xacro 命令Rviz、MoveItGazebo 仿真器
💡 记忆口诀: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

运动传递动画(节点依次点亮)

↓ 力/运动从底座 → 末端 逐级传递

base J1 腰转绕Z J2 肩绕Y J3 肘绕Y J4 腕滚绕X J5 腕摆绕Y J6 末转绕X tool0 起点 关节(电机) 末端

两种关节类型

type含义
fixed焊死,不动
revolute电机驱动旋转(有限位)

axis 决定绕哪根轴转

0 0 1 = 绕Z(左右扫)
0 1 0 = 绕Y(上下俯仰)
1 0 0 = 绕X(自身翻滚)

4. 可动机械臂演示(拖滑块控制关节)

下面用 SVG 画了简化版 Orion 臂。拖动滑块看每个关节怎么动,点"自动演示"让它自己摆姿势。

base 肩 大臂 upper_arm 小臂 forearm tool0 joint3 joint5
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_orange1.0 0.43 0.03 1.0 维修盖橙
camera_blue0.02 0.12 0.30 1.0 相机蓝
scan_cyan0.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:

← 返回 ROS2 主教程 继续学习节点/话题/MoveIt/YOLO 等完整项目知识