Welcome to MicroROS Robot repository

Robot URDF model

Note: The virtual machine needs to be in the same LAN as the car, and the ROS_DOMAIN_ID needs to be consistent. You can check [Must read before use] to set the IP and ROS_DOMAIN_ID on the board.

1、Program function description

The car connects to the agent, runs the program, and the URDF model will be displayed in rviz.

2、Program start

Load URDF and generate a simulation controller, terminal input,

ros2 launch yahboomcar_description display_launch.py

Open rivz to display the model and enter in the terminal,

xxxxxxxxxx
rviz2

Change [Fixed Frame] to base_linke to display the car model.

Then, use the mouse to adjust the viewing angle, slide the simulation controller just generated, and you can see that the tires/camera of the car are changing.

zq_Joint：Control left front wheel

yq_Joint：Control right front wheel

yh_Joint：Control right rear wheel

zh_Joint：Control left rear wheel

jq1_Joint：Control PTZ 1

jq2_Joint：Control PTZ 2

Randomize：Randomly publish values to each joint

Center：All Joints are centered

3、Code analysis

Code location (take virtual machine as an example)

xxxxxxxxxx
/home/yahboom/yahboomcar_ws/src/yahboomcar_description/launch

display_launch.py

​x
from ament_index_python.packages import get_package_share_path

from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument
from launch.substitutions import Command, LaunchConfiguration

from launch_ros.actions import Node
from launch_ros.parameter_descriptions import ParameterValue

def generate_launch_description():
    urdf_tutorial_path = get_package_share_path('yahboomcar_description')
    default_model_path = urdf_tutorial_path / 'urdf/MicroROS.urdf'

    model_arg = DeclareLaunchArgument(name='model', default_value=str(default_model_path),
                                      description='Absolute path to robot urdf file')
    robot_description = ParameterValue(Command(['xacro ', LaunchConfiguration('model')]),
                                       value_type=str)

    robot_state_publisher_node = Node(
        package='robot_state_publisher',
        executable='robot_state_publisher',
        parameters=[{'robot_description': robot_description}]
    )

    joint_state_publisher_gui_node = Node(
        package='joint_state_publisher_gui',
        executable='joint_state_publisher_gui'
    )

    
    tf_base_footprint_to_base_link = Node(
        package='tf2_ros',
        executable='static_transform_publisher',
        arguments=['0', '0', '0.05', '0.0', '0.0', '0.0', 'base_footprint', 'base_link'],
    )
    
    return LaunchDescription([
        model_arg,
        joint_state_publisher_gui_node,
        robot_state_publisher_node,
        tf_base_footprint_to_base_link
    ])

• model_arg：Load model parameters. The loaded model is MicroROS.urdf, located at /home/yahboom/yahboomcar_ws/src/yahboomcar_description/urdf

• joint_state_publisher_gui_node：Publish sensor_msgs/JointState message

• robot_state_publisher_node：Robot status release

• tf_base_footprint_to_base_link：Publish a static transformation of base_footprint to base_link

4、URDF model

URDF, the full name of Unified Robot Description Format, translated into Chinese as Unified Robot Description Format, is a robot model file described in xml format, similar to D-H parameters.

xxxxxxxxxx
<?xml version="1.0" encoding="utf-8"?>

The first line is a required item for XML and describes the version information of XML.

xxxxxxxxxx
<robot name="name="micro4.0">
</robot>

The second line describes the current robot name; all information about the current robot is contained in the [robot] tag.

4.1、component

• link，The connecting rod can be imagined as a human arm

• joint，The joint can be imagined as a human elbow joint

The relationship between link and joint: Two links are connected through joints. Imagine that an arm has a forearm (link) and an upper arm (link) connected through an elbow joint (joint).

4.1.1、link

1）、Introduction

In the URDF descriptive language, link is used to describe physical properties.

• Describe the visual display, labels.

• Describe collision properties, tags.

• Describes physical inertia, the label is not commonly used.

Links can also describe the size, color, shape, inertial matrix, collision properties, etc. Each Link will become a coordinate system.

2）、Sample code

xxxxxxxxxx
<link
    name="base_link">
    <inertial>
      <origin
        xyz="-0.0038187037800903 -0.000532399212617988 -0.00668209865413972"
        rpy="0 0 0" />
      <mass
        value="0.222555109690442" />
      <inertia
        ixx="0.000160582675692647"
        ixy="-8.18530574494391E-07"
        ixz="-2.74575507729664E-06"
        iyy="0.000176217109527607"
        iyz="1.64721285063183E-07"
        izz="0.000302441932451338" />
    </inertial>
    <visual>
      <origin
        xyz="0 0 0"
        rpy="0 0 0" />
      <geometry>
        <mesh
          filename="package://yahboomcar_description/meshes/base_link.STL" />
      </geometry>
      <material
        name="">
        <color
          rgba="1 1 1 1" />
      </material>
    </visual>
    <collision>
      <origin
        xyz="0 0 0"
        rpy="0 0 0" />
      <geometry>
        <mesh
          filename="package://yahboomcar_description/meshes/base_link.STL" />
      </geometry>
    </collision>
  </link>

3）、Tag

introduction

• origin：It describes the pose information; the xyz attribute describes the coordinate position in the general environment, and the rpy attribute describes its own posture.

• mess：Describes the quality of the link.

• inertia：The inertial reference system, due to the symmetry of the rotational inertia matrix, only requires 6 upper triangular elements ixx, ixy, ixz, iyy, iyz, izz as attributes.

• geometry：The label describes the shape; the main function of the mesh attribute is to load the texture file, and the filename attribute is the file address of the texture path.

• material：The label describes the material; the name attribute is required, can be empty, and can be repeated. Through rgba in the [color] tag

4.1.2、joints

1）、Introduction

Describe the relationship between two joints, motion position and speed limits, kinematic and dynamic properties. The types of joints are as follows:

• fixed：Immobilize joints. No movement is allowed and it serves as a connection.

• continuous：Rotating joints. Can continue to rotate, there is no limit on the rotation angle.

• revolute：Rotating joints. Similar to continuous, there is a limit on the rotation angle.

• prismatic：Sliding joints. Move along a certain axis, with position restrictions.

• floating：Suspended joints. It has six degrees of freedom, 3T3R.

• planar：Planar joints. Allows translation or rotation orthogonally to the plane.

2）、Sample code

xxxxxxxxxx
<joint
    name="zq_Joint"
    type="continuous">
    <origin
      xyz="0.0455 0.0675 -0.02125"
      rpy="0 0 0" />
    <parent
      link="base_link" />
    <child
      link="zq_Link" />
    <axis
      xyz="0 1 0" />
</joint>

In the [joint] tag, the name attribute is required, which describes the name of the joint and is unique. In the type attribute of the [joint] tag, fill in the six joint types correspondingly.

3）、Tag introduction

• origin：The child label refers to the relative position of the rotating joint to the coordinate system where the parent is located.

• parent，child：parent，The child tag represents two links to be connected; the parent is the reference object, and the child rotates around the praent.

• axis：The child tag indicates which axis (xyz) the link corresponding to the child rotates around and the amount of rotation around the fixed axis.

• limit：Subtags are mainly used to restrict child.。The lower attribute and upper attribute limit the arc range of rotation, and the effort attribute limits the force range during rotation.(Positive and negative value, unit is N )，The speed attribute limits the rotation speed in m/s.

• mimic：Describe the relationship of this joint to existing joints.

• safety_controller：Describes safety controller parameters. Protect the movement of robot joints.