# PX4 Autopilot User Guide (master)

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

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

提示

本指南包含了组装、配置和安全驾驶基于 PX4 的飞机所需的一切。

注解

本指南将持续更新! 尚未涵盖 PX4 的全部。

# 如何开始?

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

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

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

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

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

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

提示

支持的飞行器列举在 机架参考。 其中已经有很多测试过和调试好参数的机型,可以使用 QGroundControl下载这些参数,。

如果你想自己从头开始组建一架飞机:

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

一旦你准备好驾驶你的飞机,请访问 飞行 部分。

我想修改支持的飞机:

上面介绍了飞行控制器和基本传感器的修改。 为了使用新的传感器,或者如果您所做的更改会显著影响飞行特性:

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

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

# 获取帮助

支持 页面解释了如何从核心开发团队和更广泛的社区获得帮助。

Among other things it covers:

# 报告Bug & 问题

如果您在使用 PX4 时遇到任何问题,请先将其发布在 支持频道 上(因为它们可能是由飞机配置引起的)。

如果是由开发团队转过来的问题,可在Github here (opens new window) 寻找。 在可能的情况下,提供问题模板中要求的 飞行日志 和其他信息。

# 参与贡献

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

# 翻译

本指南有多种语言 翻译。 您可以从语言菜单中访问这些(右上角):

Language Selector

# 许可证

根据许可 BSD 3 条款许可证 (opens new window) 的细则,PX4 代码可自由使用和修改。 本文档可在 CC BY 4.0 (opens new window) 下进行许可 。 更多信息请参见:许可证

# 日历 & 活动

Dronecode 日历 显示了平台用户和开发者的重要社区事件。 选择下面的链接以在显示您时区的日历(并将其添加到您自己的日历中):

提示

日历默认为CET。 :::

# 图标

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

www.flaticon.com (opens new window)Smashicons 制作 placeholder 图标由 CC 3.0 BY 授权。

www.flaticon.com (opens new window)Freepik 制作的 camera-automatic-mode 图标由 CC 3.0 BY 授权。

# 治理

PX4飞行栈受Dronecode项目 (opens new window)管理。

Dronecode Logo Linux Foundation Logo