1 Service 与 Topic

我们提供一些 service 和 topic， 用以和 mycobot 交互。

1.1 Service

命令行中输入:

source ~/<ros-workspace>/devel/setup.bash # 添加环境变量
roslaunch ultraarm_communication communication_service.launch

支持参数：

• port：连接串口字符串
• baud：波特率

打开新的命令行：

# 显示活动的服务信息
rosservice list

#/get_joint_angles
#/get_joint_coords
#/set_joint_angles
#/set_joint_coords
#/switch_gripper_status
#/switch_pump_status

相关的命令与说明：

1.2 Topic

命令行中输入：

source ~/<ros-workspace>/devel/setup.bash
roslaunch ultraarm_communication communication_topic.launch

支持参数：

• port：连接串口字符串
• baud：波特率

打开新的命令行：

# 显示活动的服务信息
rostopic list

#/mycobot/angles_goal
#/mycobot/coords_goal
#/mycobot/angles_real
#/mycobot/coords_real
#/mycobot/pump_status
#/mycobot/gripper_status

相关的命令与说明：

service与topic的区别：

您可以前往service和topic深入了解这两项功能的使用

2 msg和srv简介

• msg：msg文件是描述ROS消息字段的简单文本文件。它们用于为不同语言（c++或者python等）的消息生成源代码。
• srv：srv文件用来描述服务。它由两部分组成：请求（request）和响应（response）。 msg文件存储在包的msg目录中，而srv文件存储在srv目录中。

2.1 rosmsg

rosmsg是用于显示有关 ROS消息类型的 信息的命令行工具。

rosmsg 演示：

rosmsg show       # 显示消息描述
rosmsg info       # 显示消息信息
rosmsg list       # 列出所有消息
rosmsg md5        # 显示 md5 加密后的消息
rosmsg package    # 显示某个功能包下的所有消息
rosmsg packages   # 列出包含消息的功能包

• rosmsg list 会列出当前 ROS 中的所有 msg

• rosmsg packages 列出包含消息的所有包

• rosmsg package 列出某个包下的所有msg

//rosmsg package  # 包名 
rosmsg package turtlesim

• rosmsg show 显示消息描述

//rosmsg show # 消息名称
rosmsg show turtlesim/Pose
# 结果:
float32 x
float32 y
float32 theta
float32 linear_velocity
float32 angular_velocity

• rosmsg info 作用与 rosmsg show 一样

• rosmsg md5 一种校验算法，保证数据传输的一致性

2.2 rossrv

rossrv是用于显示有关ROS服务类型的信息的命令行工具，与 rosmsg 使用语法高度雷同。

rossrv show       # 显示服务消息详情
rossrv info       # 显示服务消息相关信息
rossrv list       # 列出所有服务信息
rossrv md5        # 显示 md5 加密后的服务消息
rossrv package    # 显示某个包下所有服务消息
rossrv packages   # 显示包含服务消息的所有包

• rossrv list 会列出当前 ROS 中的所有 srv 消息

• rossrv packages 列出包含服务消息的所有包

• rossrv package 列出某个包下的所有msg

//rossrv package # 包名 
rossrv package turtlesim

• rossrv show 显示消息描述

//rossrv show # 消息名称
rossrv show turtlesim/Spawn
# 结果:
float32 x
float32 y
float32 theta
string name
---
string name

• rossrv info 作用与 rossrv show 一致

• rossrv md5 对 service 数据使用 md5 校验(加密)

3 URDF介绍

• Unified Robot Description Format，统一机器人描述格式，简称为URDF。ROS中的urdf功能包包含一个URDF的C++解析器，URDF文件使用XML格式描述机器人模型。
• URDF 不能单独使用，需要结合 Rviz 或 Gazebo，URDF 只是一个文件，需要在 Rviz 或 Gazebo 中渲染成图形化的机器人模型。

3.1 urdf文件描述

代码示例：

本处只截取部分代码进行展示：

<?xml version="1.0"?>
<robot  xmlns:xacro="http://www.ros.org/wiki/xacro" name="firefighter" >

