# 信息-EMU设备 ## 上报设备信息 * **Topic:** * 用户自定义MQTT: `v1/wudun/${PRODUCT_KEY}/${DEVICE}/``device_info/details``/post` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``device_info/details``/post` * **权限:**订阅 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型device_info_detailsdevice_info_details
datadatatrue消息内容-Payload - data
sub_device_uidstrtrue一级设备UID,仅二级替一级设备上报时需要该字段-jHODSda39
sub_device_idinttrue一级设备ID,仅二级替一级设备上报时需要该字段(0, ∞)2
device_uidstrtrue(二级)设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **Payload - data**
参数类型是否必填描述范围样例
idinttrue设备ID-1
namestrtrue设备名称-ems设备
site_namestrtrue站点名称-ems站点
locationstrtrue详细地理位置-wudun
longitudefloattrue经度-
latitudefloattrue纬度
levelinttrueEMS等级[1, 2]1
typestrtrue设备类型-ems
running_statusinttrue

运行状态

1-运行

2-离线

3-故障

[1,2,3]1
hoststrtrue地址-192.168.0.1
portstrtrue端口[0,65525]2171
licensestrtrue激活码-2YIZedmOtl4pcqo1EA4zhM5gofDI
* **Payload示例**
{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "device_info_details",
  "data": {
      "id": 1,
      "name": "右206",
      "site_name": "测试站点",
      "location": "",
      "longitude": 0,
      "latitude": 0,
      "statistics_port": 1504,
      "level": 1,
      "type": "ems",
      "running_status": 1,
      "host": "192.168.77.206",
      "port": 1502,
      "license": "2YIZedmOtl4pcqo1EA4zhM5gofDI",
  },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "sub_device_id": 2,
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}
## 平台请求同步设备信息 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``device_info/sync``/command` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``device_info/sync``/command` * **权限:**发布 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型device_info_syncdevice_info_sync
datadatatrue消息内容-Payload - data
sub_device_uidstrtrue一级设备UID,仅二级替一级设备上报时需要该字段-jHODSda39
device_uidstrtrue(二级)设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **响应代码**
错误码描述说明
200下发成功
400参数有误
* **Payload示例** ```json { "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152", "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9", "type": "device_info_sync", "sub_device_uid": "${SUB_DEVICE_UID}", "device_uid": "${DEVICE_UID}", "timestamp": 1695265671000 } ``` ### 同步设备信息响应 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``device_info/sync``/result` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``device_info/sync``/result` * **权限:**订阅 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
replyUUIDtrue所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型device_info_syncdevice_info_sync
datadatatrue消息内容-Payload - data
codeinttrue响应代码-见响应代码
msgstrtrue失败原因-参数错误
sub_device_uidstrtrue一级设备UID,仅二级替一级设备上报时需要该字段-jHODSda39
device_uidstrtrue设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **Payload - data**
参数类型是否必填描述范围样例
idinttrue设备ID-1
namestrtrue设备名称-ems设备
site_namestrtrue站点名称-ems站点
locationstrtrue详细地理位置-wudun
longitudefloattrue经度-
latitudefloattrue纬度-
levelinttrueEMS等级[1, 2]1
typestrtrue设备类型-ems
running_statusinttrue

运行状态

1-运行

2-离线

3-故障

[1,2,3]1
hoststrtrue地址-192.168.0.1
portstrtrue端口[0,65525]2171
licensestrtrue激活码-2YIZedmOtl4pcqo1EA4zhM5gofDI
* **Payload示例**
{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
  "type": "device_info_sync",
  "data": {
      "id": 1,
      "name": "右206",
      "site_name": "测试站点",
      "location": "",
      "longitude": 0,
      "latitude": 0,
      "statistics_port": 1504,
      "level": 1,
      "type": "ems",
      "running_status": 1,
      "host": "192.168.77.206",
      "port": 1502,
      "license": "2YIZedmOtl4pcqo1EA4zhM5gofDI",
  },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}
## 平台请求同步设备信息列表 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``device_info/list``/command` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``device_info/list``/command` * **权限:**发布 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型device_info_listdevice_info_list
device_uidstrtrue(二级)设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **响应代码**
错误码描述说明
200下发成功
400参数有误
* **Payload示例** ```json { "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152", "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9", "type": "device_info_list", "code": 200, "msg": "", "sub_device_uid": "${SUB_DEVICE_UID}", "device_uid": "${DEVICE_UID}", "timestamp": 1695265671000 } ``` ### 同步设备信息响应 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``device_info/list``/result` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``device_info/list``/result` * **权限:**订阅 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
replyUUIDtrue所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型device_info_listdevice_info_list
datadatatrue消息内容-Payload - data
codeinttrue响应代码-见响应代码
msgstrtrue失败原因-参数错误
device_uidstrtrue设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **Payload - data**
参数类型是否必填描述范围样例
idinttrue设备ID-1
namestrtrue设备名称-ems设备
site_namestrtrue站点名称-ems站点
locationstrtrue详细地理位置-wudun
longitudefloattrue经度-
latitudefloattrue纬度-
levelinttrueEMS等级[1, 2]1
typestrtrue设备类型-ems
running_statusinttrue

运行状态

1-运行

2-离线

3-故障

[1,2,3]1
hoststrtrue地址-192.168.0.1
portstrtrue端口[0,65525]2171
licensestrtrue激活码-2YIZedmOtl4pcqo1EA4zhM5gofDI
* **Payload示例**
{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
  "type": "device_info_list",
  "data": [{
      "id": 1,
      "name": "右206",
      "site_name": "测试站点",
      "location": "",
      "longitude": 0,
      "latitude": 0,
      "statistics_port": 1504,
      "level": 1,
      "type": "ems",
      "running_status": 1,
      "host": "192.168.77.206",
      "port": 1502,
      "license": "2YIZedmOtl4pcqo1EA4zhM5gofDI",
  }],
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}