Skip to content

PX4 自动驾驶仪用户指南

版本发布 讨论 Discord

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

TIP

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

WARNING

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

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

如何开始?

Basic Concepts should be read by all users! It provides an overview of PX4, including features provided by the flight stack (flight modes and safety features) and the supported hardware (flight controller, vehicle types, telemetry systems, RC control systems).

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

I want a vehicle that works with PX4

In the Multicopter, VTOL, and Plane (Fixed-Wing) sections you'll find topics like the following (these links are for multicopter):

  • Complete Vehicles list "Ready to Fly" (RTF) pre-built vehicles
  • Kits lists drones that you have to build yourself from a set of preselected parts
  • DIY Builds shows some examples of drones that have been built using parts that were sourced individually

Both kits and complete vehicles usually include everything you need except for a battery and RC System. Kits are usually not hard to build, provide a good introduction to how drones fit together, and are relatively inexpensive. We provide generic instructions for assembly, such as Assembling a Multicopter, and most kits come with specific instructions too.

If the kits and complete drones aren't quite right for you then you can build a vehicle from scratch, but this requires more knowledge. Airframe Builds lists the supported frame starting points to give you some idea of what is possible.

Once you have a vehicle that supports PX4 you will need to configure it and calibrate the sensors. Each vehicle type has its own configuration section that explains the main steps, such as Multicopter Configuration/Tuning.

I want to add a payload/camera

The Payloads section describes how to add a camera and how to configure PX4 to enable you to deliver packages.

I am modifying a supported vehicle

The Hardware Selection & Setup section provides both high level and product-specific information about hardware that you might use with PX4 and its configuration. This is the first place you should look if you want to modify a drone and add new components.

I want to fly

Before you fly you should read Operations to understand how to set up the safety features of your vehicle and the common behaviours of all frame types. Once you've done that you're ready to fly.

Basic instructions for flying each vehicle type are provided in the respective sections, such as Basic Flying (Multicopter).

I want to run PX4 on a new Flight Controller and extend the platform

The Development section 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.

获取帮助

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

除此以外,它还包括了:

报告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 基金会徽标