PX4 Autopilot User Guide (v1.12)

(opens new window) (opens new window) (opens new window)

PX4 是一款专业级飞控。 它由来自业界和学术界的世界级开发商开发，并得到活跃的全球社区的支持，为从竞速和物流无人机到地面车辆和潜水艇的各种载具提供动力。

提示

本指南包含了组装、配置和安全驾驶基于 PX4 的飞机所需的一切。 对贡献感兴趣吗 Check out the Development section.

如何开始？

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:

• 基本配置 解释了如何将固件更新到最新版本，校准主传感器（罗盘、陀螺仪、空速等），以及如何设置遥控器和安全功能。
• 飞行 教授飞行要领，包括安全飞行的地点和方式，以及如何调试解锁和飞行问题。 同样提供了关于飞行模式的详细信息。

I want to build a drone with PX4 from scratch:

提示

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:

• 选择机架 - Airframe Builds 列举出了支持的机架，并且提供了详细的说明如何组装。
• 选择飞控板 - 请参阅 入门指南 > 飞控板和 自驾仪硬件。
• 装配 解释了如何将重要的外围设备连接到自动驾驶仪上。
• 基本配置 演示如何更新固件，并使用适合您的机身的设置对其进行配置。 本节还介绍了如何校准主传感器（罗盘、陀螺仪、空速等），并设置遥控器和安全功能。

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

I want to add payload or a camera:

The payloads section describes how to add a camera or how to configure PX4 to enable you to deliver packages.

• Payloads describes how to integrate payloads

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:

• Peripheral Hardware provides additional information about using external sensors.
• Basic Configuration explains how to calibrate the main sensors.
• Advanced Configuration should be used to re/fine-tune the airframe.

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

• Development explains how to support new airframes and types of vehicles, modify flight algorithms, add new modes, integrate new hardware, communicate with PX4 from outside the flight controller, and contribute to PX4.

获取帮助

The Support page explains how to get help from the core dev team and the wider community.

Among other things it covers:

• Forums where you can get help
• Diagnosing issues
• How to report bugs
• Weekly dev call

报告Bug & 问题

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

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

参与贡献

Information on how to contribute to code and documentation can be found in the Contributing section:

• Code
• Documentation
• Translation

翻译

There are several translations of this guide. You can access these from the Languages menu (top right):

许可证

PX4 code is free to use and modify under the terms of the permissive BSD 3-clause license (opens new window). This documentation is licensed under CC BY 4.0 (opens new window). For more information see: Licences.

日历 & 活动

The Dronecode Calendar shows important community events for platform users and developers. Select the links below to display the calendar in your timezone (and to add it to your own calendar):

• Switzerland – Zurich (opens new window)
• Pacific Time – Tijuana (opens new window)
• Australia – Melbourne/Sydney/Hobart (opens new window)

提示

Calendar defaults to CET. :::

图标

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.

治理

The PX4 flight stack is hosted under the governance of the Dronecode Project (opens new window).