Lierda NB81(-S)&MB26(-S) DFOTA应用指导

yutao

　　1 引言

　　NB81(-S)&MB26(-S)系列模组支持固件空中差分升级(DFOTA)功能，此功能可以实现模组固件包的无线升级或降级。基于DFOTA，用户通过差分包即可实现固件升级或降级。所述差分包仅包含当前固件版本和目标固件版本之间的差异，因此大大降低了数据传输量、极大地缩短了传输时间。

　　本文档主要介绍了如何通过DFOTA功能对NB81(-S)&MB26(-S)系列模组进行的固件升级、降级，同时对中国电信AEP、IoT平台和中国移动OneNET等平台进行DFOTA升级介绍。

　　2 差分包生成

　　差分包制作工具：FotaToolKitGUI.exe。

　　注意：差分包建议小于480KB。

　　(1)双击FotaToolKitGUI.exe打开差分包制作工具。

　　(2)先选择模组对应的配置文件，再填写差分包存放位置、前置版本、后置版本。

　　(3)点击Start开始生成差分文件。

　　(4)待软件反馈差分包生成成功后就可以在相应的路径下看到差分包。

　　3  中国电信AEP平台DFOTA

　　本章节主要描述如何通过中国电信物联网开放平台(AEP平台)对NB81(-S)&MB26(-S)系列模组进行DFOTA升级并给出相关注意事项。

　　AEP平台DFOTA流程如下：
　　第一步：上传差分包到AEP平台；
　　第二步：创建DFOTA任务；
　　第三步：添加升级设备；
　　第四步：设备升级。

　　3.1  上传差分包到平台

　　登录中国电信AEP平台控制台，进入产品中心选择设备所处的产品，点击“远程升级管理”→“固件管理”→“创建固件”→“填写相关信息”，将固件信息上传至云端。

　　3.2  创建DFOTA任务

　　返回中国电信AEP平台控制台，选择“远程升级管理”→“创建任务”，即可创建升级任务。

　　3.3  添加升级设备

　　选择“远程升级管理”，选中创建的任务名称，点击任务设备管理图标，勾选需要升级的设备，点击右上角“加入升级”。

　　3.4  设备升级

　　选择“远程升级管理”→“启动升级图标”→“立即启动”，如下图所示。

       点击任务详细，即可看到设备升级状态。

　　设置平台升级任务后，设备注册到平台，收到平台下发的observe请求后，随即开始升级。如果设备在设置平台升级任务前已注册到平台，在上行一次数据后，随即开始升级。

　　3.5  AT示例

　　AT+CTM2MSETPM=221.229.214.202,5683,3600　//配置电信AEP平台
　　OK
　　AT+CTM2MREG　　　　　　　　　　　　　　　//注册电信AEP平台
　　OK

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0
　　AT+CTM2MSEND=3134　　　　　　　　　　　//发送任意数据，触发DFOTA升级
　　+CTM2MSEND: 46749

　　OK

　　+CTM2M: send,31,46749

　　+CTM2M: FIRMWARE DOWNLOADING

　　+CTM2M: FIRMWARE DOWNLOAD SUCCESS

　　+CTM2M: FIRMWARE UPDATING
　　???挝螛侮螛侮螛螛侮螛挝螛螛挝螛挝螛挝挝螛挝螛侮螛螛侮螛侮螛?
　　Lierda

　　+CTM2M: FIRMWARE UPDATE SUCCESS

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0

　　//DFOTA升级后模组自动注册到上一次配置的平台，发送数据测试
　　AT+CTM2MSEND=3134   
　　+CTM2MSEND: 35834

　　OK

　　+CTM2M: send,31,35834
　　AT+CGMR　　　　　　　　　　　　　　　　//查询版本
　　+CGMR:
　　-- SDK Version: 001036Lierda6166122 --
　　-- EVB Version: NB81_Y0C_41F00 --

　　OK

　　4  中国电信IoT平台DFOTA

　　本章节主要描述NB81(-S)&MB26(-S)系列模组通过中国电信IoT平台的固件升级功能进行升级的主要步骤和注意事项。

　　中国电信IoT平台DFOTA升级的主要步骤如下：
　　第一步：配置平台DFOTA能力；
　　第二步：生成公私密钥；
　　第三步：签名固件升级包；
　　第四步：上传公钥；
　　第五步：上传固件升级包；
　　第六步：配置平台升级任务；
　　第七步：设备升级。

　　4.1  配置平台DFOTA能力

　　在DFOTA升级之前，需要确保在中国电信IoT平台上成功注册设备，且能正常收发数据。只有在设备与中国电信IoT平台进行正常通讯时，才可以进行DFOTA升级。

　　请参考中国电信IoT平台官方文档完成应用的创建。创建应用时，请注意产品对应的Profile，该Profile必须包含omCapabilities能力(若未包含，请在Profile中添加如下Profile模板中的红色标记内容)，否则无法向平台上传对应设备的差分固件升级包且平台无法对该设备创建固件升级任务。请联系中国电信IoT平台获取具体的Profile开发指导。

