# PX4 Autopilot User Guide

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

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

提示

本指南包含了组装、配置和安全驾驶基于 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.

如果您想从头开始组装一架飞机:

  • 选择机架 - Airframe Builds 列举出了支持的机架,并且提供了详细的说明如何组装。
  • Choose a flight controller - see Getting Started > Flight Controllers and Autopilot Hardware.
  • 装配 解释了如何将重要的外围设备连接到自动驾驶仪上。
  • 基本配置 演示如何更新固件,并使用适合您的机身的设置对其进行配置。 本节还介绍了如何校准主传感器(罗盘、陀螺仪、空速等),并设置遥控器和安全功能。

当您准备好飞您的飞机时,请访问飞行部分。

我想添加有效负载或相机:

有效负载部分描述了如何添加一个相机以及如何配置PX4以使您能够运送包裹。

我想要修改已支持的机体:

上文介绍了如何修改飞行控制器和基本的传感器。 为了使用新的传感器,或者您的修改对飞行特性有重大的影响:

我想在新硬件上运行 PX4 并扩展平台:

  • 开发介绍了如何支持新的机架、机型,修改飞行算法,添加新的模式,集成新的硬件,从飞行控制器的外部与PX4通信,以及如何为PX4做出贡献。

# 获取帮助

帮助页面介绍了如何从核心开发团队和更广泛的社区获取帮助。

除此以外,它还包括了:

# 报告Bug & 问题

如果您在使用PX4的过程中遇到任何问题,请先将他们发布到支持论坛上(即使他们可能是飞行器配置问题导致的)

如果代码的问题得到了开发团队的指导,这个问题可能会被上传到Github here (opens new window)。 如果可能,请提供问题模板中所要求的飞行日志和其他信息。

# 参与贡献

有关如何贡献代码和文档的信息可以在贡献部分中找到:

# 翻译

本指南有多版本的翻译。 您可以从语言菜单中访问到它们(右上角):

选择语言

# 许可证

PX4 code is free to use and modify under the terms of the permissive BSD 3-clause license (opens new window). 文档在CC BY 4.0 (opens new window)中获得许可。 更多信息请参见:许可证

# 日历 & 活动

The Dronecode Calendar shows important community events for platform users and developers. 选择以下链接将其显示在您所在的时区日历中(并将其添加到您自己的日历中):

提示

The calendar default timezone is Central European Time (CET).

# 图标

此库中使用的以下图标是单独授权的(如下所示):

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.

# 治理

PX4飞行控制栈由 Dronecode项目 (opens new window) 治理。

Dronecode 徽标 Linux 基金会徽标