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/sub-elemeter.md

15 KiB
Raw Blame History

信息-电表设备

上报电表设备信息

  • Topic：
    • 用户自定义MQTT： v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/details/post
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/elemeter_info/details/post
  • **权限：**订阅
  • Payload主结构
参数类型是否必填描述范围样例
miduuid是消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
typestr是消息类型elemeter_info_detailselemeter_info_details
datadata是消息内容-见Payload - data
sub_device_idint是一级设备ID，仅二级替一级设备上报时需要该字段-1
device_uidstr是（二级）设备UID-iYRkfVpi77
timestampint是消息时间戳（单位：毫秒）(0, ∞)1696837112000
  • Payload - data/eleMeter
参数类型是否必填描述范围样例
iduint是ID-1
station_namestr是站点名称-丽宝广场
virtual_typeuint是虚拟类型1-虚拟电表
2-真实电表		2
proto_typeuint是协议类型

1-tcp

2-rtu

1
application_proto_typeuint是应用层协议类型1-dlt645
2-modbus		2
slave_iduint否设备从站id(应用层协议类型为modbus时必填)-1
dlt_addrstr否私有地址（应用层协议类型为1时必填）-AAAAAAAAAAAA
hoststr否地址（传输层协议类型为2时必填）-192.168.0.1
portuint否端口（传输层协议类型为2时必填）[0,65535]502
com_addrstr否串口地址（传输层协议类型为1时必填-/dev/ttyS1
com_nouint否串口号（传输层协议类型为1时必填-1
baud_rateint否波特率（传输层协议类型为1时必填）-9600
data_bitsint否数据位（传输层协议类型为1时必填）-8
stop_bitsint否停止位（传输层协议类型为1时必填）-1
paritystring否校验位 （传输层协议类型为1时必填）N:无校验
E:奇校验
O:偶校验		N
namestr是设备名称东区变压器
ele_device_type_iduint是电表类型id1
ele_device_typeele_device_type是电表类型对象
ptuint是电压互感10
ctuint是电流互感10
directionint是电表方向
running_statusuint是运行状态1
purposeint否用途 1-关口表 2-计量表1
associate_meters[]eleMeter否关联的电表关联自身
  • Payload示例

{% code lineNumbers="true" %}

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "elemeter_info_details",
  "data": {
    "id": 1,
    "proto_id": 1,
    "proto_type": 1,
    "application_proto_type": 2,
    "host": "192.168.1.2",
    "port": 502,
    "com_addr": "",
    "com_no": 0,
    "baud_rate": 9600,
    "data_bits": 8,
    "stop_bits": 1,
    "parity": "N",
    "dlt_addr": "",
    "slave_id": 1,
    "uid": "",
    "station_name": "测试站点",
    "name": "电表208",
    "virtual_type": 2,
    "ele_device_type_id": 1,
    "ele_device_type": {
      "id": 1,
      "device_type": 1,
      "name": "Acrel-ADW300"
    },
    "running_status": 1,
    "direction": 1,
    "pt": 1,
    "ct": 1,
    "purpose": 1,
    "meter_ids": null,
    "associate_meters": []
  },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "sub_device_id": 2,
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

{% endcode %}

平台请求同步设备信息

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/sync/command
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/elemeter_info/sync/command

  • **权限：**发布

  • Payload主结构

    参数类型是否必填描述范围样例
    midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestrtrue消息类型elemeter_info_syncelemeter_info_sync
    sub_device_idstrtrue一级设备UID，仅二级替一级设备上报时需要该字段-jHODSda39
    device_uidstrtrue（二级）设备UID-iYRkfVpi77
    timestampinttrue消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • 响应代码

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

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "elemeter_info_sync",
    "sub_device_id": "${SUB_DEVICE_ID}",
    "device_uid": "${DEVICE_UID}",
    "timestamp": 1695265671000
}

同步设备信息响应

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/sync/result
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/elemeter_info/sync/result

  • **权限：**订阅

  • Payload主结构

    参数类型是否必填描述范围样例
    miduuid是消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    replyuuid是所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestr是消息类型elemeter_info_syncelemeter_info_sync
    datadata是消息内容-见Payload - data
    codeint是响应代码-见响应代码
    msgstr是失败原因-参数错误
    sub_device_idint是一级设备ID，仅二级替一级设备上报时需要该字段-1
    device_uidstr是（二级）设备UID-iYRkfVpi77
    timestampint是消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • Payload - data/eleMeter

  • Payload示例

{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
  "type": "elemeter_info_sync",
  "data": {
    "id": 1,
    "proto_id": 1,
    "proto_type": 1,
    "application_proto_type": 2,
    "host": "192.168.1.2",
    "port": 502,
    "com_addr": "",
    "com_no": 0,
    "baud_rate": 9600,
    "data_bits": 8,
    "stop_bits": 1,
    "parity": "N",
    "dlt_addr": "",
    "slave_id": 1,
    "uid": "",
    "station_name": "测试站点",
    "name": "电表208",
    "virtual_type": 2,
    "ele_device_type_id": 1,
    "ele_device_type": {
      "id": 1,
      "device_type": 1,
      "name": "Acrel-ADW300"
    },
    "running_status": 1,
    "direction": 1,
    "pt": 1,
    "ct": 1,
    "purpose": 1,
    "meter_ids": null,
    "associate_meters": []
  },
  "sub_device_id": "${SUB_DEVICE_ID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

平台请求同步设备信息列表

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/list/command
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/elemeter_info/list/command

  • **权限：**发布

  • Payload主结构

    参数类型是否必填描述范围样例
    miduuid是消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestr是消息类型elemeter_info_listelemeter_info_list
    device_uidstr是（二级）设备UID-iYRkfVpi77
    timestampint是消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • 响应代码

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

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "elemeter_info_list",
    "device_uid": "${DEVICE_UID}",
    "timestamp": 1695265671000
}

同步设备信息响应

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/list/result
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/elemeter_info/list/result

  • **权限：**订阅

  • Payload主结构

    参数类型是否必填描述范围样例
    miduuid是消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    replyuuid是所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestr是消息类型elemeter_info_listelemeter_info_list
    datadata是消息内容-见Payload - data
    codeint是响应代码-见响应代码
    msgstr是失败原因-参数错误
    sub_device_idint是一级设备ID，仅二级替一级设备上报时需要该字段-1
    device_uidstr是（二级）设备UID-iYRkfVpi77
    timestampint是消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • Payload - data/[]eleMeter

  • Payload示例

{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
  "type": "elemeter_info_list",
  "data": [ 
    {
      "id": 1,
      "proto_id": 1,
      "proto_type": 1,
      "application_proto_type": 2,
      "host": "192.168.1.2",
      "port": 502,
      "com_addr": "",
      "com_no": 0,
      "baud_rate": 9600,
      "data_bits": 8,
      "stop_bits": 1,
      "parity": "N",
      "dlt_addr": "",
      "slave_id": 1,
      "uid": "",
      "station_name": "测试站点",
      "name": "电表208",
      "virtual_type": 2,
      "ele_device_type_id": 1,
      "ele_device_type": {
        "id": 1,
        "device_type": 1,
        "name": "Acrel-ADW300"
      },
      "running_status": 1,
      "direction": 1,
      "pt": 1,
      "ct": 1,
      "purpose": 1,
      "meter_ids": null,
      "associate_meters": []
    },
],
  "sub_device_id": "${SUB_DEVICE_ID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}