/cleanflight

Clean-code version of the baseflight flight controller firmware

Primary LanguageCGNU General Public License v3.0GPL-3.0

Cleanflight

Cleanflight

IMPORTANT NOTICE: Support for STM32F1 based flight controllers will be removed in late 2017, this includes NAZE, CC3D (original) and CJMCU like flight controllers.

Cleanflight is flight controller software for multi-rotor and fixed wings. The Cleanflight project, and related projects such as Betaflight and iNav are used on the majority of flight controllers used around the world. There is no other software used on as many flight-controllers!

  • If you're looking for experimental new features and don't mind doing your homework, checkout the betaflight fork.
  • If you're looking for advanced navigation features then check out the iNav fork.
  • All other users should use Cleanflight.

Features:

  • Awesome flight performance as trusted by the majority of Acrobatic and Racing Drone pilots.
  • Support for modern STM32 based processors F1/F3/F4/F7.
  • Support for modern accelerometer/gyro/barometer/compass sensors.
  • Support for modern ESC technologies DSHOT/ONESHOT and legacy PWM.
  • Support for Multi-color RGB LED strip support.
  • Advanced on-board telemetry logging (Blackbox).
  • Wide support of receivers (SBus/iBus/SumD/SumH/PPM/PWM/CRSF/JetiExBus)
  • Wide support of telemetry protocols (FrSky/SmartPort/S.Port/HoTT/iBus/LTM/MavLink/CRSF/SRXL).
  • Built-in OSD support & configuration without needing third-party OSD software/firmware/comm devices.
  • Support for external OSD slave systems.
  • VTX support (RTC6705/Unify Pro(SmartAudio)/IRC Tramp/etc).
  • and MUCH, MUCH more.

Installation & Documentation

Support

Your first place for support are the Cleanflight forums on RCGroups

The Github issue tracker is NOT for end-user support.

IRC Support and Developers Channel

There's a dedicated Cleanflight IRC channel on the Freenode IRC network. Many users and some of the developers frequent there, and it is a helpful and friendly community - but there are two important things to keep in mind: First and most importantly, please go ahead and ask if you have questions, but make sure you wait around long enough for a reply. Next, sometimes people are out flying, asleep or at work and can't answer immediately, even though they are present in the channel. This is how IRC works: Many people stay logged in, even though they are not actively participating in the discussion all the time. Have a seat, grab a drink and hang around if it's a quiet time of day.

irc://irc.freenode.net/#cleanflight

If you are using Windows and don't have an IRC client installed, take a look at HydraIRC.

There's a dedicated Slack chat channel for betaflight here:

http://www.betaflight.tk/

Etiquette: Don't ask to ask and please wait around long enough for a reply - sometimes people are out flying, asleep or at work and can't answer immediately.

Videos

There is a dedicated Cleanflight YouTube channel which has progress update videos, flight demonstrations, instructions and other related videos.

https://www.youtube.com/playlist?list=PL6H1fAj_XUNVBEcp8vbMH2DrllZAGWkt8

Please subscribe and '+1' the videos if you find them useful.

Configuration Tool

To configure Cleanflight you should use the Cleanflight-configurator GUI tool (Windows/OSX/Linux).

The source for it is here:

https://github.com/cleanflight/cleanflight-configurator

Note: the configurator auto-updates itself if installed using Chrome, if you need an old version to use old firmware then you can get them here:

https://github.com/cleanflight/cleanflight-configurator/releases

Contributing

Contributions are welcome and encouraged. You can contribute in many ways:

  • Documentation updates and corrections.
  • How-To guides - received help? Help others!
  • Bug reporting & fixes.
  • New feature ideas & suggestions.

See CONTRIBUTING.md

Developers

Please refer to the development section in the docs/development folder.

TravisCI is used to run automatic builds: https://travis-ci.org/cleanflight/cleanflight

https://travis-ci.org/cleanflight/cleanflight

Build Status

Cleanflight Releases

https://github.com/cleanflight/cleanflight/releases

Open Source

Cleanflight is software that is open source and is available free of charge without warranty to all users.

The license is GPL3.

Project/Fork History

Cleanflight is forked from Baseflight, which is now dead, all primary development happens in Cleanflight, betaflight and iNav forks.

Cleanflight v2.x -> betaflight -> cleanflight v1.x -> baseflight -> multiwii

Contributors

Thanks goes to all those whom have contributed to Cleanflight and its origins.

Primary developers:

  • Dominic Clifton (hydra) - cleanflight founder
  • Boris B (borisbstyle) - betaflight founder
  • digitalentity - inav founder
  • Martin Budden (martinbudden)
  • Jason Blackman (blckmn)

Big thanks to current and past contributors:

  • Alexinparis (for MultiWii),
  • timecop (for Baseflight),
  • Sambas (for the original STM32F4 port).
  • Bardwell, Joshua (joshuabardwell)
  • ctzsnooze
  • Höglund, Anders (andershoglund)
  • Ledvina, Petr (ledvinap) - IO code awesomeness!
  • kc10kevin
  • Keeble, Gary (MadmanK)
  • Keller, Michael (mikeller) - Configurator brilliance
  • Kravcov, Albert (skaman82) - Configurator brilliance
  • MJ666
  • Nathan (nathantsoi)
  • ravnav
  • sambas - bringing us the F4
  • savaga
  • Stålheim, Anton (KiteAnton)
  • prodrone - failsafe work
  • ctn - for the original Configurator

And many many others who haven't been mentioned....