Skip to content

Commit

Permalink
Tools: ROS2: Add missing dependencies with docs
Browse files Browse the repository at this point in the history
* Depend on all messages used in ardupilot_sitl
* Clarify limitations of wrapping with colcon
* Link github issue to support argument passthrough

Signed-off-by: Ryan Friedman <[email protected]>
  • Loading branch information
Ryanf55 authored and peterbarker committed Jul 31, 2024
1 parent 0d30dd1 commit 2937fce
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 4 deletions.
16 changes: 12 additions & 4 deletions Tools/ros2/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# ArduPilot ROS 2 packages

This directory contains ROS 2 packages and configuration files for running
ROS 2 processes and nodes that communicate with the ArduPilot DDS client
library using the microROS agent. It contains the following packages:
This directory contains ROS 2 packages and configuration files for running
ROS 2 processes and nodes that communicate with the ArduPilot DDS client
library using the microROS agent. It contains the following packages:

#### `ardupilot_sitl`

A `colcon` package for building and running ArduPilot SITL using the ROS 2 CLI.
This is a `colcon` package for building and running ArduPilot SITL using the ROS 2 CLI.
For example `ardurover` SITL may be launched with:

```bash
Expand All @@ -21,6 +21,14 @@ For example, MAVProxy can be launched, and you can enable the `console` and `map
ros2 launch ardupilot_sitl sitl_mavproxy.launch.py map:=True console:=True
```

ArduPilot SITL does not yet expose all arguments from the underlying binary.
See [#27714](https://github.com/ArduPilot/ardupilot/issues/27714) for context.

To see all current options, use the `-s` argument:
```bash
ros2 launch ardupilot_sitl sitl.launch.py -s
```

#### `ardupilot_dds_test`

A `colcon` package for testing communication between `micro_ros_agent` and the
Expand Down
3 changes: 3 additions & 0 deletions Tools/ros2/ardupilot_dds_tests/package.xml
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,15 @@
<test_depend>ament_lint_auto</test_depend>
<test_depend>ardupilot_msgs</test_depend>
<test_depend>ardupilot_sitl</test_depend>
<test_depend>builtin_interfaces</test_depend>
<test_depend>launch</test_depend>
<test_depend>launch_pytest</test_depend>
<test_depend>launch_ros</test_depend>
<exec_depend>micro_ros_msgs</exec_depend>
<test_depend>python3-pytest</test_depend>
<test_depend>rclpy</test_depend>
<test_depend>sensor_msgs</test_depend>


<export>
<build_type>ament_python</build_type>
Expand Down
8 changes: 8 additions & 0 deletions Tools/ros2/ardupilot_sitl/package.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,15 @@
<buildtool_depend>ament_cmake</buildtool_depend>
<buildtool_depend>ament_cmake_python</buildtool_depend>

<exec_depend>ardupilot_msgs</exec_depend>
<exec_depend>builtin_interfaces</exec_depend>
<exec_depend>geographic_msgs</exec_depend>
<exec_depend>geometry_msgs</exec_depend>
<exec_depend>micro_ros_agent</exec_depend>
<exec_depend>rosgraph_msgs</exec_depend>
<exec_depend>sensor_msgs</exec_depend>
<exec_depend>std_msgs</exec_depend>
<exec_depend>tf2_msgs</exec_depend>

<test_depend>ament_lint_auto</test_depend>
<test_depend>ament_cmake_black</test_depend>
Expand Down

0 comments on commit 2937fce

Please sign in to comment.