EMS3.0/00. 预研阶段/wudun_EMS_MQTT/level-2-ems/ota-emu.md

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

• 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	2
download_status	int	是	下载状态 1-下发EMU升级成功 2-下载失败 3-MD5校验失败 4-删除文件夹内容失败 5-解压失败 6-下发EMU升级失败	1

• 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 %}