[未上线]OTA-EMU

EMUOTA

请求EMU版本信息

• Topic： ${自定义前缀v1}/${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：${自定义前缀v1}/${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：${自定义前缀v1}/${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	是	下载链接	http://example.com/ems_II
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：${自定义前缀v1}/${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：${自定义前缀v1}/${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：${自定义前缀v1}/${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"
    },
}