[未上线]OTA-EMU

EMUOTA

请求EMU版本信息

  • Topic:

    • 用户自定义MQTT: v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_version/command

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_version/command

  • 权限:发布

  • Payload主结构

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    UUID

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    emu_version

    emu_version

    data

    data

    消息内容

    -

    Payload - data

    device_uid

    str

    设备UID

    -

    iYRkfVpi77

    timestamp

    int

    消息时间戳(单位:毫秒)

    (0, ∞)

    1696837112000

  • Payload - data 无

  • Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-06hjkgfg2",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "emu_version",
  "device_uid": "test",
  "timestamp": 1697789021000
}

EMU版本信息响应

  • Topic:

    • 用户自定义MQTT:v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_version/result

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_version/result

  • 权限:订阅

  • Payload主结构

参数
类型
是否必填
描述
范围
样例

mid

UUID

消息ID

-

3e681859-6917-4b9a-9afd-3f162cd185bd

type

str

消息类型

emu_version

emu_version

data

data

消息内容

-

Payload - data

device_uid

str

设备UID

-

iYRkfVpi77

timestamp

int

消息时间戳(单位:毫秒)

(0, ∞)

1696837112000

  • Payload - data []EMUVersion

  • EMUVersion

参数
类型
是否必填
描述
样例

device_id

int

升级设备ID

2

status

int

设备状态

1-运行

2-离线

3-故障

1

emu_upgrade_success

int

EMU升级成功

Bit0:传输结束

Bit1:板卡1成功

Bit2:板卡2成功

Bit3:板卡3成功

Bit4:板卡4成功

Bit5:板卡5成功

Bit6:板卡6成功

Bit7:emu成功

Bit8:全部升级成功

bit9:升级未完成

512

emu_upgrade_device

int

EMU升级设备

3:EMU

21:通讯板卡1

22:通讯板2

23:通讯板3

24:通讯板4

25:通讯板5

26:通讯板6

3

emu_upgrade_status

int

EMU升级状态

1:升级准备

2:传输准备

3:传输状态

4:校验状态

5:完成状态

5

emu_upgrade_content

int

升级内容 传输状态:对应文件传输进度

100

emu_product_sn

string

EMU产品SN码

emu-v1.0.0

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-011789wfg2",
    "mid": "389d9ac9-c660-4459-b9d5-f43160183552",
    "type": "emu_version",
    "device_uid": "test",
    "timestamp": 1725615497191,
    "data": [{
        "device_id": 2,
        "status": 1,
        "emu_upgrade_success": 512,
        "emu_upgrade_device": 3,
        "emu_upgrade_status": 5,
        "emu_upgrade_content": 100,
        "emu_product_sn": "emu-v1.0.0"   
    },
    {
        "device_id": 3,
        "status": 1,
        "emu_upgrade_success": 512,
        "emu_upgrade_device": 3,
        "emu_upgrade_status": 5,
        "emu_upgrade_content": 100,
        "emu_product_sn": "emu-v1.0.0"
    },
    {
        "device_id": 4,
        "status": 2,
        "emu_upgrade_success": null,
        "emu_upgrade_device": null,
        "emu_upgrade_status": null,
        "emu_upgrade_content": null,
        "emu_product_sn": ""
    }]
}

下发OTA-EMU升级命令

  • Topic:

    • 用户自定义MQTT: v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_upgrade/command

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_upgrade/command

  • 权限:发布

  • Payload主结构

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    UUID

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    emu_upgrade

    emu_upgrade

    data

    data

    消息内容

    -

    Payload - data

    sub_device_id

    int

    一级设备ID,仅二级替一级设备上报时需要该字段

    -

    2

    device_uid

    str

    设备UID

    -

    iYRkfVpi77

    timestamp

    int

    消息时间戳(单位:毫秒)

    (0, ∞)

    1696837112000

  • Payload - data

参数
类型
是否必填
描述
样例

download_url

string

下载链接

md5_code

string

MD5码

50a2811e047dd49ace3801685eedb732

  • Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-06hjkgfg2",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "emu_upgrade",
  "device_uid": "test",
  "sub_device_id": 2,
  "timestamp": 1697789021000,
  "data":{
    "download_url": "http://example.com/ems_II",
    "md5_code": "50a2811e047dd49ace3801685eedb732",
  }
}

