若升级包中升级包是否需要平台验证选择了是,则在批量升级前,需使用测试设备对升级包进行验证。只有测试设备全部升级成功后,升级包才可用于设备OTA升级。本文介绍如何在物联网平台控制台验证升级包。
前提条件
已创建需要验证的升级包。具体操作,请参见添加升级包。操作步骤
- 登录物联网平台控制台。
- 在实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述。
- 在左侧导航栏,选择 。说明 为提供更好的服务,物联网平台改版了原OTA升级,新增了升级包版本统计功能。首次进入改版后的OTA升级页面时,您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应,一个升级包只能关联一个产品。详情请参见控制台指引。
- 在升级包列表中,单击升级包对应的验证,配置参数后,单击确认,在一个或多个设备上进行升级包验证。
参数 描述 待升级版本号 - 整包升级时,该参数为非必选配置。
下拉列表中,展示当前产品下所有设备的除升级目标版本号外的其他版本号,您可以选择一个或者多个待升级的版本。选择后,相应的设备将作为待验证设备列表中的备选设备。
如不选择,表示对备选待验证设备的OTA模块当前版本不做限制。
- 差分升级时,该参数默认为已在添加升级包时配置的待升级版本号。
待验证设备 选择用于此次测试的设备。 云端主动推送升级包 选择物联网平台是否主动向设备推送升级任务。 - 是(默认):批次任务创建完成后,物联网平台主动将OTA升级任务,直接推送给升级范围内的在线设备。
此模式下,设备仍可主动向物联网平台发起请求,来获取OTA升级任务信息。
- 否:设备必须通过向物联网平台发起请求,来获取OTA升级任务信息。
App确认升级 如需自主控制设备OTA升级时,可以配置此参数,通过手机App来控制,设备是否可进行OTA升级。手机App需您自行开发。 - 是:设备无法获取OTA升级任务,需App侧确认设备可进行OTA升级(即通过ConfirmOTATask接口,批量确认待确认状态的设备升级作业)后,才能按照云端主动推送升级包设置,获取OTA升级任务信息。
- 否(默认):直接按照云端主动推送升级包设置,获取OTA升级任务信息。
升级包下载协议 可选协议:HTTPS或MQTT。设备端收到物联网平台推送的升级包下载信息后,通过此处设置的协议下载升级包。 重要 使用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。