升级指导
概述
软件(Software)一般分为系统软件和应用软件,系统软件实现设备最基本的功能,比如编译工具、系统文件管理等;应用软件可以根据设备的特点,提供不同的功能,比如采集数据、数据分析处理等。
软件升级又称为SOTA(SoftWare Over The Air),是指用户可以通过OTA的方式支持对LwM2M协议和MQTT协议的设备进行软件升级。基于LwM2M协议的产品模型,软件升级遵循的协议为PCP协议(查看PCP协议介绍),设备侧需要遵循PCP协议进行软件升级的适配开发,适配方法请参考设备侧适配开发指导;基于MQTT协议的产品模型,不校验软件升级协议类型。
LwM2M协议设备软件升级流程
LwM2M协议SOTA升级流程的详细说明:
1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。
3. LwM2M设备上报数据,平台感知设备上线,触发升级协商流程。(超时时间为24小时)
- 如果返回的软件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理。
- 如果返回的软件版本信息与升级的目标版本信息不同,则继续进行下一步的升级处理。
6. 物联网平台向设备订阅软件升级的状态。
- 查询成功:则根据如下方式计算可同时升级的并发数计算,并按照步骤10进行处理。
- 如下图所示,如果设备的RSRP强度和SINR强度均落在等级“0”中,则同时可以对该小区的50个相同信号覆盖区间的设备进行同时升级。
- 如果设备的RSRP强度和SINR强度分别落在等级“0”和“1”中,则以信号较弱的等级“1”为准,则只能同时对该小区的10个设备进行升级。
如果设备的RSRP强度和SINR强度分别落在等级“1”和“2”中,则以信号较弱的等级“2”为准,则只能同时对该小区的1个设备进行升级。
如果设备的RSRP强度和SINR强度不在该3个等级范围内,且均可以查询到,则按照信号最弱覆盖等级“2”处理,则只能同时对1个设备进行升级。
如果用户在软件升级中发现同时进行升级的设备数较少,则可以联系当地运营商检查和优化设备所在小区的无线覆盖情况。
- 查询失败:则按照流程9进行处理。
- 如果查询成功:物联网平台支持同时对该小区的10个相同情况的设备进行软件升级。
- 如果查询失败:则升级失败。
10~12. 物联网平台通知设备有新的软件包版本,设备启动软件包的下载。软件包的下载按照分片的方式进行下载,支持断点续传功能,通过软件包分片中携带的“versionCheckCode”确定是否属于同一个软件包。下载完成后,设备知会物联网平台软件包已下载完毕。(第11步超时时间为60分钟)
13~14. 物联网平台向设备下发升级的命令,终端设备进行升级操作,升级完成后终端设备向物联网平台反馈升级的结果。(等待设备上报升级结果和升级状态,超时时间为30分钟)
15. 物联网平台向控制台/应用服务器通知升级的结果。
MQTT协议设备软件升级流程
MQTT协议SOTA升级流程的详细说明:
1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。
3. 平台感知设备是否在线,当设备在线时立即触发升级协商流程。当设备不在线时,等待设备上线订阅升级Topic,平台感知设备上线,触发升级协商流程。(等待设备上线时间25小时以内)
- 如果返回的软件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理,升级任务置为成功。
- 如果返回的软件版本信息与升级的目标版本信息不同,且该版本号支持升级,则继续进行下一步的升级处理。
6~7. 物联网平台下发下载包URL访问这里,token及包的相关信息,用户根据下载包URL和token通过HTTPS协议来下载软件包,24小时后token无效。(下载包和升级状态上报超时时间为24小时)
8. 终端设备进行下载包升级操作,升级完成后终端设备向物联网平台反馈升级的结果。(设备升级完成后返回的版本号和设置的版本一致为成功)
9. 物联网平台向控制台/应用服务器通知升级的结果。
批量设备软件升级
用户对批量设备进行软件升级有两种方式:
- 应用服务器通过调用的“创建软件升级任务”API接口,创建批量设备的升级任务,详情请参考创建批量任务。
- 通过控制台,创建批量设备的软件升级任务。
下面将重点介绍通过控制台创建批量设备的软件升级任务。
- 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。
- 在左侧导航栏选择"设备 > 软固件升级",单击“升级任务”。
- 选择“软件升级”页签,单击“新建任务”按钮,进入新建软件升级任务页面。
- 设置“任务信息”,填写任务名称、执行时间、启用重试。
启用重试后,可以设置重启次数和重启间隔。重启次数建议设置为2次,重启间隔设置为5分钟,即设备升级失败后,隔5分钟后会进行升级重试。
- 选择需要升级的软件包。
- 选择需要升级的设备或者设备群组,然后单击“立即创建任务”。
设备群组可以参考群组与标签创建需要升级的设备群组,并绑定对应的设备。
- 创建完批量升级任务后,可以在软件升级任务列表中查看批量任务的执行结果。单击对应任务"查看"按钮,可以在“执行详情”界面查看每个设备的升级结果。
如果升级任务正在执行中,是不允许删除任务的,如需删除,请先在任务列表中,手动停止任务后,再删除升级任务。