创建升级任务
此章节主要描述平台侧OTA升级的相关操作,包括自定义OTA模块、设备固件的上传、升级任务的创建和取消以及用户如何去查看自己账号下的设备固件版本分布情况
自定义OTA模块(可选)
平台支持对设备进行不同模块升级,如主固件、子部件、软件等等。default为默认模块,代表整个设备的固件,可自定义其他OTA模块。注意:仅支持MQTT协议支持自定义OTA模块功能。
模块列表的搜索项说明见下表:
搜索项 | 说明 |
---|---|
模块标识、名称 | 通过模块标识、名称进行模糊筛选 |
所属产品 | 只显示指定产品下的模块。当前仅支持MQTT产品 |
模块列表的字段说明见下表:
字段 | 说明 |
---|---|
模块标识 | 模块的唯一标识,产品下唯一 |
模块名称 | 模块的名称 |
所属产品 | 模块所属的产品名称 |
模块描述 | 对该模块的描述信息 |
创建时间 | 模块创建的时间。defalut默认模块在创建产品时同步创建。 |
操作 | 可操作项,包括编辑和删除。1、 编辑-可编辑模块名称和描述;2、 删除-删除模块(前提为该模块下无关联固件) |
固件列表
固件列表的搜索项说明见下表:
搜索项 | 说明 |
---|---|
固件名称 | 通过固件的名称片段进行模糊筛选 |
所属产品/模块 | 只显示指定产品/模块下的固件 |
固件列表的字段说明见下表:
字段 | 说明 |
---|---|
固件名称 | 固件的名称,模块下唯一 |
固件版本 | 固件的版本号,模块下唯一 |
所属产品 | 固件所属的产品名称 |
适配硬件版本 | 固件适配的硬件版本号 |
模块名称 | 固件所属OTA模块 |
创建时间 | 固件创建(上传)的时间 |
操作 | 可操作项,包括查看、批量升级和删除。1、 查看-查看固件详情;2、 批量升级-查看此固件的批量升级任务列表3、 删除-删除固件 |
添加模块
模块添加页信息如下:
字段 | 必填/选填 | 说明 |
---|---|---|
所属产品 | 必填 | 模块所属产品。当前仅支持MQTT产品 |
模块标识 | 必填 | 模块标识,产品下唯一。创建后不可修改,支持英文字母、数字、点、中划线和下划线,长度限制 1~64 个字符 |
模块名称 | 必填 | 支持中文、英文字母、数字、点、中划线和下划线,长度限制 1~64 个字符 |
模块描述 | 选填 | 对该模块的描述,限制 100个字内 |
固件上传
创建升级任务前,需要上传供升级的固件
登录物联网平台,通过顶部导航栏进入云平台,在左侧导航栏选择FOTA升级 > 固件列表,在固件列表页面单击添加固件,可在添加固件页面完成固件的上传。
固件上传需要填写的信息见下表:
填写项 | 必填/选填 | 说明 |
---|---|---|
固件名称 | 必填 | 固件的名称,模块下唯一,长度限制4~200个字符 |
所属产品/模块 | 必填 | 选择固件对应的产品升级模块 |
固件版本 | 必填 | 固件的版本号,支持英文字母、数字、点号(.)、中划线(-)和下划线(_),长度限制为1~64个字符 |
签名算法 | 必填 | 固件使用的签名算法,目前只支持MD5 |
上传固件 | 必填 | 上传固件包文件。文件大小不超过200MB,不限制文件格式,可直接上传固件源文件。(若上传.zip格式则需要设备端解压) |
适配硬件版本号 | 选填 | 设置该固件适配的硬件版本号,之后创建升级任务时可筛选指定硬件版本的设备,支持英文字母、数字、点号(.)、中划线(-)和下划线(_),长度限制为 1~64 个字符 |
固件描述 | 选填 | 对于该固件的描述,长度限制100个字符 |
上传固件成功之后,即可在固件列表页面看到刚刚上传的固件
批量升级任务列表
固件列表页面中找到要升级的固件,在操作一栏单击批量升级,即可进入批量升级列表页面
也可通过点击查看或固件名称,进入固件详情页面,然后点击批量升级进入批量升级列表页面
批量升级任务列表的搜索项说明见下表:
搜索项 | 说明 |
---|---|
升级任务ID | 通过升级任务ID模糊筛选 |
升级策略 | 只显示指定策略(静态升级、动态升级)的升级任务 |
升级状态 | 只显示指定状态(升级中、已完成、已取消)的升级任务 |
创建时间段 | 只显示指定时间段内创建的升级任务 |
批量升级任务列表的字段说明见下表:
字段 | 说明 |
---|---|
升级任务ID | 升级任务唯一ID |
升级策略 | 任务的升级策略(静态升级、动态升级) |
升级范围 | 升级任务的设备范围(指定设备、该产品下全部设备) |
任务状态 | 升级任务的状态(升级中、已完成、已取消)1、 升级中-该任务下有待推送、已推送和升级中的设备2、 已完成-该任务下无待推送、已推送和升级中的设备3、 已取消-批量取消了任务 |
创建时间 | 升级任务创建的时间 |
操作 | 升级任务的可操作项:1、 取消-取消升级任务(批量取消该任务下“待升级”的设备)2、 查看-查看任务详情 |
创建批量升级任务
在批量升级任务列表页面单击添加升级任务,即可进入创建升级任务页面
选择升级策略、升级范围、升级的时间、升级触发机制、失败重试规则、升级超时时间、是否覆盖已有任务,单机确定即可创建升级任务,创建后在批量升级任务列表页面查看刚创建的升级任务
创建批量升级任务需要填写的字段说明见下表:
字段 | 必填/选填 | 说明 |
---|---|---|
升级策略 | 必填 | 1、静态升级:仅升级目前满足升级条件的设备。2、动态升级:除了升级目前满足升级条件的设备外,还将持续升级后续满足升级条件的设备,包括:a.后续新激活的满足升级条件的设备。b.设备当前版本号不满足升级条件,后续上报了满足升级条件的版本号。【一个固件包下只能有一个动态升级任务,若要新建则需取消原有动态升级任务】 |
升级范围 | 必填 | 1、全部设备:升级该产品下所有满足升级条件的设备2、指定设备:静态升级策略下,可以指定升级设备,可以通过手动勾选或批量导入。 |
待升级版本号 | 选填 | 当升级范围为全部范围时需选择待升级的设备版本号,多选。 |
升级时间 | 必填 | 1、立即升级:任务创建后立即进行升级。2、定时升级:设置升级任务开始时间、结束时间;结束时间不填写则不会强制取消任务。【升级开始时间距当前时间最少5分钟,最多7天。升级结束时间距开始时间最少1小时,最多为30天。仅静态升级支持定时升级】 |
升级触发机制 | 必填 | 1、设备端:由设备端主动上报版本号触发升级。2、云端:由云端主动推送升级通知指令触发升级。 |
升级失败重试间隔 | 必填 | 可设置失败是否进行重试以及重试间隔。·重试上限:设置了失败重试后可设置重试次数。 |
升级超时时间 | 选填 | 选填,设置单设备升级超时时间,从设备回复已收到IOT平台推送的固件链接消息后计算升级时间,超过设置时间未上报升级结果则升级失败。时间区间为1-1440分钟,不填则默认超时时间为24小时。 |
是否覆盖设备已有升级任务 | 必填 | 一台设备只能同时存在一个正在进行的升级任务中(设备处于“待推送、已推送或升级中状态),选择是否进行覆盖:1、覆盖:设备将执行新的升级任务,旧的升级任务将被取消2、不覆盖:若设备存在未完成的旧任务则不会执行新任务 |
批量取消升级任务
在批量升级任务列表页面中找到需要取消的升级任务,从操作一栏中点击取消,即可取消批量升级任务
取消后,该任务状态会变为“已取消”
取消设备升级任务
在任务详情页面中找到需要取消的设备,从操作一栏中点击取消,即可取消该设备升级任务
取消后,操作栏的显示会变更为重新升级,通过点击重新升级即可重新启动批量升级任务
固件版本分布
在云平台的左侧导航栏选择FOTA升级 > 版本分布,即可查看当前账号下所有设备的固件版本分布和硬件版本分布情况。
页面上半部分是设备固件和硬件的整体分布环形图,下半部分则是设备固件版本列表。
设备固件版本列表页面的字段说明如下表:
字段 | 说明 |
---|---|
设备ID | 设备ID |
所属产品 | 设备所属的产品名称 |
模块名称 | 产品模块名称, 默认则为主模块 |
固件版本号 | 设备对应模块的固件版本号 |
硬件版本号 | 设备对应模块的硬件版本号 |
上报时间 | 设备固/硬件信息上报时间 |