Third_Dev_Dept/StandardSence

Fork 0

Files

T

zhaowei.huang c8e540d272 init commit

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

44 KiB

Raw Blame History

StandardScene - Charge 模块逻辑文档

本文档用于梳理 StandardScene/Charge/ 充电桩管理与充电业务的整体逻辑，重点包含：

充电桩配置（数据模型与持久化）
通信报文解析与 ChargeStation 状态落库
StandardChargeMission 的充电业务循环
相关 WinForms 界面如何展示与交互

1. 目录/模块职责速览（Charge/ 内）

数据与配置层

ChargeStation.cs：充电桩数据模型（ChargeStation）及相关枚举（ChargeStationStatus、CommunicationStatus、ChargeCommandStatus 等）
ChargeStationDataService.cs：ChargeStation 的持久化与查询/更新（JSON 文件存储）
AlarmConfig.cs：报警配置模型（AlarmConfig）
AlarmConfigDataService.cs：报警配置的持久化与查询/更新（JSON 文件存储）
ChargeStrategyConfig.cs：充电策略配置模型
ChargeStrategyConfigService.cs：充电策略配置的持久化（JSON 文件存储）

运行时与通信层

CommunicationMessageService.cs：通信报文“记录 + 解析 + 更新 ChargeStation”的核心服务
ChargeUdpService.cs：UDP 监听入口，将 UDP 收到的数据转为 CommunicationMessageService.AddReceiveMessage(...)
StandardChargeMission.cs：主业务进程（初始化充电站实例、500ms 循环下发充电指令）

WinForms 界面层

ChargeStationManagementForm.cs：充电桩管理窗口（列表、增删改、跳转其它窗口）
ChargeStrategyConfigForm.cs：充电策略参数配置窗口
CommunicationMonitorForm.cs：通信报文监控窗口（订阅 MessageAdded 并刷新表格）
AlarmConfigManagementForm.cs：报警配置管理窗口（增删改、筛选与搜索）

2. 数据模型（ChargeStation / AlarmConfig / 策略）

2.1 `ChargeStation`（`Charge/ChargeStation.cs`）

ChargeStation 是所有界面展示与通信落库的核心对象。与本模块强相关的字段包括：

身份与配置
- StationId：充电桩编号（用于唯一标识，UI 校验 1-99）
- Name、Type（充电桩类型：FRLDTall / FRLDShort / MuXing）
- ChargeMethod（地充/尾充/侧充）
- IpAddress、Port：通信地址
- SetVoltage、SetElectricCurrent：设定值
- Enabled：是否启用
- GroupCarType、SiteId：与调度系统站点配置绑定
通信与状态（用于 UI 展示）
- Status（ChargeStationStatus）：Idle / Charging / Fault / Battery
- CommStatus（CommunicationStatus）：UI 中展示用的通讯状态（通常由 UI Ping 计算）
- ChargeCommandStatus（ChargeCommandStatus）：最近一次“启动/停止充电指令”的状态
- MechanismStatus：机构伸缩状态
- HasAlarm、AlarmLevel、AlarmMessage：报警相关
实时数值
- LastSendTime、LastReceiveTime
- RealTimeVoltage、RealTimeCurrent
- BatteryLevel、CurrentVehicle

2.2 枚举含义（`ChargeStation.cs`）

主要枚举：

ChargeStationStatus：空闲/充电中/报警中/AGV电池已接入
CommunicationStatus：未知/正常/延迟/超时/断开/错误
ChargeCommandStatus：停止/启动
MechanismStatus：伸出/缩回/运动中
AlarmLevel：无/低/中/高/严重
ChargeMethodType：地充/尾充/侧充

2.3 报警配置 `AlarmConfig`（`Charge/AlarmConfig.cs`）

报警配置用于 UI 管理与展示（AlarmConfigManagementForm 管理）。字段包括：

AlarmId、AlarmCode、AlarmContent
Level（报警级别）、Enabled
Remarks

2.4 策略配置 `ChargeStrategyConfig`（`Charge/ChargeStrategyConfig.cs`）

策略配置包含 SOC 阈值、时间参数、以及开关项（例如 AllowInterruptTask、UseLowerSocForCharge 等），由 ChargeStrategyConfigForm 编辑、由 ChargeStrategyConfigService 持久化。

3. 持久化与服务层（DataService）

3.1 充电桩数据持久化：`ChargeStationDataService`

入口与关键能力（来自实现）：

获取：GetAllStations()、GetStationById(...)、GetStationByIp(ip,port)
增加：AddStation(...)
更新：UpdateStation(...)（可选 isSave）、UpdateStationStatus(...)
删除：DeleteStation(...)
刷新：Reload()

落库逻辑特点：

通信解析后会调用 ChargeStationDataService.UpdateStation(station, out errorMessage)，最终把 ChargeStation 新状态写回 JSON。

3.2 报警配置持久化：`AlarmConfigDataService`

入口与关键能力：

获取：GetAllAlarmConfigs()、GetAlarmConfig(alarmId)、GetAlarmConfigByCode(...)
增加：AddAlarmConfig(...)
更新：UpdateAlarmConfig(...)
删除：DeleteAlarmConfig(...)
刷新：Reload()（实现中一般会重新从文件加载）

4. 通信报文解析与落库：CommunicationMessageService

Charge/CommunicationMessageService.cs 是本模块最核心的“桥梁”：

把发送/接收报文记录到内存队列（LinkedList）
根据报文原始 hex 字符串与协议类型 type 解析出结构化数据
更新对应的 ChargeStation 字段
调用 ChargeStationDataService.UpdateStation(...) 落库到 JSON，并触发 UI 展示更新

4.1 报文记录与订阅

MessageAdded 事件：当新报文加入时触发
UI 通信监控窗体（CommunicationMonitorForm）订阅该事件，并在 UI 线程刷新表格

4.2 发送报文路径（AddSendMessage -> 更新 ChargeCommandStatus 等）

外部调用：AddSendMessage(ipAddress, port, rawData, type, stationId?)
内部流程：
- ParseSendRawData(rawData, type) 解析
- UpdateStationFromSendData(station, parsedData) 更新：
  - LastSendTime = SendTime
  - 根据 ChargeCommand（启动/停止）更新 ChargeCommandStatus
  - 更新 BatteryLevel 与 CurrentVehicle
- ChargeStationDataService.UpdateStation(station, out errorMessage) 落库

4.3 接收报文路径（AddReceiveMessage -> 更新状态/机构/告警）

外部调用：AddReceiveMessage(ipAddress, port, rawData, type, stationId?)
内部流程：
- ParseReceiveRawData(rawData, type) 解析
- UpdateStationFromReceiveData(station, parsedData) 更新：
  - LastReceiveTime
  - MechanismStatus、RealTimeVoltage、RealTimeCurrent
  - Status（Idle/Charging/Fault/Battery）
  - HasAlarm、AlarmLevel、AlarmMessage
