在鸿云文档Appearance
OTA升级
平台提供OTA升级与管理服务，使用该服务首先要确保设备端支持OTA服务，然后在平台控制台的OTA升级页面，上传新的升级包并指定需要升级的设备。平台推送OTA升级消息给设备，设备即可下载OTA升级包，并进行OTA升级。本文主要介绍OTA升级页面的操作流程。 具体协议请看：OTA升级协议
升级任务列表
登录设备管理平台控制台后，鼠标点击左侧菜单->OTA升级->升级任务，显示OTA升级任务列表如下图。
列表参数说明
参数 | 描述 |
|---|---|
| 任务名称 | OTA升级任务名称。 |
| 升级设备 | 指定设备：选择指定设备分组下的设备进行升级。 指定渠道：根据设备归属的渠道进行升级。 全量升级： 满足条件的全量设备进行升级。 |
| 升级类型 | 整包升级：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。 差分升级：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。 |
| 所属产品 | 升级任务对应的产品。 |
| 升级成功数 | 任务升级成功的设备数。 |
| 创建时间 | 任务创建时间。 |
| 任务状态 | 任务的状态。 未开始：任务未开启状态。 开启：任务已开启状态。 暂停：任务已暂停状态。 已结束：任务已结束状态。 |
创建升级任务
在升级任务列表中，单击创建升级任务，进入创建升级任务页面。 如下图。
参数 | 描述 |
|---|---|
| 任务名称 | OTA升级任务名称。 |
| 所属产品 | 升级任务对应的产品。 |
| 选择模块 | 选择产品对应的升级包模块。 |
| 任务备注 | 任务的备注信息。 |
| 升级类型 | 整包升级：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。 差分升级：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。 |
| 可选/强制 | 可选升级：提示设备有新版本可以升级，可选择升级或不升级。 强制升级：提示设备有新版本可以升级，必须升级后才能正常使用。 |
| 升级目标版本 | 选择升级目标版本。 |
| 升级设备 | 指定设备：选择指定设备分组下的设备进行升级。 指定渠道：根据设备归属的渠道进行升级。 全量升级： 满足条件的全量设备进行升级。 |
| 前置条件 | 设备在满足升级前置条件时，平台才会下发升级包。 |
| 模块 | 选择产品对应的升级包模块。 |
| 规则 | 条件规则。 =：相等。 <>：不相等。 >：大于。 <：小于。 >=：大于等于。 <=：小于等于。 BETWEEN：在什么区间。 LIKE：模糊比较。 |
| 条件 | 规则比较的条件。 |
| 升级方式 | 提示升级：提示设备有新版本可以升级，需要确认才会下发升级包。 |
| 设备执行时间 | 指定设备升级的时间段。 |
| 升级文案 | 设备升级时提示的方案。 |
升级任务详情
在升级任务列表中，单击某个任务的详情，进入任务详情页面。 如下图。
任务详情说明
参数 | 描述 |
|---|---|
| 任务名称 | OTA升级任务名称。 |
| 任务ID | OTA升级任务ID。 |
| 所属产品 | 升级任务对应的产品。 |
| 升级类型 | 整包升级：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。 差分升级：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。 |
| 升级目标版本 | 指定升级目标版本。 |
| 升级设备 | 指定设备：选择指定设备分组下的设备进行升级。 指定渠道：根据设备归属的渠道进行升级。 全量升级： 满足条件的全量设备进行升级。 |
| 升级方式 | 提示升级：提示设备有新版本可以升级，需要确认才会下发升级包。 |
| 升级时间 | 指定设备升级的时间段。 |
| 创建时间 | 任务创建时间。 |
| 任务状态 | 任务的状态。 未开始：任务未开启状态。 开启：任务已开启状态。 暂停：任务已暂停状态。 已结束：任务已结束状态。 |
| 任务备注 | 任务的备注信息。 |
| 升级文案 | 设备升级时提示的方案。 |
升级数据说明
参数 | 描述 |
|---|---|
| 激活设备数 | 已激活的设备数。 |
| 计划升级数 | 任务计划升级的设备数。 |
| 下发升级数 | 已下发升级任务的设备数。 |
| 升级成功数 | 已成功升级的设备数。 |
| 升级失败数 | 累计升级失败的次数。由于设备升级失败后会重试， 所以失败的数量可能会比设备的数量多 |
升级详情说明
升级详情列表，列出需要升级的设备。
参数 | 描述 |
|---|---|
| DeviceName | 设备名称。 |
| 最新下发时间 | 任务的最新下发时间。 |
| 当前版本号 | 设备的当前版本号。 |
| 当前升级状态 | 当前设备的升级状态 未开始：设备未开始升级。 升级中：设备处于升级中。 升级成功：设备成功升级。 升级失败：设备升级失败。 |
| 日志 | 查看设备升级日志。 |
| 查看 | 点击查看，可以查看指定设备上报的升级日志。 |
| 下发 | 点击下发，可以给设备下发升级任务信息。 |
| 添加指定设备 | 点击添加指定设备，可以添加指定设备到升级任务里。 |
| 全量升级 | 点击全量升级，可以把列表中未升级的设备，批量下发升级任务。 |
开启升级任务
在升级任务列表中，单击某个升级任务后面的开启操作，点击右侧->开启，弹出开启升级任务提示框。如下图。
- 点击->确定，开户升级任务。
- 点击->取消，取消开启升级任务操作。
暂停升级任务
在升级任务列表中，单击某个升级任务后面的暂停操作，点击右侧->暂停，弹出暂停升级任务提示框。如下图。
- 点击->确定，暂停升级任务。
- 点击->取消，取消暂停升级任务操作。
继续升级任务
在升级任务列表中，单击某个升级任务后面的继续操作，点击右侧->继续，弹出继续升级任务提示框。如下图。
- 点击->确定，继续开启升级任务。
- 点击->取消，取消继续开启升级任务操作。
结束升级任务
在升级任务列表中，单击某个升级任务后面的结束操作，点击右侧->结束，弹出结束升级任务提示框。如下图。
- 点击->确定，结束升级任务，结束后不能在开启。
- 点击->取消，取消结束升级任务的操作。