Skip to content

ros-controls/gz_ros2_control

Repository files navigation

gz_ros2_control

ROS2 Distro Build Status Package build
Licence Build Status Build Status

This is a ROS 2 package for integrating the ros2_control controller architecture with the Gazebo simulator. More information about ros2_control can be found here: https://control.ros.org/

This package provides a Gazebo-Sim system plugin which instantiates a ros2_control controller manager and connects it to a Gazebo model.

ROS version Gazebo version Branch Binaries hosted at
Foxy Citadel foxy https://packages.ros.org
Foxy Edifice foxy only from source
Galactic Edifice galactic https://packages.ros.org
Galactic Fortress galactic only from source
Humble Fortress humble https://packages.ros.org
Iron Edifice iron only from source
Iron Fortress iron https://packages.ros.org
Iron Garden iron only from source
Iron Harmonic iron only from source
Jazzy Harmonic master https://packages.ros.org
Rolling Harmonic master https://packages.ros.org

Build status

ROS 2 Distro Branch Build status Documentation
Rolling master gazebo_ros2_control CI - Rolling Documentation
API Reference
Iron iron gazebo_ros2_control CI - Iron Documentation
API Reference
Humble humble ign_ros2_control CI - Humble Documentation
API Reference

Documentation

See the documentation file or control.ros.org

Compile from source

Note that gz_ros2_control depends on the version of Gazebo that is provided by the Gazebo Vendor packages gz_plugin_vendor and gz_sim_vendor. Currently, for ROS 2 Jazzy and Rolling, the Gazebo version is Harmonic.

To compile gz_ros2_control from source, create a workspace, clone the repo and compile it:

mkdir -p ~/gz_ros2_control_ws/src
cd ~/gz_ros2_control_ws/src
git clone https://github.com/ros-controls/gz_ros2_control
rosdep install -r --from-paths . --ignore-src --rosdistro $ROS_DISTRO -y
cd ~/gz_ros2_control_ws
colcon build