全部文档
OneOS简介 硬件支持 快速开发指南 编译构造工具 API参考文档 高级语言 用户编程手册 应用笔记 FAQ

远程升级套件

简介

远程升级(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算出来的值填入即可,这是制作差分包时,平台需要的信息。

  1. 与平台相关配置:
(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。

app烧录地址

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

f0系列ram修改

OTA云平台制作差分包

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

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

块大小配置

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

wosun模式ram配置

示例

1、包含头文件

#include <cmiot_user.h>

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

升级结果通知代码

API使用说明手册

OTA API使用说明手册

注意事项

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

results matching ""

    No results matching ""