ros2_control_demos

This repository provides examples for functionalities and capabilities of ros2_control framework. It consists of simple implementations that demonstrate different concepts. Choose the right branch of this repository matching you ROS 2 distribution as well as the full documentation on control.ros.org, see this table.

If you want to have rather step by step manual how to do things with ros2_control checkout the ros-control/roscon2022_workshop repository.

Contributing

As an open-source project, we welcome each contributor, regardless of their background and experience. Pick a PR and review it, or create your own! If you are new to the project, please read the contributing guide for more information on how to get started. We are happy to help you with your first contribution.

Getting Started

Follow the steps provided in the documentation to install ros2_control_demos.

Content

The following examples are part of this demo repository:

• Example 1: RRBot

  RRBot - or ‘‘Revolute-Revolute Manipulator Robot’’ - a simple position controlled robot with one hardware interface. This example also demonstrates the switching between different controllers.

• Example 2: DiffBot

  DiffBot, or ‘‘Differential Mobile Robot’’, is a simple mobile base with differential drive. The robot is basically a box moving according to differential drive kinematics.

• Example 3: “RRBot with multiple interfaces”

  RRBot with multiple interfaces.

• Example 4: “Industrial robot with integrated sensor”

  RRBot with an integrated sensor.

• Example 5: “Industrial robots with externally connected sensor”

  RRBot with an externally connected sensor.

• Example 6: “Modular robots with separate communication to each actuator”

  The example shows how to implement robot hardware with separate communication to each actuator.

• Example 7: “6-DOF robot”

  A full tutorial for a 6 DOF robot for intermediate ROS 2 users.

• Example 8: “Using transmissions”

  RRBot with an exposed transmission interface.

• Example 9: “Gazebo simulation”

  Demonstrates how to switch between simulation and hardware.

• Example 10: “Industrial robot with GPIO interfaces”

  RRBot with GPIO interfaces.

• Example 11: “Car-like robot using steering controller library”

• Example 12: “Controller chaining”

  The example shows a simple chainable controller and its integration to form a controller chain to control the joints of RRBot.

• Example 13: “Multi-robot system with hardware lifecycle management”

  This example shows how to handle multiple robots in a single controller manager instance.

• Example 14: “Modular robots with actuators not providing states and with additional sensors”

  The example shows how to implement robot hardware with actuators not providing states and with additional sensors.

• Example 15: “Using multiple controller managers”

  This example shows how to integrate multiple robots under different controller manager instances.

• Example 16: “DiffBot with Chained Controllers”

  This example shows how to create chained controllers using diff_drive_controller and two pid_controllers to control a differential drive robot.

Structure

The repository is structured into example_XY folders that fully contained packages with names ros2_control_demos_example_XY.

The packages have following structure of subfolders:

• bringup - stores launch files and runtime configurations for demo robots.
• description - stores URDF (and XACRO) description files, rviz configurations and meshes for the example robots.
• hardware - stores implementations of example hardware components (interfaces).
• controllers (optional) - stores implementation of example controllers.

The important files to check in each example are:

• bringup/launch/<example_name>.launch.py - launch file for the example
• bringup/config/<example_name>_controllers.yaml - parameters with controllers’ setup for the example.

File truncated at 100 lines see the full file