Betaflight Configurator开源仓库说明-中文版

Betaflight Configurator

Betaflight

Crowdin Build Status Quality Gate Status Build Status

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 的作者和维护者,本项目就是从项目派生出来的。

posted @ 2021-10-27 21:37  蔡子CaiZi  阅读(1925)  评论(0编辑  收藏  举报