本文介绍如何在物联网平台控制台,向设备批量推送升级包,进行OTA升级。

前提条件

已完成以下操作:
  1. 添加升级包
  2. (可选)验证升级包

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,找到对应的实例,单击实例进入实例详情页面。
    实例概览
  3. 在左侧导航栏,选择监控运维 > OTA升级
    说明 为提供更好的服务,物联网平台改版了原OTA升级,新增了升级包版本统计功能。首次进入改版后的OTA升级页面时,您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应,一个升级包只能关联一个产品。详情请参见控制台指引。
  4. 在升级包列表中,单击升级包对应的批量升级,完成升级范围配置,单击下一步
    参数 描述
    待升级版本号
    • 整包静态升级时,该参数为非必选配置;整包动态升级时,为必选配置。当升级范围为定向升级时,不配置该参数。

      下拉列表中,展示当前产品下所有设备的除升级目标版本号外的其他版本号,选择一个或者多个待升级的版本。

      如不选择,表示对待升级设备OTA模块的当前版本不做限制。

    • 差分升级时,该参数默认为添加升级包时配置的待升级版本号。
    升级方式
    • 静态升级:仅升级当前满足升级条件的设备。
    • 动态升级:升级当前和持续检查中,满足升级条件的设备。

      持续检查中包括但不限于以下情况的设备,可进行OTA升级:

      • 后续新激活设备满足升级条件。
      • 设备当前上报的OTA模块版本号不满足升级条件,后续上报了满足升级条件的OTA模块版本号。
      说明
      • 一个升级包下仅可有1个动态升级批次。如果升级包下已有1个动态升级批次,将不能创建新的动态升级,需先取消原有动态升级批次。
      • 一个设备在一个动态升级批次下只能匹配10次升级。超过10次后,即使后续满足动态升级匹配条件,物联网平台也不会再触发设备升级。
    升级范围
    • 全部设备:升级该产品下满足升级条件的全部设备。
    • 定向升级:仅升级被选中的设备。选择为定向升级后,提供两种设备选择方式:
      • 手动勾选:从设备范围下拉列表选择要升级的设备。

        在华东2(上海)、华北2(北京)、华南1(深圳)地域企业版实例中,您可以通过高级搜索搜索设备,还可下载已搜索设备的CSV格式文件。

      • 文件上传:下载模板,填写、上传CSV格式的设备列表文件。单次最多包含10,000条记录。

        若设备列表文件中有不合法的设备名称,将出现错误提示。请单击下载不合法列表,查看不合法的设备名称,修改设备列表文件,再重新上传。

    • 区域升级:升级实际地理位置在指定区域的设备。选择为区域升级后,下方出现指定区域的省份和城市选项框。
    • 灰度升级:即局部升级。升级方式为静态升级时出现的可选项。

      选择为灰度升级后,下方出现灰度范围输入框,需针对已选择的设备,设置灰度百分比。物联网平台根据设置的灰度百分进行计算,计算结果向下取整。灰度升级的设备至少为1个。

  5. 完成升级策略配置,单击完成,批量向设备推送升级通知。
    参数 描述
    升级时间 指定设备OTA升级的时间。
    • 立即升级:立即进行OTA升级。
    • 定时升级:设置升级开始时间、升级结束时间。升级开始时间距当前时间最少5分钟,最多7天。升级结束时间距开始时间最少1小时,最多为30天,可不设置,不设置表示不会强制结束。
      说明 仅当升级方式为静态升级时,支持定时升级。
    升级包推送速率 设置每分钟向多少个设备推送升级包下载URL。取值范围:10~1,000。
    升级失败重试间隔 如果升级失败,选择重试升级的时间。可选:
    • 不重试
    • 立即重试
    • 10分钟后重试
    • 30分钟后重试
    • 1小时后重试
    • 24小时后重试
    注意 升级失败重试间隔需要小于设备升级超时时间。例如:
    • 设备升级超时时间为60分钟,升级失败重试间隔最大可设置为30分钟后重试
    • 设备升级超时时间为1440分钟,升级失败重试间隔最大可设置为1小时后重试

    升级失败重试间隔需设置为24小时后重试,则建议不设置设备升级超时时间。因升级超时后,不会再触发升级重试。

    升级重试上限次数 选择升级失败后,最多可重试几次。可选:
    • 1次
    • 2次
    • 5次
    设备升级超时时间 设置单个设备的升级超时时间,即多长时间之后,升级未完成则为超时。可选值范围:1分钟~1,440分钟。
    说明 从设备第一次上报升级进度开始计算升级时间。

    升级期间若设备多次上下线,触发物联网平台多次推送升级包,都始终以设备最开始的第一次上报升级进度时间作为开始时间。

    是否覆盖设备之前的升级任务 同一时间,如果一个设备处于多个升级批次中(即设备状态为:待推送、已推送或升级中),需要选择是否覆盖设备之前的升级任务。
    • 是,则设备只执行新的升级任务,之前的升级任务会被取消。
    • 否,若设备已有升级任务,则只执行已有任务。
    说明 不覆盖升级中的任务,此时继续执行升级中的任务,不执行新的任务。
    是否仅对新上报版本的设备生效 当升级方式选择为动态升级时的参数。可选:
    • 是,则仅升级后续新上报版本号的设备。
    • 否,则升级当前满足升级条件的设备,并持续检查后续新上报版本号的设备是否满足升级条件。
    批次标签 单击新增标签,在显示的输入框中,输入标签的标签Key标签Value。批次标签创建后不可修改。

    批次标签将在向设备推送升级通知时下发给设备。

    标签配置规则,可单击帮助图标帮助查看。

执行结果

查看升级情况

相关API

API 描述
CreateOTAStaticUpgradeJob 创建静态升级批次。
CreateOTADynamicUpgradeJob 创建动态升级批次。
CancelOTAStrategyByJob 取消动态升级批次所关联的动态升级策略。
CancelOTATaskByDevice 取消指定升级包下状态为待升级的设备升级作业。
CancelOTATaskByJob 取消指定批次下的设备升级作业。

OTA相关API的更多信息,请参见OTA升级相关API