Skip to content

PX4 Autopilot User Guide

版本发布 讨论 Discord

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

TIP

本指南包含了组装、配置和安全驾驶基于 PX4 的飞机所需的一切。 对贡献感兴趣吗 查看开发部分。

WARNING

This guide is for the development version of PX4 (main branch). Use the Version selector for the current stable version.

Documented changes since the stable release are captured in the evolving release note. :::

如何开始?

所有使用者都应该阅读入门指南! 它提供了对PX4的概述,包括飞行控制栈(飞行模式和安全功能)以及支持的硬件(飞控板,飞行器,机架,数传系统,遥控系统)提供的功能。

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

我已经拥有一架无人机,我只是想让它飞起来:

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

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

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

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.

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

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

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

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

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

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

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

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

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

获取帮助

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

除此以外,它还包括了:

报告Bug & 问题

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

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

参与贡献

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

翻译

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

选择语言

许可证

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

日历 & 活动

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

TIP

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项目 治理。

Dronecode 徽标Linux 基金会徽标