mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-07-27 00:48:23 +08:00
2f459921f6
Document the Official PX4 Developer Kit program: a new top-level Developer Kits section listing the certified kits (ModalAI Starling 2 Max, DroneBlocks DEXI 5, Holybro X500 v2), a new DEXI 5 page, and a manufacturer-facing page describing the program requirements, benefits, and eligibility. Restructure the hardware navigation so all certified kits live in one place instead of being split across Complete Vehicles and Kits, drop discontinued build guides from the sidebar (still linked from the kit build guides page), and group the manufacturer guides under a new Manufacturers section in Development > Hardware. Signed-off-by: Ramon Roche <mrpollo@gmail.com>
110 lines
6.9 KiB
Markdown
110 lines
6.9 KiB
Markdown
<script setup>
|
||
import { useData } from 'vitepress'
|
||
const { site } = useData();
|
||
</script>
|
||
|
||
# PX4 Autopilot User Guide
|
||
|
||
[](https://github.com/PX4/PX4-Autopilot/releases) [](https://discuss.px4.io//) [](https://discord.com/invite/dronecode)
|
||
|
||
PX4 is an open-source autopilot for drones and autonomous vehicles. It runs on multirotors, fixed-wing, VTOL, helicopters, rovers, and more. This guide covers everything from assembly and configuration to flight operations and development.
|
||
|
||
<div v-if="site.title == 'PX4 Guide (main)'">
|
||
|
||
:::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](releases/main.md).
|
||
:::
|
||
|
||
</div>
|
||
|
||
## Try PX4
|
||
|
||
No hardware needed. Run PX4 in simulation with a single command using [Docker or a .deb package](simulation/px4_simulation_quickstart.md). Connect [QGroundControl](https://qgroundcontrol.com), [MAVSDK](https://mavsdk.mavlink.io/), or [ROS 2](ros2/index.md) and start flying immediately.
|
||
|
||
## For Developers
|
||
|
||
Want to modify PX4 or build from source? Start with the [Development Guide](development/development.md): set up your [dev environment](dev_setup/dev_env.md), [build the code](dev_setup/building_px4.md), and run [SITL simulation](simulation/index.md).
|
||
|
||
## Getting Started
|
||
|
||
Start with [Basic Concepts](getting_started/px4_basic_concepts.md) for an overview of the flight stack, flight modes, safety features, and supported hardware.
|
||
|
||
## Developer Kits
|
||
|
||
The fastest way to get flying hardware for PX4 development. [Official PX4 Developer Kits](dev_kits/index.md) ship with the latest stable PX4 pre-installed on current Pixhawk-standard hardware, need no build skills, and are certified by the PX4 team.
|
||
|
||
## Build a Vehicle
|
||
|
||
Pick your frame type: [Multicopter](frames_multicopter/index.md), [Fixed-Wing](frames_plane/index.md), [VTOL](frames_vtol/index.md), [Helicopter](frames_helicopter/index.md), or [Rover](frames_rover/index.md). Each section covers complete vehicles, kits, and DIY builds. For assembly instructions see [Assembling a Multicopter](assembly/assembly_mc.md) or the equivalent for your frame.
|
||
|
||
## Configure and Tune
|
||
|
||
Once assembled, follow the configuration guide for your vehicle type (e.g. [Multicopter Configuration](config_mc/index.md)). This covers sensor calibration, flight mode setup, and tuning.
|
||
|
||
## Hardware
|
||
|
||
The [Hardware Selection & Setup](hardware/drone_parts.md) section covers flight controllers, sensors, telemetry, RC systems, and payloads. See [Payloads](payloads/index.md) for camera and delivery integrations.
|
||
|
||
## Fly
|
||
|
||
Read [Operations](config/operations.md) to understand safety features and failsafe behavior before your first flight. Then see [Basic Flying (Multicopter)](flying/basic_flying_mc.md) or the equivalent for your frame type.
|
||
|
||
## Support
|
||
|
||
Get help on the [discussion forums](https://discuss.px4.io/) or [Discord](https://discord.com/invite/dronecode). See the [Support](contribute/support.md) page for diagnosing problems, reporting bugs, and joining the [weekly dev call](contribute/dev_call.md).
|
||
|
||
## Contributing
|
||
|
||
See the [Contributing](contribute/index.md) section for code, [documentation](contribute/docs.md), and [translation](contribute/translation.md) guidelines.
|
||
|
||
## Translations
|
||
|
||
There are several [translations](contribute/translation.md) of this guide. Use the language selector in the top navigation.
|
||
|
||
<!--@include: _contributors.md-->
|
||
|
||
## License
|
||
|
||
PX4 code is free to use and modify under the terms of the permissive [BSD 3-clause license](https://opensource.org/license/BSD-3-Clause).
|
||
This documentation is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
||
For more information see: [Licences](contribute/licenses.md).
|
||
|
||
## Calendar & Events
|
||
|
||
The _Dronecode Calendar_ shows important community events for platform users and developers.
|
||
Select the links below to display the calendar in your timezone (and to add it to your own calendar):
|
||
|
||
- [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
|
||
The calendar default timezone is Central European Time (CET).
|
||
|
||
:::
|
||
|
||
<iframe src="https://calendar.google.com/calendar/embed?title=Dronecode%20Calendar&mode=WEEK&height=600&wkst=1&bgcolor=%23FFFFFF&src=linuxfoundation.org_g21tvam24m7pm7jhev01bvlqh8%40group.calendar.google.com&color=%23691426&ctz=Europe%2FZurich" style="border-width:0" width="800" height="600" frameborder="0" scrolling="no"></iframe>
|
||
|
||
### Icons
|
||
|
||
The following icons used in this library are licensed separately (as shown below):
|
||
|
||
<img src="../assets/site/position_fixed.svg" title="Position fix required (e.g. GPS)" width="30px" /> _placeholder_ icon made by <a href="https://www.flaticon.com/authors/smashicons" title="Smashicons">Smashicons</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a> is licensed by <a href="https://creativecommons.org/licenses/by/3.0/" title="Creative Commons BY 3.0" target="_blank">CC 3.0 BY</a>.
|
||
|
||
<img src="../assets/site/automatic_mode.svg" title="Automatic mode" width="30px" /> _camera-automatic-mode_ icon made by <a href="https://www.magnific.com/" title="Magnific">Magnific (formerly Freepik)</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a> is licensed by <a href="https://creativecommons.org/licenses/by/3.0/" title="Creative Commons BY 3.0" target="_blank">CC 3.0 BY</a>.
|
||
|
||
## Governance
|
||
|
||
The PX4 Autopilot project is hosted by the [Dronecode Foundation](https://dronecode.org/), a [Linux Foundation](https://www.linuxfoundation.org/) Collaborative Project. Dronecode holds all PX4 trademarks and serves as the project's legal guardian, ensuring vendor-neutral stewardship. No single company owns the name or controls the roadmap. The source code is licensed under the [BSD 3-Clause](https://opensource.org/license/BSD-3-Clause) license, so you are free to use, modify, and distribute it in your own projects.
|
||
|
||
<a href="https://dronecode.org/" style="padding:20px"><img src="../assets/site/dronecode_logo.svg" alt="Dronecode Logo" width="140px"/></a>
|
||
<a href="https://www.linuxfoundation.org/projects" style="padding:20px;"><img src="../assets/site/logo_linux_foundation.png" alt="Linux Foundation Logo" width="80px" /></a>
|
||
|
||
<div style="padding:10px"> </div>
|
||
|
||
Doc build time: {{ $buildTime }}
|