ROS Package with a modular structure to create mobile robots with differential drive configuration. The purpose of this package is to provide xacro modules to make it easier to build the URDF description file of your differential robot. To active this purpose, this package has some modules that are inside the file common_macro.urdf.xacro that can be parametrized using YAML files, making it easier, fast, and more flexible to create your robot model. There is, also, common_sensors.xacro file with some commonly used sensors in mobile robots.
This project has the following folder structure.
- config: Folder to place the config files with the parameters of the parts of the robot and also some config files to the RVIZ.
- sub-folder: The config files to a specific project should be placed in a sub-folder in order to make it possible to have different models in the same project.
- launch: Folder with the launch files for the robots.
- meshes: Folder to place the mesh files for the links of the robot. These meshes files will be used only as visual. The collision of the links is set as basic shapes to reduce the computational cost as the Gazebo tutorial suggests.
- sub-folder: The specific mesh files of each project should be placed in the sub-folder with the name of the project.
- rviz: Folder with the RVIZ configuration for the robot.
- urdf: Folder with the URDF and xacro files.
- include: Folder with the common module files, similar to the Libs.
To install this package, just clone it inside your ROS workspace, running:
$ git clone https://github.com/ros-mobile-robots/mobile_robot_description.git
This command will clone the master branch which is compatible with "ROS 1". If you intend to use ROS 2 (Foxy), use this command:
$ git clone -b ros2-foxy https://github.com/ros-mobile-robots/mobile_robot_description.git
Check the ros2-foxy branch documentation to know some differences.
The basic modules of this package are inside the file common_macro.urdf.xacro that is at urdf/include folder as described above. This file work as a library and you can add it to your robot description like this:
<xacro:include filename="$(find ${package_name})/urdf/include/common_macros.urdf.xacro" />package_name is set as a variable so to use this command you must have been set the package_name variable with the name of your project.
package_name with the name of your project and the xacro property robot_name with the name that you choose for your robot. This name should be the same as the folder where you organize the config and mesh files. It can be seen in the mobile_robot, quimera_robot and diffbot. In case of change the name of the package, as it is a template repository, the value of this variable MUST be updated with the name that you choose. Setting this property globally on the robot file makes the path for the config and mesh files correct, because it is made relatively.
In the common_macro.urdf.xacro, there is the xacro modules:
- Color properties: The color reference that appears on RVIZ.
- Basic shape inertia:
- Base link: A macro to add a base link that can be parametrized using YAML file. The
collisionof this link has a box shape and thevisualcan have a basic shape or use a mesh. - Wheel: A macro to add the wheel link, joint and transmission. This macro can be parametrized using YAML file. The
collisionhas the cylinder shape and thevisualcan have a basic cylinder shape or a mesh. - Caster_wheel: A macro to add a caster wheel link and joints. The caster_wheel only has passive joints, there is no
transmissiontag. This macro can be parametrized using YAML file. Thecollisionhas basic shapes and thevisualcan have a basic shapes or meshes.
For more detailed information about the xacro modules or about the usage, see the Wiki
If you have any comments, doubts, or suggestions, I'll be more than happy to know them, so, feel free to open an issue or a Pull Request with your collaboration.