ExpressLRS开源之接收机固件编译烧录步骤
ExpressLRS是航模上目前比较流行的开源发射机和接收机开源代码之一。
其目的旨在提供最好的完全开放、高刷新率的无线电控制链路,同时以低延迟保持该速率下的最大可实现范围,在900MHz和2.4GHz频率下对硬件提供大量支持。
这个也是笔者一直使用的RC控制链路。从无人机的控制电传,图传以外,RC链路控制是非常重要的链路。
不过这里有一个非常痛苦的事情,就是编译。为什么???? 耗时
因此,本文主要的出发点是确保操作步骤的正确性,并针对常见问题进行必要且快速的解决方法。
注:如果想要更加方便且快速的编译,就需要了解更多关于VSCode&ELRS Configurator背后整合的工具面命令,将一键操作进行分解。如果有时间,后续我们会进一步的分解,以便这个耗时的编译烧录能最简化,也许1~2分钟就可以解决问题。
在所有编译之前,首先进行源代码下载:
A) Git拉取Github开源代码
$ git clone git@github.com: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工具进行配置
- 设备配置:目前采用了一块类似BETAFPV 900的接收机硬件(硬件管脚定义)
2. 烧录方式:采用串口直接烧录
3. 设备选项:通常使用"Standard mode" + “FCC_915”
4. 固件烧录方式
步骤四:设置ELRS接收机为烧录模式
- 首先,将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
- 然后,按住"Firmware Upgrade Button"按键
- 最后,同时将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"目录,重新步骤六。
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配置界面
ELRS采用了乐鑫的芯片,因此还可以命令行输入,详见:ExpressLRS_Manufacturer_Design_Guidelines_v1.7.pdf
4.1 命令行
4.2 GUI工具
【1】Advanced Toolchain Setup for ELRS
【2】ExpressLRS-Configurator
来源地址:https://blog.csdn.net/lida2003/article/details/132518813