- ChargeStationDataService.UpdateStation(...) 落库

4.4 协议类型 `type`

解析分支中常见类型示例：

FRLDShort
FRLDTall

不同类型会使用不同索引位置从报文字节数组中解析字段。

5. 通信接入入口

5.1 UDP 接入：ChargeUdpService

Charge/ChargeUdpService.cs：

创建线程监听 UDP：UdpClient(40001)
循环接收并转发：
- CommunicationMessageService.AddReceiveMessage(remoteIp, 40001, hexString, "FRLDShort")
同时会通过 SimpleProject.proj.Missions 找到 StandardChargeMission 实例，并在 chargeMission.ChargeStations 中按 IP 找到对应站点
对特定站点类型（例如 PCBChargeStation）进一步更新站点字段（例如 IsSafe、IndexReceive）

5.2 TCP 接入：以 FLChargeStation 为例（ChargeStationType）

以 ChargeStationType/FLChargeStation.cs 为例：

OnPlaintextReceived(...) 在收到 TCP 明文后：
- 提取报文字节（示例中 Take(35)）
- 更新站点内的一些运行时字段（例如 IsSafe）
- 调用 CommunicationMessageService.AddReceiveMessage(...)，并把 type 传为对应协议类型（例如 "FRLDTall"）

说明：具体 TCP 断连/重连机制由底层 TCP 客户端与对应站点实现决定；无论 TCP/UDP，最终都会汇聚到 CommunicationMessageService 完成解析与落库。

6. 运行时充电业务循环：StandardChargeMission

Charge/StandardChargeMission.cs 负责把“调度系统中的车的状态 + 充电策略 + 站点配置”组合成周期性的充电指令下发。

6.1 初始化充电桩实例（创建 station 对象）

关键步骤（来自实现片段）：

遍历系统 Site 中带有 fields["Charge"] 的站点，构建 station 配置
根据 ChargeStationType 使用反射创建 AbstractChargeStation 实例
给站点对象赋值：
- SiteId、Ip、Port
- CommunicationType
  - 示例：FRLDShort 时设置为 "UDP"；否则使用配置中的 CommunicationType（默认走 TCP）
调用 chargeStation.CreateCommunication(ipAddress, port) 建立通信通道
把站点对象加入 ChargeStations 字典：Dictionary<int, AbstractChargeStation>

如果存在任何 UDP 站点，会创建 UdpService ??= new ChargeUdpService()。

6.2 500ms 业务循环（选择车辆 -> 下发指令）

主循环（实现中包含 Thread.Sleep(500)）逻辑大致如下：

对每个 chargeStationEntry（按站点遍历）：
- 通过 SimpleLib.GetAllCars() 查找：
  - 车辆当前所在站点 c.GetLastSite() == siteId
  - 或车辆正在竞争锁/持有锁（aquiringLock == siteId 或 holdingLocks.Contains(siteId)）
若找到车辆：
- 判断车辆状态：Commons.GetVehicleStatus((Car)car) == VehicleStatus.Normal
- 判断是否正在“充电标记”（car.tags.Contains("charging")）
- 结合锁状态与 tag 状态计算 openCharge（0/1）
当未屏蔽交互（shieldInterLock == false）时下发指令：
- chargeStation.SendToChargeStation(openCharge, (Car)car)

6.3 Stop/ShieldInterLock/管理界面入口

Stop()：中止 mission 线程，并对每个 station 调用 CloseCommunication()
ShieldInterLock()：切换“是否屏蔽充电桩交互”
OpenManagementWindow()：打开 ChargeStationHelper.OpenManagementWindow()

7. WinForms 界面与交互细节

7.1 充电桩管理：ChargeStationManagementForm

文件：Charge/ChargeStationManagementForm.cs

核心展示数据来源

列表数据来源：ChargeStationDataService.GetAllStations()
UI 侧通讯状态：
- 在 LoadStations() 中对每个 station 执行 Ping.Send(station.IpAddress, 1000)
- Ping 成功则 station.CommStatus = CommunicationStatus.Normal，否则 CommunicationStatus.Error
电气/运行时信息来源：
- ChargeCommandStatus、Status、MechanismStatus、HasAlarm/AlarmLevel/AlarmMessage、RealTimeVoltage/Current 等都来自 CommunicationMessageService 解析并落库后的 ChargeStation 字段

自动刷新

autoRefreshTimer.Interval = 3000
AutoRefreshTimer_Tick：
- 保存当前选中行的 StationId
- 调用 LoadStations() 重绘
- 恢复选中行

关键编辑与保存逻辑（btnSave）

btnSave.Text == "修改"：先切换为编辑模式 SetEditMode(true)
新增/保存时校验：
- StationId 不能为空且必须是 1-99 范围整数
- 新增时禁止重复 StationId
- SiteId 必须存在于调度系统站点集合（SimpleLib.GetSite((int)numSiteId.Value)）
保存调用：
- 新增：dataService.AddStation(...)
- 更新：dataService.UpdateStation(..., isSave:true)
同步到调度系统 Site.fields：
- setVoltage、setElectricCurrent
- group：根据 Enabled 设置为 "禁用" 或 GroupCarType

删除逻辑（btnDelete）

调用 dataService.DeleteStation(stationId, out errorMessage)
同步清理 Site.fields：
- 移除 setVoltage、setElectricCurrent、Charge、group

列表交互

dgvStations_CellDoubleClick：
- 根据 StationId 查找 ChargeStation
- 调用 LoadStationToFields(station)
- 进入编辑模式 SetEditMode(true, true)

其它窗口入口按钮

btnStrategyConfig_Click：打开 ChargeStrategyConfigForm
btnCommMonitor_Click：打开 CommunicationMonitorForm
btnAlarmConfig_Click：打开 AlarmConfigManagementForm
btnExport_Click：导出 JSON 或 CSV（从 GetAllStations() 读取）

7.2 策略配置：ChargeStrategyConfigForm

文件：Charge/ChargeStrategyConfigForm.cs

初始化：config = configService.LoadConfig()
保存：把 UI 控件值写入 ChargeStrategyConfig 后调用 configService.SaveConfig(config)
恢复默认：调用 ChargeStrategyConfig.CreateDefault() 并重新加载到界面

7.3 通信监控：CommunicationMonitorForm

文件：Charge/CommunicationMonitorForm.cs

