mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-04-14 10:07:39 +08:00
56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# PX4 ROS 2 Interface Library
|
|
|
|
<Badge type="tip" text="PX4 v1.15" /> <Badge type="warning" text="Experimental" />
|
|
|
|
:::warning
|
|
실험
|
|
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](https://github.com/Auterion/px4-ros2-interface-lib) is a C++ library (with Python bindings) that simplifies controlling and interacting with PX4 from ROS 2.
|
|
|
|
The library provides three high-level interfaces for developers:
|
|
|
|
1. The [Control Interface](./px4_ros2_control_interface.md) 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.
|
|
2. The [Navigation Interface](./px4_ros2_navigation_interface.md) enables sending vehicle position estimates to PX4 from ROS 2 applications, such as a VIO system.
|
|
3. [Waypoint Missions](./px4_ros2_waypoint_missions.md) allows waypoint missions to run entirely in ROS 2.
|
|
|
|
## Installation in a ROS 2 Workspace
|
|
|
|
To get started using the library within an existing ROS 2 workspace:
|
|
|
|
1. Make sure you have a working [ROS 2 setup](../ros2/user_guide.md), with [`px4_msgs`](https://github.com/PX4/px4_msgs) in the ROS 2 workspace.
|
|
|
|
2. Clone the repository into the workspace:
|
|
|
|
```sh
|
|
cd $ros_workspace/src
|
|
git clone --recursive https://github.com/Auterion/px4-ros2-interface-lib
|
|
```
|
|
|
|
::: info
|
|
To ensure compatibility, use the latest _main_ branches for PX4, _px4_msgs_ and the library.
|
|
See also [here](https://github.com/Auterion/px4-ros2-interface-lib#compatibility-with-px4).
|
|
|
|
:::
|
|
|
|
3. Build the workspace:
|
|
|
|
```sh
|
|
cd ..
|
|
colcon build
|
|
source install/setup.bash
|
|
```
|
|
|
|
<!--
|
|
## How to Use the Library
|
|
-->
|
|
|
|
## 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.
|
|
|
|
For more information see [PX4 ROS2 Interface Library Integration Testing](../test_and_ci/integration_testing_px4_ros2_interface.md).
|