操作场景
本文档主要介绍 OTA 升级包升级在物联网开发平台的使用方法，帮助您快速使用升级包升级服务完成设备升级。
操作步骤
步骤1：添加模块
1. 登录 物联网开发平台控制台，进入公共实例。
2. 选择左侧导航售后运维 > OTA升级，进入模块列表页，可查看当前全部模块列表。
3. 单击新建模块添加新模块。
所属产品：必选，选择上传固件所属的产品。
模块类型：必填，在所属产品下新增模块类型，创建后不可修改。
模块名称：给模块类型定义一个名称，创建后不可修改。
模块描述：详细描述模块类型的具体信息。
步骤2：添加升级包
1. 选择左侧导航售后运维 > OTA升级，进入升级包列表页，可查看当前全部升级任务。
2. 单击添加升级包添加新升级包。
注意：
1. 一个账号下最多可上传100个升级包 ，若继续上传，则需要删除旧版本升级包。
2. 模块类型默认为 MCU模块，一个设备支持多个模块类型。若需要修改类型和名称，需删除该模块重新创建即可。
3. 上传完成后，升级包将显示在列表中，可对该升级包进行升级、增删查改、查看详情等操作。
步骤3：批量升级
升级包上传成功后，选择想要升级的升级包版本，单击升级包列表右侧的批量升级发起升级任务。升级包升级方式支持按静态升级和动态升级两种批量升级方式。
（可选）静态升级模式：按升级包版本号升级
1. 进入批量升级页，页面展示目标升级包的信息（例如升级包名称、所属产品、升级包版本号等）。
2. 选择批量升级方式为“按升级包版本”升级。
3. 单击保存后，系统将会执行升级任务，下发所选的目标版本升级包到升级范围内的目标设备中。
说明：
1. 按升级包版本升级需要待升级设备上报当前运行的升级包版本，如果未上传您可选择下文介绍的按设备名称升级。
2. 在升级范围内，若指定设备中无法搜索到该设备，需核查待升级设备的版本号是否满足升级任务。
（可选）静态升级模式：按设备名称升级
1. 进入批量升级页，页面展示目标升级包的信息（例如名称、所属产品、升级包版本号等）。
2. 选择批量升级方式为“按设备名称”升级。
3. 单击保存后，系统将会执行升级任务，下发升级包到目标设备中。
（可选）动态升级模式：按升级包版本升级
1. 进入批量升级页，页面展示目标升级包的信息（例如名称、所属产品、升级包版本号等）。
2. 选择批量升级模式为“动态升级”。
3. 单击保存后，系统将会执行升级任务，下发升级包到目标设备中。
参数 | 描述 |
升级包名称 | 支持中文、英文大小写、数字、部分常用符号（下划线，减号，括弧），必须以中文、英文或数字开头，长度不超过32个字符。 |
所属产品 | 选择上传升级包所属的产品。 |
模块类型 | |
升级包版本号 | 仅支持英文字母、数字、点、中划线和下划线，长度限制1 - 32字符。 |
升级模式 | 静态升级：指仅针对当前已经满足升级条件的设备进行升级操作。一旦升级开始，系统只会处理这些已满足条件的设备，对于后续新出现的满足升级条件的设备，不会自动纳入本次升级范围。 |
动态升级：不仅会对当前满足升级条件的设备进行升级，还会持续监控设备状态，对后续满足升级条件的设备也进行升级处理。 涵盖以下情况： 后续新激活的设备满足升级条件：若在动态升级开始后，有新设备被激活且其状态符合升级条件，系统会自动将该设备纳入升级范围并进行升级。 设备当前上报的升级包版本号不满足升级条件，后续上报了满足升级条件的升级包版本号：有些设备在动态升级开始时所上报的升级包版本号不符合升级要求，但在后续运行过程中，设备上报了满足升级条件的升级包版本号，此时系统也会对该设备进行升级操作。 | |
批量升级方式 | 按升级包版本：根据待升级设备当前模块中的版本号来进行批量升级。 |
按设备名称：根据设备名称来进行批量升级。 | |
待升级版本号 | 选择下拉框中的升级包版本号作为等待被升级的升级包，可多选。 |
升级范围 | 支持两种升级范围，可将待升级版本号下的全部设备或者指定设备作为升级包升级目标设备。 |
升级确认 | 支持静默升级、用户确认升级两种升级包升级确认方式： 静默升级：无需用户确认，平台自动下发任务至设备完成升级。 用户确认升级：需用户手动确认后平台再进行下发任务至设备完成升级，支持 云 API 升级确认。 |
延迟时间 | 升级包任务按照指定时分钟数来延迟任务下发，该功能只在静默升级中支持。 |
超时时长配置 | 当云端超过超时时长没有收到设备升级包升级消息时，则会重新下发升级包升级任务。静默升级超时时长默认为15分钟。用户确认升级超时时长默认为2分钟。您也可以根据业务实际需求自定义配置。 |
是否覆盖 | 当同个升级创建多个升级任务模式时，可根据实际情况来选择相同设备的任务是否进行覆盖。 |
重试间隔 | 当升级包任务下发任务失败后，可设置不同时间段的重试时间。 |
自定义信息 | 可选。创建升级任务后，自定义信息会在升级通知中发送至设备。通过 JSON 字符串（UTF-8）形式下发到设备，总大小不能超过1024字节，当前序列化后的大小为0。 |
步骤4：查看升级包详情
1. 在升级包列表右侧点击查看按钮进入升级包详情。
2. 进入升级包详情页，可查看该升级包任务的详细信息、升级包升级设备统计和升级任务管理列表。
升级包信息：包括升级包名称、所属产品、升级包版本号、升级包签名、签名算法、添加时间与升级包描述等。点击右上角的编辑按钮，可修改升级包名称与描述。
升级包升级设备统计：包括对该升级包全部批量升级任务中的设备总数，以及不同升级状态的升级包升级任务对应的设备数量。
任务管理列表：
单击任务明细，可查看该升级包的全部升级任务。升级任务的任务状态包含4种：待升级、升级中、任务成功、任务失败。
单击设备明细，可查看该升级包关联的所有升级任务中设备升级的记录明细。设备升级状态包含6种：待推送、已推送、升级中、等待用户确认、升级成功和升级失败。
3. 在任务管理的任务明细，单击某次任务右侧的查看详情，进入任务详情页，可以查看此次任务升级的设备清单、升级状态以及不同升级状态的设备数量统计。
4. 在设备详情列表，可查看该任务批量升级的所有设备当前的升级状态和状态详情。
另外，在设备详情列表右侧，可以根据升级进度进行设备升级的取消、重试操作。取消升级的设备升级状态将标记为升级失败；升级失败的设备可单击重试进行重新升级。
升级任务阶段 | 升级状态 | 状态详情 |
待确认 | 等待用户确认 | - |
待推送 | 待推送 | - |
| 设备离线 | - |
已推送 | 已推送 | - |
升级中 | 升级中 | 烧录中，显示百分比进度 |
| 下载中 | 下载中，显示百分比进度 |
| 更新中 | - |
升级成功 | 升级成功 | - |
升级失败 | 设备离线 | resultCode：0下载成功，-1下载超时，-2文件不存在，-3签名过期，-4MD5不匹配，-5更新固件失败 |
| 设备离线 | - |
已取消 | 取消升级 | - |
相关API能力
确认固件升级任务
修改OTA模块
删除OTA模块
新建OTA模块
批量升级固件