初始化：
- messageService = CommunicationMessageService.Instance
- 窗体加载完成后订阅：messageService.MessageAdded += OnMessageAdded
新报文到达：OnMessageAdded(...)
- 若 InvokeRequired 则 BeginInvoke 回 UI 线程
- 根据当前 IP 筛选条件刷新消息列表（调用 LoadMessages()）
消息列表展示：
- 从 messageService.GetAllMessages() 或 GetMessagesByIp(ip) 取出数据
- 根据 Direction（发送/接收）设置行颜色
统计信息：
- lblStatistics.Text = $"显示: {displayCount} | 总数: ... | 发送: ... | 接收: ..."

7.4 报警配置管理：AlarmConfigManagementForm

文件：Charge/AlarmConfigManagementForm.cs

界面加载：
- 初始化级别下拉框与筛选下拉框
- 调用 LoadAlarmConfigs()
列表加载逻辑：
- 从 AlarmConfigDataService.GetAllAlarmConfigs() 获取全量
- 按筛选条件（等级 cmbLevelFilter、搜索框 txtSearch）过滤
- 填充 dgvAlarmConfigs 并根据 AlarmLevel 设置行颜色
保存：
- selectedAlarmConfig == null -> 新增 dataService.AddAlarmConfig
- 否则 -> 更新 dataService.UpdateAlarmConfig
删除：
- dataService.DeleteAlarmConfig(selectedAlarmConfig.AlarmId, out ...)
双击列表：
- dgvAlarmConfigs_CellDoubleClick 读取 AlarmId 并加载到编辑区

7（代码一致性修订）：UI 窗体导航与更新流

7.1 `ChargeStationManagementForm`（充电桩管理）

入口/导航

通过 ChargeStationHelper.OpenManagementWindow()（单例 Show()）或 ChargeStationHelper.OpenManagementDialog()（ShowDialog()）打开。
窗体内通过按钮打开：
- btnStrategyConfig_Click -> ChargeStrategyConfigForm.ShowDialog()
- btnCommMonitor_Click -> CommunicationMonitorForm.Show()
- btnAlarmConfig_Click -> AlarmConfigManagementForm.ShowDialog()

更新/刷新

列表自动刷新：autoRefreshTimer.Interval = 3000，AutoRefreshTimer_Tick 会保存当前选中 StationId、重建 dgvStations（LoadStations()）、再恢复选中行。
关闭窗体：OnFormClosing 停止并释放 autoRefreshTimer。
LoadStations() 的状态刷新点：
- 数据：ChargeStationDataService.GetAllStations() + 按 cmbStatusFilter 过滤。
- 通讯状态：逐个对站点执行 Ping.Send(station.IpAddress, 1000)，成功/失败分别写入 station.CommStatus，再刷新行颜色。
搜索/筛选：txtSearch_TextChanged 与 cmbStatusFilter_SelectedIndexChanged 都会触发 ApplyFilters()，清空并重建 dgvStations（包含行颜色规则）。
手动刷新：btnRefresh_Click -> dataService.Reload() -> LoadStations()。

编辑与保存

双击列表：dgvStations_CellDoubleClick -> LoadStationToFields(station) -> SetEditMode(false)（查看模式，btnSave.Text="修改"）。
btnSave_Click 两段式：
- btnSave.Text=="修改"：仅切到编辑模式 SetEditMode(true)。
- 否则执行保存：校验 StationId（1-99）、新增时校验唯一性、校验 SiteId 存在，然后调用 AddStation / UpdateStation(..., isSave:true)。
- 保存成功后同步调度系统 Site.fields：setVoltage、setElectricCurrent、group（启用写 GroupCarType，禁用写 "禁用"），再刷新列表并清空编辑区。
删除：btnDelete_Click 确认后 DeleteStation，并同步清理 Site.fields（setVoltage、setElectricCurrent、Charge、group）。

7.2 `ChargeStrategyConfigForm`（充电策略配置）

入口/导航

通常由管理窗体打开：ChargeStationManagementForm 的 btnStrategyConfig_Click 使用 ShowDialog()。

更新/刷新

初始化：configService = ChargeStrategyConfigService.Instance，构造时 LoadConfig() 把文件配置加载到界面控件。
保存/应用：btnSave_Click 与 btnApply_Click 都会先 ValidateConfig() 校验阈值关系，再把控件值写回 config 并调用 configService.SaveConfig(config)。
恢复默认：btnRestoreDefaults_Click 确认后 config = ChargeStrategyConfig.CreateDefault()，调用 LoadConfig(true) 刷新界面，但不自动保存（状态提示“未保存”）。
取消：btnCancel_Click -> Close()。

7.3 `CommunicationMonitorForm`（通信监控）

入口/导航

由管理窗体 btnCommMonitor_Click 打开：Show()（非阻塞）。

更新/刷新（事件驱动）

构造中拿到 messageService = CommunicationMessageService.Instance；FormClosing 退订 MessageAdded。
CommunicationMonitorForm_Load：
- InitializeForm() + LoadMessages() 后设置 isFormLoaded=true
- 再订阅 messageService.MessageAdded += OnMessageAdded
OnMessageAdded：
- InvokeRequired 时 BeginInvoke 回 UI 线程
- 新 IP 则刷新 cmbIpFilter（RefreshIpFilter()）
- 若当前筛选匹配（“全部”或等于当前消息 IP）则调用 LoadMessages() 重建消息列表
手动操作：
- cmbIpFilter_SelectedIndexChanged -> LoadMessages()
- btnRefresh_Click -> RefreshIpFilter() + LoadMessages()
- btnClear_Click：确认 -> messageService.Clear() -> 刷新列表并清空 txtParsedData
列表选择与解析展示：
- dgvMessages_SelectionChanged 根据所选行构造临时 CommunicationMessage，再调用 ParseMessage()，并将解析结果写入 txtParsedData。

7.4 `AlarmConfigManagementForm`（报警配置管理）

入口/导航

由管理窗体 btnAlarmConfig_Click 打开：ShowDialog()。

更新/刷新（加载 + 筛选/搜索）

构造：dataService = AlarmConfigDataService.Instance，并订阅 this.Load += AlarmConfigManagementForm_Load。
InitializeForm()：
- 初始化 cmbLevel 与 cmbLevelFilter
- 调用 LoadAlarmConfigs() 加载列表
- 调用 ClearEditFields() 初始化编辑区（默认新增态）
LoadAlarmConfigs()：
- 数据源：dataService.GetAllAlarmConfigs()
- 过滤：cmbLevelFilter（映射到 AlarmLevel）与 txtSearch（匹配 AlarmId/AlarmCode/AlarmContent）
- 填充 dgvAlarmConfigs 并按 AlarmLevel + Enabled 设置行颜色/样式，同时更新统计与标题
实时刷新：txtSearch_TextChanged 与 cmbLevelFilter_SelectedIndexChanged 都直接调用 LoadAlarmConfigs()；btnRefresh_Click 会 dataService.Reload() 后重新加载。

