# PX4 ROS 2 Interface Librarymain (PX4 v1.15) Experimental
At the time of writing, parts of the PX4 ROS 2 Interface Library are experimental, and hence subject to change.
The PX4 ROS 2 Interface Library (opens new window) is a C++ library that simplifies controlling and interacting with PX4 from ROS 2.
The library provides two high-level interfaces for developers:
- The Control Interface allows developers to create and dynamically register modes written using ROS 2. It provides classes for sending different types of setpoints, ranging from high-level navigation tasks all the way down to direct actuator controls.
- The Navigation Interface enables sending vehicle position estimates to PX4 from ROS 2 applications, such as a VIO system.
# Installation in a ROS 2 Workspace
To get started using the library within an existing ROS 2 workspace:
Clone the repository into the workspace:
cd $ros_workspace/src git clone --recursive https://github.com/Auterion/px4-ros2-interface-lib
To ensure compatibility, use the latest main branches for PX4, px4_msgs and the library. See also here (opens new window).
Build the workspace:
cd .. colcon build source install/setup.bash
# CI: Integration Tests
When opening a pull request to PX4, CI runs the library integration tests. These test that mode registration, failsafes, and mode replacement, work as expected.
The tests can also be run locally from PX4:
And to run only a single case:
./test/ros_test_runner.py --verbose --case <case>
You can list the available test cases with: