StandardSence/StandardScene.Core/Docs/Charge/充电桩报文自动更新说明.md

# 充电桩报文自动更新功能说明

## 功能概述

系统现已支持发送和接收充电桩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报文自动解析和更新