SOTA示例
场景描述
QuecThing的SOTA升级，一般来说指的是把新的固件写入外挂MCU中，代替原有的固件的过程。升级方式均为将固件包上传到开发者中心，设备从开发者中心获取固件包实现远程升级，最后 MCU 接收升级包并写入本地闪存，实现固件的升级。本章节指导用户通过AT指令进行SOTA固件升级。
涉及指令
| 指令名称 | 功能描述 |
|---|---|
| AT+QIOTOTAREQ | 请求OTA升级计划 |
| AT+QIOTUPDATE | 配置 OTA 升级行为 |
| AT+QIOTOTARD | 分片读取 SOTA 数据 |
| AT+QIOTMCUVER | 配置 MCU 版本号 |
提示：OTA升级相关命令详情请参考这里，产品配置相关命令详情请参考这里。
操作步骤
一、登录开发者中心
二、创建产品
创建产品是产品开发流程的第一步，产品是开发者中心定义一类设备的抽象描述，用于对同类设备进行管理。例如您有一台具备LTE联网能力的香薰机，需要接入开发者中心完成设备监控，则您可以定义它为一个产品：“智能香薰机”产品。
三、OTA升级操作流程
1、添加版本包
- 版本包名称 ：为此升级包输入一个名称。
- 组件类型：支持模组固件升级与MCU固件升级。
- 模组固件（FOTA），一般来说指的是把新的固件写入移远模组芯片中 。
- MCU固件（SOTA），一般来说指的是把新的软件包通过移远模组烧入进外挂MCU内。
- 版本包类型：支持整包升级、差分包升级两种固件升级方式。
- 差分包针对指定源版本的升级，一般为进行小规模功能或修复BUG升级。
- 整包不指定源版本，所有设备均可升级。
- 源版本：源固件包的版本，若选择差分包类型则会显示此项，整包则无。（开发者中心根据设备连接平台时上报的设备信息中的版本号判断是否与此参数一致，若一致则下发升级信息）。
- 目标版本：固件包的新版本号。（设备升级完成后需要上报升级后的版本号，开发者中心检查设备上报的版本号是否与此参数一致，若一致则判断为升级成功）。
- 上传版本包：上传的固件文件支持格式： .bin,.zip,.rar,.pack,.mini_1,.mini_2,.py,.tar,.tar.gz,.s19,.bin_1,.bin_2等类型的文件，文件大小不能超过100MB，最多支持5个文件。
- 备注：对本次上传的固件版本进行描述和记录。
2、版本包固件验证（可选）
固件验证是为了确保将要大规模升级的固件是安全可用的，最大限度降低升级风险，防止意外损失的出现。在大批量升级设备之前，您可以选择单台设备进行固件验证并执行OTA升级流程。
i.选择需要验证的版本包，点击 固件验证。
ii.选择用来验证的设备，输入需要验证的组件标识，提交验证。
iii.点击固件包详情，查看固件验证详情。
3、创建升级计划
在升级设备前，需创建或选择一个已有的升级计划；计划包含了需要升级的设备、升级时间、升级的组件配置等信息。
i.基本信息填写
- 计划名称：为此升级计划输入一个名称。
- 升级产品 ：选择对应需要升级设备的产品。
- 设置黑白名单：若不设置黑、白名单，则该产品下所有设备升级。若同时设置黑、白名单，则黑名单优先级大于白名单优先级
- 若只设置白名单：只允许在白名单中的设备被升级。
- 若只设置黑名单：在黑名单中的设备不允许被升级。
- 时区：此项必须配置。配置后平台只会在此时区+推送时段推送升级计划。
- 推送时段：配置平台主动推送升级计划的时间段，可选择性配置，只能配置整点到整点，至少间隔1个小时。
- 升级方式 ：
- 静默升级： 是指无需用户确认，应用端将自动完成升级，再次开启后为升级过的版本。
- 用户确认升级： 是指用户需主动进入设备控制界面，在设备详情页检查并确认固件升级。
ii.制定升级策略
在固件升级的过程中，难免会遇到因升级环境较差的情况导致升级失败，为了避免这种情况，从而需制定升级策略来减少升级失败概率。点击升级策略旁的 自定义 按钮即可在弹窗配置升级策略。
iii.新增升级组件
升级组件是用户自主创建，由一个或多个组件构成的集合体。用于创建升级计划时对需要升级的产品组件进行选择和规划，组件标识需唯一。
iv.配置升级文案
用户确认升级计划需要录入升级文案，静默升级计划无需录入。其中中文和英文的文案必须输入，其他语言根据实际需求录入。
v.激活升级任务
完成以上的 添加版本包 与 创建升级计划 操作步骤后，点击左下角的 激活计划 按钮即可激活此计划。开发者中心将会执行升级任务，下发所选的目标版本固件到升级范围内的目标设备中。
提示：升级任务激活后将不允许被删除。
4、设备连接
MCU可通过 AT+QIOTREG=<reg_mode> 指令配置平台连接模式，连接开发者中心前需配置PK/PS，若未配置则返回ERROR。发送指令后，当模组响应如以下返回值，则代表设备已成功与开发者中心连接。
[TX]AT+QIOTREG=1
[RX]AT+QIOTREG=1
[RX]OK
[RX]+QIOTEVT: 2,10200
[RX]+QIOTEVT: 3,102005、设置MCU版本号
[TX]AT+QIOTMCUVER="STM32","1_0_0"
[RX]OK6、OTA请求
1）制定完成升级计划及激活后，设备需发送 AT+QIOTOTAREQ 指令请求SOTA升级。发送SOTA请求指令后，若该设备已包含在创建的升级计划产品内，则主动打印事件，事件包括组件标识+源版本+目标版本+最低电池电量+最低信号强度+固件包大小。若确认设备满足升级策略要求即可进行下一步确认升级。
2）设备可无需请求OTA，确保设备在线，等待平台每隔10分钟主动匹配下发升级计划，例如：10:00、10:10。
[TX]AT+QIOTOTAREQ=1
[RX]OK
[RX]+QIOTEVT: 7,10700,"STM32","","2_0_0",30,-113,279547、设备升级结果
发送 AT+QIOTUPDATE 指令确认是否升级。
[TX]AT+QIOTUPDATE=1
[RX]AT+QIOTUPDATE=1
[RX]OK提示：设备确认升级后，可在软件升级任务列表中查看批量任务的执行结果。单击对应任务 查看 按钮，可以在 执行详情 界面查看每个设备的升级结果。
8、设备升级流程反馈
固件升级成功的流程分为 开始下载、下载中、下载完成、更新中、更新完成 5个步骤。其中当升级状态为“更新中”，"状态详情"则显示百分比进度。SOTA升级流程反馈如下所示。
设备开始下载固件包
c[RX]+QIOTEVT: 7,10701,"STM32",27954,"95cbdeb4faeda4322ad9b65eb731ed2b",4022793929,"2bb534d576fb307f049a149787afab2382ebb8605467acfc2c05a2e67677e094"固件包下载中
c[RX]+QIOTEVT: 7,10702固件包下载完成
c[RX]+QIOTEVT: 7,10703,"STM32",27954,0,27954MCU固件更新中
c[TX]AT+QIOTOTARD=0,1024 [RX]+QIOTOTARD: 0,1024 00000064 65746e45 52412072 4d545f48 ... OK ... [TX]AT+QIOTOTARD=1024,1024 [RX]+QIOTOTARD: 1024,1024 71657220 74736575 00000000 532c736b ... OK [TX]AT+QIOTOTARD=27649,1024 [RX]+QIOTOTARD: 27649,305 6c512072 6365535f 54646e6f 6369546f ... OK [TX]AT+QIOTUPDATE=3 [RX]AT+QIOTUPDATE=3 [RX]OK [RX]+QIOTEVT: 7,10704MCU 接收升级包后需运行用户提前编写好的MCU程序将固件包写入本地闪存里，从而实现固件更新
设置新的MCU版本（MCU升级完成后，需MCU发送AT命令给模组主动设置新的MCU版本号）
c[TX]AT+QIOTMCUVER="STM32","2_0_0" [RX]OK更新固件成功
c[RX]+QIND: "FOTA","END",0 [RX]+QIOTEVT: 7,10705
四、升级监控
在计划列表中点击 升级监控，在设备升级列表，可查看该计划下所有设备的升级状态。
点击 组件详情 可查看具体设备的升级日志，如下图所示。
