MAVROS Documentation

MAVROS is a MAVLink-to-ROS 2 bridge for PX4, ArduPilot, and other MAVLink-based autopilots.

Start Here

• Install MAVROS and required datasets: Installation
• Try example workflows: Task control, Waypoint mission

Package Overview

• mavros: core ROS 2 nodes (Router, UAS, standard plugins)
• mavros_extras: optional plugins
• mavros_msgs: ROS 2 message and service interfaces
• libmavconn: MAVLink transport library

Plugin Reference

Generated plugin reference is available in:

• docs/plugins/std/*.md (standard plugins)
• docs/plugins/extras/*.md (extra plugins)

Index data used for generation:

• docs/plugins/std/index.json
• docs/plugins/extras/index.json

Build And Test (Workspace)

source /opt/ros/<distro>/setup.bash
source install/setup.bash  # if your workspace is already built
colcon build --packages-up-to mavros mavros_extras mavros_msgs
colcon test --packages-select mavros mavros_extras mavros_msgs
colcon test-result --verbose

Developer Notes

• Plugin docs are generated by tools in tools/; prefer regenerating outputs instead of manual edits.
• See repository guidance in AGENTS.md and contribution workflow in CONTRIBUTING.md.