hkc
/
EMS3.0
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
EMS3.0/00. 预研阶段/wudun_EMS_MQTT/level-2-ems/power-node.md

22 KiB
Raw Blame History

配置-支路设计

上报支路设计

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

{
  "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示例

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

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