ExpressLRS开源之接收机固件编译烧录步骤

1. 源由

ExpressLRS是航模上目前比较流行的开源发射机和接收机开源代码之一。

其目的旨在提供最好的完全开放、高刷新率的无线电控制链路，同时以低延迟保持该速率下的最大可实现范围，在900MHz和2.4GHz频率下对硬件提供大量支持。

这个也是笔者一直使用的RC控制链路。从无人机的控制电传，图传以外，RC链路控制是非常重要的链路。

不过这里有一个非常痛苦的事情，就是编译。为什么？？？？ 耗时

因此，本文主要的出发点是确保操作步骤的正确性，并针对常见问题进行必要且快速的解决方法。

注：如果想要更加方便且快速的编译，就需要了解更多关于VSCode&ELRS Configurator背后整合的工具面命令，将一键操作进行分解。如果有时间，后续我们会进一步的分解，以便这个耗时的编译烧录能最简化，也许1~2分钟就可以解决问题。

2. 编译步骤

在所有编译之前，首先进行源代码下载：

A) Git拉取Github开源代码

$ git clone [e-mail]:ExpressLRS/ExpressLRS.git
$ git checkout 3.x.x-maintenance //根据需要进行分支切换

B) 稳定发布版本获取压缩包

$ wget https://github.com/ExpressLRS/ExpressLRS/archive/refs/tags/3.3.0.zip
$ unzip ExpressLRS-3.3.0.zip //根据需要下载对应的版本，并进行解压

C) 通过ELRS Configurator下载

注：该方式并不推荐，但这确实是一个OneButton的解决方案。

2.1 推荐源代码指定方案

因为国内网络的不稳定性，采用本地代码进行编译是一个比较好的选择，且大多数开发人员也经常使用的是本地代码进行开发，开发完成后提交相应修改。

因此，我们推荐采用"LOCAL"的方式进行源代码选择，而非上面C)选项中的方式。

2.2 方法一：ELRS Configurator

步骤一：下载ELRS Configurator工具

通过ELRS Configurator配置工具发布页面寻找合适软件版本，进行下载。

目前，最新的版本号是1.6.0。

步骤二：安装ELRS Configurator工具

ELRS Configurator工具支持较多系统（比如：MacOS/Linux/Windows），且如果Github上无二进制，用户可以根据需求直接源代码进行交叉编译（不再讨论范围之内）。

具体安装方式与常规软件类似，Windows版本请根据安装提示完成安装。

步骤三：使用ELRS Configurator工具进行配置

1. 设备配置：目前采用了一块类似BETAFPV 900的接收机硬件（硬件管脚定义）

2. 烧录方式：采用串口直接烧录

3. 设备选项：通常使用"Standard mode" + “FCC_915”

4. 固件烧录方式

步骤四：设置ELRS接收机为烧录模式

1. 首先，将ELRS接收机的Rx/Tx/GND/VCC与USB串口板连接

ELRS-Rx <–> USB-SerialAdapter-Tx
ELRS-Tx <–> USB-SerialAdapter-Rx
ELRS-VCC <–> USB-SerialAdapter-5V
ELRS-GND <–> USB-SerialAdapter-GND

2. 然后，按住"Firmware Upgrade Button"按键
3. 最后，同时将USB插入电脑，上电时接收机将会自动进入烧录模式

步骤五：点击"Flash"烧录固件

这里的“Flash”是一键式编译+烧录，从设计的角度来说是非常方便的，但是从实际情况来看会出现大量的网络问题导致编译失败。

注：如果出现编译失败，请删除"src/.pio"目录，重新步骤五。

2.3 方法二：VSCode IDE

步骤一：安装vscode

在VisualStudioCode上下载最新版本，安装vscode IDE开发环境。

注：Windows安装软件比较简单和直观，next by next就好了。

步骤二：安装PlatformIO插件

在vscode IDE环境中点击"extension"，搜索platformio，安装"PlatformIO IDE"插件，最后将会在左侧ICON上显示PlatformIO的图标，表示安装成功。

注：因为ExpressLRS是使用Arduino框架用C++编写的。

步骤三：选择ELRS工程

在使用Visual Studio Code时，在选项卡中看到PlatformIO主页。单击“打开项目”按钮。导航到ExpressLRS repo目录。导航到src文件夹（即./ExpressLRS/src/）。最后，按下“打开”按钮。

步骤四：修改工程配置

编辑文件/src/user_defines.txt来定义用户特定的变量。

步骤五：选择编译目标

在左侧工具栏中，单击PlatformIO图标，该图标将显示任务列表。选择“编译目标”

步骤六：编译&烧录固件

常用的几个选项是：Build/Upload/Clean/Full Clean

注：如果上述方法无法解决编译时出现的错误，很有可能还是网络问题导致组件下载出现异常，请删除"src/.pio"目录，重新步骤六。

3. ELRS基本调试验证

ELRS基本调试验证，主要侧重硬件方面的信号数据指标。通过固件配置参数的调整获取相关硬件性能的参数。

基础参数如下：

-DMY_BINDING_PHRASE=“”
-DAUTO_WIFI_ON_INTERVAL=“60”
-DLOCK_ON_FIRST_CONNECTION
-DRegulatory_Domain_FCC_915 //请根据国家地区，以及设备进行选择合适的规则

3.1 ID,Antenna,RSSI,LQ,SNR,PWR,FHSS,TimingOffset

在基础参数前提下，增加以下配置参数：

-DDEBUG_LOG
-DDEBUG_CRSF_NO_OUTPUT
-DDEBUG_RCVR_LINKSTATS

通过串口可得到如下类似串口打印调试信息：

3.2 IRQ_CNT,RSSI_AVE,SNR_AVE,SNV_MAX,TELEM_CNT,FAIL_CNT

在基础参数前提下，增加以下配置参数：

-DDEBUG_LOG
-DDEBUG_CRSF_NO_OUTPUT
-DDEBUG_RCVR_SIGNAL_STATS

通过串口可得到如下类似串口打印调试信息：

3.3 RX Scoreboard

-DPRINT_RX_SCOREBOARD

3.4 ELRS Configurator配置界面

3.5 VSCode配置界面

4. 固件烧录

ELRS采用了乐鑫的芯片，因此还可以命令行输入，详见：ExpressLRS_Manufacturer_Design_Guidelines_v1.7.pdf

4.1 命令行

4.2 GUI工具

5. 参考资料

【1】Advanced Toolchain Setup for ELRS
【2】ExpressLRS-Configurator