PX4 User Guide

# PX4 Autopilot User Guide (book.px4_version

PX4 is the Professional Autopilot. Developed by world-class developers from industry and academia, and supported by an active world wide community, it powers all kinds of vehicles from racing and cargo drones through to ground vehicles and submersibles.

Tip This guide contains everything you need to assemble, configure, and safely fly a PX4-based vehicle.

Note This guide is still a work in progress! It does not yet cover all of PX4.

# How Do I Get Started?

Getting Started should be read by all users! It provides an overview of PX4, including features provided by the flight stack (flight modes and safety features) and the supported hardware (flight controller, vehicles, airframes, telemetry systems, RC control systems).

Depending on what you want to achieve, the following tips will help you navigate through this guide:

I already have a drone and I just want to fly:

If you have a Ready To Fly (RTF) vehicle that supports PX4:

  • Basic Configuration explains how to update your firmware to the latest version, calibrate the main sensors (compass, gyro/IMU, airspeed etc.), and setup your remote control and safety features.
  • Flying teaches flight essentials, including where and how to fly safely, and how to debug arming and flight issues. It also provides detailed information about flight modes.

I want to build a drone with PX4 from scratch:

Tip The "supported" vehicles are listed in the Airframes Reference. These are vehicles that have tested and tuned configurations that you can download using QGroundControl.

If you want to build a vehicle from scratch:

  • Choose a frame - Airframe Builds lists the supported frames and provides detailed instructions for how to construct a subset of vehicles.
  • Choose a flight controller - see Getting Started > Flight Controllers and Autopilot Hardware.
  • Assembly explains how to wire up the important peripherals to your autopilot.
  • Basic Configuration shows how to update your firmware and configure it with settings appropriate for your airframe. This section also explains how to calibrate the main sensors (compass, gyro/IMU, airspeed etc.), and setup your remote control and safety features.

Once you are ready to fly your vehicle, visit the Flying section.

I am modifying a supported vehicle:

Modifications of the flight controller and basic sensors are covered above. In order to use new sensors, or if you have made changes that significantly affect flight characteristics:

I want to run PX4 on new hardware and extend the platform:

  • PX4 Developer Guide explains how to modify flight algorithms, add new modes, integrate new hardware, communicate with PX4 from outside the flight controller, and contribute to PX4.

# Forums and Chat {#support}

The core development team and community are active on the following forums and chat channels:

# Reporting Bugs & Issues

If you have any problems using PX4 first post them on the support channels above (as they may be caused by vehicle configuration).

If directed by the development team, code issues may be raised on Github here. Where possible provide flight logs and other information requested in the issue template.

# Contributing

Information on how to contribute to code and documentation can be found in the Developer Guide:

# License

PX4 code is free to use and modify under the terms of the permissive BSD 3-clause license. This documentation is licensed under CC BY 4.0. For more information see: PX4 Development Guide > Licences.

# Icons

The following icons used in this library are licensed separately (as shown below):

placeholder icon made by Smashicons from www.flaticon.com is licensed by CC 3.0 BY.

camera-automatic-mode icon made by Freepik from www.flaticon.com is licensed by CC 3.0 BY.

# Governance

The PX4 flight stack is hosted under the governance of the Dronecode Project.

Dronecode Logo Linux Foundation Logo

Basic Concepts →