<xacro:property name="width" value=".2" />


  <link name="base">
    <visual>
      <geometry>
         <!--- 0.0 0 -0.04  1.5708 3.14159-->
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-base.dae"/>
      </geometry>
      <origin xyz = " 0 0 0.0 " rpy = " 0 0 0"/>
    </visual>
    <collision>
      <geometry>
         <!--- 0.0 0 -0.04  1.5708 3.14159-->
        <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-base.dae"/>
      </geometry>
      <origin xyz = " 0 0 0.0 " rpy = " 0 0 0"/>
    </collision>

  </link>

  <link name="link1">
    <visual>
      <geometry>
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-1.dae"/>
      </geometry>
      <origin xyz = "0 0 0.122 " rpy = " 3.1415926 0 0"/>
    </visual>
    <collision>
      <geometry>
        <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-1.dae"/>
      </geometry>
      <origin xyz = "0 0  0.122 " rpy = " 3.1415926 0 0"/>
    </collision>
  </link>

  <link name="link2">
    <visual>
      <geometry>    
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-2.dae"/>
      </geometry>
      <origin xyz = "-0.03  0.112 0.0  " rpy = " 1.5708 0 0"/>
    </visual>
    <collision>
      <geometry>    
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-2.dae"/>
      </geometry>
      <origin xyz = "-0.03  0.112 0.0  " rpy = " 1.5708 0 0"/>
    </collision>     

  </link>

  <link name="link3">
    <visual>
      <geometry>
       <!--- 0.0 0 -0.04 -->
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-3.dae"/>
      </geometry>
      <origin xyz = "-0.03 0.23  0.0 " rpy = "1.5708 0 0"/>
    </visual>
    <collision>
      <geometry>
       <!--- 0.0 0 -0.04 -->
       <mesh filename="package://mycobot_description/urdf/ultraArm_urdf/ultraArm-3.dae"/>
      </geometry>
      <origin xyz = "-0.03 0.23  0.0 " rpy = "1.5708 0 0"/>
    </collision>
  </link>


</robot>

可以看出，urdf文件并不复杂，主要是由link和joint两个部分不断重复而成。

3.2 link部分

link元素描述具有惯性、可视特征和碰撞属性的刚体

3.2.1 属性

name： 用来描述链接本身的名称

3.2.2 元素

• <inertial> (可选)
  • 连杆的惯性特性
  • <origin> (可选，defaults to identity if not specified)
    • 定义相对于连杆坐标系的惯性参考系的参考坐标，该坐标必需定义在连杆重心处，其坐标轴可与惯性主轴不平行。
    • xyz (可选，默认为零向量) 表示 x , y , z x,y,zx,y,z 方向的偏置，单位为米。
    • rpy(可选: defaults to identity if not specified) 表示坐标轴在RPY方向上的旋转，单位为弧度。
  • <mass> 连杆的质量属性
  • <inertia> 3×3旋转惯性矩阵，由六个独立的量组成：ixx, ixy, ixz, iyy, iyz, izz。
• <visual> (可选)
  • 连杆的可视化属性。用于指定连杆显示的形状（矩形、圆柱体等），同一连杆可以存在多个visual元素，连杆的形状为多个元素两个形成。一般情况下模型较为复杂可以通过soildwork绘制后生成stl调用，简单的形状如添加末端执行器等可以直接编写。同时可以在此处可根据理论模型和实际模型差距调整几何形状的位置。
  • <namel> (可选) 连杆几何形状的名字。
  • <origin> (可选，defaults to identity if not specified)
    • 相对于连杆的坐标系的几何形状坐标系。
    • xyz (optional: defaults to zero vector) 表示x , y , z x,y,zx,y,z 方向的偏置，单位为米。
    • rpy (optional: defaults to identity if not specified) 表示坐标轴在RPY方向上的旋转，单位为弧度。

• <geometry> （必需）
  • 可视化对象的形状，可以是下面的其中一种：
  • <box> 矩形，元素包含长、宽、高。原点在中心。
  • <cylinder> 圆柱体，元素包含半径、长度。原点中心。
  • <sphere> 球体，元素包含半径。原点在中心。
  • <mesh> 网格，由文件决定，同时提供 scale ，用于界定其边界。推荐使用 Collada .dae 文件， 也支持.stl文件，但必须为一个本地文件。
• <material> (可选)
  • 可视化组件的材料。可以在link标签外定义，但必需在robot标签内，在link标签外定义时，需引用link的名字。
  • <color>(可选) 颜色，由 red/green/blue/alpha 组成，大小范围在 [0,1] 内。
  • <texture>(可选) 材料属性，由文件定义。

• <collision> (可选)
  • 连杆的碰撞属性。碰撞属性和连杆的可视化属性不同，简单的碰撞模型经常用来简化计算。同一个连杆可以有多个碰撞属性标签，连杆的碰撞属性表示由其定义的几何图形集构成。
  • <name> (可选) 指定连杆几何形状的名称
  • <origin> (可选，defaults to identity if not specified)
    • 碰撞组件的参考坐标系相对于连杆坐标系的参考坐标系。
    • xyz (可选， 默认零向量) 表示x , y , z x,y,zx,y,z 方向的偏置，单位为米。
    • rpy (可选， defaults to identity if not specified) 表示坐标轴在RPY方向上的旋转，单位为弧度。
  • <geometry> 与上述geometry元素描述相同