　　4.2  生成公私密钥

　　4.2.1  工具下载

　　登陆中国电信IoT平台(https://develop.local.ct10649.com:8843/#/login)，进入“系统管理”→“工具”页面，点击“离线签名工具”下载离线签名工具压缩包signtool.zip。如下图所示：

　　4.2.2  生成公私钥

　　解压工具压缩包，运行signtool.exe，选择“签名算法”为“ECDSA_256K1+SHA256”，输入“私钥加密口令”，例如“lierdaNB81”；点击“生成公私密钥”，将生成一对公私密钥文件private.pem和public.pem。如下图所示：

　　4.2.3  签名固件升级包

　　将生成的NB81035_36.par重命名为NB81035_36.bin，并使用压缩文件压缩为 NB81035_36.zip文件(签名工具要求为zip文件)。

　　导入私钥文件和固件进行数字签名。

　　4.3  上传公钥

　　进入“系统管理”→“设备管理”，选择所创建的产品名称，点击“软件库”→“公钥管理”→“上传”，上传公钥文件public.pem到中国电信IoT平台，如下图所示。注意“厂商名称”需要与Profile文件里面的厂商名称相对应。

　　4.4  上传固件包

　　登陆中国IoT平台，进入“软件库”→“固件包管理”→“添加固件包”页面。

　　设备类型、厂商名称、型号、协议必须与应用的Profile严格一致，否则上传差分固件升级包和DFOTA升级任务将失败。

　　4.5  配置平台升级任务

　　“设备”→“所有设备”→“升级设备详情”→“软件”。

　　4.6  AT示例

　　+CEREG: 1
　　AT+CTM2MSETPM=180.101.147.115,5683,3600
　　OK
　　AT+CTM2MREG
　　OK

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0
　　AT+CTM2MSEND=3134
　　+CTM2MSEND: 25689

　　OK

　　+CTM2M: send,31,25689

　　+CTM2M: FIRMWARE DOWNLOADING

　　+CTM2M: FIRMWARE DOWNLOAD SUCCESS

　　+CTM2M: FIRMWARE UPDATING

　　+CEREG: 0
　　???挝螛侮螛侮螛螛侮螛挝螛螛挝螛挝螛挝挝螛挝螛侮螛螛侮螛侮螛?
　　Lierda

　　+CEREG: 2

　　+CEREG: 1

　　+CTM2M: FIRMWARE UPDATE SUCCESS

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0

　　+CTM2M: send,32,8019

　　+CTM2M: FIRMWARE UPDATE OVER
　　AT+CGMR
　　+CGMR:
　　-- SDK Version: 001036Lierda6166122 --
　　-- EVB Version: NB81_Y0C_41F00 --

　　OK

　　5  中国移动OneNET平台DFOTA

　　本章节主要描述如何通过中国移动OneNET平台的DFOTA功能对NB81(-S)&MB26(-S)系列模组进行升级并给出相关注意事项。

　　DFOTA流程如下：
　　第一步：上传差分包到OneNET平台；
　　第二步：关联设备；
　　第三步：创建DFOTA任务；
　　第四步：设备升级。

　　5.1  上传差分包到平台

　　登录OneNET平台，进入“NB-IoT物联网套件”→“FOTA升级”→“添加FOTA群组”。

　　填写群组相关信息。

　　点击“FOTA升级”。

　　点击“添加固件版本”。

　　模组的固件版本信息可用AT+LFOTAVER指令查看：
　　AT+LFOTAVER
　　+LFOTAVER: V001.036.022

　　OK

　　点击添加升级包。

　　填写固件信息，添加固件包。

　　5.2  关联设备

　　点击“关联设备”选择待升级的设备。

　　5.3  创建DFOTA任务

　　进入“升级任务管理”，点击“添加升级任务”。

　　填写升级任务信息，启动升级任务。

　　5.4  设备升级

　　模组重新登录平台或者上传任意一包数据即可触发OneNET平台DFOTA任务。

　　5.5  AT示例

　　+CEREG: 1
　　AT+MIPLCREATE
　　+MIPLCREATE: 0

　　OK
　　AT+MIPLADDOBJ=0,3200,1,"1",4,1
　　OK
　　AT+MIPLOPEN=0,86400,30
　　OK

　　+MIPLEVENT: 0,1

　　+MIPLEVENT: 0,2

　　+MIPLEVENT: 0,6

　　+MIPLOBSERVE: 0,95644,1,3200,0,-1

　　+MIPLOBSERVE: 0,95644,1,3200,0,-1
　　AT+MIPLOBSERVERSP=0,95644,1
　　OK

　　+MIPLDISCOVER: 0,30109,3200

　　+MIPLDISCOVER: 0,30109,3200
　　AT+MIPLDISCOVERRSP=0,30109,1,19,"5502;5503;5505;5750"
　　OK

　　+MIPLEVENT: 0,11

　　+MIPLEVENT: 0,40　　//下载中

　　+MIPLEVENT: 0,42　　//下载完成

　　+MIPLEVENT: 0,43　　//升级中

　　+MIPLEVENT: 0,99
　　???挝螛侮螛侮螛螛侮螛挝螛螛挝螛挝螛挝挝螛挝螛侮螛螛侮螛侮螛?
　　Lierda

　　+MIPLEVENT: 0,44　　//升级成功

　　+MIPLEVENT: 0,11　　//更新成功

　　+MIPLEVENT: 0,48　　//升级成功

　　+MIPLEVENT: 0,46　　//升级完成

　　+MIPLEVENT: 0,11　　//更新成功

　　6  华为云物联网IoT平台DFOTA

　　本章节主要描述如何通过华为云物联网IoT平台的DFOTA功能对NB81(-S)&MB26(-S)系列模组进行升级并给出相关注意事项。

       DFOTA流程如下：
       第一步：上传差分包到物联网IoT平台；
       第二步：创建IoT任务；
       第三步：设备升级。

　　6.1  上传差分包到平台

　　登录华为云物联网平台，点击“设备”→“软固件升级”→“资源包管理”→“固件列表”→“上传固件”。

　　添加生成的差分包文件。填写固件版本名称，选择设备对应的产品。

　　6.2  创建DFOTA任务

　　选择“升级任务”→“固件升级”→“新建任务”。

　　配置升级任务任务名称，执行时间(立刻还是指定时间)，重试策略等。
　　选择升级包。
　　选择制定设备，或者设备组。

　　任务创建完毕，等待设备接入平台开始fota升级。

　　6.3  设备升级

　　上线设备，如无Fota响应，发送任意一包数据到平台即可激活Fota任务。

　　6.4  AT示例

　　AT+CGMR
　　+CGMR:
　　-- SDK Version: 001038Lierda6166226 --
　　-- EVB Version: MB26_Y0C_43J00 --

　　OK

　　AT+CTM2MSETPM=119.3.250.80,5683,900
　　OK

　　AT+CTM2MREG
　　OK

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0

　　+CTM2M: FIRMWARE DOWNLOADING

　　+CTM2M: FIRMWARE DOWNLOAD SUCCESS

　　+CTM2M: FIRMWARE UPDATING

　　+QIND: "FOTA","UPDATING",4%,1,1

　　+QIND: "FOTA","UPDATING",7%,1,1

　　+QIND: "FOTA","UPDATING",10%,1,1

　　+QIND: "FOTA","UPDATING",13%,1,1

　　+QIND: "FOTA","UPDATING",16%,1,1

　　+QIND: "FOTA","UPDATING",20%,1,1

　　+QIND: "FOTA","UPDATING",23%,1,1

　　+QIND: "FOTA","UPDATING",26%,1,1

　　+QIND: "FOTA","UPDATING",29%,1,1

　　+QIND: "FOTA","UPDATING",32%,1,1

　　+QIND: "FOTA","UPDATING",35%,1,1

　　+QIND: "FOTA","UPDATING",38%,1,1

　　+QIND: "FOTA","UPDATING",41%,1,1

　　+QIND: "FOTA","UPDATING",44%,1,1

　　+QIND: "FOTA","UPDATING",47%,1,1

　　+QIND: "FOTA","UPDATING",50%,1,1

　　+QIND: "FOTA","UPDATING",53%,1,1

　　+QIND: "FOTA","UPDATING",56%,1,1

　　+QIND: "FOTA","UPDATING",60%,1,1

　　+QIND: "FOTA","UPDATING",63%,1,1

　　+QIND: "FOTA","UPDATING",66%,1,1

　　+QIND: "FOTA","UPDATING",69%,1,1

　　+QIND: "FOTA","UPDATING",72%,1,1

　　+QIND: "FOTA","UPDATING",75%,1,1

　　+QIND: "FOTA","UPDATING",78%,1,1

　　+QIND: "FOTA","UPDATING",81%,1,1

　　+QIND: "FOTA","UPDATING",84%,1,1

　　+QIND: "FOTA","UPDATING",87%,1,1

　　+QIND: "FOTA","UPDATING",90%,1,1

　　+QIND: "FOTA","UPDATING",93%,1,1

　　+QIND: "FOTA","UPDATING",96%,1,1

　　+QIND: "FOTA","UPDATING",100%,1,1

　　\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0
　　+CTM2M: FIRMWARE UPDATE SUCCESS

　　+CTM2M: reg,0

　　+CTM2M: obsrv,0

　　+CTM2M: FIRMWARE UPDATE OVER

　　AT+CGMR
　　+CGMR:
　　-- SDK Version: 001038Lierda6166227 --
　　-- EVB Version: MB26_Y0C_43J00 --

　　OK

　　7  相关文档

　　以下相关文档提供了文档的名称，版本请以最新发布的为准。