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）

1. 访问Chrome网络商店中的BetaLight配置器产品页面
2. 点击 + Add to Chrome

请注意-当新版本发布时，应用程序将自动更新自身。请确保按照BetaLight文档中的说明维护配置备份。

（所有平台的弃用旧版也可在此处找到）

（所有平台的弃用旧版也可在[此处]here.)

不稳定的测试版本

大多数平台上最新版本的configurator的不稳定测试版本可从此处下载。

请注意，这些版本仅用于测试/反馈，可能有缺陷或损坏，并可能导致飞行控制器设置损坏。建议在使用这些版本时小心

通过NW.js构建本机应用程序

构建开发环境

1. Install node.js (version 10 required)
2. Install yarn: npm install yarn -g
3. Change to project folder and run yarn install.
4. 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 的作者和维护者，本项目就是从项目派生出来的。