物联网开发平台 OTA 升级包

一、前提条件

·已有可使用的实例，可参见 实例管理。

·已接入设备。

二、步骤1：添加模块

1. 登录 物联网开发平台控制台，单击目标实例卡片。

2. 在左侧导航栏选择售后运维 > OTA升级，默认进入升级包列表页面。

3. 单击切换至模块列表页面，然后单击新建模块。

·所属产品：必选，选择上传固件所属的产品。

·模块类型：必填，在所属产品下新增模块类型，创建后不可修改。

·模块名称：选填，给模块类型定义一个名称。

·模块描述：选填，详细描述模块类型的具体信息。

三、步骤2：添加升级包

1. 进入实例详情页后，在左侧导航栏选择售后运维 > OTA升级，进入升级包列表页面。

2. 单击添加升级包，填写相关信息。

3. 提交上传完成后，升级包将显示在列表中，你可对该升级包进行升级、删除、查看详情等操作。

四、步骤3：批量升级

升级包上传成功后，选择想要升级的升级包版本，单击升级包列表右侧的批量升级发起升级任务。升级包升级模式支持按静态升级和动态升级。

静态升级模式动态升级模式

五、按升级包版本升级

1. 进入批量升级页，页面展示目标升级包的信息（例如升级包名称、所属产品、升级包版本号等）。

2. 选择批量升级模式为“按升级包版本”，然后配置其他信息，具体字段说明参见 下表。

注意：说明：

3. 单击保存后，系统将会执行升级任务，下发所选的目标版本升级包到升级范围内的目标设备中。

六、按设备名称升级

1. 进入批量升级页，页面展示目标升级包的信息（例如名称、所属产品、升级包版本号等）。

2. 选择批量升级模式为“按设备名称”，然后配置其他信息，具体字段说明参见 下表。

3. 单击保存后，系统将会执行升级任务，下发升级包到目标设备中。

七、按升级包版本升级

1. 进入批量升级页，页面展示目标升级包的信息（例如名称、所属产品、升级包版本号等）。

2. 选择批量升级模式为“动态升级”，然后配置其他信息，具体字段说明参见 下表。

3. 单击保存后，系统将会执行升级任务，下发升级包到目标设备中。

字段说明如下：

八、步骤4：查看升级包详情

1. 在升级包列表中，单击操作列中的查看进入升级包详情。

2. 在升级包详情页，可查看该升级包的详细信息、升级包升级设备统计和升级任务管理列表。

·升级包信息：包括升级包名称、所属产品、升级包版本号、升级包签名、签名算法、添加时间与升级包描述等。单击右上角的编辑，可修改升级包名称与描述。

·升级包升级设备统计：包括对该升级包全部批量升级任务中的设备总数，以及不同升级状态的升级包升级任务对应的设备数量。

·任务管理列表：

·单击任务明细，可查看该升级包的全部升级任务。升级任务的任务状态包含：待升级、升级中、任务成功和任务失败。

·单击设备明细，可查看该升级包关联的所有升级任务中设备升级的记录明细。设备升级状态包含：待推送、已推送、升级中、等待用户确认、升级成功和升级失败。

3. 在任务管理的任务明细，单击某次任务右侧的查看详情，进入任务详情页，可以查看此次任务升级的设备清单、升级状态以及不同升级状态的设备数量统计。

·在设备详情列表，可查看该任务批量升级的所有设备当前的升级状态和状态详情。

·在设备详情列表右侧，可以根据升级进度进行设备升级的取消、重试操作。取消升级的设备升级状态将标记为升级失败。升级失败的设备可单击重试进行重新升级。不同升级任务阶段对应状态说明如下表：

九、相关 API 能力

·查询设备可升级固件版本

·查询设备固件升级状态

·确认固件升级任务

·修改 OTA 模块

·删除 OTA 模块

·新建 OTA 模块

·获取产品 OTA 模块列表

·获取 OTA 模块列表

·批量升级固件