若升级包中升级包是否需要平台验证选择了,则在批量升级前,需使用测试设备对升级包进行验证。只有测试设备全部升级成功后,升级包才可用于设备OTA升级。本文介绍如何在物联网平台控制台验证升级包。

前提条件

已创建需要验证的升级包。具体操作,请参见添加升级包

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述
    实例概览
  3. 在左侧导航栏,选择监控运维 > OTA升级
    说明 为提供更好的服务,物联网平台改版了原OTA升级,新增了升级包版本统计功能。首次进入改版后的OTA升级页面时,您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应,一个升级包只能关联一个产品。详情请参见控制台指引。
  4. 在升级包列表中,单击升级包对应的验证,配置参数后,单击确认,在一个或多个设备上进行升级包验证。
    参数描述
    待升级版本号
    • 整包升级时,该参数为非必选配置。

      下拉列表中,展示当前产品下所有设备的除升级目标版本号外的其他版本号,您可以选择一个或者多个待升级的版本。选择后,相应的设备将作为待验证设备列表中的备选设备。

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

    • 差分升级时,该参数默认为已在添加升级包时配置的待升级版本号。
    待验证设备选择用于此次测试的设备。
    云端主动推送升级包选择物联网平台是否主动向设备推送升级任务。
    • (默认):批次任务创建完成后,物联网平台主动将OTA升级任务,直接推送给升级范围内的在线设备。

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

    • :设备必须通过向物联网平台发起请求,来获取OTA升级任务信息。
    App确认升级如需自主控制设备OTA升级时,可以配置此参数,通过手机App来控制,设备是否可进行OTA升级。手机App需您自行开发。
    • :设备无法获取OTA升级任务,需App侧确认设备可进行OTA升级(即通过ConfirmOTATask接口,批量确认待确认状态的设备升级作业)后,才能按照云端主动推送升级包设置,获取OTA升级任务信息。
    • (默认):直接按照云端主动推送升级包设置,获取OTA升级任务信息。
    升级包下载协议可选协议:HTTPSMQTT。设备端收到物联网平台推送的升级包下载信息后,通过此处设置的协议下载升级包。
    重要 使用MQTT协议下载升级包,必须符合以下条件:
    • 支持的地域:仅中国的华东2(上海)、华北2(北京)和华南1(深圳)。
    • OTA升级包:仅包含一个文件,且文件大小不超过16 MB。
    • 设备端SDK:必须使用物联网平台提供的C语言Link SDK最新版本的软件包,开发OTA升级和MQTT下载文件的能力。详细内容,请参见使用MQTT协议下载升级包的OTA升级代码示例
    设备升级超时时间设置单个设备的升级超时时间,即多长时间后,设备升级未完成则为超时。可选值范围:1分钟~1,440分钟。

    升级包第一次发起OTA升级时,建议将该参数设置为最大值,以提高设备升级成功率。控制台会根据升级记录,推荐超时时长。

    说明
    • 从设备第一次上报升级进度开始计算升级时间。

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

    • 设备升级成功后,请第一时间上报升级成功后的目标版本,避免因升级超时,导致升级失败。

    例如,将该参数设置为60分钟,设备10:00第一次上报升级进度,11:00之前若未上报升级成功后的目标版本,则升级失败(超时)。

    批次标签

    单击新增标签,在显示的输入框中,输入标签的标签Key标签Value

    升级批次任务创建完成后,如果升级批次状态为升级中,支持修改和新增标签。具体操作,请参见批次管理

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

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

执行结果

页面弹出验证升级包对话框,单击关闭

升级包列表页签,找到状态为验证中升级包,单击对应的查看按钮。单击升级包信息页签,可查看验证进度

验证进度

后续操作

测试设备全部升级成功后,升级包状态显示为已验证,才能进行下一步批量升级。具体操作,请参见发起升级批次任务

相关API

API描述
CreateOTAVerifyJob创建升级包验证批次。
QueryOTAFirmware查询指定升级包的详细信息。

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