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

前提条件

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

操作步骤

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

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

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

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

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

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

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

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

    待升级版本号
    • 整包静态升级时,该参数为非必选配置;整包动态升级时,为必选配置。当升级范围为定向升级时,不配置该参数。

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

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

    • 差分升级时,该参数默认为添加升级包时配置的待升级版本号。
  5. 完成升级策略配置,单击完成,批量向设备推送升级通知。
    升级策略
    参数 描述
    升级时间 指定设备OTA升级的时间。
    • 立即升级:立即进行OTA升级。
    • 定时升级:设置升级开始时间、升级结束时间。升级开始时间距当前时间最少5分钟,最多7天。升级结束时间距开始时间最少1小时,最多为30天,可不设置,不设置表示不会强制结束。
      说明 仅当升级方式为 静态升级时,支持定时升级。
    App确认升级 如需自主控制设备OTA升级时,可以配置此参数,通过手机App来控制,设备是否可进行OTA升级。手机App需您自行开发。
    • :设备无法获取OTA升级任务,需App侧确认设备可进行OTA升级(即通过ConfirmOTATask接口,批量确认待确认状态的设备升级作业)后,才能按照云端主动推送升级包设置,获取OTA升级任务信息。
    • (默认):直接按照云端主动推送升级包设置,获取OTA升级任务信息。
    云端主动推送升级包 选择物联网平台是否主动向设备推送升级任务。
    • (默认):批次任务创建完成后,物联网平台主动将OTA升级任务,直接推送给升级范围内的在线设备。

      此模式下,设备仍可主动向物联网平台发起请求,来获取OTA升级任务信息。

    • :设备必须通过向物联网平台发起请求,来获取OTA升级任务信息。
    升级包推送速率 设置每分钟向多少个设备推送升级包下载URL。取值范围:10~1,000。
    注意 如果 云端主动推送升级,无需设置此参数。
    升级失败重试间隔 如果升级失败,选择重试升级的时间。可选:
    • 不重试
    • 立即重试
    • 10分钟后重试
    • 30分钟后重试
    • 1小时后重试
    • 24小时后重试
    注意 升级失败重试间隔需要小于 设备升级超时时间。例如:
    • 设备升级超时时间为60分钟,升级失败重试间隔最大可设置为30分钟后重试
    • 设备升级超时时间为1440分钟,升级失败重试间隔最大可设置为1小时后重试

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

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

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

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

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

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

  6. 可选:升级包详情页面的批次管理列表中,找到动态升级批次,单击操作栏编辑,可在升级范围配置升级策略配置中修改待升级版本号设备升级超时时间(支持取消超时时间设置)。
    注意 动态升级配置修改后:
    • 待升级版本号:若新增版本号,会对新增版本号对应的存量设备发起升级,也会对符合动态策略的新增设备发起升级;若删除版本号,对存量升级的设备无影响。
    • 设备升级超时时间:仅对新增设备的OTA动态升级生效,对存量设备的升级无影响。

执行结果

批量升级提交后,物联网平台根据您的设置向设备推送升级通知,您可在控制台查看目标设备的升级状态、升级包信息等,具体操作,请参见查看升级情况

相关API

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

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