Third_Dev_Dept/StandardSence

Fork 0

Files

T

zhaowei.huang c8e540d272 init commit

2026-06-14 11:19:15 +08:00

8.8 KiB

Raw Permalink Blame History

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

功能概述

系统现已支持发送和接收充电桩UDP报文，分别解析后合并更新充电桩管理列表中的实时数据。

工作流程

发送方向: 应用程序 → 发送报文 → CommunicationMessageService(存储+解析发送数据) → 更新设定值
接收方向: 充电桩设备 → UDP报文(40001端口) → ChargeUdpService → CommunicationMessageService(存储+解析接收数据) → 更新实时数据
合并结果: 发送数据 + 接收数据 → 数据服务 → 管理界面自动刷新

核心组件

1. CommunicationMessageService（通讯报文服务）

文件位置: Charge/CommunicationMessageService.cs

主要功能:

存储所有发送和接收的报文（最多保留100条）
分开解析发送和接收的报文数据
根据IP地址匹配对应的充电桩并更新数据
提供报文查询和筛选功能

发送报文解析的数据:

✅ 充电指令（启动/停止）
✅ 设定电压（V）
✅ 设定电流（A）
✅ 发送时间

接收报文解析的数据:

✅ 通讯状态（正常/错误）
✅ 充电指令状态（启动/停止）
✅ 机构状态（伸出/缩回/伸出中/缩回中/故障）
✅ 实时电压（V）
✅ 实时电流（A）
✅ 电量百分比（%）
✅ 报警状态和级别
✅ 充电桩状态（空闲/充电中/故障/离线）
✅ 当前充电车辆编号
✅ 接收时间

2. ChargeUdpService（UDP监听服务）

文件位置: Charge/ChargeUdpService.cs

监听端口: 40001

工作流程:

接收UDP报文
调用 CommunicationMessageService.AddReceiveMessage() 记录报文
CommunicationMessageService 自动解析接收报文并更新充电桩数据
保持原有任务处理逻辑的兼容性

3. 发送报文处理

发送位置:

ChargeStationType/MuXingChargeStation.cs
ChargeStationType/FLChargeStation.cs
ChargeStationType/PCBChargeStation.cs

工作流程:

发送UDP报文到充电桩
调用 CommunicationMessageService.AddSendMessage() 记录报文
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 方法中的字节位置：

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 方法中的字节位置：

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监听

// 在程序启动时创建UDP服务
var udpService = new ChargeUdpService();

2. 添加充电桩

在充电桩管理界面中添加充电桩，确保IP地址与实际设备一致：

充电桩编号: 1
名称: 1号充电桩
IP地址: 192.168.1.101  ← 必须与设备IP一致
端口: 502

3. 自动更新

发送报文时：

应用程序发送充电指令到充电桩
系统记录发送报文
解析发送报文数据（设定电压、电流等）
根据IP地址匹配充电桩
更新充电桩的设定值

接收报文时：

系统自动接收UDP报文（端口40001）
记录接收报文
解析接收报文数据（实时状态、电压、电流等）
根据IP地址匹配充电桩
更新充电桩的实时数据

界面显示：

管理界面每2秒自动刷新显示
同时显示设定值（来自发送报文）和实时值（来自接收报文）

调试信息

系统会在日志中输出以下信息：

[UDP返回报文信息] ChargeStation ADD:[1,2,3,4,...]
[ChargeStation] 更新充电桩成功: [1] 1号充电桩 (192.168.1.101:502) - Charging

查看报文记录：

打开通讯监控界面可以查看所有发送和接收的报文
报文按时间倒序排列（最新的在最前面）
最多保留100条报文记录

常见问题

Q1: 报文接收了但数据没更新？

检查项:

充电桩的IP地址是否在管理列表中
报文格式是否正确（至少30字节）
查看日志中是否有解析错误信息

Q2: 如何修改刷新间隔？

在 ChargeStationManagementForm.cs 的 InitializeAutoRefresh 方法中修改：

autoRefreshTimer.Interval = 2000; // 改为你需要的毫秒数

Q3: 如何关闭自动刷新？

// 在InitializeAutoRefresh方法中注释掉这行
// autoRefreshTimer.Start();

扩展功能

添加新的解析字段

发送报文新字段：

在 ParsedSendData 类中添加新属性
在 ParseSendRawData 方法中解析新字段
在 UpdateStationFromSendData 方法中更新到充电桩对象

接收报文新字段：

在 ParsedReceiveData 类中添加新属性
在 ParseReceiveRawData 方法中解析新字段
在 UpdateStationFromReceiveData 方法中更新到充电桩对象

支持其他通讯协议

在 CommunicationMessageService.cs 中可以根据端口号或其他特征判断协议类型：

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报文自动解析和更新

8.8 KiB Raw Permalink Blame History Unescape Escape