浏览代码

1.修改MQTT接口定义

liyuezong 1 年之前
父节点
当前提交
c77294186f

+ 98 - 36
04-软件设计及源码/03-核心板/V1.0/01.doc/02-设计文档/MQTT接口设计/购旺PDU MQTT接口协议定义表.docx

@@ -1,8 +1,74 @@
- 系统架构
+ MQTT连接配置
 
-Mqtt broker服务器由pdu端配置统一的IP和端口。
-协议使用JSON格式。
+Mqtt broker服务器需要在pdu的后台进行配置指定,包括配置服务器的名称、Broke ID、域名/IP、端口、用户名、密码以及上传SSL/TSL证书等信息。单台PDU最多可同时连接5台Mqtt broker服务器。
+ 
  接口协议
+                                    序号
+                                    类型
+                                 接口类型
+                                  Topic定义
+                                    交互
+                                    周期
+                                       1
+                                    发布
+PDU设备基本信息
+/pdu/<pdu id >/info/device
+                                      5s
+                                       2
+                                       
+PDU网络状态信息
+/pdu/{pdu id}/status/network
+                                      5s
+                                       3
+                                       
+PDU服务状态信息
+/pdu/{ pdu id}/status/service
+                                      5s
+                                       4
+                                       
+PDU电源总体状态信息
+/pdu/<pdu id >/status/power/all
+                                      1s
+                                       5
+                                       
+PDU通道状态信息
+/pdu/<pdu id>/status/power/channel
+                                      1s
+                                       6
+                                       
+PDU传感器状态信息
+/pdu/<pdu id>/status/sensor
+                                      1s
+                                       7
+                                       
+PDU电源报警信息
+/pdu/<pdu id>/alarm/power
+                                 单次触发
+                                       8
+                                       
+PDU传感器报警信息
+/pdu/<pdu id>/alarm/sensor
+                                 单次触发
+                                       9
+                                    订阅
+PDU电源总体控制指令
+/pdu/<pdu id >/control/power/all_channel
+                                 单次触发
+                                      10
+                                       
+PDU电源通道控制指令
+/pdu/<pdu id >/control/power/<channel id>
+                                 单次触发
+                                      11
+                                       
+PDU重启控制指令
+/pdu/<pdu id >/control/device/restart
+                                 单次触发
+                                      12
+                                       
+PDU重置控制指令
+/pdu/<pdu id >/control/device/reset
+                                 单次触发
 2.1 PDU发布接口
 2.1.1 PDU设备基本信息
 Topic:  /pdu/<pdu id >/info/device
