# OTA升级功能使用说明文档

# 1 创建OTA升级任务

# 1.1 添加OTA升级包

（1）选择“监控运维”模块下的OTA升级功能，点击按钮添加升级包

ota_1.1_1

（2）输入升级包名称，填写升级包版本号，版本号目前只支持两位小数类型，选择升级包所属的产品类型，点击“选取文件”进行OTA升级包上传，最后点击确认按钮，完成OTA升级包的添加

ota_1.1_2

（3）OTA升级包成功添加

ota_1.1_3

# 1.2 添加OTA升级任务

（1）选择需要进行升级的OTA包，点击“OTA升级”按钮

ota_1.2_1

（2）可选择不同的任务升级方式

  • 按固件版本：可选择同产品下，OTA升级包版本小于当前升级包版本，对所有设备或者指定设备进行升级

ota_1.2_2

  • 按设备名称：手动选择升级包所属产品下的设备

ota_1.2_3

（3）指定升级时间

ota_1.2_4

（4）点击保存，成功创建升级任务

# 1.3 查看升级任务详情

（1）点击查看升级任务详情

ota_1.3_1

（2）查看任务列表和设备升级列表

ota_1.3_2

ota_1.3_3

# 1.4 OTA升级信息下发设备

（1）设备订阅OTA升级信息下发的topic：/{productId}/{serialNumber}/upgrade/get，在设备详情的topic列表查看

ota_1.4_1

（2）到达预定时间，平台通过MQTT通过指定topic将升级包信息及下载地址发送到设备

[
  {
    "id": "productId",
    "remark": "",
    "value": "250"
  },
  {
    "id": "deviceName",
    "remark": "",
    "value": "服务端消息设备"
  },
  {
    "id": "serialNumber",
    "remark": "",
    "value": "D1798333207855521792O***349NX1"
  },
  {
    "id": "firmwareName",
    "remark": "",
    "value": "OTA测试升级包"
  },
  {
    "id": "firmwareVersion",
    "remark": "",
    "value": "1.1"
  },
  {
    "id": "messageId",
    "remark": "",
    "value": "606183069153505***"
  },
  {
    "id": "otaId",
    "remark": "",
    "value": "23"
  },
  {
    "id": "taskId",
    "remark": "",
    "value": "53"
  },
  {
    "id": "otaUrl",
    "remark": "",
    "value": "https://aliiot.oss-cn-hangzhou.aliyuncs.com/profile/uploadPath/ota/17983*32078**5217*3/2024/07/30/001_20240730152620A004.zip"
  }
]

（3）对应设备的升级情况发生改变，升级信息已发送设备

ota_1.4_2

# 2 设备返回OTA升级情况

# 2.1 设备OTA升级回复说明

[
 {
  "id": "messageId",
  "value": "606183069153505***"
 },{
  "id": "code",
  "value": "3"
 },{
  "id": "version",
  "value": "1.1"
 }
]
code 描述
2 设备OTA升级中
3 升级成功
4 升级失败

（2）OTA回复topic：/{productId}/{serialNumber}/upgrade/reply，在设备详情页面，topic列表中查看

ota_2.1_1

# 2.2 设备升级成功回复

（1）设备使用指定格式向设备的OTA回复topic发送MQTT消息

ota_2.2_1

（2）查看平台升级任务详情

ota_2.2_2

← 自定义topic →