信息-电表设备

上报电表设备信息

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