设备上报OTA模块版本

数据上行

/ota/device/inform/${productKey}/${deviceName}

  1. {
  2.     "id": "123",
  3.     "params": {
  4.         "version": "1.0.1",
  5.         "module": "MCU"
  6.     }
  7. }

参数说明

参数 类型 说明
id String 消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version String OTA模块版本。
module String OTA模块名。

物联网平台推送OTA升级包信息

数据下行

/ota/device/upgrade/${productKey}/${deviceName}

单个文件的OTA升级包信息

物联网平台通过这个Topic推送OTA升级包信息， 设备订阅该Topic可以获得升级包信息。

  1. {
  2.     "code": "1000",
  3.     "data": {
  4.         "size": 432945,
  5.         "version": "2.0.0",
  6.         "url": "https://***/nop***.tar.gz?Expires=1502955804&OSSAccessKeyId=***&Signature=XfgJu7P6DW***qAKU%3D&security-token=***Tz2IHtIf3***",
  7.         "md5": "93230c3bde425a9d***",
  8.         "module": "MCU"
  9.     },
  10.     "id": 1626969597470,
  11.     "message": "success"
  12. }
参数 类型 说明
code String 状态码。
size Long 升级包文件大小，单位：字节。
OTA升级包中仅有一个升级包文件时，包含该参数
version String 设备升级包的版本信息
url String 升级包在对象存储（OSS）上的存储地址。OTA升级包中仅有一个升级包文件，且下载协议为HTTPS时，包含该参数。
md5 String 当签名方法为MD5时，除了会给sign赋值外还会给md5赋值。
OTA升级包中仅有一个升级包文件时，包含该参数。
sign String 升级包签名。
OTA升级包中仅有一个升级包文件时，包含该参数。
id Long 消息ID号。每个消息ID在当前设备中具有唯一性。
message String 结果信息。

设备上报升级进度

数据上行

/ota/device/progress/${productKey}/${deviceName}

OTA升级过程中，设备可以通过这个Topic上报OTA升级的进度百分比。

  1. {
  2.     "id": "123",
  3.     "params": {
  4.         "step": "-1",
  5.         "desc": "OTA升级失败，请求不到升级包信息。",
  6.         "module": "MCU"
  7.     }
  8. }
参数 类型 说明
id String 消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
step String OTA升级进度。
取值范围：
- 1~100的整数：升级进度百分比。
- -1：升级失败。
- -2：下载失败。
- -3：校验失败。
- -4：烧写失败。
desc String 当前步骤的描述信息，长度不超过128个字符。如果发生异常，此字段可承载错误信息。
module String 升级包所属的模块名

设备请求OTA升级包信息

设备主动请求升级， 暂定