# PX4 Autopilot User Guide (master)

版本发布 (opens new window) 讨论 (opens new window) Slack (opens new window)

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

提示

This guide contains everything you need to assemble, configure, and safely fly a PX4-based vehicle. ::: :::tip Note This guide is still a work in progress! It does not yet cover all of PX4.

# 如何开始?

所有用户都应阅读 入门指南! 它概述了 PX4,包括飞行栈(飞行模式和安全功能)和支持的硬件(飞控板、飞机、机架、遥测系统、遥控系统)提供的功能。

根据您想要实现的目标,以下提示将帮助您浏览本指南:

我已经有了一架飞机,我想让它飞起来:

如果您有支持 PX4 的到手飞(RTF)的飞行器:

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

我想从头开始组装一架使用 PX4 的飞机:

提示

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 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:

  • 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:

# 报告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:

# 翻译

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

Language Selector

# 许可证

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):

提示

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).

Dronecode Logo Linux Foundation Logo