# PX4 自动驾驶仪用户指南
[](https://github.com/PX4/PX4-Autopilot/releases) [](https://discuss.px4.io//) [](https://discord.gg/dronecode)
_PX4_ 是一款专业级飞控。
它由来自业界和学术界的世界级开发商开发,并得到活跃的全球社区的支持,为从竞速和物流无人机到地面车辆和潜水艇的各种载具提供动力。
:::tip
这份指南包含组装、配置、安全使用 PX4 的设备的各种只是。
对贡献感兴趣吗 查看 [Development](development/development.md) 部分。
:::
:::warning
本指南适用于_development_ version of PX4 (`main` 分支)。
使用 **版本** 选择器查找当前的 _稳定_ 版本。
自稳定版本发布以来的已记录变更,收录在不断更新的(releases/main.md ) 中。
:::
## 如何开始?
所有用户都应该先阅读[基本概念](getting_started/px4_basic_concepts.md) !
它概述了PX4,包括由飞行堆栈提供的功能(飞行模式和安全特征)和支持的硬件(飞行控制器、载具类型、数传系统、遥控控制系统)。
根据您想要实现的目标,以下提示将帮助您浏览本指南:
### 我想要一个能与PX4配合使用的载具
在 [多旋翼](frames_multicopter/index.md), [VTOL](frames_vtol/index.md), 和 [飞机(固定翼)](frames_plane/index.md)部分你会找到如下主题(这些链接针对多旋翼飞行器):
- [完整的载具](complete_vehicles_mc/index.md)列出了到手飞(RTF)的硬件
- [套件(frames_multicopter/kits.md) 列出了需要你利用一组预先选定的部件自行组装的无人机。
- [DIY 组装](frames_multicopter/diy_builds.md) 展示了一些使用单独采购的零部件组装而成的无人机示例。
无论是套件还是成品飞行器,通常都包含你所需的一切,除了电池和遥控系统。
套装通常不难建造,可以很好地介绍无人机如何合在一起,而且费用相对较低。
我们提供了一般的组装指示,例如[组装一个多旋翼机](assembly/assembly_mc.md),大多数套装也附有具体的指示。
如果套件和成品无人机不太符合你的需求,那么你可以从零开始打造一架飞行器,但这需要更多专业知识。
[机身构建](airframes/index.md) 列出了受支持的机身起点,让你了解哪些方案是可行的。
一旦你拥有支持PX4的载具,你将需要配置它并校准传感器。
每种飞行器类型都有其专属的配置章节,阐述主要步骤,比如[多旋翼飞行器配置 / 调校](config_mc/index.md))。
### 我想添加一个有效载荷/相机
[有效载荷](payloads/index.md)部分描述了如何添加相机,以及如何配置 PX4 以实现交付包裹。
### 我正在修改一个支持的载具
[硬件选择和设置](hardware/drone_parts.md)部分提供了关于您可能使用 PX4 的硬件及其配置的高层次和特定产品信息。
如果你想改装无人机并添加新组件,这里是你首先应该查看的地方。
### 我想飞行
在飞行之前,您应该阅读 [Operations](config/operations.md)来了解如何设置您的载具的安全性能和所有机型的常见特性。
完成后,你可以准备飞行。
每种飞行器类型的基本飞行说明在各自对应部分给出,例如[基本飞行(多旋翼飞行器)](flying/basic_flying_mc.md)。
### 我想在一个新的飞行控制器上运行 PX4并扩展平台
[开发](development/development.md)部分解释了如何支持新的机体和车辆类型,修改飞行算法添加新模式,整合新的硬件,与飞行控制器外的 PX4 进行沟通,并为PX4 作出贡献。
## 获取帮助
[支持](contribute/support.md)页解释了如何从核心开发团队和更广泛的社区获得帮助。
除此以外,它还包括了:
- [您可以获得帮助的论坛](contribute/support.md#forums-and-chat)
- [诊断问题](contribute/support.md#diagnosing-problems)
- [如何报告bug](contribute/support.md#issue-bug-reporting)
- [每周开发会议](contribute/support.md#weekly-dev-call)
## 报告错误和问题
如果您在使用 PX4 首次发布时遇到任何问题,请在[支持论坛](contribute/support.md#forums-and-chat) 上(因为它们可能是由载具配置引起)。
如果开发团队指示,代码问题可以在 [Github](https://github.com/PX4/PX4-Autopilot/issues) 上提出。
尽可能提供 [飞行日志](getting_started/flight_reporting.md) 和问题模板中要求的其他信息。
## 参与贡献
如何贡献代码和文档的信息可以在 [贡献](contribute/index.md部分中找到:
- [代码](contribute/index.md)
- [Documentation](contribute/docs.md)
- [Translation](contribute/translation.md)
## 翻译
本指南有多种 [译文](contribute/translation.md)。
您可以从语言菜单中访问到它们 (右上角):

## 许可证
PX4 代码可依据宽松的 [BSD 3-clause license](https://opensource.org/license/BSD-3-Clause) 免费使用和修改。
此文档已使用 [CC BY 4.0]授权。(https://creativecommons.org/licenses/by/4.0/)。
详情见: [Licences](contribute/licenses.md)。
## 日历和活动
_Dronecode 日历_ 展示了面向平台用户和开发者的重要社区活动。
选择以下链接将其显示在您所在的时区日历中(并将其添加到您自己的日历中):
- [Switzerland – Zurich](https://calendar.google.com/calendar/embed?src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&ctz=Europe%2FZurich)
- [Pacific Time – Tijuana](https://calendar.google.com/calendar/embed?src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&ctz=America%2FTijuana)
- [Australia – Melbourne/Sydney/Hobart](https://calendar.google.com/calendar/embed?src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&ctz=Australia%2FSydney)
:::tip
日历的默认时区为中欧时间(CET)。
:::
### 图标
此库中使用的以下图标是单独授权的(如下所示):
_placeholder_icon 由 Smashicons 通过 www.flaticon.com 创作,使用 CC 3.0 By 授权。
_camera-automatic-mode_ 图标由 Freepik 从 www.flaticon.com 是由 CC 3.0 By 授权的。
## 治理
PX4 飞行控制架构由[Dronecode Project](https://dronecode.org/)负责管理。
文档构建时间:{{ $buildTime }}