Betaflight is free, open-source flight control software for every kind of drone, from racing and freestyle to cinematic filming, long range, micros and wings. It exists so that every pilot, whatever they fly and whoever made their hardware, gets precise, predictable and reliable flight, and so that the knowledge behind it stays open to everyone.
This repository holds the Betaflight firmware that runs on the flight controller.
Release Schedule
The Betaflight release schedule and development cadence are published at betaflight.com.
Requirements for the submission of new and updated target configuration
The requirements for pull requests adding new targets or modifying existing targets are available on the betaflight.com website.
Features
Betaflight has the following features:
- Multi-color RGB LED strip support (each LED can be a different color using variable length WS2811 Addressable RGB strips - use for Orientation Indicators, Low Battery Warning, Flight Mode Status, Initialization Troubleshooting, etc)
- DShot (150, 300 and 600), Multishot, Oneshot (125 and 42) and Proshot1000 motor protocol support
- Blackbox flight recorder logging (to onboard flash or external microSD card where equipped)
- Support for targets that use STM32 F4, F7, G4, H5 and H7 (plus C5 and N6 in developer preview), AT32F435, APM32 and RP2350 (PICO) processors, experimental support for ESP32 and X32, and SITL for simulation (see the hardware policy for current status)
- PWM, PPM, SPI, and Serial (CRSF, SBus, SumH, SumD, Spektrum 1024/2048, XBus, etc) RX connection with failsafe detection
- Multiple telemetry protocols (CRSF, FrSky, HoTT smart-port, MSP, etc)
- RSSI via ADC - Uses ADC to read PWM RSSI signals, tested with FrSky D4R-II, X8R, X4R-SB, & XSR
- OSD support & configuration without needing third-party OSD software/firmware/comm devices
- OLED Displays - Display information on: Battery voltage/current/mAh, profile, rate profile, mode, version, sensors, etc
- In-flight manual PID tuning and rate adjustment
- PID and filter tuning using sliders
- Rate profiles and in-flight selection of them
- Configurable serial ports for Serial RX, Telemetry, ESC telemetry, MSP, GPS, OSD, Sonar, etc - Use most devices on any port, softserial included
- VTX support for Unify Pro and IRC Tramp
- and MUCH, MUCH more.
Installation & Documentation
See: https://betaflight.com/docs/wiki
Support and Developers Channel
There's a dedicated Discord server for help, support and general community.
Betaflight Application
To configure Betaflight you should use the Betaflight App. It is a progressive web app, so should always be the latest version.
Contributing
Contributions are welcome and encouraged. You can contribute in many ways:
- implement a new feature in the firmware or in the app (see below);
- documentation updates and corrections;
- How-To guides - received help? Help others!
- bug reporting & fixes;
- new feature ideas & suggestions;
- provide a new translation for the app, or help us maintain the existing ones (see below).
The best place to start is the Betaflight Discord. Next place is the github issue tracker:
https://github.com/betaflight/betaflight/issues
https://github.com/betaflight/betaflight-configurator/issues
Before creating new issues please search to see if there is an existing one.
If you want to contribute to our efforts financially, please consider making a donation to us through PayPal.
If you want to contribute financially on an ongoing basis, you should consider becoming a patron for us on Patreon.
Developers
Contribution of bugfixes and new features is encouraged. Please be aware that we have a thorough review process for pull requests, and be prepared to explain what you want to achieve with your pull request.
Before starting to write code, please read our development guidelines and coding style definition.
GitHub actions are used to run automatic builds.
Building with Docker/Devcontainers
A preconfigured devcontainer is included for a consistent build environment across all platforms. This is the recommended approach for Windows developers:
# With VS Code: Install "Dev Containers" extension, open folder, and select "Reopen in Container"
# Or command-line only:
docker build -t betaflight-dev -f .devcontainer/containerfile .devcontainer/
docker run --rm -v "${PWD}:/workspace" -w /workspace betaflight-dev make TARGET=SPEEDYBEEF405WING
See the devcontainer documentation for detailed setup instructions including hardware flashing.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
