Inverted pendulum demo

Disclaimer

This is work in progress and should be considered just as a proof of concept on how to leverage ROS 2 features to use in real-time applications. Any feedback and help to improve the project is appreciated.

Rolling branch is under active development.

Build status

Table of content

• Inverted pendulum demo
  • Project description
  • Install instructions
  • How to run the demo
  • How to configure real-time settings
  • How to measure real-time performance metrics
  • How to contribute
  • Issues and feature request

Project description

The aim of this project is to show the real-time capabilities using the ROS2 framework. This project is based on the previous work made by the Open Robotics. The project uses these packages as a base.

This is the motivation of using an inverted pendulum for a real-time demo:

A classic example of a controls problem commonly solved by real-time computing is balancing an inverted pendulum. If the controller blocked for an unexpectedly long amount of time, the pendulum would fall down or go unstable. But if the controller reliably updates at a rate faster than the motor controlling the pendulum can operate, the pendulum will successfully adapt react to sensor data to balance the pendulum.

A more detailed description of demo the project design be found here: Design Article

Install instructions

Several ways to install the pendulum demo project are provided depending on the user needs.

• ADE based installation: This provides a pre-configured Docker image with everything ready to be used. This is the recommended option to quickly test the demo. It is also useful to have development environment to add new features.
• Installation from source: provides instructions to build all the required ROS 2 packages from source.
• Crosscompilation: provides instructions to crosscompile the demo for an embedded device.
• Pre-configured Raspberry PI image: provides a Raspberry PI with everything configured in a Linux Real-time (RT-PREEMPT patch).

How to run the demo

Source your workspace

If installed as an ADE image:

source /opt/ros/rolling/setup.bash

If installed from source:

cd ~/pendulum_ws
source ./install/setup.bash

Launch the demo

A complete explanation of all the possible options to run the demo can be found in the tutorial document:

• Tutorial

For a quick test, launch the demo with rviz enabled:

ros2 launch pendulum_bringup pendulum_bringup.launch.py rviz:=True

If everything went well you should see the inverted pendulum being controlled in rviz:

How to configure real-time settings

Instructions to configure the demo real-time settings can be found here.

How to measure real-time performance metrics

TODO

How to contribute

Make a fork using github, and make your changes. This project uses the same guidelines as all the officials ROS 2 packages, make sure that your code is compliant with cppcheck, uncrustify… After this, submit a PR and we will review as soon as possible.

Issues and feature request

Please, use the templates and make sure that you labeled them properly. Also, consider to open a PR to fix the issue or to implement a feature.