Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rotorflight/rotorflight

A repository for storing Rotorflight wiki, media files, changelogs, example files, etc.
https://github.com/rotorflight/rotorflight

Last synced: about 1 month ago
JSON representation

A repository for storing Rotorflight wiki, media files, changelogs, example files, etc.

Awesome Lists containing this project

README 

        

![Rotorflight](https://github.com/rotorflight/rotorflight/blob/master/images/rotorflight2.png?raw=true)



***



[Rotorflight](https://github.com/rotorflight) is a Flight Control software suite designed for

single-rotor helicopters. It consists of:



- Rotorflight Flight Controller Firmware

- Rotorflight Configurator, for flashing and configuring the flight controller

- Rotorflight Blackbox Explorer, for analyzing blackbox flight logs

- Rotorflight LUA Scripts, for configuring the flight controller using a transmitter



Built on Betaflight 4.3, Rotorflight incorporates numerous advanced features specifically

tailored for helicopters. It's important to note that Rotorflight does _not_ support multi-rotor

crafts or airplanes; it's exclusively designed for RC helicopters.



## Downloads



Please download the latest version from here:



- [Rotorflight Configurator](https://github.com/rotorflight/rotorflight-configurator/releases/)

- [Rotorflight Blackbox](https://github.com/rotorflight/rotorflight-blackbox/releases/)

- [LUA Scripts for EdgeTx and OpenTx](https://github.com/rotorflight/rotorflight-lua-scripts/releases/)

- [LUA Scripts for FrSky Ethos](https://github.com/rotorflight/rotorflight-lua-ethos/releases/)



## Installation



Instructions, guides, tutorials, documentation can be found on the [Rotorflight website](https://www.rotorflight.org/).



## Features



Rotorflight has many features:



* Many receiver protocols: CRSF, S.BUS, F.Port, DSM, IBUS, XBUS, EXBUS, GHOST, CPPM

* Support for various telemetry protocols: CSRF, S.Port, HoTT, etc.

* ESC telemetry protocols: BLHeli32, Hobbywing, Scorpion, Kontronik, OMP Hobby, ZTW, APD, YGE

* Advanced PID control tuned for helicopters

* Stabilisation modes (6D)

* Rotor speed governor

* Motorised tail support with Tail Torque Assist (TTA, also known as TALY)

* Remote configuration and tuning with the transmitter

  - With knobs / switches assigned to functions

  - With LUA scripts on EdgeTX, OpenTX and Ethos

* Extra servo/motor outputs for AUX functions

* Fully customisable servo/motor mixer

* Sensors for battery voltage, current, BEC, etc.

* Advanced gyro filtering

  - Dynamic RPM based notch filters

  - Dynamic notch filters based on FFT

  - Dynamic LPF

* High-speed Blackbox logging



Plus lots of features inherited from Betaflight:



* Configuration profiles for changing various tuning parameters

* Rates profiles for changing the stick feel and agility

* Multiple ESC protocols: PWM, DSHOT, Multishot, etc.

* Configurable buzzer sounds

* Multi-color RGB LEDs

* GPS support



And many more...



## Hardware support



The best hardware for Rotorflight is any Flight Controller especially designed for it.

See [What board is suitable?](https://www.rotorflight.org/docs/Tutorial-Quickstart/What-Board)



Otherwise, Rotorflight supports all flight controller boards that are supported by Betaflight 4.3,

assuming that the board has enough suitable I/O pins for connecting all the servos and motors required.



Also, the Betaflight boards are labeled for multi-rotor use - thus the user needs to understand how

these functions can be used for a different purpose with helicopters. Usually this is just about using

the motor outputs for servos, but in some cases a more advanced remapping may be needed.



Rotorflight supports STM32G4, STM32F4, STM32F7 and STM32H7 MCUs from ST.



It's highly recommended to use an STM32F7 based flight controller for Rotorflight.

It's the way to go since it can take full advantage of the latest control and filtering

algorithms, plus other cool features that really put the CPU to work.



An absolute minimum is an STM32G4 based board, but it probably won't be able to run all

the new features later on. The older STM32F411 should be avoided if possible.



## Contributing



Rotorflight is an open-source community project. Anybody can join in and help to make it better by:



* helping other users on Rotorflight Discord or other online forums

* [reporting](https://github.com/rotorflight?tab=repositories) bugs and issues, and suggesting improvements

* testing new software versions, new features and fixes; and providing feedback

* participating in discussions on new features

* create or update content on the [Website](https://www.rotorflight.org)

* [contributing](https://www.rotorflight.org/docs/Contributing/intro) to the software development - fixing bugs, implementing new features and improvements

* [translating](https://www.rotorflight.org/docs/Contributing/intro#translations) Rotorflight Configurator into a new language, or helping to maintain an existing translation



## Origins



Rotorflight is software that is **open source** and is available free of charge without warranty.



Rotorflight is forked from [Betaflight](https://github.com/betaflight), which in turn is forked from [Cleanflight](https://github.com/cleanflight).

Rotorflight borrows ideas and code also from [HeliFlight3D](https://github.com/heliflight3d/), another Betaflight fork for helicopters.



Big thanks to everyone who has contributed along the journey!



## Donate



If you find Rotorflight useful, please consider [supporting the development by donating](https://www.paypal.com/donate/?hosted_button_id=LLP4MT8C8TPVJ) to the Rotorflight Project.



## Contact



Team Rotorflight can be contacted by email at [email protected].