天工造物局

参考视频：【奥特学园】ROS机器人入门课程《ROS理论与实践》零基础教程_哔哩哔哩_bilibili

参考文档：http://www.autolabor.com.cn/book/ROSTutorials/

需求描述:

在前面小车底盘基础之上，添加摄像头和雷达传感器。

结果演示:

实现分析:

机器人模型由多部件组成，可以将不同组件设置进单独文件，最终通过文件包含实现组件的拼装。

实现流程:

1. 首先编写摄像头和雷达的 xacro 文件

2. 然后再编写一个组合文件，组合底盘、摄像头与雷达

3. 最后，通过 launch 文件启动 Rviz 并显示模型

摄像头文件  demo06_car_camera.urdf.xacro

雷达文件 demo07_car_laser.urdf.xacro

组合文件 car.urdf.xacro

1.前节小车底盘模型文件实现

demo05_car_base.urdf.xacro

<!--
    使用 xacro 优化 URDF 版的小车底盘实现：

    实现思路:
    1.将一些常量、变量封装为 xacro:property
      比如:PI 值、小车底盘半径、离地间距、车轮半径、宽度 ....
    2.使用 宏 封装驱动轮以及支撑轮实现，调用相关宏生成驱动轮与支撑轮

-->
<!-- 根标签，必须声明 xmlns:xacro -->
<robot name="my_base" xmlns:xacro="http://www.ros.org/wiki/xacro">
    <!-- 封装变量、常量 -->
    <xacro:property name="PI" value="3.141"/>
    <!-- 宏:黑色设置 -->
    <material name="black">
        <color rgba="0.0 0.0 0.0 1.0" />
    </material>
    <!-- 底盘属性 -->
    <xacro:property name="base_footprint_radius" value="0.001" /> <!-- base_footprint 半径  -->
    <xacro:property name="base_link_radius" value="0.1" /> <!-- base_link 半径 -->
    <xacro:property name="base_link_length" value="0.08" /> <!-- base_link 长 -->
    <xacro:property name="earth_space" value="0.015" /> <!-- 离地间距 -->

    <!-- 底盘 -->
    <link name="base_footprint">
      <visual>
        <geometry>
          <sphere radius="${base_footprint_radius}" />
        </geometry>
      </visual>
    </link>

    <link name="base_link">
      <visual>
        <geometry>
          <cylinder radius="${base_link_radius}" length="${base_link_length}" />
        </geometry>
        <origin xyz="0 0 0" rpy="0 0 0" />
        <material name="green">
          <color rgba="0 0.8 0.3 0.5" />
        </material>
      </visual>
    </link>

    <joint name="base_link2base_footprint" type="fixed">
      <parent link="base_footprint" />
      <child link="base_link" />
      <origin xyz="0 0 ${earth_space + base_link_length / 2 }" />
    </joint>

    <!-- 驱动轮 -->
    <!-- 驱动轮属性 -->
    <xacro:property name="wheel_radius" value="0.0325" /><!-- 半径 -->
    <xacro:property name="wheel_length" value="0.015" /><!-- 宽度 -->
    <!-- 驱动轮宏实现 -->
    <xacro:macro name="add_wheels" params="name flag">
      <link name="${name}_wheel">
        <visual>
          <geometry>
            <cylinder radius="${wheel_radius}" length="${wheel_length}" />
          </geometry>
          <origin xyz="0.0 0.0 0.0" rpy="${PI / 2} 0.0 0.0" />
          <material name="black" />
        </visual>
      </link>

      <joint name="${name}_wheel2base_link" type="continuous">
        <parent link="base_link" />
        <child link="${name}_wheel" />
        <origin xyz="0 ${flag * base_link_radius} ${-(earth_space + base_link_length / 2 - wheel_radius) }" />
        <axis xyz="0 1 0" />
      </joint>
    </xacro:macro>
    <xacro:add_wheels name="left" flag="1" />
    <xacro:add_wheels name="right" flag="-1" />
    <!-- 支撑轮 -->
    <!-- 支撑轮属性 -->
    <xacro:property name="support_wheel_radius" value="0.0075" /> <!-- 支撑轮半径 -->

    <!-- 支撑轮宏 -->
    <xacro:macro name="add_support_wheel" params="name flag" >
      <link name="${name}_wheel">
        <visual>
            <geometry>
                <sphere radius="${support_wheel_radius}" />
            </geometry>
            <origin xyz="0 0 0" rpy="0 0 0" />
            <material name="black" />
        </visual>
      </link>

      <joint name="${name}_wheel2base_link" type="continuous">
          <parent link="base_link" />
          <child link="${name}_wheel" />
          <origin xyz="${flag * (base_link_radius - support_wheel_radius)} 0 ${-(base_link_length / 2 + earth_space / 2)}" />
          <axis xyz="1 1 1" />
      </joint>
    </xacro:macro>

    <xacro:add_support_wheel name="front" flag="1" />
    <xacro:add_support_wheel name="back" flag="-1" />

</robot>

2.组合文件实现

car.urdf.xacro

<robot name="my_base" xmlns:xacro="http://www.ros.org/wiki/xacro">
    <!--包含底盘、摄像头与雷达的 xacro 文件-->
    <xacro:include filename="demo05_car_base.urdf.xacro" />
    <xacro:include filename="demo06_car_camera.urdf.xacro" />
    <xacro:include filename="demo07_car_laser.urdf.xacro" />
