You're reading the documentation for a version of ROS 2 that has reached its EOL (end-of-life), and is no longer officially supported. If you want up-to-date information, please have a look at Iron.

Demos

This repository provides templates for the development of ros2_control-enabled robots and a simple simulations to demonstrate and prove ros2_control concepts.

Repository organization

Note: the following list is comprehensive.

The repository is organized in the following packages:

  • ros2_control_demo_hardware - implementation of example hardware interfaces,

  • ros2_control_demo_bringup - nodes starting hardware interfaces, controllers and GUIs.

  • ros2_control_test_node - nodes for testing ros2_control-enabled robots and their integration in the framework.

Mode switching demo

Start up the multi interface rrbot system:

ros2 launch ros2_control_demo_bringup rrbot_system_multi_interface.launch.py

List the available interfaces

$ ros2 control list_hardware_interfaces
command interfaces
    joint1/acceleration [unclaimed]
    joint1/position [unclaimed]
    joint1/velocity [unclaimed]
    joint2/acceleration [unclaimed]
    joint2/position [unclaimed]
    joint2/velocity [unclaimed]
state interfaces
     joint1/acceleration
     joint1/position
     joint1/velocity
     joint2/acceleration
     joint2/position
     joint2/velocity

Load and configure all controllers

ros2 control load_controller forward_position_controller --set-state configure
ros2 control load_controller forward_velocity_controller --set-state configure
ros2 control load_controller forward_acceleration_controller --set-state configure
ros2 control load_controller forward_illegal1_controller--set-state configure
ros2 control load_controller forward_illegal2_controller --set-state configure
ros2 control load_controller joint_state_broadcaster --set-state configure

Start the position controller

ros2 control set_controller_state forward_position_controller start

Check the hardware interfaces, position interfaces should be claimed now

$ ros2 control list_hardware_interfaces
command interfaces
    joint1/acceleration [unclaimed]
    joint1/position [claimed]
    joint1/velocity [unclaimed]
    joint2/acceleration [unclaimed]
    joint2/position [claimed]
    joint2/velocity [unclaimed]
state interfaces
     joint1/acceleration
     joint1/position
     joint1/velocity
     joint2/acceleration
     joint2/position
     joint2/velocity

Let’s switch controllers now to velocity

ros2 control switch_controllers --stop forward_position_controller --start forward_velocity_controller

List hardware interfaces again to see that indeed position interfaces have been unclaimed while velocity is claimed now

$ ros2 control list_hardware_interfaces
command interfaces
    joint1/acceleration [unclaimed]
    joint1/position [unclaimed]
    joint1/velocity [claimed]
    joint2/acceleration [unclaimed]
    joint2/position [unclaimed]
    joint2/velocity [claimed]
state interfaces
     joint1/acceleration
     joint1/position
     joint1/velocity
     joint2/acceleration
     joint2/position
     joint2/velocity