OTA-EMU升级命令响应

  • Topic:

    • 用户自定义MQTT:v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_upgrade/result

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_upgrade/result

  • 权限:订阅

  • Payload主结构

参数
类型
是否必填
描述
范围
样例

mid

UUID

消息ID

-

3e681859-6917-4b9a-9afd-3f162cd185bd

type

str

消息类型

emu_upgrade

emu_upgrade

data

data

消息内容

-

Payload - data

sub_device_id

int

一级设备ID,仅二级替一级设备上报时需要该字段

-

2

device_uid

str

设备UID

-

iYRkfVpi77

timestamp

int

消息时间戳(单位:毫秒)

(0, ∞)

1696837112000

  • Payload - data

参数
类型
是否必填
描述
样例

device_id

int

升级设备ID

2

download_status

int

下载状态

1-下发EMU升级成功

2-下载失败

3-MD5校验失败

4-删除文件夹内容失败

5-解压失败

6-下发EMU升级失败

1

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-011789wfg2",
    "mid": "389d9ac9-c660-4459-b9d5-f43160183552",
    "type": "emu_upgrade",
    "device_uid": "test",
    "sub_device_id": 2,
    "timestamp": 1725615497191,
    "data": {
        "device_id": 2,
        "download_status": 1,
    },
}

请求OTA-EMU升级结果

  • Topic:

    • 用户自定义MQTT: v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_upgrade_result/command

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_upgrade_result/command

  • 权限:发布

  • Payload主结构

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    UUID

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    emu_upgrade_result

    emu_upgrade_result

    data

    data

    消息内容

    -

    Payload - data

    sub_device_id

    int

    一级设备ID,仅二级替一级设备上报时需要该字段

    -

    2

    device_uid

    str

    设备UID

    -

    iYRkfVpi77

    timestamp

    int

    消息时间戳(单位:毫秒)

    (0, ∞)

    1696837112000

  • Payload - data 无

  • Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-06hjkgfg2",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "emu_upgrade_result",
  "device_uid": "test",
  "sub_device_id": 2,
  "timestamp": 1697789021000,
}

OTA-EMU升级结果响应

  • Topic:

    • 用户自定义MQTT:v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_upgrade_result/result

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/ota/emu_upgrade_result/result

  • 权限:订阅

  • Payload主结构

参数
类型
是否必填
描述
范围
样例

mid

UUID

消息ID

-

3e681859-6917-4b9a-9afd-3f162cd185bd

type

str

消息类型

emu_upgrade_result

emu_upgrade_result

data

data

消息内容

-

Payload - data

sub_device_id

int

一级设备ID,仅二级替一级设备上报时需要该字段

-

2

device_uid

str

设备UID

-

iYRkfVpi77

timestamp

int

消息时间戳(单位:毫秒)

(0, ∞)

1696837112000

  • Payload - data

参数
类型
是否必填
描述
样例

device_id

int

升级设备ID

2

status

int

设备状态

1-运行

2-离线

3-故障

1

emu_upgrade_success

int

EMU升级成功

Bit0:传输结束

Bit1:板卡1成功

Bit2:板卡2成功

Bit3:板卡3成功

Bit4:板卡4成功

Bit5:板卡5成功

Bit6:板卡6成功

Bit7:emu成功

Bit8:全部升级成功

bit9:升级未完成

512

emu_upgrade_device

int

EMU升级设备

3:EMU

21:通讯板卡1

22:通讯板2

23:通讯板3

24:通讯板4

25:通讯板5

26:通讯板6

3

emu_upgrade_status

int

EMU升级状态

1:升级准备

2:传输准备

3:传输状态

4:校验状态

5:完成状态

5

emu_upgrade_content

int

升级内容 传输状态:对应文件传输进度

100

emu_product_sn

string

EMU产品SN码

emu-v1.0.0

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-011789wfg2",
    "mid": "389d9ac9-c660-4459-b9d5-f43160183552",
    "type": "emu_upgrade_result",
    "device_uid": "test",
    "sub_device_id": 2,
    "timestamp": 1725615497191,
    "data": {
        "device_id": 2,
        "status": 1,
        "emu_upgrade_success": 512,
        "emu_upgrade_device": 3,
        "emu_upgrade_status": 5,
        "emu_upgrade_content": 100,
        "emu_product_sn": "emu-v1.0.0"
    },
}

最后更新于