</robot>

car.launch

<launch>
    <!--1.在参数服务器中载入urdf-->
    <!--<param name="robot_description" textfile="$(find urdf01_rviz)/urdf/xacro/demo05_car_base.urdf" />-->
    <param name="robot_description" command="$(find xacro)/xacro  $(find urdf01_rviz)/urdf/xacro/car.urdf.xacro" />
    <!--2.启动rviz-->
    <node pkg="rviz" name="rviz" type="rviz" args="-d $(find urdf01_rviz)/config/show_mycar.rviz"/>

    <!--3.关节状态发布节点-->
    <node pkg="joint_state_publisher" type="joint_state_publisher" name="joint_state_publisher"/>
    <!--4.机器人状态发布节点-->
    <node pkg="robot_state_publisher" type="robot_state_publisher" name="robot_state_publisher"/>
    <!--5.添加控制关节运动的节点-->
    <node pkg="joint_state_publisher_gui"  type="joint_state_publisher_gui"  name="joint_state_publisher_gui" />
</launch>

此时摄像头文件和雷达文件都写为：

<robot name="my_base" xmlns:xacro="http://www.ros.org/wiki/xacro">

</robot>

结果为：

cys@ubuntu:~/demo05_ws$ source ./devel/setup.bash
cys@ubuntu:~/demo05_ws$ roslaunch urdf01_rviz car.launch

3.摄像头文件实现

demo06_car_camera.urdf.xacro

<robot name="my_car" xmlns:xacro="http://www.ros.org/wiki/xacro">
    <!--摄像头部件-->
    <!--1.参数-->
    <!--
        参数：
            连杆属性：厚度、宽度、高度
            关节属性：x y z
    -->
    <xacro:property name="camera_length" value="0.02" /><!--厚度(x)-->
    <xacro:property name="camera_width" value="0.05" /><!--宽度(y)-->
    <xacro:property name="camera_height" value="0.05" /><!--高度(z)-->
    <xacro:property name="joint_camera_x" value="0.08" /><!--x上偏移量-->
    <xacro:property name="joint_camera_y" value="0" /><!--y上偏移量-->
    <xacro:property name="joint_camera_z" value="${base_link_length / 2 + camera_height / 2}" /><!--z上偏移量-->

    <!--2.设计连杆和关节-->
    <link name="camera">
        <visual>
            <geometry>
                <box size="${camera_length} ${camera_width} ${camera_height}" />
            </geometry>
            <material name="blue">
                <color rgba="0 0.3 0.8 0.8" />
            </material>
        </visual>
    </link>
    <joint name="camera2base" type="fixed">
        <parent link="base_link" />
        <child link="camera" />
        <origin xyz="${joint_camera_x} ${joint_camera_y} ${joint_camera_z}" rpy="0 0 0" />
    </joint>
</robot>

运行：

cys@ubuntu:~/demo05_ws$ source ./devel/setup.bash
cys@ubuntu:~/demo05_ws$ roslaunch urdf01_rviz car.launch

3.雷达文件实现

demo07_car_laser.urdf.xacro

<robot name="my_base" xmlns:xacro="http://www.ros.org/wiki/xacro">
    <!--雷达部件-->
    <!--参数-->
    <!--
        1.支架
            支架尺寸：半径 高度
            关节偏移量：x y z
        2.雷达
            雷达尺寸：半径 高度
            关节偏移量：x y z
    -->
    <xacro:property name="support_radius" value="0.01" />
    <xacro:property name="support_length" value="0.15" />
    <xacro:property name="laser_radius" value="0.03" />
    <xacro:property name="laser_length" value="0.05" />

    <xacro:property name="joint_support_x" value="0" />
    <xacro:property name="joint_support_y" value="0" />
    <!-- z = 车体高度 / 2 + 支架高度 / 2-->
    <xacro:property name="joint_support_z" value="${base_link_length / 2 + support_length / 2}" />
    <xacro:property name="joint_laser_x" value="0" />
    <xacro:property name="joint_laser_y" value="0" />
    <!-- z = 支架高度 / 2 + 雷达高度 / 2-->
    <xacro:property name="joint_laser_z" value="${support_length / 2 + laser_length / 2}" />

    <!--1.支架-->
    <link name="support">
        <visual>
            <geometry>
                <cylinder radius="${support_radius}" length="${support_length}" />
            </geometry>
            <material name="red">
                <color rgba="0.8 0 0.0 0.8" />
            </material>
        </visual>
    </link>
    <joint name="support2base" type="fixed">
        <parent link="base_link" />
        <child link="support" />
        <origin xyz="${joint_support_x} ${joint_support_y} ${joint_support_z}" rpy="0 0 0" />
    </joint>
    <!--2.雷达-->
    <link name="laser">
        <visual>
            <geometry>
                <cylinder radius="${laser_radius}" length="${laser_length}" />
            </geometry>
            <material name="yellow">
                <color rgba="1 1 0 0.8" />
            </material>
        </visual>
    </link>
    <joint name="laser2support" type="fixed">
        <parent link="support" />
        <child link="laser" />
        <origin xyz="${joint_laser_x} ${joint_laser_y} ${joint_laser_z}" rpy="0 0 0" />
    </joint>
    
</robot>