欢迎光临
我们一直在努力

urdf语法

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 )才能被解

 

赞(0)
未经允许不得转载:171主机测评 » urdf语法
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址