上传文件至 'Wenbo'

Wenbo/接口(1).docx

@@ -0,0 +1,206 @@
+1.总体状态监控
+1.1显示所有通道的总电压（V）、总电流（A）、总功率（W）、频率（仅交流，HZ）、总耗电量Kwh）、功率因数（仅交流）信息；
+1.2具备总开、总关操作，操作需要确认才能执行。
+
+type类型说明：listQuery列表查询；open打开；close关闭
+
+1.1接口路由：pdu/overallStatusMonitoring
+参数：{"token":"用户唯一标识","type":"类型：listQuery"}
+返回：{
+    "code": 200,
+    "data": [
+        {
+            "totalVoltage": "总电压",
+            "totalCurrent": "总电流",
+            "totalPower": "总功率",
+            "frequency": "频率",
+            "powerConsumption": "总耗电量",
+            "powerFactor": "功率因数"
+        }
+    ],
+    "msg": "操作成功"
+}
+
+
+1.2接口路由：pdu/overallStatusMonitoring
+参数：{"token":"用户唯一标识","type":"类型：open/close 打开/关闭"}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+
+
+2.通道状态监控
+2.1显示每个通道的通道号、通道名称、电压（V）、电流（A）、功率（W）、频率（仅交流，HZ）、耗电量（Kwh）、功率因数（仅交流）信息；
+2.2具备每个通道单开、单关操作，操作需要确认才能执行；
+2.3能够编辑每个通道的名称信息，可选择通道负载类型（空调/服务器/交换机/路由器/计算机/显示器/灯/自定义）。
+
+type类型说明：listQuery列表查询；open打开；close关闭;save 保存
+
+2.1接口路由：pdu/channelStatusMonitoring
+
+参数：{
+"token":"用户唯一标识",
+"type":"类型：listQuery"
+    }
+返回：{
+    "code": 200,
+    "data": [
+        {
+            "channelName": "通道名称",
+            "channelNumber": "通道号",
+            "voltage": "电压",
+            "current": "电流",
+            "power": "功率",
+            "frequency": "频率",
+"powerConsumption": "耗电量",
+"powerFactor": "功率因数"
+        }
+    ],
+    "msg": "操作成功"
+}
+
+2.2接口路由：pdu/channelStatusMonitoring
+参数：{
+"token": "用户唯一标识",
+ "channelNumber": "通道号",  
+"type":"类型：open/close"
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+2.3接口路由：pdu/channelStatusMonitoring
+参数：{
+"token":
+"用户唯一标识",
+"type":"类型：save",
+ "channelName": "通道名称",
+ "channelNumber": "通道号", 
+"ChannelLoadType":"空调/服务器/交换机/路由器/计算机/显示器/灯/自定义"
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+
+
+3.传感器状态监控
+3.1具备PDU传感器状态监控及管理功能，包括温湿度传感器、烟雾探测器、水位探测器、门禁传感器、空调红外控制器、专用气体传感器、气流气压传感器类型传感器。传感器为标准MODBUS传感器，可切换级联中的任一PDU设备。具体：
+3.1能够显示各传感器的序号、名称、类型、COM口号【面板】、地址、波特率、连接状态（在线/离线）信息；
+能够对传感器感知信息进行显示，包括；
+温湿度传感器：温度值（℃）、湿度值（%）；
+烟雾探测器：监测其报警状态（报警/未报警）；
+水位探测器：水浸入状态（侵入/未侵入）；
+门禁传感器：门禁释放状态（锁闭/释放）；
+专用气体传感器：气体浓度（mg/m³或PPM）；
+气流气压传感器：气流值（m/s）、气压值（MPa）。
+3.2能够支持传感器的添加/删除/配置管理功能，配置主要对传感器的名称、类型、COM口、地址、波特率进行配置管理；
+
+3.3能够对传感器进行控制输出指令，包括；
+烟雾探测器：复位其报警状态指令【RS485】；
+门禁传感器：门禁释放指令；【RS485】
+空调红外控制器：空调开启/关闭指令。【RS485】
+
+type类型说明：listQuery列表查询；add添加；delete删除;update配置;issueInstructions下发指令
+sensorType传感器类型说明：temperatureSenso温湿度传感器、smokeDetector烟雾探测器、waterlevel Detector水位探测器、accessControlSensor门禁传感器、airConditioningController空调红外控制器、specializedGasSensors专用气体传感器、airflowPressureSensor气流气压传感器类型传感器
+
+3.1接口路由：pdu/sensorStatusMonitoring
+
+参数：{
+"token":"用户唯一标识",
+"type":"类型：listQuery"
+  "sensorType": "传感器类型", 
+    }
+返回：{
+    "code": 200,
+    "data": [
+        {
+            "sensorType": "传感器类型",
+            "sensorNumber": "传感器序号",
+            "sensorName": "传感器名称",
+            "comSlogan": "COM口号",
+            "address": "地址",
+            "baud": "波特率",
+"connectionStatus": "连接状态:在线/离线",
+"temperatureValue":"温度值",
+"humidityValue":"湿度值",
+"alarmStatus":"报警状态（报警/未报警）",
+"waterImmersionState":"水浸入状态（侵入/未侵入）",
+"accessControlStatus":"门禁释放状态（锁闭/释放）",
+"gasConcentration":"气体浓度",
+"airflowValue":"气流值",
+"airPressureValue":"气压值" 
+        }
+    ],
+    "msg": "操作成功"
+}
+3.2添加接口路由：pdu/sensorStatusMonitoring
+参数：{
+"token":
+"用户唯一标识",
+"type":"类型：add",
+ "sensorType": "传感器类型",
+            "sensorNumber": "传感器序号",
+            "sensorName": "传感器名称",
+            "comSlogan": "COM口号",
+            "address": "地址",
+            "baud": "波特率",
+"connectionStatus": "连接状态:在线/离线"
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+3.2删除接口路由：pdu/sensorStatusMonitoring
+参数：{
+"token":
+"用户唯一标识",
+"type":"类型：delete",
+ "sensorType": "传感器类型",
+ "sensorNumber": "传感器序号"
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+3.2配置接口路由：pdu/sensorStatusMonitoring
+参数：{
+"token":
+"用户唯一标识",
+"type":"类型：update",
+ "sensorType": "传感器类型",
+            "sensorNumber": "传感器序号",
+            "sensorName": "传感器名称",
+            "comSlogan": "COM口号",
+            "address": "地址",
+            "baud": "波特率",
+"connectionStatus": "连接状态:在线/离线"
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}
+
+3.3配置接口路由：pdu/sensorStatusMonitoring
+参数：{
+"token":
+"用户唯一标识",
+"type":"类型：issueInstructions",
+ "sensorType": "传感器类型",
+  "sensorNumber": "传感器序号",
+  "alarmStatus":"报警状态（报警/未报警）",
+"accessControlStatus":"门禁释放状态（锁闭/释放）",
+"airConditioningInstruct":"空调(开启/关闭)" 
+}
+返回：
+{
+    "code": 200,
+    "msg": "操作成功"
+}