Cleanflight Configurator
这是一个 Cleanflight 飞行控制系统的跨平台配置工具。
该工具和 Cleanflight 支持各种类型的飞机,如四旋翼飞机、六旋翼飞机、八旋翼飞机和固定翼飞机。
现在也有一个独立的版本。旧版的 Google Chrome Apps 将被 Google 在 Chrome OS 以外的平台上删除。
项目历史
这个配置器最初是 Baseflight 配置器的一个分支,支持 Cleanflight 而不是 Baseflight。
这个配置器是唯一支持Cleanflight特定功能的配置器。它可能需要您在飞行控制器上运行最新的固件。如果您遇到任何问题,请确保您运行的是最新的固件版本。
安装方法
单机
从 发行 下载安装程序。这是默认的安装方法,在未来的某一天,这将成为大多数平台的唯一可用方式。请尽可能使用这种方法。
MacOS X 用户须知
MacOS X 10.14(Mojave)和 10.15(Catalina)最新版本中使用的安全模型的变化意味着,当试图安装应用程序时,操作系统将显示错误信息('"Cleanflight Configurator.app "已损坏,无法打开。你应该把它移到垃圾桶。')时。要解决这个问题,安装后在终端中运行以下命令:sudo xattr -rd com.apple.quarantine /Applications/Cleanflight/Configurator.app。
通过 Chrome Web 商店(适用于 ChromeOS)
- 访问 web 商店中的 Cleanflight Configurator 页面
- 点击 + 添加到 Chrome 浏览器
请注意 -- 当新版本发布时,应用程序会自动更新。请确保您维护 Cleanflight 文档中描述的配置备份。
不稳定的测试版本
大多数平台的配置器最新版本的不稳定测试版本可以从这里下载。
请注意,这些版本仅用于测试/反馈,可能会出现错误或损坏,并可能导致飞行控制器设置损坏。建议在使用这些版本时要谨慎。
您可以在您的应用程序标签 "应用程序" 中找到 Cleanflight Configurator 图标。
通过 NW.js 构建原生应用
开发
安装node.js(需要10版本)
安装yarn:npm install yarn -g
更改项目文件夹并运行yarn安装。
运行yarn start。
运行测试
yarn test
应用程序的构建和发布
这些任务在 gulpfile.js 中定义,可以通过 yarn 运行。
yarn gulp <taskname> [[platform] [platform] ...] <pre> <ul> <li><strong>dist</strong> 拷贝 <code>./dist</code> 文件夹中的所有JS和CSS文件。</li> <li><strong>apps</strong> 构建 <code>./apps</code> 文件夹[1]中构建应用程序的调试版本。</li> <li><strong>debug</strong> 在 <code>./debug</code> 文件夹[1]中构建应用程序的调试版本。</li> <li><strong>release</strong> 将应用程序压缩到 <code>./release</code> 文件夹[1]中的单个存档中。</li> </ul> <p>1] 在 macOS 或 Linux 上运行这个任务需要 Wine,因为需要设置 Windows 应用的图标(为特定平台构建以避免错误)。 </p> <h3>为一个特定平台构建或发布应用 </h3> <p>如果要只为一个特定的平台进行构建或发布,可以在任务名称后面添加 plaform。如果没有提供平台,所有的平台将按顺序进行: </p> <ul> <li><strong>MacOS X</strong> 使用 <code>yarn gulp <task-name> --osx64</code></li> <li><strong>Linux</strong> 使用 <code>yarn gulp <task-name> --linux64</code></li> <li><strong>Windows</strong> 使用 <code>yarn gulp <task-name> --win32</code></li> <li><strong>ChromeOS</strong> 使用 <code>yarn gulp <task-name> --chromeos</code></li> </ul> <p>你也可以使用多个平台,例如 yarn gulp <taskname> --osx64 --linux64。 </p> <h2>语种 </h2> <p>Cleanflight Configurator 已经被翻译成多种语言。如果有翻译成您的系统语言,该应用程序将尝试检测并使用您的系统语言。您可以帮助<a href="https://github.com/cleanflight/cleanflight/tree/master/README.md#Translators">将应用程序翻译成您的语言</a>。 </p> <p>如果您希望应用程序使用英语或任何其他语言,您可以在应用程序的第一个屏幕中选择您想要的语言。 </p> <h2>注意事项 </h2> <h3>图形问题 </h3> <p>如果您在配置器中遇到图形显示问题或模糊/抖动字体显示问题,请尝试使用 --disable-gpu 命令行开关调用 cleanflight-configurator 可执行文件。这将关闭硬件图形加速。同样,将显卡抗锯齿选项设置为关闭(例如NVidia显卡的FXAA参数)也可能是一个补救措施。 </p> <h3>Linux 用户 </h3> <p>在大多数 Linux 发行版中,你的用户默认情况下没有访问串行接口的权限。要添加这个访问权,请在终端中键入以下命令,注销你的用户并重新登录。 </p> <pre>sudo usermod -aG dialout ${USER}
Linux/MacOS X 用户
如果你有 3D 模型动画的问题,请在 Chrome 的 flags 中启用 "覆盖软件渲染列表" chrome://flags/#ignore-gpu-blacklist。
支持
如果您需要帮助,请在github上提出问题之前,先到 cleanflight slack 频道联系。请注册并在这里申请 slack 访问。
问题跟踪器
对于 Cleanflight 配置器的问题,请在这里提出。
https://github.com/cleanflight/cleanflight-configurator/issues
对于Cleanflight的固件问题,请在这里提出。
https://github.com/cleanflight/cleanflight/issues
技术细节
配置器基于 chrome.serial API,运行在 Google Chrome/Chromium core 上。
开发者
我们接受干净合理的补丁,请提交补丁!
作者
Dominic Clifton/hydra - Cleanflight 固件和配置器的维护者。 ctn - Baseflight 配置器的主要作者和维护者,Cleanflight 配置器项目就是从这个配置器分叉出来的。
(The first version translated by vz on 2020.12.19)