Wi-SUN入门指导8：生成Wi-SUN SoC Meter OTA DFU升级所需的固件

由于我们的 EFR32FG25 USB Dongle 使用的是 EFR32FG25A121F1152IM56 无线SoC芯片，它的 flash 只有 1152 kB，不能实现固件备份式的 OTA 升级，因此我们使用 EFR32FG25 的 BRD4270B 开发板来测试 OTA 功能。BRD4270B 开发板使用的芯片是 EFR32FG25B222F1920IM56 芯片，它的 flash 大小为 1920 kB，足够放下 bootloader、应用固件和升级固件。本文主要以 BRD4270B 开发板为例，介绍生成 Wi-SUN SoC Meter OTA DFU 升级所需固件的方法。

1、在对 Meter 执行 OTA 升级之前，需要先给 Meter 烧录 bootloader 固件，所以我们先新建 bootloader工程。在 Simplicity Studio v5 软件的菜单栏点击 File，点击 New，再点击 SILICON LABS Project Wizard。

在 New Project Wizard 页面，为了方便给使用 EFR32FG25 芯片自己做板子的客户提供参考，我们没有使用 BRD4270B 开发板直接创建工程，而是使用 EFR32FG25B222F1920IM56 芯片来创建工程，所以 Target Boards 不用选择；Target Device 输入并选中 BRD4270B 开发板所使用的芯片型号：EFR32FG25B222F1920IM56，SDK 选择 Simplicity SDK Suite v2024.6.1；IDE/Toolchain 选择 GNU ARM v12.2.1；点击 NEXT。

在 MCU 下面勾选 Bootloader，点击搜索到的 Bootloader - SoC Internal Storage (single image on 1920kB device) 工程，点击 NEXT。

勾选 Copy contents，点击 FINISH。

2、默认的 bootloader 工程没有使用压缩算法，所以用于升级的 gbl 固件比较大，升级所需的时间比较长。建议使用 lzma 压缩算法，使用 lzma 压缩后的 gbl 固件大小只有没压缩 gbl 固件的 61%。

为了使用 lzma 压缩算法，我们需要安装 GBL Compression (LZMA) 组件。点击 bootloader-storage-internal-single-1920k.slcp，点击 SOFTWARE COMPONENTS，在搜索栏输入 lzma，点击搜索到的 GBL Compression (LZMA)，点击 Install。

3、编译 bootloader-storage-internal-single-1920k 工程，把编译后的 hex 或者 s37 固件下载到 BRD4270B 开发板。

4、按照上面创建 bootloader 工程的方法，再使用 EFR32FG25B222F1920IM56 芯片创建 Wi-SUN - SoC Meter 工程。

为了方便跟之前使用 EFR32FG25 Wi-SUN Dongle 创建的 Meter 工程做区分，我们把工程名称改为 wisun_soc_meter_brd4270b，勾选 Copy contents，点击 FINISH。

5、点击 wisun_soc_meter_brd4270b.slcp 文件，点击 SOFTWARE COMPONENTS，在搜索栏输入 clock manager，点击搜索到的 Clock Manager 组件，点击 Configure。

勾选 HFXO Settings (if High Frequency crystal is used)，

将 Clock Tree Settings 的 Default Clock Source Selection for HF clock branches 改为 HFXO。

6、点击 wisun_soc_meter_brd4270b.slcp 文件，点击 SOFTWARE COMPONENTS，在搜索栏输入 eusart，点击搜索到的 IO Stream: EUSART 组件，点击 Install。

把 INSTANCE NAME 改为 vcom，点击 Done。

等待组件安装完成后，点击 Configure，

选择串口外设，配置串口引脚。

7、接下来需要在 wisun_soc_meter_brd4270b 工程安装 OTA 所需要的 OTA DFU 组件，点击 wisun_soc_meter_brd4270b.slcp 文件，点击 SOFTWARE COMPONENTS，在搜索栏输入 ota dfu，点击搜索到的 Wi-SUN Over-The-Air Device Firmware Upgrade (OTA DFU) 组件，点击 Install。

勾选 Enable verbose mode 使用详细模式，方便在测试时打印详细的 OTA DFU log。一旦您熟悉了 OTA DFU，您就可以禁用详细模式。

把 TFTP service listening address 改为：fd00:6172:6d00::1；

把 OTA DFU notification server address 改为：fd00:6172:6d00::2。

Firmware image (gbl) file name on TFTP server 可以保持 wisun_firmware.gbl 不变，我们在 WSBRD 中也要使用同样的文件名。