编辑与保存

双击列表：dgvAlarmConfigs_CellDoubleClick 读取 AlarmId -> dataService.GetAlarmConfig(alarmId) -> LoadAlarmConfigToFields()（编号不可编辑，切为编辑态）。
保存：btnSave_Click 校验 numAlarmCode >= 0、txtAlarmContent 非空；根据是否选中项决定 AddAlarmConfig 或 UpdateAlarmConfig；成功后刷新列表并清空编辑区。
删除：btnDelete_Click 确认后 DeleteAlarmConfig(selectedAlarmConfig.AlarmId)，成功后刷新列表并清空编辑区。
取消/关闭：btnCancel_Click 清空编辑区，btnClose_Click 关闭窗体。

8. 关键调用链（建议排查/理解用）

8.1 周期循环下发充电指令 -> 发送报文记录 -> ChargeCommandStatus 更新

flowchart TD
  A[StandardChargeMission 500ms循环] --> B[chargeStation.SendToChargeStation(openCharge, car)]
  B --> C[chargeStation 内部构造发送报文]
  C --> D[CommunicationMessageService.AddSendMessage(...)]
  D --> E[ParseSendRawData(type)]
  E --> F[UpdateStationFromSendData]
  F --> G[ChargeStationDataService.UpdateStation]
  G --> H[ChargeStation 字段落库]
  H --> I[ChargeStationManagementForm(3s刷新) 展示]

8.2 TCP/UDP 接收报文 -> 解析 -> ChargeStation 状态与告警更新 -> UI 展示

flowchart TD
  A[TCP 收到明文 或 UDP 收到报文] --> B[CommunicationMessageService.AddReceiveMessage(...)]
  B --> C[ParseReceiveRawData(type)]
  C --> D[UpdateStationFromReceiveData]
  D --> E[ChargeStationDataService.UpdateStation]
  E --> F[ChargeStation 字段落库]
  F --> G[ChargeStationManagementForm(3s刷新) 展示 Status/告警/电压电流]

8.3 通信监控界面订阅报文事件

flowchart TD
  A[CommunicationMessageService.AddMessage/MessageAdded] --> B[CommunicationMonitorForm.OnMessageAdded]
  B --> C[BeginInvoke 切到UI线程]
  C --> D[LoadMessages 刷新 dgvMessages]

9. 常用调试点（建议）

通信解析落库：
- 看 CommunicationMessageService 的 UpdateStationFromSendData/ReceiveData 更新了哪些字段
UI 展示：
- ChargeStationManagementForm.LoadStations() 中的 Ping.Send(...) 会影响 CommStatus 展示
如果“列表里状态不变”：
- 优先确认报文是否真的进入 CommunicationMessageService.AddSendMessage/AddReceiveMessage
- 再确认解析是否返回非 null（解析失败会直接 return null）

StandardScene/Charge：充电桩数据模型与持久化（仅数据层）

本页聚焦 StandardScene/Charge/ 中与“数据模型 + DataService 持久化/更新 API”相关的部分，覆盖：

ChargeStation：充电桩配置/运行时状态字段含义与 JsonIgnore 持久化边界
ChargeStationDataService：Config/ChargeStations.json 的读取/保存、增删改与状态更新
AlarmConfig 与 AlarmConfigDataService：Config/AlarmConfigs.json 的读取/保存、增删改

1. 数据模型：`ChargeStation`

文件：Charge/ChargeStation.cs

1.1 配置/计算字段说明（按 `JsonIgnore` 区分）

ChargeStation 的下列字段用于“充电桩配置”，在 JSON 里会被序列化（即：未标注 JsonIgnore）：

StationId：充电桩编号（唯一标识）
Name：充电桩名称
Type：充电桩类型（ChargeStationType）
ChargeMethod：充电方式（ChargeMethodType）
IpAddress：IP 地址
Port：端口号
CommunicationType：通讯类型（属性初始值为 "TCP"，但构造函数会覆盖为 "UDP"）
SetVoltage：额定电压（V）
SetElectricCurrent：额定电流（A）
Enabled：是否启用
GroupCarType：停靠车辆类型（ChargeStationCarType）
SiteId：关联站点 ID（可选）
ShieldSiteMechanismStatus：屏蔽机构状态交互
Remarks：备注
CreatedTime：创建时间
ModifiedTime：最后修改时间
Power：计算属性（SetVoltage * SetElectricCurrent），标注了 [JsonIgnore]，不会写入 JSON

1.2 运行时状态字段（不会被持久化到 JSON）

以下字段标注了 [JsonIgnore]，因此不会写入 Config/ChargeStations.json（重启后这些运行时状态通常会丢失）：

RealTimeVoltage、RealTimeCurrent：实时电压/电流
LastSendTime、LastReceiveTime：最后发送/接收时间
HasAlarm、AlarmMessage、AlarmLevel：报警标记/报警文本/报警级别
CommStatus、LastCommunicationTime：通讯状态/最后通讯时间（注意：当前代码里通讯状态字段的更新路径不在本节展开）
MechanismStatus：机构伸缩状态
CurrentVehicle：当前充电车辆编号
BatteryLevel：当前电量百分比
ChargeCommandStatus：发送充电指令状态（停止/启动）
Status：充电桩状态（空闲/充电中/报警中/AGV电池已接入）

1.3 校验：`IsValid(out errorMessage)`

ChargeStation.IsValid() 约束：

StationId、Name、IpAddress 不能为空
IpAddress 需为可解析的 IP
Port 必须在 1-65535
SetVoltage 必须在 (0, 64]
SetElectricCurrent 必须在 (0, 101]

2. 数据服务：`ChargeStationDataService`

文件：Charge/ChargeStationDataService.cs

2.1 单例与持久化文件

单例：ChargeStationDataService.Instance
内部数据：private List<ChargeStation> chargeStations
JSON 文件路径：基于运行目录写入
- AppDomain.CurrentDomain.BaseDirectory/Config/ChargeStations.json
构造函数会确保 Config/ 目录存在，并执行 LoadData()

2.2 读取：`LoadData()`

行为：

若文件存在：读取文本并 JsonConvert.DeserializeObject<List<ChargeStation>>(json)
若文件不存在：初始化为空列表（并不会自动生成默认样例）
异常：记录诊断日志并回退到空列表

2.3 保存：`SaveData()`

行为：

在锁 lockObj 下序列化整个 chargeStations 列表
写入文件 Config/ChargeStations.json（Formatting.Indented）
保存失败：返回 false 并由调用方回滚内存状态（部分方法会回滚）

2.4 查询 API

