Betaflight Configurator开源仓库说明-中文版
Betaflight Configurator
Betaflight Configurator是Betaflight飞行控制系统的跨平台配置工具。
它在Google Chrome中作为应用程序运行,允许您配置任何运行Betaflight的飞控。
现在还有一个独立版本可用,因为谷歌Chrome应用程序在非Chrome操作系统的平台上越来越不受欢迎。可在发布版中下载。
该工具和Betaflight支持各种类型的航模,例如四旋翼、六旋翼、八旋翼和固定翼。
作者
Betaflight Configurator是Cleanflight Configurator的一个分支,为了配置Betaflight飞控参数而建.
此配置程序是唯一支持BetaLight特定功能的配置程序。可能需要在飞行控制器上运行最新固件。
如果您遇到任何问题,请确保您正在运行最新固件版本。
安装方法
独立版
这是默认的安装方法,在将来的某个时候,这将成为大多数平台可用的唯一方法。请尽可能使用这种方法
从Releases下载安装程序。
MacOS X用户注意事项
对MacOS X 10.14(Mojave)和10.15(Catalina)最新版本中使用的安全模型所做的更改意味着,在尝试安装应用程序时,操作系统将显示错误消息(“BetaLight Configurator.app”已损坏且无法打开。您应将其移到垃圾箱中。“)。要解决此问题,请在安装之前在终端中运行以下命令 sudo xattr -rd com.apple.quarantine /Applications/Betaflight\ Configurator.app
.
通过Chrome网络商店
(适用于ChromeOS)
- 访问Chrome网络商店中的BetaLight配置器产品页面
- 点击 + Add to Chrome
请注意-当新版本发布时,应用程序将自动更新自身。请确保按照BetaLight文档中的说明维护配置备份。
(所有平台的弃用旧版也可在此处找到)
(所有平台的弃用旧版也可在[此处]here.)
不稳定的测试版本
大多数平台上最新版本的configurator的不稳定测试版本可从此处下载。
请注意,这些版本仅用于测试/反馈,可能有缺陷或损坏,并可能导致飞行控制器设置损坏。建议在使用这些版本时小心
通过NW.js构建本机应用程序
构建开发环境
- Install node.js (version 10 required)
- Install yarn:
npm install yarn -g
- Change to project folder and run
yarn install
. - Run
yarn start
.
运行测试
yarn test
应用程序构建和发布
任务在gulpfile.js
中定义,可以通过以下方式运行:
yarn gulp <taskname> [[platform] [platform] ...]
<task-name>
的可选列表:
- dist 复制
./dist
文件夹中的所有JS和CSS文件; - apps 在
./apps
文件夹中生成应用程序[1]; - debug 在
./debug
文件夹中生成应用程序的调试版本 [1]; - release 将应用程序压缩到
./release
文件夹中的单个存档中[1]。
[1] 在macOS或Linux上运行此任务需要Wine,因为需要为Windows应用程序设置图标(为特定平台构建以避免错误)。
为一个特定平台构建或发布应用程序
要仅为一个特定平台构建或发布,您可以在task-name
后面追加平台名称。如果未提供平台,则将按顺序完成所有平台。
- MacOS X use
yarn gulp <task-name> --osx64
- Linux use
yarn gulp <task-name> --linux64
- Windows use
yarn gulp <task-name> --win32
- ChromeOS use
yarn gulp <task-name> --chromeos
您还可以使用多个平台,例如yarn gulp <taskname> --osx64 --linux64
.
语言
Betaflight Configurator已翻译成多种语言。如果可以翻译成您的系统语言,应用程序将尝试检测并使用您的系统语言。您可以帮助将应用程序翻译成您的语言。
如果您希望应用程序使用英语或任何其他语言,您可以在应用程序的首页中选择所需的语言。
注意
图形问题
如果在BetaLight Configurator中遇到图形显示问题或字体污迹/抖动显示问题,请尝试使用--disable gpu
命令行开关来调用BetaLight Configurator可执行文件,这将关闭硬件图形加速。同样,将显卡抗锯齿选项设置为OFF(例如NVidia图形卡上的FXAA参数)也可能是一种补救方法。
Linux用户
在大多数Linux发行版中,默认情况下用户无法访问串行接口。要添加此访问权限,请在终端中键入以下命令,注销用户并重新登录:
sudo usermod -aG dialout ${USER}
Linux / MacOS X 用户
如果存在三维模型动画问题,请在Chrome标志中(chrome://flags/#ignore-gpu-blacklist)启用覆盖软件渲染列表
支持
如果您需要帮助,请在github上提出问题之前,访问BetaflightGroup,注册并在此请求slack访问。
问题追踪器
对于Betaflight configurator 问题,请在此处提出:
https://github.com/betaflight/betaflight-configurator/issues
对于Betaflight固件问题,请在此处提出:
https://github.com/betaflight/betaflight/issues
技术细节
配置程序基于运行在Google Chrome/Chromium core上的chrome.serial API。
开发者
我们接受干净合理的补丁,提交它们!
贡献者
ctn - Cleanflight Configurator 项目的主要作者和维护者。
Hydra - Cleanflight Configurator 的作者和维护者,本项目就是从项目派生出来的。