init commit

2026-06-14 11:19:15 +08:00
parent e79a3815a5
commit c8e540d272
174 changed files with 60830 additions and 39 deletions
@@ -0,0 +1,309 @@
+# 充电桩报文自动更新功能说明
+
+## 功能概述
+
+系统现已支持发送和接收充电桩UDP报文，**分别解析后合并更新**充电桩管理列表中的实时数据。
+
+## 工作流程
+
+```
+发送方向: 应用程序 → 发送报文 → CommunicationMessageService(存储+解析发送数据) → 更新设定值
+接收方向: 充电桩设备 → UDP报文(40001端口) → ChargeUdpService → CommunicationMessageService(存储+解析接收数据) → 更新实时数据
+合并结果: 发送数据 + 接收数据 → 数据服务 → 管理界面自动刷新
+```
+
+## 核心组件
+
+### 1. CommunicationMessageService（通讯报文服务）
+
+**文件位置**: `Charge/CommunicationMessageService.cs`
+
+**主要功能**:
+- 存储所有发送和接收的报文（最多保留100条）
+- **分开解析发送和接收的报文数据**
+- 根据IP地址匹配对应的充电桩并更新数据
+- 提供报文查询和筛选功能
+
+**发送报文解析的数据**:
+- ✅ 充电指令（启动/停止）
+- ✅ 设定电压（V）
+- ✅ 设定电流（A）
+- ✅ 发送时间
+
+**接收报文解析的数据**:
+- ✅ 通讯状态（正常/错误）
+- ✅ 充电指令状态（启动/停止）
+- ✅ 机构状态（伸出/缩回/伸出中/缩回中/故障）
+- ✅ 实时电压（V）
+- ✅ 实时电流（A）
+- ✅ 电量百分比（%）
+- ✅ 报警状态和级别
+- ✅ 充电桩状态（空闲/充电中/故障/离线）
+- ✅ 当前充电车辆编号
+- ✅ 接收时间
+
+### 2. ChargeUdpService（UDP监听服务）
+
+**文件位置**: `Charge/ChargeUdpService.cs`
+
+**监听端口**: 40001
+
+**工作流程**:
+1. 接收UDP报文
+2. 调用 `CommunicationMessageService.AddReceiveMessage()` 记录报文
+3. `CommunicationMessageService` 自动解析接收报文并更新充电桩数据
+4. 保持原有任务处理逻辑的兼容性
+
+### 3. 发送报文处理
+
+**发送位置**: 
+- `ChargeStationType/MuXingChargeStation.cs`
+- `ChargeStationType/FLChargeStation.cs`
+- `ChargeStationType/PCBChargeStation.cs`
+
+**工作流程**:
+1. 发送UDP报文到充电桩
+2. 调用 `CommunicationMessageService.AddSendMessage()` 记录报文
+3. `CommunicationMessageService` 自动解析发送报文并更新充电桩设定值
+
+### 4. ChargeStationDataService（数据服务）
+
+**新增方法**: `GetStationByIp(string ipAddress)`
+
+**功能**: 根据IP地址快速查找对应的充电桩记录
+
+### 5. ChargeStationManagementForm（管理界面）
+
+**新增功能**: 自动刷新
+
+**刷新间隔**: 2秒
+
+**特点**: 
+- 自动更新列表显示
+- 不影响用户的编辑操作
+- 窗体关闭时自动停止刷新
+
+## 报文格式说明
+
+### 当前支持的报文格式
+
+报文采用逗号分隔的字节数组格式，例如：
+```
+1,2,3,4,5,...,28,29,30
+```
+
+### 发送报文字节位置定义（示例）
+
+| 字节位置 | 数据内容 | 说明 |
+|---------|---------|------|
+| 5 | 充电指令 | 0=停止, 1=启动 |
+| 6-7 | 设定电压 | 高低字节，单位0.1V |
+| 8-9 | 设定电流 | 高低字节，单位0.1A |
+
+### 接收报文字节位置定义（示例）
+
+| 字节位置 | 数据内容 | 说明 |
+|---------|---------|------|
+| 10 | 充电指令状态 | 0=停止, 1=启动 |
+| 11 | 机构状态 | 0=未知, 1=伸出, 2=缩回, 3=伸出中, 4=缩回中, 5=故障 |
+| 12-13 | 实时电压 | 高低字节，单位0.1V |
+| 14-15 | 实时电流 | 高低字节，单位0.1A |
+| 16 | 电量百分比 | 0-100 |
+| 20 | 报警级别 | 0=无, 1-2=低, 3-5=中, 6-8=高, 9+=严重 |
+| 25 | 充电桩状态 | 0=空闲, 1=充电中, 2=故障, 3=离线 |
+| 26-29 | 车辆编号 | 4字节整数 |
+| 28 | 通讯状态 | 1=正常, 其他=错误 |
+
+**⚠️ 注意**: 以上字节位置为示例，需要根据实际通讯协议进行调整。
+
+## 如何调整报文解析规则
+
+打开 `CommunicationMessageService.cs` 文件，分别修改发送和接收报文的解析方法：
+
+### 调整发送报文解析
+
+修改 `ParseSendRawData` 方法中的字节位置：
+
+```csharp
+private ParsedSendData ParseSendRawData(string rawData)
+{
+    // ... 字节数组转换代码 ...
+    
+    var parsed = new ParsedSendData
+    {
+        // 根据实际协议修改字节位置
+        ChargeCommand = bytes.Length > 5 ? bytes[5] : (byte)0,
+        SetVoltage = bytes.Length > 7 ? (bytes[6] << 8 | bytes[7]) / 10.0 : 0,
+        SetCurrent = bytes.Length > 9 ? (bytes[8] << 8 | bytes[9]) / 10.0 : 0,
+        SendTime = DateTime.Now
+    };
+    
+    return parsed;
+}
+```
+
+### 调整接收报文解析
+
+修改 `ParseReceiveRawData` 方法中的字节位置：
+
+```csharp
+private ParsedReceiveData ParseReceiveRawData(string rawData)
+{
+    // ... 字节数组转换代码 ...
+    
+    var parsed = new ParsedReceiveData
+    {
+        // 根据实际协议修改字节位置
+        CommStatus = bytes[28] == 1 ? CommunicationStatus.Normal : CommunicationStatus.Error,
+        ChargeCommandStatus = bytes[10] == 1 ? ChargeCommandStatus.Started : ChargeCommandStatus.Stopped,
+        // ... 其他字段 ...
+        ReceiveTime = DateTime.Now
+    };
+    
+    return parsed;
+}
+```
+
+## 使用示例
+
+### 1. 启动UDP监听
+
+```csharp
+// 在程序启动时创建UDP服务
+var udpService = new ChargeUdpService();
+```
+
+### 2. 添加充电桩
+
+在充电桩管理界面中添加充电桩，确保IP地址与实际设备一致：
+
+```
+充电桩编号: 1
+名称: 1号充电桩
+IP地址: 192.168.1.101  ← 必须与设备IP一致
+端口: 502
+```
+
+### 3. 自动更新
+
+**发送报文时**：
+1. 应用程序发送充电指令到充电桩
+2. 系统记录发送报文
+3. 解析发送报文数据（设定电压、电流等）
+4. 根据IP地址匹配充电桩
+5. 更新充电桩的设定值
+
+**接收报文时**：
+1. 系统自动接收UDP报文（端口40001）
+2. 记录接收报文
+3. 解析接收报文数据（实时状态、电压、电流等）
+4. 根据IP地址匹配充电桩
+5. 更新充电桩的实时数据
+
+**界面显示**：
+- 管理界面每2秒自动刷新显示
+- 同时显示设定值（来自发送报文）和实时值（来自接收报文）
+
+## 调试信息
+
+系统会在日志中输出以下信息：
+
+```
+[UDP返回报文信息] ChargeStation ADD:[1,2,3,4,...]
+[ChargeStation] 更新充电桩成功: [1] 1号充电桩 (192.168.1.101:502) - Charging
+```
+
+**查看报文记录**：
+- 打开通讯监控界面可以查看所有发送和接收的报文
+- 报文按时间倒序排列（最新的在最前面）
+- 最多保留100条报文记录
+
+## 常见问题
+
+### Q1: 报文接收了但数据没更新？
+
+**检查项**:
+1. 充电桩的IP地址是否在管理列表中
+2. 报文格式是否正确（至少30字节）
+3. 查看日志中是否有解析错误信息
+
+### Q2: 如何修改刷新间隔？
+
+在 `ChargeStationManagementForm.cs` 的 `InitializeAutoRefresh` 方法中修改：
+
+```csharp
+autoRefreshTimer.Interval = 2000; // 改为你需要的毫秒数
+```
+
+### Q3: 如何关闭自动刷新？
+
+```csharp
+// 在InitializeAutoRefresh方法中注释掉这行
+// autoRefreshTimer.Start();
+```
+
+## 扩展功能
+
+### 添加新的解析字段
+
+**发送报文新字段**：
+1. 在 `ParsedSendData` 类中添加新属性
+2. 在 `ParseSendRawData` 方法中解析新字段
+3. 在 `UpdateStationFromSendData` 方法中更新到充电桩对象
+
+**接收报文新字段**：
+1. 在 `ParsedReceiveData` 类中添加新属性
+2. 在 `ParseReceiveRawData` 方法中解析新字段
+3. 在 `UpdateStationFromReceiveData` 方法中更新到充电桩对象
+
+### 支持其他通讯协议
+
+在 `CommunicationMessageService.cs` 中可以根据端口号或其他特征判断协议类型：
+
+```csharp
+public void AddReceiveMessage(string ipAddress, int port, string rawData, string stationId = null)
+{
+    // ... 添加报文记录 ...
+
+    // 根据端口判断协议类型
+    if (port == 40001)
+    {
+        ParseReceiveDataAndUpdateStation(ipAddress, rawData); // UDP协议
+    }
+    else if (port == 502)
+    {
+        ParseModbusReceiveAndUpdate(ipAddress, rawData); // Modbus协议
+    }
+}
+
+public void AddSendMessage(string ipAddress, int port, string rawData, string stationId = null)
+{
+    // ... 添加报文记录 ...
+
+    // 根据端口判断协议类型
+    if (port == 40001)
+    {
+        ParseSendDataAndUpdateStation(ipAddress, rawData); // UDP协议
+    }
+    else if (port == 502)
+    {
+        ParseModbusSendAndUpdate(ipAddress, rawData); // Modbus协议
+    }
+}
+```
+
+## 技术特点
+
+✅ **实时性**: UDP报文接收后立即解析更新  
+✅ **自动化**: 无需手动刷新，数据自动同步  
+✅ **分离解析**: 发送和接收报文分开解析，数据更准确  
+✅ **合并更新**: 自动合并发送和接收数据到充电桩管理界面  
+✅ **可扩展**: 支持自定义报文格式和解析规则  
+✅ **兼容性**: 保留原有任务处理逻辑  
+✅ **稳定性**: 异常处理完善，不影响系统运行  
+
+## 版本历史
+
+- **v1.1** (2026-01-18): 发送和接收报文分开解析，合并更新到充电桩管理界面
+- **v1.0** (2026-01-18): 初始版本，支持UDP报文自动解析和更新
+