List<ChargeStation> GetAllStations()：返回列表副本（拷贝）
ChargeStation GetStationById(string stationId)：按 StationId 查找
ChargeStation GetStationByIp(string ipAddress, int port)：按 IpAddress + Port 查找
List<ChargeStation> GetIdleStations()：过滤 Enabled && Status == Idle
int GetChargingCount()：统计 Status == Charging
void Reload()：重新执行 LoadData()

2.5 新增：`AddStation(ChargeStation station, out string errorMessage)`

关键点：

station == null 返回失败
先执行 station.IsValid(out errorMessage)
唯一性校验：
- StationId 不可重复
- IpAddress + Port 组合不可重复
写入字段：
- 设置 CreatedTime / ModifiedTime 为当前时间
成功后：SaveData()；失败则将新增对象从内存移除

2.6 更新：`UpdateStation(ChargeStation station, out string errorMessage, bool isSave = false)`

该方法同时被用作“配置更新”与“运行时状态合并后再落盘”的入口之一（不同调用方会用不同的 isSave 值）。

核心流程：

校验：station.IsValid(out errorMessage)
找到原对象：existingStation = chargeStations.FirstOrDefault(s => s.StationId == station.StationId)
冲突校验：IpAddress + Port 不能被其它站点占用
时间处理：
- 保留 existingStation.CreatedTime
- 更新 station.ModifiedTime = DateTime.Now
赋值策略取决于 isSave：
- isSave == true：仅将“配置类字段”拷贝到 existingStation（并令 station = existingStation）
- isSave == false：不进行字段级拷贝，直接用传入的 station 替换列表里的对应项
之后无论 isSave 为何都会执行 SaveData() 并落盘整个列表
保存失败：回滚为 existingStation

持久化边界提醒（结合 ChargeStation 的 JsonIgnore）：

因为 Status / Alarm / 实时电压电流等运行时字段 都是 JsonIgnore，即使 UpdateStation 被用于合并运行时字段，重启后这些运行时字段仍不会出现在 JSON 中
但 ModifiedTime（未 JsonIgnore）会被写入，因此会出现“通信上报频繁导致 JSON 文件 ModifiedTime 刷新”的现象

2.7 删除：`DeleteStation(string stationId, out string errorMessage)`

按 stationId 找到对象并移除
成功后保存；失败则将对象重新加入内存
代码中原本有“如果正在充电则禁止删除”的检查，但被注释掉了

2.8 状态更新（运行时）：`UpdateStationStatus(string stationId, ChargeStationStatus status)`

修改内存对象的 Status 与 ModifiedTime
然后 SaveData()
由于 Status 标注了 JsonIgnore，因此重启后站点 Status 通常不会从 JSON 恢复（但 ModifiedTime 会更新）

3. 数据模型：`AlarmConfig`

文件：Charge/AlarmConfig.cs

3.1 字段含义（会被持久化）

AlarmConfig 没有 JsonIgnore，因此以下字段都能写入 Config/AlarmConfigs.json：

AlarmId：报警编号（构造函数自动生成，格式类似 ALMyyyyMMddHHmmssxxx）
AlarmCode：报警编码值（int）
AlarmContent：报警内容描述（文本）
Level：报警级别（AlarmLevel：None/Low/Medium/High/Critical）
Enabled：是否启用
Remarks：备注
CreatedTime / ModifiedTime：创建与修改时间

3.2 校验：`IsValid(out errorMessage)`

AlarmId 不能为空
AlarmCode >= 0
AlarmContent 不能为空

4. 数据服务：`AlarmConfigDataService`

文件：Charge/AlarmConfigDataService.cs

4.1 单例与持久化文件

单例：AlarmConfigDataService.Instance
数据文件路径：AppDomain.CurrentDomain.BaseDirectory/Config/AlarmConfigs.json
构造函数调用 LoadData()；若目录不存在则创建

4.2 读取：`LoadData()`

行为：

文件存在：读取并反序列化为 List<AlarmConfig>
- 若反序列化结果为 null，回退为空列表
文件不存在：初始化默认报警配置 InitializeDefaultAlarms()，随后 SaveData()
异常：记录 Debug.WriteLine，回退到空列表并初始化默认报警配置

默认报警包含（示例）：

1001：电压过高
1002：电压过低
1003：电流过大
2001：温度异常
3001：通讯超时
3002：连接断开

4.3 保存：`SaveData()`

序列化整个 _alarmConfigs 并写入 AlarmConfigs.json
保存失败会抛出异常（不只是返回 false）

4.4 查询 API

List<AlarmConfig> GetAllAlarmConfigs()：返回列表副本
AlarmConfig GetAlarmConfig(string alarmId)：按 AlarmId 查找
AlarmConfig GetAlarmConfigByCode(int alarmCode)：按 AlarmCode 查找

4.5 新增：`AddAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`

先执行 alarmConfig.IsValid(out errorMessage)
校验 AlarmCode 唯一性（不允许重复）
添加到列表后 SaveData()

4.6 更新：`UpdateAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`

校验：IsValid
查找目标：按 AlarmId 找到索引；不存在则失败
冲突校验：AlarmCode 不能被其它报警配置占用
设置 alarmConfig.ModifiedTime = DateTime.Now
替换列表项并 SaveData()

4.7 删除：`DeleteAlarmConfig(string alarmId, out string errorMessage)`

按 AlarmId 找到并移除
然后 SaveData()

4.8 重新加载：`Reload()`

在锁下重新执行 LoadData()

5. 与“更新路径”的关系（为何运行时变化也会触发落盘）

虽然本页主要讲 DataService，但为了说明“哪些字段会/不会出现在 JSON 里”，需要点到调用关系：

通讯层（Charge/CommunicationMessageService.cs）在解析发送/接收报文后，会：
- 更新 ChargeStation 的运行时字段（例如 HasAlarm、Status、RealTimeVoltage/Current 等）
- 然后调用 ChargeStationDataService.UpdateStation(station, out errorMessage)（使用默认 isSave=false）
UI 保存站点配置（Charge/ChargeStationManagementForm.cs）在“保存/修改配置”时会调用：
- ChargeStationDataService.UpdateStation(station, out errorMessage, true)
报警配置的 UI 增删改（Charge/AlarmConfigManagementForm.cs）直接调用：
- AddAlarmConfig / UpdateAlarmConfig / DeleteAlarmConfig

因此你会观察到：

ChargeStations.json 中的“运行时字段”不会被写入（因为它们带 JsonIgnore）
但 ModifiedTime 这类未忽略字段会被写入，所以文件仍会频繁变化

6. 通讯报文解析：`CommunicationMessageService` 如何更新 `ChargeStation`

本节重点解释 Charge/CommunicationMessageService.cs 中“报文解析 -> 更新充电桩运行时字段”的完整链路（并说明当前实现里哪些字段没有被真正落到 ChargeStation）。

6.1 入口与站点匹配规则

