更新时间:2024-06-11 GMT+08:00

批量设备OTA升级

上传软固件包

创建批量设备软件、固件升级任务前需要上传软件升级包,平台支持两种方式上传软件、固件包:

  1. 应用服务器通过调用“创建OTA升级包”API接口,创建OTA升级包,详情请参考创建OTA升级包
  2. 通过控制台,在软固件升级页面上传软件、固件升级包,详情请参考软固件包上传
    • 通过API接口创建的OTA升级包,只支持MQTT协议设备升级。
    • 升级包为OBS对象时,无论OBS桶是否配置了CDN域名加速功能,下发的升级包链接都为OBS链接地址。

批量设备软件升级

用户对批量设备进行软件升级有两种方式:

  1. 应用服务器通过调用的“创建软件升级任务”API接口,创建批量设备的升级任务,详情请参考创建批量任务
  2. 通过控制台,创建批量设备的软件升级任务。

下面将重点介绍通过控制台创建批量设备的软件升级任务。

  1. 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。
  2. 在左侧导航栏选择"设备 > 软固件升级",单击“升级任务”。
  3. 选择“软件升级”页签,单击“新建任务”按钮,进入新建软件升级任务页面。

  4. 设置“任务信息”,填写任务名称、执行时间、启用重试。

    启用重试后,可以设置重启次数和重启间隔。重启次数建议设置为2次,重启间隔设置为5分钟,即设备升级失败后,隔5分钟后会进行升级重试。

  5. 选择需要升级的软件包。

  6. 选择需要升级的设备或者设备群组,然后单击“立即创建任务”。

    设备群组可以参考群组与标签创建需要升级的设备群组,并绑定对应的设备。

  7. 创建完批量升级任务后,可以在软件升级任务列表中查看批量任务的执行结果。单击对应任务"查看"按钮,可以在“执行详情”界面查看每个设备的升级结果。

    如果升级任务正在执行中,是不允许删除任务的,如需删除,请先在任务列表中,手动停止任务后,再删除升级任务。

批量设备固件升级

用户对批量设备进行固件升级有两种方式:

  1. 应用服务器通过调用的“创建固件升级任务”API接口,创建批量设备的升级任务,详情请参考创建批量任务
  2. 通过控制台,创建批量设备的固件升级任务。

下面将重点介绍通过控制台创建批量设备的固件升级任务。

  1. 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。
  2. 在左侧导航栏选择"设备 > 软固件升级",单击“升级任务”。
  3. 在“固件升级”页签,单击“新建任务”按钮,进入新建固件任务页面。

  4. 设置“任务信息”,填写任务名称、执行时间、启用重试。

    启用重试后,可以设置重启次数和重启间隔。重启次数建议设置为2次,重启间隔设置为5分钟(最大重启次数为5次,最大重启间隔为1440分钟),即设备升级失败后,隔5分钟后会进行升级重试。

  5. 选择需要升级的固件包。

  6. 选择需要升级的设备群组,然后单击“提交”。

    设备群组可以参考群组与标签创建需要升级的设备群组,并绑定对应的设备。

  7. 创建完批量升级任务后,可以在固件升级任务列表中查看批量任务的执行结果。单击对应任务"查看"按钮,可以在“执行详情”界面查看每个设备的升级结果。

    如果升级任务正在执行中,是不允许删除任务的,如需删除,请先在任务列表中,手动停止任务后,再删除升级任务。

固件升级失败原因

物联网平台上报的失败原因:

失败原因

原因解释

处理建议

Device Abnormal is not online

设备异常未在线

请检查设备侧。

Task Conflict

任务冲突

请检查当前设备是否有软件升级、固件升级、日志收集或设备重启的任务正在进行。

Waiting for the device online timeout

等待设备上线超时

请检查设备侧。

Wait for the device to report upgrade result timeout

等待设备上报升级结果超时

请检查设备侧。

Waiting for report device firmware version timeout

等待上报设备固件版本超时

请检查设备侧。

Waiting for report cellId timeout

等待上报cellId超时

请检查设备侧。

Updating timeout and query device version for check timeout

等待升级结果超时,且等待设备版本信息超时

请检查设备侧。

Waiting for device downloaded package timeout

等待设备完成下载固件包超时

请检查设备侧。

Waiting for device start to update timeout

等待设备启动更新超时

请检查设备侧。

Waiting for device start download package timeout

等到设备开始下载固件包超时

请检查设备侧。

设备上报的失败原因:

失败原因

原因解释

处理建议

Not enough storage for the new firmware package

下载的固件包存储空间不足

请检查设备存储。

Out of memory during downloading process

下载过程中内存不足

请检查设备内存。

Connection lost during downloading process

下载过程中连接断开

请检查设备连接状态。

Integrity check failure for new downloaded package

下载的固件包完整性校验失败

请检查设备下载的固件包是否完整。

Unsupported package type

固件包类型不支持

请检查设备状态和厂商提供的固件包是否正确。

Invalid URI

URI不可用

检查设备侧的固件包下载地址是否正确。

Firmware update failed

固件更新失败

请检查设备侧。