18 KiB

Raw Blame History

description
EMUOTA

[未上线]OTA-EMU

请求EMU版本信息

Topic：
- 用户自定义MQTT： v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_version/command
- 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/ota/emu_version/command
权限：发布

Payload主结构

参数	类型	是否必填	描述	范围	样例
mid	UUID	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_version	emu_version
data	data	true	消息内容	-	见Payload - data
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

Payload - data 无
Payload示例

{% code lineNumbers="true" %}

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

{% endcode %}

EMU版本信息响应

Topic：
- 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/ota/emu_version/result
- 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/ota/emu_version/result
**权限：**订阅
Payload主结构

参数	类型	是否必填	描述	范围	样例
mid	UUID	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_version	emu_version
data	data	true	消息内容	-	见Payload - data
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

**Payload - data []**EMUVersion
EMUVersion

参数	类型	是否必填	描述	样例
device_id	int	是	升级设备ID	2
status	int	是	设备状态 1-运行 2-离线 3-故障	1
emu_upgrade_success	int	否	EMU升级成功 0-有错误 1-全部升级成功	1
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": 1,
        "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": 1,
        "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	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_upgrade	emu_upgrade
data	data	true	消息内容	-	见Payload - data
sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段	-	2
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

Payload - data

参数	类型	是否必填	描述	样例
download_url	string	是	下载链接	http://example.com/ems_II
md5_code	string	是	MD5码	50a2811e047dd49ace3801685eedb732

参数

类型

是否必填

描述

样例

download_url

string

是

下载链接

http://example.com/ems_II

md5_code

string

是

MD5码

50a2811e047dd49ace3801685eedb732

Payload示例

{% code lineNumbers="true" %}

{
  "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",
  }
}

{% endcode %}

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	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_upgrade	emu_upgrade
data	data	true	消息内容	-	见Payload - data
sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段	-	2
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

Payload - data

参数

类型

是否必填

描述

样例

device_id

int

是

升级设备ID

download_status

int

是

下载状态

1-下发EMU升级成功

2-下载失败

3-MD5校验失败

4-删除文件夹内容失败

5-解压失败

6-下发EMU升级失败

Payload示例

{% code lineNumbers="true" %}

{
    "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,
    },
}

{% endcode %}

请求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	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_upgrade_result	emu_upgrade_result
data	data	true	消息内容	-	见Payload - data
sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段	-	2
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

Payload - data 无
Payload示例

{% code lineNumbers="true" %}

{
  "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,
}

{% endcode %}

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	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
type	str	true	消息类型	emu_upgrade_result	emu_upgrade_result
data	data	true	消息内容	-	见Payload - data
sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段	-	2
device_uid	str	true	设备UID	-	iYRkfVpi77
timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

Payload - data

参数	类型	是否必填	描述	样例
device_id	int	是	升级设备ID	2
status	int	是	设备状态 1-运行 2-离线 3-故障	1
emu_upgrade_success	int	否	EMU升级成功 0-有错误 1-全部升级成功	1
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示例

{% code lineNumbers="true" %}

{
    "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": 1,
        "emu_upgrade_device": 3,
        "emu_upgrade_status": 5,
        "emu_upgrade_content": 100,
        "emu_product_sn": "emu-v1.0.0"
    },
}

{% endcode %}

18 KiB Raw Blame History Unescape Escape

[未上线]OTA-EMU

请求EMU版本信息

EMU版本信息响应

下发OTA-EMU升级命令

OTA-EMU升级命令响应

请求OTA-EMU升级结果

OTA-EMU升级结果响应

18 KiB

Raw Blame History