8、在 wisun_soc_meter_brd4270b 工程的 app.c 文件中，为了区分 Meter 固件版本号，在 app_task() 函数的 sl_wisun_app_core_util_connect_and_wait() 这行代码前面，添加如下打印版本号和是否支持 OTA DFU 的代码：

printf("Version 1. Compiled on %s at %s\n", __DATE__, __TIME__);

#ifdef SL_CATALOG_WISUN_OTA_DFU_PRESENT

  printf("OTA DFU is supported\n");

#endif

9、安装 OTA DFU 组件后，Simplicity Studio v5 软件会自动生成 led0 和 led1 的代码，如果我们不对这两个 led 的 GPIO 进行配置，编译程序会报如下错误。

在 SOFTWARE COMPONENTS 的搜索栏输入 led，点击搜索到的 Simple LED 组件，点击右边的 Add New Instances。

在 INSTANCE NAME 输入 led0，点击 Done。

led0 组件安装完成后，点击 Simple LED 组件左边的三角形图标，点击 led0，再点击 Configure。

在 SL_SIMPLE_LED_LED0 的 Selected Module 选择 BRD4270B 开发板 LED0 对应的 GPIO：PC06。

10、点击 wisun_soc_meter_brd4270b.slcp，再次点击 Simple LED 组件，点击 Add New Instances。

在 INSTANCE NAME 输入 led1，点击 Done。

led1 组件安装完成后，点击 led1，再点击 Configure。

在 SL_SIMPLE_LED_LED1 的 Selected Module 选择 BRD4270B 开发板 LED1 对应的 GPIO：PC07。

11、此时编译 wisun_soc_meter_brd4270b 工程，它会报 sl_wisun_meter_process 和 sl_wisun_meter_init 函数没有定义的错误。

因为安装 OTA DFU 组件之后，工程会启用 CoAP 优化模式，不需要使用这两个函数，所以这两个函数的源代码就被屏蔽了。

我们在 app.c 文件的 app_task() 函数里面，屏蔽 sl_wisun_meter_process(); 这行代码。

然后在 app_init.c 文件的 app_init() 函数里面，屏蔽 sl_wisun_meter_init(); 这行代码。

12、编译 wisun_soc_meter_brd4270b 工程，此时工程就能编译通过了。

13、为了区分不同版本的固件，点击 wisun_soc_meter_brd4270b 工程的 Binaries，在 wisun_soc_meter_brd4270b.s37 固件点击右键，点击 Rename。

将固件名称改为 wisun_soc_meter_brd4270b_version_1.s37，点击OK。

14、在 app.c 的 app_task() 函数中，将版本打印信息由 Version 1 改为 Version 2，重新编译 wisun_soc_meter_brd4270b 工程。

使用同样的方式，把刚编译好的固件名称改为 wisun_soc_meter_brd4270b_version_2.s37。

15、由于我们直接使用 EFR32FG25B222F1920IM56 芯片来创建 Meter 工程，没有使用 BRD4270B 开发板创建工程，所以没有使用虚拟串口。因此我们需要在开发板底板的 20pin 拓展接口上连接USB转串口工具，用来使用串口命令跟 Meter 通信，并且打印 Meter 的 log。

16、把 wisun_soc_meter_brd4270b_version_1.s37 固件烧录到 BRD4270B 开发板，EFR32FG25 芯片复位后会打印如下信息。可以看到 EFR32FG25 芯片现在使用的 Meter 固件版本号和程序编译时间。

17、找到 wisun_soc_meter_brd4270b_version_2.s37 固件的存放路径，并复制这个固件。

把 wisun_soc_meter_brd4270b_version_2.s37 固件粘贴到 commander.exe 所在的文件夹。

18、打开电脑的命令行页面，先进入到 commander.exe 所在的文件夹，再使用如下命令将 wisun_soc_meter_brd4270b_version_2.s37 固件转换为 wisun_soc_meter_brd4270b_version_2_lzma.gbl 固件，并且使用了 lzma 压缩算法。

commander gbl create  --app wisun_soc_meter_brd4270b_version_2.s37 wisun_soc_meter_brd4270b_version_2_lzma.gbl --compress lzma

现在可以在 commander 文件夹中看到刚生成的 wisun_soc_meter_brd4270b_version_2_lzma.gbl 固件，后面对 Meter 做 OTA 升级时，需要把这个 gbl 固件发送到树莓派。