基于 DL/T645-2007 规约的多功能电能表通信调试上位机（.NET 8 / WPF / MVVM）：通过 RS485 串口轮询电能表的电量、电压、电流、功率等数据，实时卡片墙 + 三相电压趋势图 + 报文监视，内置仿真从站——没有真表也能克隆即跑。
📌 原创声明 本仓库为本项目的唯一原始出处，作者 @Jayla630，首次发布于 2026-07-01，完整开发脉络见本仓库提交历史（slice-01 → slice-07）。 本项目采用 MIT 许可证，欢迎自由使用、修改与转载；唯一前提是保留原作者署名并注明本仓库链接——这是 MIT 许可证的明确条件。任何删除署名的搬运或转载，均已超出 MIT 授权范围。
📌 Original Work This repository is the sole original source of this project, authored by @Jayla630 and first published on 2026-07-01; the full development history is visible in the commit log. Licensed under MIT — you are free to use, modify, and redistribute it, provided the original author attribution and a link to this repository are retained, as required by the MIT License. Any redistribution that strips this attribution falls outside the MIT grant.
demo.mp4
- 零硬件即可运行：内置 DL/T645 仿真从站与内存回环传输，克隆后直接启动，完整走通「连接 → 轮询 → 组帧 → 解析 → 展示」全链路。仿真数据按电网物理特性标定：频率在 49.90
50.10 Hz 随机游走、功率因数钳制 0.930.99、三相电压 209~235 V、电能只增不减单调走字。 - 139 个单元测试全绿：协议编解码契约测试（含手工推演的黄金报文向量）、帧扫描器增量组帧、收发统计口径、视图模型命令状态机、波动数据源长序列值域断言、CSV 导出转义与不变文化序列化。
- 严格分层架构：Core 纯类库（协议 + 领域模型 + 轮询服务，零框架依赖）/ Transport（真实串口 + 仿真回环）/ App（Prism + MVVM）。
ITransport接口置于 Core，服务层只依赖抽象——真实串口与仿真回环互换只改一行装配代码。
- 多数据项周期轮询（一问一答、半双工串行）与单次读取
- 实时电参数卡片墙：按电能/电压/电流/功率与频率分组，涨跌箭头、电压 250V 占比进度条，断开后转离线灰并保留末次数值
- 三相电压趋势图（LiveCharts2，120 点滚动窗口，250V 红色虚线警戒线）
- 报文监视：收发分色、时间戳、自动滚底、上限 500 条，可导出为文本文件
- 读数记录导出 CSV（UTF-8 带 BOM，Excel 直接打开中文不乱码；缓冲 20000 条约合半小时数据）
- 通信统计：Tx/Rx 帧数、超时、错误、往返时延
- 深色工业 HMI 主题、自定义标题栏（拖拽/双击最大化/分屏吸附）
环境要求：Windows 10/11，.NET 8 SDK。
git clone https://github.com/Jayla630/Dlt645Master.git
cd Dlt645Master
dotnet build
dotnet test
dotnet run --project src/Dlt645Master.App启动后默认已装配仿真链路（内存回环 + 仿真从站），界面操作三步走：
- 点击 连接（标题栏徽标转绿色「已连接」）；
- 点击 启动轮询——卡片墙数值开始跳动、三相电压曲线滚动、右侧报文监视滚屏；
- 观察数分钟后可点 导出读数 (CSV) 或报文监视区的 导出；停止轮询 → 断开 收尾。
┌─────────────────────────────────────────────────────────┐
│ Dlt645Master.App WPF + Prism（MVVM） │
│ Views / ViewModels / 仿真链路装配 / 导出 │
└──────────────┬──────────────────────────┬───────────────┘
│ 依赖 │ 依赖
┌──────────────▼──────────────┐ ┌────────▼────────────────┐
│ Dlt645Master.Core │ │ Dlt645Master.Transport │
│ 纯类库，零框架依赖 │◄─┤ 依赖 Core │
│ ├ Protocol 帧编解码/组帧 │ │ ├ Serial 真实串口 │
│ ├ Models 领域模型 │ │ └ Simulation 仿真从站/ │
│ ├ Services 轮询调度/统计 │ │ 内存回环/波动数据源 │
│ └ Transport ITransport 抽象 │ └─────────────────────────┘
└─────────────────────────────┘
三条关键设计取舍：
ITransport抽象放在 Core：服务层（轮询调度）只依赖这个接口，不知道对面是System.IO.Ports还是内存回环。真实串口切换只需把装配处的LoopbackTransport换成SerialPortTransport，其余代码一行不动，也因此消除了 Core → Transport 的环形依赖。- 事件线程口径明确：轮询服务的三个事件（读数完成/报文收发/统计变更）一律在后台工作线程触发，服务层不做线程封送；视图模型统一经
IUiDispatcher抽象调度回界面线程（测试中用同步替身，无需真实消息泵）。 - 字节序约定单点化：地址与数据标识在所有接口/模型中一律为「显示序（高位在前）」，只有帧编解码器内部上/下线时转换为传输序（低位在前）——转换点唯一，杜绝「反了两次等于没反」类缺陷。
帧结构：68 A0..A5 68 C L DATA... CS 16（地址 6 字节 BCD 低位在前；DATA 域每字节 +0x33 掩码；CS 为算术和校验）。
默认串口参数：2400 bps · 8 数据位 · 偶校验 · 1 停止位（规约常用默认值，已内置）。
| 数据项 | 数据标识 DI | 单位 |
|---|---|---|
| 正向有功总电能 | 00 01 00 00 | kWh |
| 反向有功总电能 | 00 02 00 00 | kWh |
| A/B/C 相电压 | 02 01 01~03 00 | V |
| A/B/C 相电流 | 02 02 01~03 00 | A |
| 总有功功率 | 02 03 00 00 | kW |
| 总功率因数 | 02 06 00 00 | — |
| 电网频率 | 02 80 00 07 | Hz |
DI 表以 DL/T645-2007 附录 A.2 为准；其中电网频率的 DI 为占位值，对接真表前需按标准原文核对。
| 库 | 版本 | 锁定理由 |
|---|---|---|
| .NET | 8.0 | 当前 LTS |
| Prism.DryIoc | 9.0.537 | MVVM 基础设施 + DI 容器 |
| LiveCharts2 (SkiaSharpView.WPF) | 2.0.4（锁定） | 首个正式版，MIT 许可证；禁用浮动版本保证可重现构建 |
| FluentAssertions | 7.2.2（锁定） | 8.x 起改为 Xceed 非商业社区许可证，7.2.2 是最后一个 Apache-2.0 版本 |
| xUnit | 2.9 | 测试框架 |
依赖许可证均为 MIT / Apache-2.0，与本仓库 MIT 许可证无传染冲突。
- 真实串口运行时切换（串口/波特率下拉选择，装配处
ITransport改工厂注入） - 报文解析详情面板（点击报文条目展开地址/控制码/DI/数值的字段级解读）
- 轮询参数界面化配置（周期/超时/帧间延时）
- 多表地址管理与批量轮询
- 读数数据持久化（SQLite）与历史查询
MIT © 2026 Jayla630