详细元素以及各个元素的作用可以前往官方文档进行查看

3.3 joint部分

joint部分描述了关节的运动学和动力学，并指定了关节的安全限值。

3.3.1 joint的属性：

name：

指定关节的唯一名称

type：

指定关节的类型，其中类型可以是下列类型之一：

• revolute - 沿轴线旋转的铰链接头，其范围由上限和下限指定。
• 连续 - 一种连续铰链接头，围绕轴旋转，没有上限和下限。
• 棱柱形 - 沿轴滑动的滑动接头，其范围由上限和下限指定。
• 固定 - 这不是真正的关节，因为它不能移动。所有自由度都被锁定。这种类型的接头不需要轴，校准，动力学，极限或safety_controller。
• 浮动 - 此接头允许所有 6 个自由度的运动。
• 平面 - 此接头允许在垂直于轴的平面上运动。

3.3.2 joint的元素

• <origin> (可选，defaults to identity if not specified) 从parent link到child link的变换，joint位于child link的原点，修改该参数可以调整连杆的位置，可用在调整实际模型与理论模型误差，但不建议大幅度修改，因为该参数影响连杆stl的位置，容易影响碰撞检测效果。

  • xyz (可选: 默认为零向量) 代表x , y , z x,y,zx,y,z轴方向上的偏移，单位米。
  • rpy (可选: 默认为零向量) 代表绕着固定轴旋转的角度：roll绕着x轴,pitch绕着y轴，yaw绕着z轴，用弧度表示。

• <parent> (必需)

  • parent link的名字是一个强制的属性。
  • link parent link的名字，是这个link在机器人结构树中的名字。

• <child> (必需)

  • child link的名字是一个强制的属性。
  • link child link的名字，是这个link在机器人结构树中的名字。

• <axis>(可选: 默认为(1,0,0))

  • joint的axis轴在joint的坐标系中。这是旋转轴(revolute joint)，prismatic joint移动的轴，是planar joint的标准平面。这个轴在joint坐标系中被指定。修改该参数可以调整关节的旋转所绕着的轴，常用于调整旋转方向，若模型旋向与实际相反，只需乘-1即可。固定(fixed)和浮动(floating)类型的joint不需要用到这个元素。
  • xyz(必需) 代表轴向量的x , y , z x,y,zx,y,z分量，为标准化的向量。

• <calibration> (可选)

  • joint的参考点，用来矫正joint的绝对位置。
  • rising (可选) 当joint正向运动时，参考点会触发一个上升沿。
  • falling (可选) 当joint正向运动时，参考点会触发一个下降沿。

• <dynamics>(可选)

  • 该元素用来指定joint的物理性能。它的值被用来描述joint的建模性能，尤其是在仿真的时候。

<limit> (当关节为旋转或移动关节时为必需)

• 该元素为关节运动学约束。
• lower (可选, 默认为0) 指定joint运动范围下界的属性(revolute joint的单位为弧度，prismatic joint的单位为米)，连续型的joint忽略该属性。
• upper (可选, 默认为0) 指定joint运动范围上界的属性(revolute joint的单位为弧度，prismatic joint的单位为米)，连续型的joint忽略该属性。
• effort (必需) 该属性指定了joint运行时的最大的力。
• velocity (required) 该属性指定了joint运行时的最大的速度。

<mimic>(可选)

• 这个标签用于指定已定义的 joint 来模仿已存在的 joint 。这个joint的值可以用以下公式计算： value = multiplier * other_joint_value + offset
• joint(必填) 需要模仿的joint的名字。
• multiplier(可选) 指定上述公式中的乘数因子。
• offset(可选) 指定上述公式中的偏移项。默认值为0

<safety_controller> (可选)

• 该元素为安全控制限制，此元素下数据会读入到move_group中，但实际上时无效，move_group会跳过此处限制直接读取limit下的参数内容，同时设置该元素有几率会导致规划失败。
• soft_lower_limit (可选, 默认为0) 该属性指定了joint安全控制边界的下界，是joint安全控制的起始限制点。这个值需要大于上述的limit中的lower值。
• soft_upper_limit (可选, 默认为0) 该属性指定了joint安全控制边界的上界，是joint安全控制的起始限制点。这个值需要小于上述的limit中的upper值。
• k_position(可选, 默认为0) 本属性用于说明位置和速度之间的关系。
• k_velocity(必需) 本属性用于说明力和速度之间的关系。

详细元素以及各个元素的作用可以前往 http://wiki.ros.org/urdf/XML/joint 进行查看