CommunicationMessageService 通过两个入口接收外部报文，并在内部完成“解析 + 更新 + 落盘（通过 DataService）”：

发送报文入口：AddSendMessage(ipAddress, port, rawData, type, stationId)
接收报文入口：AddReceiveMessage(ipAddress, port, rawData, type, stationId)

两条链路在解析前都会做同样的站点匹配：

先拿到单例：ChargeStationDataService.Instance
通过 GetStationByIp(ipAddress, port) 找到对应 ChargeStation
找不到站点直接返回（此时只会记录报文，不会更新该站点运行时字段）

解析成功后才会调用：

ChargeStationDataService.UpdateStation(station, out errorMessage)（该调用在当前代码里使用默认参数，最终会落盘整个 ChargeStations.json；但由于运行时字段多为 JsonIgnore，重启后这些运行时值不会恢复）

异常处理方面：

ParseSendDataAndUpdateStation / ParseReceiveDataAndUpdateStation 都使用 try/catch 并“静默吞掉异常”，因此解析失败通常表现为：报文列表有记录，但充电桩字段没有变化。

6.2 发送报文解析与字段更新（`UpdateStationFromSendData`）

发送报文完整调用链如下：

AddSendMessage -> ParseSendDataAndUpdateStation -> ParseSendRawData(rawData, type) -> UpdateStationFromSendData(station, parsedData) -> ChargeStationDataService.UpdateStation(...)

6.2.1 `ParseSendRawData` 输入格式与 `type` 支持

ParseSendRawData 的输入要求：

rawData 以空格分隔字节 token（例如："BB 01 42 ..."）
每个 token 会按十六进制解析：byte.TryParse(token, NumberStyles.HexNumber, ...)
发送报文最少 token 数：parts.Length >= 10

当前实现里，type 仅对以下两种有明确字节位映射：

FRLDShort
FRLDTall

其他 type（例如 MuXing）不会命中映射分支，此时解析出来的数值保持默认值，然后仍可能触发 UpdateStationFromSendData 的“默认覆盖”逻辑（见下文“已知限制”）。

6.2.2 从发送报文写入哪些 `ChargeStation` 字段

UpdateStationFromSendData 实际更新的字段如下（直接对应代码赋值）：

station.LastSendTime = parsedData.SendTime
station.ChargeCommandStatus
- parsedData.ChargeCommand == 1 -> ChargeCommandStatus.Started
- parsedData.ChargeCommand == 0 -> ChargeCommandStatus.Stopped
station.BatteryLevel = parsedData.BatteryLevel
station.CurrentVehicle = parsedData.CurrentVehicleId.ToString()

注意：

UpdateStationFromSendData 里 SetVoltage / SetElectricCurrent 的赋值被注释掉了（即：发送报文不会更新 ChargeStation.SetVoltage / ChargeStation.SetElectricCurrent 的配置目标值）。

6.3 接收报文解析与字段更新（`UpdateStationFromReceiveData`）

接收报文完整调用链如下：

AddReceiveMessage -> ParseReceiveDataAndUpdateStation -> ParseReceiveRawData(rawData, type) -> UpdateStationFromReceiveData(station, parsedData) -> ChargeStationDataService.UpdateStation(...)

6.3.1 `ParseReceiveRawData` 输入格式与 `type` 支持

ParseReceiveRawData 的输入要求：

rawData 以空格分隔字节 token（rawData.Split(' ')）
接收报文最少 token 数：parts.Length >= 30
每个 token 的解析使用的是 byte.TryParse(parts[i], out bytes[i])（没有显式 NumberStyles.HexNumber）

因此当 rawData token 形如十六进制字节（例如 0A、FF）时，可能出现解析失败导致 parsedData == null（从而不会更新站点字段）的情况。

type 的字节位映射同样只实现了两种：

FRLDShort
FRLDTall

6.3.2 从接收报文写入哪些 `ChargeStation` 字段

UpdateStationFromReceiveData 实际更新的字段如下：

station.LastReceiveTime = parsedData.ReceiveTime
station.MechanismStatus = parsedData.MechanismStatus
station.RealTimeVoltage = parsedData.RealTimeVoltage
station.RealTimeCurrent = parsedData.RealTimeCurrent
station.Status = parsedData.Status
station.HasAlarm = parsedData.HasAlarm
station.AlarmLevel = parsedData.AlarmLevel
station.AlarmMessage
- parsedData.HasAlarm == true -> 报警级别: {GetAlarmLevelText(parsedData.AlarmLevel)}
- 否则 -> string.Empty

与报警相关的映射：

ParseReceiveRawData 里 HasAlarm = chargeStationStatus == 2
ParseStationStatus 将 statusByte == 2 映射为 ChargeStationStatus.Fault

当前实现里 AlarmLevel 的来源有一个明显限制：

ParseReceiveRawData 中 AlarmLevel = ParseAlarmLevel(bytes[20]) 被注释掉了
因此 parsedData.AlarmLevel 多半保持默认值（AlarmLevel.None），但只要 HasAlarm == true，AlarmMessage 仍会按默认 AlarmLevel 生成文本

同时，ParsedReceiveData 中的以下字段虽然会解析出来，但 UpdateStationFromReceiveData 没有把它们写入 ChargeStation：

ParsedReceiveData.CommStatus
ParsedReceiveData.ChargeCommandStatus
ParsedReceiveData.ChargeID
ParsedReceiveData.BatteryAH

6.4 已知限制/行为总结（影响“字段是否更新”）

解析失败只影响“字段更新”，不影响“报文记录与 UI 列表展示”
- 报文一定会先进入 _messages（并触发 MessageAdded）
- 但解析函数返回 null / 站点找不到 / 异常时，字段更新不会发生
站点匹配使用 IP + Port
- GetStationByIp(ipAddress, port) 找不到对应 ChargeStation 时，不会更新该站点运行时字段
type 只对 FRLDShort / FRLDTall 完成了映射
- 发送侧对未知 type 仍会返回默认 ParsedSendData，从而可能覆盖 ChargeCommandStatus / BatteryLevel / CurrentVehicle 为默认值
- 接收侧未知 type 也可能产生默认 ParsedReceiveData，但前提是 rawData.Split(' ') 后仍满足 parts.Length >= 30
接收侧 token 解析方式可能与输入十六进制格式不一致
- ParseReceiveRawData 未使用 NumberStyles.HexNumber
- 如果 rawData token 是十六进制字节（如 0A），可能导致 parsedData == null，进而不更新实时字段

7. 运行时充电业务：StandardChargeMission

本节聚焦 Charge/StandardChargeMission.cs 中的“充电进程启动 + 500ms 充电业务循环”，并跟踪 SendToChargeStation(...) 的真实调用路径到具体充电桩实现类。

