Cleanflight

Baseflight 飞行控制器固件的干净代码版本。「Clean-code version of the baseflight flight controller firmware」

Github stars Tracking Chart

Cleanflight

Cleanflight 是多旋翼和固定翼的飞行控制器软件。Cleanflight 项目和相关项目被用于世界各地的大多数飞行控制器上。没有其他软件能在这么多的飞行控制器上使用。

功能介绍

Cleanflight 具有以下特点:

  • 支持多色 RGB LED 灯条(每个 LED 灯条可以使用可变长度的 WS2811 可寻址 RGB 灯条成为不同的颜色 -- 用于方向指示、低电池警告、飞行模式状态、初始化故障排除等。
  • 支持 DShot(150、300、600 和 1200)、Multishot 和 Oneshot(125 和 42)电机协议。
  • 黑匣子飞行记录仪记录(到机载闪存或外部 microSD 卡(如果配备))。
  • 支持使用 STM32 F7、F4 和 F3 处理器的目标(targets)。
  • PWM、PPM 和串行(SBus、SumH、SumD、Spektrum 1024/2048、XBus 等)带故障保护检测的RX连接。
  • 多种遥测协议(CSRF、FrSky、HoTT 智能端口、MSP 等)
  • 通过 ADC 读取 RSSI -- 使用 ADC 读取 PWM RSSI 信号,经 FrSky D4R-II、X8R、X4R-SB 和 XSR 测试。
  • 不需要第三方 OSD 软件/固件/通讯设备的 OSD 支持和配置。
  • OLED 显示屏 -- 显示以下信息:电池电压/电流/mAh、曲线、速率曲线、模式、版本、传感器等信息。
  • 飞行中的手动 PID 调整和速率调整
  • 评级简介和飞行中选择它们
  • 可配置的串行端口,用于串行 RX、遥测、ESC 遥测、MSP、GPS、OSD、声纳等 -- 在任何端口上使用大多数设备,包括软串口。
  • 支持 Unify Pro 和 IRC Tramp 的 VTX。
  • 还有很多很多。

安装和文档

支持

您可以在 RCGroups 上的 Cleanflight 论坛上 寻求支持。

Github 问题跟踪器不用于终端用户支持。

支持和开发者渠道

在这里有一个专门的 Slack 聊天频道,为 cleanflight 服务:

http://cleanflight.com/slack/

礼仪。不要问来问去,请在周围等待足够长的时间来回答--有时人们在外面飞行、睡觉或工作,无法立即回答。

录像

有一个专门的 Cleanflight YouTube 频道,里面有进度更新视频、飞行演示、说明和其他相关视频。

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

如果您觉得这些视频有用,请订阅并点赞。

配置工具

要配置 Cleanflight,你应该使用 Cleanflight-configurator GUI 工具(Windows/OSX/Linux),可以在这里找到:

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

贡献

欢迎并鼓励大家做出贡献。您可以通过多种方式做出贡献:

  • 在固件或配置器中实现一个新功能(见下文“翻译”)。
  • 文档更新和更正。
  • 如何指南 -- 得到帮助?帮助他人
  • 错误报告和修复。
  • 新功能的想法和建议。
  • 为配置器提供新的翻译,或帮助我们维护现有的翻译(见下文)。

最好的地方是 Cleanflight Slack(在这里注册)。下一个地方是 github 问题跟踪器。

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

在创建新问题之前,请检查是否有一个现有的问题,先搜索,否则你浪费人们的时间,而他们本可以写代码。

如果你想为我们的工作做出经济上的贡献,请考虑通过 PayPal 向我们捐款。

如果你想在经济上持续贡献,你应该考虑在 Patreon 上成为我们的赞助人。

我们鼓励贡献错误修复和新功能。请注意,我们对拉请求有一个彻底的审查过程,并准备好解释你想通过拉请求实现什么。在开始写代码之前,请阅读我们的开发指南编码风格定义

TravisCI 是用来运行自动构建的。

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

翻译人员

我们希望让不精通英语的飞行员也能使用 Cleanflight,因此我们目前正在维护 Cleanflight 配置的 18 种语言的翻译:加泰罗尼亚语, Deutsch, Español, Euskera, Français, Galego, Hrvatski, Bahasa Indonesia, Italiano, 日本语, 한국어, Latviešu, Português, Português Brasileiro, polski, Русзык, Svenska, 简体中文。我们有一个志愿者翻译团队来完成这项工作,但我们随时欢迎其他翻译人员来分担工作,我们也很愿意增加其他语言的翻译。如果您愿意帮助我们进行翻译,您有以下选择:

  • 如果您可以通过建议更新或改进您熟悉的语言的翻译来提供帮助,请前往 crowdin 并在那里添加您建议的翻译。
  • 如果你想开始为一种新语言的翻译工作,或者负责校对你非常熟悉的语言的翻译,请前往 Cleanflight Slack(在此注册),并加入 "#team_translation" 频道 -- 那里的人可以帮助你添加一种新的语言,或者安排你作为校对。

发布

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

开源/贡献者

Cleanflight 是一款开源的软件,免费提供给所有用户,不提供任何保证。

Cleanflight 是由 Baseflight 分叉出来的,Cleanflight 是由 Betaflight 分叉出来的,Cleanflight 又是由 Betaflight 分叉出来的。

Cleanflight 4.x -> betaflight 4.x -> Cleanflight v2.x -> Betaflight 3.x -> Cleanflight v1.x -> Baseflight -> MultiWii。

起源

  • Alexinparis (for MultiWii),
  • timecop (for Baseflight),

项目创始人:

Dominic Clifton (hydra)

重要贡献者:

  • Boris B (borisbstyle)
  • digitalentity
  • Martin Budden (martinbudden)
  • Jason Blackman (blckmn)
  • Alexinparis (for MultiWii),
  • timecop (for Baseflight),
  • Sambas
  • Bardwell, Joshua (joshuabardwell)
  • ctzsnooze
  • Höglund, Anders (andershoglund)
  • Ledvina, Petr (ledvinap)
  • kc10kevin
  • Keeble, Gary (MadmanK)
  • Keller, Michael (mikeller)
  • Kravcov, Albert (skaman82)
  • MJ666
  • Nathan (nathantsoi)
  • ravnav
  • sambas
  • savaga
  • Stålheim, Anton (KiteAnton)
  • prodrone
  • ctn

还有很多很多没有被提及的人....


(The first version translated by vz on 2020.12.12)

Main metrics

Overview
Name With Ownercleanflight/cleanflight
Primary LanguageC
Program languageC (Language Count: 9)
PlatformLinux, Mac, Windows
License:GNU General Public License v3.0
所有者活动
Created At2013-03-27 23:49:19
Pushed At2023-10-20 18:37:55
Last Commit At2020-09-08 21:39:09
Release Count63
Last Release NameCLFL_v4.2.0-RC3 (Posted on 2020-06-04 02:00:31)
First Release Nameflight-ready-1 (Posted on 2013-08-28 19:13:27)
用户参与
Stargazers Count2.6k
Watchers Count310
Fork Count1.4k
Commits Count16.6k
Has Issues Enabled
Issues Count1740
Issue Open Count5
Pull Requests Count818
Pull Requests Open Count1
Pull Requests Close Count567
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private

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

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:

https://slack.betaflight.com/

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....