@@ -55,7 +121,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.2 PDU网络状态信息
-Topic:  /PDU/{PDU id}/status/network
+Topic:  /pdu/{PDU id}/status/network
 Data: 
 {
   "lan_ipv4_link": "1",
@@ -129,7 +195,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.3 PDU电源总体状态信息
-Topic:  /pdu/<pdu id >/status/power/all_channel
+Topic:  /pdu/<pdu id >/status/power/all
 Data:
 {
   "power_status": [
@@ -247,39 +313,33 @@ Data:
                                      time
                                     时间
                                    hh:mm:ss
-
 2.1.4 PDU通道状态信息
-Topic:  /pdu/<pdu id>/status/power/ <channel id>
+Topic:  /pdu/<pdu id>/status/power/channel
 Data:
 {
-  "id": "1",
-  "name": "CH1",
-  "status": "1",
-  "voltage": "219.208",
-  "current": "0.000",
-  "power": "0.000",
-  "consumption": "0.000",
-  "voltage_over": "1",
-  "voltage_low": "0",
-  "current_over": "0",
-  "power_over": "0",
-  "consumption_over": "0",
-  "power_freq": "49.180",
-  "power_factor": "0.000",
-  "pactive_power": "0.000",
-  "reactive_power": "0.000",
-  "apparent_power": "0.000",
-  "phase_data": [
+  "data": [
     {
-      "phase_type": "L1",
-      "phase_voltage": "219.208",
-      "phase_current": "0.000",
-      "phase_power": "0.000",
-      "phase_consumption": "0.000"
+      "id": "1",
+      "name": "CH1",
+      "status": "1",
+      "voltage": "217.230",
+      "current": "0.415",
+      "power": "90.228",
+      "consumption": "0.071",
+      "voltage_over": "0",
+      "voltage_low": "0",
+      "current_over": "0",
+      "power_over": "0",
+      "consumption_over": "0",
+      "power_freq": "49.115",
+      "power_factor": "0.999",
+      "pactive_power": "90.228",
+      "reactive_power": "0.090",
+      "apparent_power": "90.318"
     }
   ],
-  "date": "2025-07-05",
-  "time": "15:44:51"
+  "date": "2025-07-09",
+  "time": "23:28:54"
 }
 数据说明:
                                     序号
@@ -289,7 +349,7 @@ Data:
                                         
                                       id
                                    通道id
-                                     1-32
+                                     1-255
                                         
                                      name
                                  通道名称
@@ -388,8 +448,9 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.5 PDU传感器状态信息
-Topic:  /pdu/<pdu id>/status/sensor/ <sensor id>
+Topic:  /pdu/<pdu id>/status/sensor
 Data:
+{
 {
   "name": "Gas Sensor",
   "type": "4",
@@ -403,9 +464,10 @@ Data:
   "value1_low": "0",
   "value2_over": "0",
   "value2_low": "0",
+},
   "date": "2025-07-05",
   "time": "15:44:51"
-}
+	}
 数据说明:
                                     序号
                                       Key
@@ -560,7 +622,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.8 PDU服务状态信息
-Topic:  /PDU/{PDU id}/status/service
+Topic:  /pdu/{PDU id}/status/service
 Data: 
 {
   "telnet": "0",

+ 98 - 36
04-软件设计及源码/03-核心板/V1.0/01.doc/04-用户文档/MQTT协议/购旺PDU MQTT接口协议定义表.docx

@@ -1,8 +1,74 @@
- 系统架构
+ MQTT连接配置
 
-Mqtt broker服务器由pdu端配置统一的IP和端口。
-协议使用JSON格式。
+Mqtt broker服务器需要在pdu的后台进行配置指定,包括配置服务器的名称、Broke ID、域名/IP、端口、用户名、密码以及上传SSL/TSL证书等信息。单台PDU最多可同时连接5台Mqtt broker服务器。
+ 
  接口协议
+                                    序号
+                                    类型
+                                 接口类型
+                                  Topic定义
+                                    交互
+                                    周期
+                                       1
+                                    发布
+PDU设备基本信息
+/pdu/<pdu id >/info/device
+                                      5s
+                                       2
+                                       
+PDU网络状态信息
+/pdu/{pdu id}/status/network
+                                      5s
+                                       3
+                                       
+PDU服务状态信息
+/pdu/{ pdu id}/status/service
+                                      5s
+                                       4
+                                       
+PDU电源总体状态信息
+/pdu/<pdu id >/status/power/all
+                                      1s
+                                       5
+                                       
+PDU通道状态信息
+/pdu/<pdu id>/status/power/channel
+                                      1s
+                                       6
+                                       
+PDU传感器状态信息
+/pdu/<pdu id>/status/sensor
+                                      1s
+                                       7
+                                       
+PDU电源报警信息
+/pdu/<pdu id>/alarm/power
+                                 单次触发
+                                       8
+                                       
+PDU传感器报警信息
+/pdu/<pdu id>/alarm/sensor
+                                 单次触发
+                                       9
+                                    订阅
+PDU电源总体控制指令
+/pdu/<pdu id >/control/power/all_channel
+                                 单次触发
+                                      10
+                                       
+PDU电源通道控制指令
+/pdu/<pdu id >/control/power/<channel id>
+                                 单次触发
+                                      11
+                                       
+PDU重启控制指令
+/pdu/<pdu id >/control/device/restart
+                                 单次触发
+                                      12
+                                       
+PDU重置控制指令
+/pdu/<pdu id >/control/device/reset
+                                 单次触发
 2.1 PDU发布接口
 2.1.1 PDU设备基本信息
 Topic:  /pdu/<pdu id >/info/device
@@ -55,7 +121,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.2 PDU网络状态信息
-Topic:  /PDU/{PDU id}/status/network
+Topic:  /pdu/{PDU id}/status/network
 Data: 
 {
   "lan_ipv4_link": "1",
@@ -129,7 +195,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.3 PDU电源总体状态信息
-Topic:  /pdu/<pdu id >/status/power/all_channel
+Topic:  /pdu/<pdu id >/status/power/all
 Data:
 {
   "power_status": [
@@ -247,39 +313,33 @@ Data:
                                      time
                                     时间
                                    hh:mm:ss
-
 2.1.4 PDU通道状态信息
-Topic:  /pdu/<pdu id>/status/power/ <channel id>
+Topic:  /pdu/<pdu id>/status/power/channel
 Data:
 {
-  "id": "1",
-  "name": "CH1",
-  "status": "1",
-  "voltage": "219.208",
-  "current": "0.000",
-  "power": "0.000",
-  "consumption": "0.000",
-  "voltage_over": "1",
-  "voltage_low": "0",
-  "current_over": "0",
-  "power_over": "0",
-  "consumption_over": "0",
-  "power_freq": "49.180",
-  "power_factor": "0.000",
-  "pactive_power": "0.000",
-  "reactive_power": "0.000",
-  "apparent_power": "0.000",
-  "phase_data": [
+  "data": [
     {
-      "phase_type": "L1",
-      "phase_voltage": "219.208",
-      "phase_current": "0.000",
-      "phase_power": "0.000",
-      "phase_consumption": "0.000"
+      "id": "1",
+      "name": "CH1",
+      "status": "1",
+      "voltage": "217.230",
+      "current": "0.415",
+      "power": "90.228",
+      "consumption": "0.071",
+      "voltage_over": "0",
+      "voltage_low": "0",
+      "current_over": "0",
+      "power_over": "0",
+      "consumption_over": "0",
+      "power_freq": "49.115",
+      "power_factor": "0.999",
+      "pactive_power": "90.228",
+      "reactive_power": "0.090",
+      "apparent_power": "90.318"
     }
   ],
-  "date": "2025-07-05",
-  "time": "15:44:51"
+  "date": "2025-07-09",
+  "time": "23:28:54"
 }
 数据说明:
                                     序号
@@ -289,7 +349,7 @@ Data:
                                         
                                       id
                                    通道id
-                                     1-32
+                                     1-255
                                         
                                      name
                                  通道名称
@@ -388,8 +448,9 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.5 PDU传感器状态信息
-Topic:  /pdu/<pdu id>/status/sensor/ <sensor id>
+Topic:  /pdu/<pdu id>/status/sensor
 Data:
+{
 {
   "name": "Gas Sensor",
   "type": "4",
@@ -403,9 +464,10 @@ Data:
   "value1_low": "0",
   "value2_over": "0",
   "value2_low": "0",
+},
   "date": "2025-07-05",
   "time": "15:44:51"
-}
+	}
 数据说明:
                                     序号
                                       Key
@@ -560,7 +622,7 @@ Data:
                                     时间
                                    hh:mm:ss
 2.1.8 PDU服务状态信息
-Topic:  /PDU/{PDU id}/status/service
+Topic:  /pdu/{PDU id}/status/service
 Data: 
 {
   "telnet": "0",