配置-支路设计

上报支路设计

• Topic：

  • 用户自定义MQTT： v1/wudun/${PRODUCT_KEY}/${DEVICE}/power_node/list/post

  • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/power_node/list/post

• 权限：订阅

• Payload主结构

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

• Payload - data

参数	类型	是否必填	描述		样例
id	int		ID	-	1
name	str		支路名称	-	电表1
type	int		设备类型 1-电表设备 2-EMS设备	[1,2]	1
device	eleMeter/emsDevice		设备详情	-	-
parent_id	int		父节点ID	-	0
path	str		路径	-	-0-
running_status	int		运行状态 1-运行 2-离线 3-故障	[1,2,3]	1
children	[]powerNode		子节点	-	-

• Payload - emsDevice

  参数	类型	是否必填	描述	范围	样例
  uid	str		设备UID	-	DGHDJSJKD-1
  name	str		设备名称	-	ems设备
  site_name	str		站点名称	-	ems站点
  location	str		详细地理位置	-	wudun
  longitude	float		经度	-	-
  latitude	float		纬度		-
  level	int		EMS等级	[1, 2]	1
  type	str		设备类型	-	ems
  running_status	int		运行状态 1-运行 2-离线 3-故障	[1,2,3]	1
  host	str		地址	-	192.168.0.1
  port	str		端口	[0,65525]	2171
  license	str		激活码	-	2YIZedmOtl4pcqo1EA4zhM5gofDI

• Payload - eleMeter

  参数	类型	是否必填	描述		样例
  uid	str		电表UID	-	QmqEhterhgrzS66grew-1
  station_name	str		站点名称	-	站点1
  port	int		端口	[0,65535]	1
  name	str		设备名称	-	东区变压器
  rate	int		倍率	(0, ∞)	100
  running_status	int		运行状态 1-在线 2-离线	[1,2]	1

• Payload示例

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

平台请求同步支路设计

• Topic：

  • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/power_node/sync/command

  • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/power_node/sync/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	power_node_sync	power_node_sync
  code	int		响应代码	-	见响应代码
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "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主结构

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

• Payload - data

参数	类型	是否必填	描述		样例
id	int		ID	-	1
name	str		支路名称	-	电表1
type	int		设备类型 1-电表设备 2-EMS设备	[1,2]	1
device	emsMeter/emsDevice		设备详情	-	-
parent_id	int		父节点ID	-	0
path	str		路径	-	-0-
running_status	int		运行状态 1-运行 2-离线 3-故障	[1,3]	1
children	[]powerNode		子节点	-	-

• Payload - emsDevice

  参数	类型	是否必填	描述	范围	样例
  uid	str		设备UID	-	DGHDJSJKD-1
  name	str		设备名称	-	ems设备
  site_name	str		站点名称	-	ems站点
  location	str		详细地理位置	-	wudun
  longitude	float		经度	-
  latitude	float		纬度
  level	int		EMS等级	[1, 2]	1
  type	str		设备类型	-	ems
  running_status	int		运行状态 1-运行 2-离线 3-故障	[1,2,3]	1
  host	str		地址	-	192.168.0.1
  port	str		端口	[0,65525]	2171
  license	str		激活码	-	2YIZedmOtl4pcqo1EA4zhM5gofDI

• Payload - eleMeter

  参数	类型	是否必填	描述		样例
  uid	str		电表UID	-	QmqEhterhgrzS66grew-1
  station_name	str		站点名称	-	站点1
  port	int		端口	[0,65535]	1
  name	str		设备名称	-	东区变压器
  rate	int		倍率	(0, ∞)	100
  running_status	int		运行状态 1-在线 2-离线	[1,2]	1

• Payload示例

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