URDF建模核心语法详解(适配机械臂/机器人,极简实用版)
URDF(Unified Robot Description Format)是ROS中描述机器人结构的XML格式文件,核心是用链接(link) 定义刚体、关节(joint) 定义刚体连接,组合实现机器人完整结构建模,以下是所有核心语法、标签含义及实操示例,直接适配你的六轴机械臂开发。
一、 URDF文件基础结构(必遵循)
整体是XML格式,根标签为 <robot> ,内部嵌套多个 <link> 和 <joint> ,一个完整URDF的最小结构如下,标签顺序无强制要求,但建议link在前、joint在后,方便维护:
xml
<?xml version="1.0"?>
<robot name="my_arm"> <!– 机器人名称,唯一标识,需和功能包/配置对应 –>
<!– 1. 定义链接:每个刚体对应1个link,描述外形、惯性、碰撞属性 –>
<link name="link_base">…</link>
<link name="link1">…</link>
<!– 2. 定义关节:连接两个link,描述连接方式、运动限制 –>
<joint name="joint_base_link1" type="revolute">…</joint>
</robot>
二、 核心标签1:link(链接,机器人刚体核心)
<link> 描述单个刚体的可视化外形、碰撞检测、惯性属性,是机器人建模的基础,3个核心子标签缺一不可,额外可加坐标系标签,适配ROS坐标转换。
核心子标签(4个必掌握)
1. <name> :link名称(全局唯一,如link_base、link1),joint需通过该名称关联link
2. <visual> :可视化属性(rviz中显示的外形),仅用于显示,不参与碰撞和运动计算
– <geometry> :外形几何形状,常用3种(适配机械臂)
– 长方体: <box size="x y z"/> (长宽高,单位m,如 size="0.1 0.1 0.05" )
– 圆柱体: <cylinder length="长度" radius="半径"/> (机械臂臂身首选)
– 球体: <sphere radius="半径"/> (末端执行器辅助)
– <origin> :外形相对于link坐标系的位姿,格式 x y z r p y (平移+欧拉角,单位m/rad,默认(0,0,0,0,0,0))
– <material> :颜色/材质,简化用颜色即可,示例:
xml
<material name="gray">
<color rgba="0.5 0.5 0.5 1"/> <!– rgba:红绿蓝+透明度,范围0-1 –>
</material>
3. <collision> :碰撞属性(Gazebo仿真/碰撞检测用),结构和 <visual> 一致,建议几何尺寸和visual一致或略大,避免穿模
4. <inertial> :惯性属性(Gazebo仿真必需,无此标签模型会飘),描述刚体质量、转动惯量,核心是 <mass> 和 <inertia>
– <mass value="数值"/> :质量,单位kg(机械臂连杆建议0.1-1kg,按需调整)
– <origin> :惯性坐标系相对于link坐标系的位姿(一般和visual/origin一致)
– <inertia> :转动惯量矩阵,6个参数对应惯性张量,机械臂连杆(圆柱/长方体)可直接套用经验值,示例(圆柱连杆常用):
xml
<inertia ixx="0.001" ixy="0" ixz="0" iyy="0.001" iyz="0" izz="0.0005"/>
link完整示例(机械臂底座)
xml
<link name="base_link">
<!– 可视化:长方体底座,灰色 –>
<visual>
<origin xyz="0 0 0" rpy="0 0 0"/>
<geometry><box size="0.2 0.2 0.08"/></geometry>
<material name="gray"><color rgba="0.4 0.4 0.4 1"/></material>
</visual>
<!– 碰撞:和可视化一致 –>
<collision>
<origin xyz="0 0 0" rpy="0 0 0"/>
<geometry><box size="0.2 0.2 0.08"/></geometry>
</collision>
<!– 惯性:质量0.8kg,简单惯性矩阵 –>
<inertial>
<mass value="0.8"/>
<origin xyz="0 0 0" rpy="0 0 0"/>
<inertia ixx="0.002" ixy="0" ixz="0" iyy="0.002" iyz="0" izz="0.001"/>
</inertial>
</link>
三、 核心标签2:joint(关节,连接link的核心)
<joint> 定义两个link的连接关系、运动类型、限位范围,是机器人能运动的关键,核心是 type (关节类型)和两个关联link,以及运动限位。
1. 关节核心属性(必写)
– name :关节名称(全局唯一,如joint_base_link1),便于ROS识别和控制
– type :关节运动类型(机械臂常用2种,其余少用),六轴机械臂全用revolute
1. revolute:旋转关节(绕单轴转动,带角度限位,机械臂关节首选,如肩、肘、腕关节)
2. fixed:固定关节(无相对运动,如底座和地面、连杆和连接件,最常用的辅助关节)
3. prismatic:移动关节(沿单轴移动,少用)
4. continuous:连续旋转关节(无角度限位,如轮子)
2. 关节核心子标签(5个必掌握)
1. <parent link="父link名称"/> :父链接(如底座base_link),父link是运动参考基准
2. <child link="子link名称"/> :子链接(如臂身link1),子link相对父link运动
3. <origin> :关节坐标系相对于父link的位姿( xyz rpy ),决定子link的初始位置,机械臂关节关键参数(如连杆长度靠此设置)
4. <axis> :关节旋转/移动轴(仅revolute/prismatic需要),格式 x y z ,机械臂常用3个轴:
– 绕z轴转: <axis xyz="0 0 1"/> (肩、腕关节常用)
– 绕y轴转: <axis xyz="0 1 0"/> (肘关节常用)
– 绕x轴转: <axis xyz="1 0 0"/> (末端关节常用)
5. <limit> :运动限位(revolute/prismatic必需,否则仿真/控制会超限),核心4个参数
– lower:最小角度/位移(revolute单位rad,机械臂一般-3.14~0)
– upper:最大角度/位移(revolute单位rad,机械臂一般0~3.14,对应-180°~180°)
– effort:最大扭矩(单位N·m,机械臂设1~5即可,防止过载)
– velocity:最大角速度(单位rad/s,设1~3即可)
joint完整示例(机械臂底座-臂身旋转关节)
xml
<joint name="joint_base_link1" type="revolute">
<parent link="base_link"/> <!– 父链接:底座 –>
<child link="link1"/> <!– 子链接:第一臂身 –>
<origin xyz="0 0 0.04" rpy="0 0 0"/> <!– 关节在底座顶部,z轴偏移0.04m –>
<axis xyz="0 0 1"/> <!– 绕z轴旋转 –>
<limit lower="-3.14" upper="3.14" effort="3" velocity="2"/> <!– 360°旋转限位 –>
</joint>
四、 辅助标签(提升建模效率,必用)
1. <material> :全局材质,可在robot标签下单独定义,所有link直接引用,避免重复写颜色
xml
<robot name="my_arm">
<!– 全局材质定义 –>
<material name="red"><color rgba="1 0 0 1"/></material>
<material name="blue"><color rgba="0 0 1 1"/></material>
<!– link中直接引用 –>
<link name="link1"><visual><material name="red"/></material></visual></link>
</robot>
2. <gazebo> :Gazebo仿真专用标签(可选,仅仿真需要),用于设置摩擦、阻尼、颜色映射,示例(给link加阻尼):
xml
<gazebo reference="link1"> <!– reference对应link名称 –>
<mu1>0.8</mu1> <!– 摩擦系数 –>
<mu2>0.8</mu2>
<self_collide>true</self_collide> <!– 开启自碰撞,避免连杆互穿 –>
</gazebo>
五、 URDF建模核心规则(避坑关键,适配机械臂)
1. 命名唯一:所有link和joint的name不能重复,建议按“link_序号”“joint_父link_子link”命名(如link1、joint_base_link1),便于排查
2. 父子闭环:机器人结构必须是树状结构,从base_link开始,每个子link只能有1个父link,不能出现闭环(否则ROS解析报错)
3. 坐标系规则:遵循ROS右手定则,x轴向前、y轴向左、z轴向上,关节axis和origin按此设置,避免运动方向错乱
4. 惯性必加:Gazebo仿真时,所有运动的link必须加 <inertial> ,否则模型会浮空、无法正常运动,固定link可省略
5. 单位统一:所有参数单位固定(长度m、质量kg、角度rad、力N),不能混用mm/°,否则模型比例错乱
六、 URDF vs Xacro(补充,适配你后续进阶)
– URDF:语法简单,适合简单模型,但重复代码多(如6个连杆要写6次link,参数无法复用)
– Xacro:URDF的升级版,支持参数复用、宏定义、数学运算,六轴机械臂首选(6个关节可通过宏循环生成,修改参数只需改1处)
– 核心关联:Xacro文件后缀 .xacro ,最终需转换成URDF格式(ROS命令 xacro xxx.xacro > xxx.urdf )才能被解


