远程升级套件

简介

远程升级(Firmware Over The Air)可通过无线网络实现固件升级。OneOS的OTA为差分升级，采用此方式可极大降低升级包的大小。OneOS OTA组件分两部分：BootLoader和App，BootLoader实现固件还原功能、升级功能，App部分完成更新检测、固件下载、版本校验。

BootLoader下载地址为：https://gitee.com/cmcc-oneos/bootloader，目前开放出来的BootLoader只支持LUSUN算法，所以在配置的时候请选用LUSUN，关于分区配置请参照对应板子下的README.txt。

下载协议所有板子目前都可支持，列举部分板子差分算法的支持情况(RAM > 200k，可以考虑使用Wosun；RAM > 512k，可以考虑使用Wosun high)：

注1：如果使用串口通信，buffer推荐设置成512或更大，以免下载升级包出错

STM32F091：支持LUSUN。

STM32F103：支持LUSUN。

STM32F407：支持LUSUN。

STM32F429：支持LUSUN。

STM32F469：支持LUSUN。

STM32F769：支持LUSUN。

STM32L452：支持LUSUN。

STM32L475：支持LUSUN。

STM32L496：支持LUSUN。

配置指南

menuconfig配置：

1.由于要使用BootLoader，需要将BootLoader的开关打开。如下：

(Top) → Boot Config

OneOS Configuration

[*] Enable OneOS bootloader

2.选择合适的联网方式

注2：使用串口收发数据时，buffer推荐设置为512或更大;如果接收数据丢失，查看RX是否配置为DMA接收模式

3.OTA相关信息配置

按需要更更改的地址为：1、下载的方式，2、差分的算法，3、平台相关的值。

下载的方式目前支持HTTP和COAP，差分的算法目前支持LUSUN、WOSUN LOW、WOSUN HIGH，BootLoader和App需要保持算法一致。App对应这两个的配置选项如下。

(Top) → Components→ OTA→ Fota by CMIOT

OneOS Configuration

[*] Enable fota by cmiot

The supported network protocol (Http) --->

The supported algorithm (Lusun) --->

如果使用Wosun 差分算法，还需要配置如下两项：

(0x8020000) App part addr from fal's OS_APP_PART_ADDR

(0x20000) Download part size from fal's OS_DL_PART_SIZE

分别把OS_APP_PART_ADDR和OS_DL_PART_SIZE算出来的值填入即可，这是制作差分包时，平台需要的信息。

与平台相关配置：

(cmiot_cd) Oem

(F103RE) Model

(1593394730) Product id

(e7f48e3ea6c3417d82edfe66b1305ac8) Product secret

(box) Device type

(STM32F1) Platform

(5.0) Firmware version

注3：须保持与OTA平台侧项目信息一致。

注4： Firmware version 是制作出软件包的版本，改变此值后在KEIL里编译会生成相应版本的软件包，之后即可在OTA平台上传制作差分包

工程构建：

1、APP烧录的位置和大小，跟APP分区一致，不能随意更改，不然会跳转失败，可以参照下面注7。

注5：不同的联网方式会改变app大小，需要根据使用场景调整app及bootloader分区大小

2、打包命令可以加到Keil软件里，也可以自己手动在scons或cmd命令行打包。命令为：

压缩软件支持：WinRAR.exe、7z.exe

只生成axf文件的打包命令：..\..\components\ota\cmiot\cmiot_axf.bat fromelf程序路径 压缩软件路径 oneos_config.h axf文件路径

已生成bin文件的打包命令：..\..\components\ota\cmiot\cmiot_bin.bat 压缩软件路径 oneos_config.h bin文件路径

例如：

只生成axf文件：..\..\components\ota\cmiot\cmiot_axf.bat "D:\Keil_v5\ARM\ARMCC\bin\fromelf.exe" "C:\Program Files\WinRAR\WinRAR.exe" oneos_config.h build\keil\Obj\oneos.axf

已生成bin文件：..\..\components\ota\cmiot\cmiot_bin.bat "C:\Program Files\WinRAR\WinRAR.exe" oneos_config.h ..\..\out\stm32l475-atk-pandora\oneos.bin

注6：WinRAR.exe和fromelf.exe是绝对路径，需要根据个人电脑相应路径进行修改

注7：App的烧录地址要跟分区表匹配，才能跳转成功，以ARMCC的链接文件link.sct为例，GCC的链接文件为link.lds，IAR的链接文件为link.icf。

注8：F0系列产品需要注意KEIL配置RAM根据以下代码修改

OTA云平台制作差分包

1.平台建项目的时候注意选精简版，我们的板子只支持这个。OTA类型选择精简版。

2.差分对比块大小和驱动一样，配置为块大小。

3.如果使用WOSUN，在OTA平台制作差分包时需要设置设备内存，设置为(RAM总大小 - 10)

示例

1、包含头文件

#include

2、添加上报升级结果和升级更新的代码

API使用说明手册

注意事项

详细见各个分项下的注意事项。