7.1 启动入口：`Execute()`

StandardChargeMission.Execute() 负责启动充电进程，核心流程：

设置进程状态：status.status = "已启动"
防重复启动：通过 myStarted 判断，避免重复创建线程
初始化运行时字典：ChargeStations = new Dictionary<int, AbstractChargeStation>()
创建后台线程：ChargeThread = new Thread(() => { ... })
- 在线程内部完成“充电站初始化 + 500ms 业务循环”
启动辅助任务：定期上传带 unavailable 标签的站点到迷毂系统（同样是 Thread.Sleep(500) 周期）
最后调用 base.Execute()，让基类调度/联锁逻辑继续工作

7.2 初始化：后台线程 Step1（创建/重建 `AbstractChargeStation`）

在 ChargeThread 的 while (true) 内部，每一轮都会先执行“步骤1：初始化充电站”：

读取配置：ChargeStationHelper.GetAllStationConfigs()
- 底层来自 ChargeStationDataService.Instance.GetAllStations()
遍历每个充电桩配置项，执行校验与创建：
- Enabled == false：跳过
- 校验 SiteId > 0、IpAddress 可解析、Port 在 1-65535
- 若字典里已存在相同 siteId 的站点：
  - 当 IP/Port 发生变化：existingStation.CloseCommunication() 后更新 Ip/Port 并重新 CreateCommunication(...)
  - IP/Port 未变化：直接 continue（复用原连接）
- 若不存在：
  - 使用 GetChargeTypeString(stationConfig.Type) 映射到具体站点类名：
    - FRLDTall -> FLChargeStation
    - FRLDShort -> PCBChargeStation
    - MuXing -> MuXingChargeStation
    - 默认回退 -> PCBChargeStation
  - Activator.CreateInstance(type) 创建对象，设置：
    - SiteId / Ip / Port
    - CommunicationType：FRLDShort 强制 UDP，其它使用配置里的 CommunicationType
  - 调用 CreateCommunication(ipAddress, port) 建立通信连接
  - 放入字典：ChargeStations.Add(siteId, stationInstance)

同时，线程内部还会做 UDP 服务初始化：

若存在任意站点 CommunicationType == "UDP"：
- UdpService ??= new ChargeUdpService();

7.3 500ms 业务循环：后台线程 Step3 + `SendToChargeStation(...)`

ChargeThread 的主循环结构（简化）：

读取互锁开关：var shieldInterLock = ((StandardChargeMissionStatus)status).ShieldInterLock
更新/清理配置绑定：
- 若 ChargeStationHelper.GetStationBySiteId(siteId) == null：从 ChargeStations 移除该站点
- 对 SimpleLib.GetAllSites() 中仍带 fields["Charge"] 但不在 ChargeStations 配置里的站点：
  - 移除 Charge / setVoltage / setElectricCurrent / group 等字段
遍历每个站点，执行“车辆搜索 -> openCharge 计算 -> 下发”：
- 取站点配置：chargeStationSetting = ChargeStationHelper.GetStationBySiteId(siteId)
- 若 !chargeStationSetting.Enabled：跳过
- 将站点配置绑定回 site.fields：
  - site.fields["Charge"] = "True"
  - site.fields["setVoltage"] = chargeStationSetting.SetVoltage.ToString("0.0")
  - site.fields["setElectricCurrent"] = chargeStationSetting.SetElectricCurrent.ToString("0.0")
- site.fields["group"]：启用时写 GroupCarType，禁用时写 "禁用"
- 设置站点进入/离开权限：
  - ChargeMethodType.Side 分支：SetAllowEnter / SetAllowExit 与 ShieldSiteMechanismStatus / MechanismStatus == Retracted 联动
  - 非 Side：直接 SetAllowEnter(true) / SetAllowExit(true) / SetAcknowledgeLeave(true)
- 查找与该站点相关的车辆（在站/获取锁/持有锁）：
  - GetLastSite() == siteId 或 aquiringLock == siteId 或 holdingLocks.Contains(siteId)
- 计算 openCharge：
  - 默认 0
  - 仅当车辆存在且 Commons.GetVehicleStatus((Car)car) == VehicleStatus.Normal
  - 并且满足充电条件：
    - charging 标记存在
    - 未被占用：!car.tags.Contains("occupied")
    - 锁状态匹配：holdingLocks.Length == 1 且 pendingLocks.Length == 0
  - 则 openCharge = 1
- 互锁门控后下发指令：
  - 若 !shieldInterLock：
    - chargeStation.SendToChargeStation(openCharge, (Car)car);
循环尾部固定节拍：Thread.Sleep(500)

7.4 `SendToChargeStation` 调用链（下发路径）

�� 500ms 循环中，下发的调用路径是：

StandardChargeMission(ChargeThread 500ms loop) -> AbstractChargeStation 子类 SendToChargeStation(int isCharge, Car car) -> 子类内部组包 + 记录发送报文：CommunicationMessageService.Instance.AddSendMessage(...) -> 通过 TCP/UDP 通道真正发送报文

各站点实现类的“发送端”关键点：

FLChargeStation.SendToChargeStation
- 依赖 IsConnected && Client != null，否则不发送
- 读取 Car 的 Soc/Voltage/ElectricCurrent，并可覆盖 site.fields["setVoltage"]/["setElectricCurrent"]
- AddSendMessage(..., "FRLDTall", site?.name) 后 Client.Send(msg)
MuXingChargeStation.SendToChargeStation
- 计算 openChargePort = (isCharge == 1 ? 2 : 3) 并组包（包含时间戳与 CRC）
- AddSendMessage(..., "MuXing") 后写入 TCP stream
PCBChargeStation.SendToChargeStation（FRLDShort）
- 使用 UdpClient 发送
- AddSendMessage(..., "FRLDShort", site?.name) 后 udpClient.SendAsync(msg, msg.Length, _endPoint)

flowchart TD
  A[StandardChargeMission.Execute\n启动 ChargeThread] --> B[ChargeThread while(true)]
  B --> C[Step1 初始化/重建 ChargeStations]
  B --> D[Step3 遍历每个站点]
  D --> E[计算 openCharge(0/1)]
  E --> F{!ShieldInterLock}
  F -->|false| Z[跳过下发]
  F -->|true| G[chargeStation.SendToChargeStation(openCharge, car)]
  G --> H[站点子类组包]
  H --> I[CommunicationMessageService.AddSendMessage]
  I --> J[TCP/UDP 发送报文]

44 KiB Raw Blame History Unescape Escape

StandardScene - Charge 模块逻辑文档

1. 目录/模块职责速览（Charge/ 内）

数据与配置层

运行时与通信层

WinForms 界面层

2. 数据模型（ChargeStation / AlarmConfig / 策略）

