# 配置-支路设计 ## 上报支路设计 * **Topic:** * 用户自定义MQTT: `v1/wudun/${PRODUCT_KEY}/${DEVICE}/``power_node/list``/post` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``power_node/list``/post` * **权限:**订阅 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型power_node_listpower_node_list
datadatatrue消息内容-Payload - data
device_uidstrtrue(二级)设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **Payload - data**
参数类型是否必填描述样例
idinttrueID-1
namestrtrue支路名称-电表1
typeinttrue设备类型 1-电表设备 2-EMS设备[1,2]1
deviceeleMeter/emsDevicetrue设备详情--
parent_idinttrue父节点ID-0
pathstrtrue路径--0-
running_statusinttrue运行状态 1-运行 2-离线 3-故障[1,2,3]1
children[]powerNodetrue子节点--
* **Payload - emsDevice**
参数类型是否必填描述范围样例
uidstrtrue设备UID-DGHDJSJKD-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 - eleMeter**
参数类型是否必填描述样例
uidstrtrue电表UID-QmqEhterhgrzS66grew-1
station_namestrtrue站点名称-站点1
portinttrue端口[0,65535]1
namestrtrue设备名称-东区变压器
rateinttrue倍率(0, ∞)100
running_statusinttrue

运行状态

1-在线

2-离线

[1,2] 1
* **Payload示例** {% code lineNumbers="true" %} ```json { "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152", "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed", "type": "power_node_list", "data": [{ "id": 1, "name": "总电表", "type": 1, "device": { "uid": "QmqEhterhgrzS66grew-1", "station_name": "", "port": 1, "com_addr": "/dev/ttyS9", "slave_id": 1, "name": "总电表", "running_status": 2, "direction": -1, "rate": 100 }, "parent_id": 0, "path": "-0-", "running_status": 0, "children": null },{ "id": 2, "name": "左电表", "type": 1, "device": { "uid": "QmqEhterhgrzS66grew-2", "station_name": "", "port": 2, "com_addr": "/dev/ttyS5", "slave_id": 1, "name": "左电表", "running_status": 2, "direction": 1, "rate": 20 }, "parent_id": 1, "path": "-0-1-", "running_status": 0, "children": null },{ "id": 3, "name": "设备204", "type": 2, "device": { "uid": "QmqEiSCEuFNXCozS66W9y8-5", "name": "设备204", "site_name": "测试站点", "location": "", "longitude": 0, "latitude": 0, "level": 1, "charges": null, "license": "", "type": "", "running_status": 2, "host": "192.168.77.204", "port": 1502 }, "parent_id": 2, "path": "-0-1-2-", "running_status": 0, "children": null }], "device_uid": "${DEVICE_UID}", "timestamp": 1695265371000 } ``` {% endcode %} ## 平台请求同步支路设计 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``power_node/sync``/command` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``power_node/sync``/command` * **权限:**发布 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
replyUUIDtrue所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型power_node_syncpower_node_sync
codeinttrue响应代码-见响应代码
msgstrfalse失败原因-参数错误
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": "power_node_sync", "code": 200, "msg": "", "device_uid": "iYRkfVpi77", "timestamp": 1695265671000 } ``` ### 同步支路设计响应 * **Topic:** * 用户自定义MQTT:`v1/wudun/${PRODUCT_KEY}/${DEVICE}/``power_node/sync``/result` * 平台默认MQTT: `v1/user/${TENANT}/${DEVICE}/``power_node/sync``/result` * **权限:**订阅 * **Payload主结构**
参数类型是否必填描述范围样例
midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestrtrue消息类型power_node_syncpower_node_sync
datadatatrue消息内容-Payload - data
device_uidstrtrue(二级)设备UID-iYRkfVpi77
timestampinttrue消息时间戳(单位:毫秒)(0, ∞)1696837112000
* **Payload - data**
参数类型是否必填描述样例
idinttrueID-1
namestrtrue支路名称-电表1
typeinttrue设备类型 1-电表设备 2-EMS设备[1,2]1
deviceemsMeter/emsDevicetrue设备详情--
parent_idinttrue父节点ID-0
pathstrtrue路径--0-
running_statusinttrue运行状态 1-运行 2-离线 3-故障[1,3]1
children[]powerNodetrue子节点--
* **Payload - emsDevice**
参数类型是否必填描述范围样例
uidstrtrue设备UID-DGHDJSJKD-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 - eleMeter**
参数类型是否必填描述样例
uidstrtrue电表UID-QmqEhterhgrzS66grew-1
station_namestrtrue站点名称-站点1
portinttrue端口[0,65535]1
namestrtrue设备名称-东区变压器
rateinttrue倍率(0, ∞)100
running_statusinttrue

运行状态

1-在线

2-离线

[1,2] 1
* **Payload示例** {% code lineNumbers="true" %} ```json { "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152", "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed", "type": "power_node_sync", "data": [{ "id": 1, "name": "总电表", "type": 1, "device": { "uid": "QmqEhterhgrzS66grew-1", "station_name": "", "port": 1, "com_addr": "/dev/ttyS9", "slave_id": 1, "name": "总电表", "running_status": 2, "direction": -1, "rate": 100 }, "parent_id": 0, "path": "-0-", "running_status": 0, "children": null },{ "id": 2, "name": "左电表", "type": 1, "device": { "uid": "QmqEhterhgrzS66grew-2", "station_name": "", "port": 2, "com_addr": "/dev/ttyS5", "slave_id": 1, "name": "左电表", "running_status": 2, "direction": 1, "rate": 20 }, "parent_id": 1, "path": "-0-1-", "running_status": 0, "children": null },{ "id": 3, "name": "设备204", "type": 2, "device": { "uid": "QmqEiSCEuFNXCozS66W9y8-5", "name": "设备204", "site_name": "测试站点", "location": "", "longitude": 0, "latitude": 0, "level": 1, "charges": null, "license": "", "type": "", "running_status": 2, "host": "192.168.77.204", "port": 1502 }, "parent_id": 2, "path": "-0-1-2-", "running_status": 0, "children": null }], "device_uid": "${DEVICE_UID}", "timestamp": 1695265371000 } ``` {% endcode %}