BETAFPV Configurator 完整上手指南：5分钟跑起飞控地面站
【免费下载链接】BETAFPV_Configurator项目地址: https://gitcode.com/gh_mirrors/be/BETAFPV_Configurator
BETAFPV Configurator 是一款面向 BETAFPV 飞控和 LiteRadio 遥控器的开源地面站工具，通过 USB 串口连接飞控，完成固件烧写、ELRS 接收机（2.4G 遥控链路协议）绑定、电机测试和通道配置。读完这篇，你带着"入口在哪、协议在哪、文档在哪"三个答案离开，几分钟内能自己把主窗口拉起来。
核心能力速览
- 📡 固件烧写工具：支持从网络或本地 .bin 文件加载飞控、OSD、传感器固件，一键烧写。
- 🔌 串口智能检测：每 500ms 轮询一次 COM 口，自动只保留 STM32 虚拟串口（飞控在电脑里呈现的通信端口），别的 USB 设备不会混进来。
- 🎮 遥控器 HID 配置：indexLiteRadio.js 通过 node-hid（USB 人机接口设备库）读写 LiteRadio 2/3 的通道参数、射频协议和功率。
- 📄 配套图文手册：docs/ 里有固件烧写、ELRS 绑定、找不到 COM 口排障的完整步骤图。
3步把项目跑起来
- 装好 Node.js（建议 16 版），克隆仓库：
git clone https://gitcode.com/gh_mirrors/be/BETAFPV_Configurator - 项目根目录执行
npm install，装好 serialport（串口通信库）、node-hid 等依赖 - 执行
npx electron-rebuild重编译串口、USB 等原生模块，Windows 下卡住就改用.cmd版本 npm start，Electron 主窗口弹出，加载 index.html，地面站就绪
入口文件与两个配置各管什么
整体结构一句话带过：src/ 放页面和样式，libraries/ 放第三方 JS，locales/ 放中英语言包。真正要打开看的只有三个文件：
| 文件 | 它管什么 | 什么时候需要动它 |
|---|---|---|
| main.js | Electron 入口，仅 40 行：创建最小 1024×550 的主窗口、加载 index.html、关掉系统菜单、挂上热重载 | 改窗口尺寸、换加载 liteRadio.html、调启动逻辑 |
| package.json | 依赖清单（serialport、node-hid、usb、three）、窗口标题与最小尺寸、Windows/Linux/macOS 三套打包脚本 | 增删依赖、换个平台出安装包时 |
| LiteRadio.json | 按遥控器型号列出可烧写的固件版本，如 LiteRadio_3_SX1280 对应 1.0.0 到 2.0.1 | 新增遥控器型号或放出新固件版本时 |
想深入协议层就看 indexLiteRadio.js：开头的 Command_ID 命令码表和 liteRadioUnitType 型号编号表，就是 HID 通信的心跳。
上图是飞控在设备管理器里的样子。index.js 里按厂商 ID 0483/0493 过滤，保证端口下拉框里只有飞控。
新手上手提醒
- 先读 main.js，再读 index.js：main.js 决定窗口怎么开，index.js 的串口轮询和连接按钮逻辑占启动流程八成，两个文件读完主线就通了。
- 改 LiteRadio.json 前先对齐型号字符串：key 必须和 indexLiteRadio.js 里 liteRadioUnitType 的型号名一致，对不上就匹配不到设备。
- 动 package.json 的 version 前先想清楚：窗口标题和打包版本都取自这里，改错会污染发布产物。
完整烧写流程看 docs/UpdateFirmwareProcedure_CN.md，接收机绑定看 docs/BindingProcedure.md，卡住时先翻这两篇再翻代码。
【免费下载链接】BETAFPV_Configurator项目地址: https://gitcode.com/gh_mirrors/be/BETAFPV_Configurator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