2.1 ChargeStation（Charge/ChargeStation.cs）

2.2 枚举含义（ChargeStation.cs）

2.3 报警配置 AlarmConfig（Charge/AlarmConfig.cs）

2.4 策略配置 ChargeStrategyConfig（Charge/ChargeStrategyConfig.cs）

3. 持久化与服务层（DataService）

3.1 充电桩数据持久化：ChargeStationDataService

3.2 报警配置持久化：AlarmConfigDataService

4. 通信报文解析与落库：CommunicationMessageService

4.1 报文记录与订阅

4.2 发送报文路径（AddSendMessage -> 更新 ChargeCommandStatus 等）

4.3 接收报文路径（AddReceiveMessage -> 更新状态/机构/告警）

4.4 协议类型 type

5. 通信接入入口

5.1 UDP 接入：ChargeUdpService

5.2 TCP 接入：以 FLChargeStation 为例（ChargeStationType）

6. 运行时充电业务循环：StandardChargeMission

6.1 初始化充电桩实例（创建 station 对象）

6.2 500ms 业务循环（选择车辆 -> 下发指令）

6.3 Stop/ShieldInterLock/管理界面入口

7. WinForms 界面与交互细节

7.1 充电桩管理：ChargeStationManagementForm

核心展示数据来源

自动刷新

关键编辑与保存逻辑（btnSave）

删除逻辑（btnDelete）

列表交互

其它窗口入口按钮

7.2 策略配置：ChargeStrategyConfigForm

7.3 通信监控：CommunicationMonitorForm

7.4 报警配置管理：AlarmConfigManagementForm

7（代码一致性修订）：UI 窗体导航与更新流

7.1 ChargeStationManagementForm（充电桩管理）

7.2 ChargeStrategyConfigForm（充电策略配置）

7.3 CommunicationMonitorForm（通信监控）

7.4 AlarmConfigManagementForm（报警配置管理）

8. 关键调用链（建议排查/理解用）

8.1 周期循环下发充电指令 -> 发送报文记录 -> ChargeCommandStatus 更新

8.2 TCP/UDP 接收报文 -> 解析 -> ChargeStation 状态与告警更新 -> UI 展示

8.3 通信监控界面订阅报文事件

9. 常用调试点（建议）

StandardScene/Charge：充电桩数据模型与持久化（仅数据层）

1. 数据模型：ChargeStation

1.1 配置/计算字段说明（按 JsonIgnore 区分）

1.2 运行时状态字段（不会被持久化到 JSON）

1.3 校验：IsValid(out errorMessage)

2. 数据服务：ChargeStationDataService

2.1 单例与持久化文件

2.2 读取：LoadData()

2.3 保存：SaveData()

2.4 查询 API

2.5 新增：AddStation(ChargeStation station, out string errorMessage)

2.6 更新：UpdateStation(ChargeStation station, out string errorMessage, bool isSave = false)

2.7 删除：DeleteStation(string stationId, out string errorMessage)

2.8 状态更新（运行时）：UpdateStationStatus(string stationId, ChargeStationStatus status)

3. 数据模型：AlarmConfig

3.1 字段含义（会被持久化）

3.2 校验：IsValid(out errorMessage)

4. 数据服务：AlarmConfigDataService

4.1 单例与持久化文件

4.2 读取：LoadData()

4.3 保存：SaveData()

4.4 查询 API

4.5 新增：AddAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)

4.6 更新：UpdateAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)

4.7 删除：DeleteAlarmConfig(string alarmId, out string errorMessage)

4.8 重新加载：Reload()

5. 与“更新路径”的关系（为何运行时变化也会触发落盘）

6. 通讯报文解析：CommunicationMessageService 如何更新 ChargeStation

6.1 入口与站点匹配规则

6.2 发送报文解析与字段更新（UpdateStationFromSendData）

6.2.1 ParseSendRawData 输入格式与 type 支持

6.2.2 从发送报文写入哪些 ChargeStation 字段

6.3 接收报文解析与字段更新（UpdateStationFromReceiveData）

44 KiB

Raw Blame History

2.1 `ChargeStation`（`Charge/ChargeStation.cs`）

2.2 枚举含义（`ChargeStation.cs`）

2.3 报警配置 `AlarmConfig`（`Charge/AlarmConfig.cs`）

2.4 策略配置 `ChargeStrategyConfig`（`Charge/ChargeStrategyConfig.cs`）

3.1 充电桩数据持久化：`ChargeStationDataService`

3.2 报警配置持久化：`AlarmConfigDataService`

4.4 协议类型 `type`

7.1 `ChargeStationManagementForm`（充电桩管理）

7.2 `ChargeStrategyConfigForm`（充电策略配置）

7.3 `CommunicationMonitorForm`（通信监控）

7.4 `AlarmConfigManagementForm`（报警配置管理）

1. 数据模型：`ChargeStation`

1.1 配置/计算字段说明（按 `JsonIgnore` 区分）

1.3 校验：`IsValid(out errorMessage)`

2. 数据服务：`ChargeStationDataService`

2.2 读取：`LoadData()`

2.3 保存：`SaveData()`

2.5 新增：`AddStation(ChargeStation station, out string errorMessage)`

2.6 更新：`UpdateStation(ChargeStation station, out string errorMessage, bool isSave = false)`

2.7 删除：`DeleteStation(string stationId, out string errorMessage)`

2.8 状态更新（运行时）：`UpdateStationStatus(string stationId, ChargeStationStatus status)`

3. 数据模型：`AlarmConfig`

3.2 校验：`IsValid(out errorMessage)`

4. 数据服务：`AlarmConfigDataService`

4.2 读取：`LoadData()`

4.3 保存：`SaveData()`

4.5 新增：`AddAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`

4.6 更新：`UpdateAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`

4.7 删除：`DeleteAlarmConfig(string alarmId, out string errorMessage)`

4.8 重新加载：`Reload()`

6. 通讯报文解析：`CommunicationMessageService` 如何更新 `ChargeStation`

6.2 发送报文解析与字段更新（`UpdateStationFromSendData`）

6.2.1 `ParseSendRawData` 输入格式与 `type` 支持

6.2.2 从发送报文写入哪些 `ChargeStation` 字段

6.3 接收报文解析与字段更新（`UpdateStationFromReceiveData`）

6.3.1 `ParseReceiveRawData` 输入格式与 `type` 支持

6.3.2 从接收报文写入哪些 `ChargeStation` 字段

7.1 启动入口：`Execute()`

7.2 初始化：后台线程 Step1（创建/重建 `AbstractChargeStation`）

7.3 500ms 业务循环：后台线程 Step3 + `SendToChargeStation(...)`

7.4 `SendToChargeStation` 调用链（下发路径）