信息-电表设备

上报电表设备信息

  • Topic:

    • 用户自定义MQTT: v1/wudun/${PRODUCT_KEY}/${DEVICE}/elemeter_info/details/post

    • 平台默认MQTT: v1/user/${TENANT}/${DEVICE}/elemeter_info/details/post

  • 权限:订阅

  • Payload主结构

参数
类型
是否必填
描述
范围
样例

mid

uuid

消息ID

-

3e681859-6917-4b9a-9afd-3f162cd185bd

type

str

消息类型

elemeter_info_details

elemeter_info_details

data

data

消息内容

-

Payload - data

sub_device_id

int

一级设备ID,仅二级替一级设备上报时需要该字段

-

1

device_uid

str

(二级)设备UID

-

iYRkfVpi77

timestamp

int

消息时间戳(单位:毫秒)

(0, ∞)

1696837112000

  • Payload - data/eleMeter

参数
类型
是否必填
描述
范围
样例

id

uint

ID

-

1

station_name

str

站点名称

-

丽宝广场

virtual_type

uint

虚拟类型

1-虚拟电表 2-真实电表

2

proto_type

uint

协议类型

1-tcp

2-rtu

1

application_proto_type

uint

应用层协议类型

1-dlt645 2-modbus

2

slave_id

uint

设备从站id(应用层协议类型为modbus时必填)

-

1

dlt_addr

str

私有地址(应用层协议类型为1时必填)

-

AAAAAAAAAAAA

host

str

地址(传输层协议类型为2时必填)

-

192.168.0.1

port

uint

端口(传输层协议类型为2时必填)

[0,65535]

502

com_addr

str

串口地址(传输层协议类型为1时必填

-

/dev/ttyS1

com_no

uint

串口号(传输层协议类型为1时必填

-

1

baud_rate

int

波特率(传输层协议类型为1时必填)

-

9600

data_bits

int

数据位(传输层协议类型为1时必填)

-

8

stop_bits

int

停止位(传输层协议类型为1时必填)

-

1

parity

string

校验位 (传输层协议类型为1时必填)

N:无校验 E:奇校验 O:偶校验

N

name

str

设备名称

东区变压器

ele_device_type_id

uint

电表类型id

1

ele_device_type

ele_device_type

电表类型对象

pt

uint

电压互感

10

ct

uint

电流互感

10

direction

int

电表方向

running_status

uint

运行状态

1

purpose

int

用途

1-关口表 2-计量表

1

associate_meters

[]eleMeter

关联的电表

关联自身

  • Payload示例

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

平台请求同步设备信息

  • Topic:

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

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

  • 权限:发布

  • Payload主结构

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    UUID

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    elemeter_info_sync

    elemeter_info_sync

    sub_device_id

    str

    一级设备UID,仅二级替一级设备上报时需要该字段

    -

    jHODSda39

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

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    uuid

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    reply

    uuid

    所回复消息的mid

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    elemeter_info_sync

    elemeter_info_sync

    data

    data

    消息内容

    -

    Payload - data

    code

    int

    响应代码

    -

    见响应代码

    msg

    str

    失败原因

    -

    参数错误

    sub_device_id

    int

    一级设备ID,仅二级替一级设备上报时需要该字段

    -

    1

    device_uid

    str

    (二级)设备UID

    -

    iYRkfVpi77

    timestamp

    int

    消息时间戳(单位:毫秒)

    (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主结构

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    uuid

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    elemeter_info_list

    elemeter_info_list

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

    参数
    类型
    是否必填
    描述
    范围
    样例

    mid

    uuid

    消息ID

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    reply

    uuid

    所回复消息的mid

    -

    3e681859-6917-4b9a-9afd-3f162cd185bd

    type

    str

    消息类型

    elemeter_info_list

    elemeter_info_list

    data

    data

    消息内容

    -

    Payload - data

    code

    int

    响应代码

    -

    见响应代码

    msg

    str

    失败原因

    -

    参数错误

    sub_device_id

    int

    一级设备ID,仅二级替一级设备上报时需要该字段

    -

    1

    device_uid

    str

    (二级)设备UID

    -

    iYRkfVpi77

    timestamp

    int

    消息时间戳(单位:毫秒)

    (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
}

最后更新于