夜雨聆风学习资料网

ARTICLE · 1393288

WPF 企业级插件化工业软件平台(上位机)

WPF 企业级插件化工业软件平台(上位机)

前言

工业现场的上位机软件,长期处在一个挺尴尬的位置:每接一台新设备,就得新写一套程序;每改一个协议,就得动一次核心代码。项目越做越多,代码越堆越乱,最后谁也不敢碰。

项目想解决的,就是这个问题——把"一台设备一套程序"变成"一套平台装多个插件",让设备协议、MES 适配、报表、认证这些能力都能装卸,业务模块按模板新建,二次开发不碰核心。

项目介绍

项目是一个企业级插件化工业软件平台,定位是上位机平台。下位机的 AI 编程由姊妹项目 NeuroAxis 承担,专注把现场设备的数据采上来、存下去、送到界面上。

技术栈是 .NET 8(照顾存量工控机)加 .NET 10(新现场),数据库用 PostgreSQL 16/17,客户端是 WPF,现场以 Windows 服务直装,不引入 Docker。

一条点位从 PLC 到数据库再到界面的全链路已经跑通并做了自动化验证,设备台账和多设备采集也已经落地。

项目功能

功能
说明
驱动契约
IDeviceDriver / PointRef / ReadValue(值+质量+时间戳)/ QualityCode
Modbus TCP 驱动
FC03 保持寄存器,支持 40001:Float32:CDAB 地址表达式,断线指数退避重连
采集流水线
有界队列 Wait 背压 + 500 点 / 200ms 攒批,flush 失败批次保留重试,不可丢语义
数据层
point_history 按月分区 + BRIN 索引,Npgsql 二进制 COPY 写入,时序不走 EF
API
/health/live、/health/ready、/api/snapshot
WPF 客户端
快照表格 1s 轮询,5s 超时 + 全异常兜底,只连 API 不直连数据库
设备台账
device / device_point 表,Host 启动加载注册表,每设备独立轮询循环,故障隔离
自测工具
ModbusSlaveSimulator 从站模拟器、DbInit 建库建表、run-m0.ps1 一键 E2E、run-scenarios.ps1 场景回归

项目特点

插件化底座:设备协议、MES 适配、报表、认证都能装卸,业务模块按模板新建,二次开发不动核心。

不可丢语义:采集走有界队列背压,攒批写入失败时批次保留重试,停机也不丢数据。

设备间故障隔离:每设备独立轮询循环,按 driver_id 由驱动工厂实例化,一台设备出问题不拖垮其他设备。

时序数据专门处理:point_history 按月分区加 BRIN 索引,写入走二进制 COPY,时序查询禁走 EF,避免 ORM 拖慢采集。

客户端只连 API:WPF 不直连数据库,5s 超时加全异常兜底,界面不会因为后端抖动而卡死。

离线友好:现场 Windows 服务直装,不依赖 Docker,适配存量工控机环境。

质量门禁:构建 0 错 0 警,15/15 单测通过,其中包含断线重连、flush 失败不丢数据、多设备故障隔离三个韧性回归。

项目架构

项目技术

语言与运行时:.NET 8 基线 / .NET 10 新现场,C#。

数据库:PostgreSQL 16/17,point_history 按月分区 + BRIN 索引,Npgsql 二进制 COPY。

客户端:WPF,快照表格轮询,只连 API。

服务端:ASP.NET API + 采集 HostedService,薄组合根设计。

插件体系:Platform.Abstractions 定义驱动/点位/质量码契约,插件唯一依赖,仅 BCL。

采集内核:Platform.Core 负责采集调度与有界队列流水线。

数据写入:Platform.Data 专做 point_history 的 COPY 写入。

测试:xUnit 单测,含韧性回归。

工具链:DbInit、ModbusSlaveSimulator 两个 .NET 工具项目,配合 PowerShell 自测脚本。

项目代码

工程结构可以参考:

├─ src/│  ├─ xxxx.Abstractions/     # 驱动/点位/质量码契约(插件唯一依赖,仅 BCL)│  ├─ xxxx.Core/             # 采集调度、有界队列流水线(业务内核)│  ├─ xxxx.Data/             # point_history COPY 写入器(时序专用)│  ├─ xxxx.Host/             # ASP.NET API + 采集 HostedService(薄组合根)│  ├─ xxxx.Client/           # WPF 客户端(只连 API)│  └─ Plugins/Driver.ModbusTcp/  # 驱动插件├─ tests/xxxx.Tests/         # xUnit 单测(含韧性回归)├─ tools/                        # DbInit、ModbusSlaveSimulator(.NET 工具项目)├─ scripts/                      # run-m0.ps1 等运维/自测脚本├─ deploy/sql/                   # DDL(V001 point_history 分区表)└─ docs/                         # 设计文档五分册 + architecture.svg

项目效果

项目第一阶段已经跑通一条完整链路:Modbus TCP 从站 → 驱动插件 → 有界队列(背压)→ 攒批 COPY → point_history → API → WPF,并且做了自动化验证。

第二阶段设备台账和多设备采集落地,S1~S7 七大业务场景 17 项断言全部通过,覆盖采集正确性、多设备、韧性自愈、停机完整性。

一键自测的命令也很直接:

powershell scripts/run-m0.ps1          # 建库 -> 模拟器 -> Host 采集 -> 验证行数 -> 清理dotnet test xxxx.slnx             # 单元测试

手动分步则是先跑 DbInit 建库建表,再开 ModbusSlaveSimulator 模拟 PLC,然后启动 xxxWPF 客户端,三步就能看到数据从模拟设备一路流到界面。

项目源码

设计文档在 docs/ 下分五个分册,另有整体架构图。

总结

项目把上位机从"一设备一程序"的泥潭里拉出来,做成插件化底座。M0 证明了全链路可行,M1 把设备台账和多设备采集补上,场景回归也跑通了。对现场来说,这意味着接新设备、改协议、加报表不再需要动核心代码;对二次开发来说,业务模块按模板新建,边界清晰。后面 P1/P2 还要继续推进,但从目前的质量门禁和回归覆盖看,底子是打得比较扎实的。

关键词

#插件化、#工业软件、#上位机、Modbus TCP、PostgreSQL、WPF、.NET、#设备采集、#时序数据、#二次开发

最后
如果你觉得这篇文章对你有帮助,不妨点个赞支持一下!你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助,欢迎随时留言。也可以加入微信公众号[DotNet技术匠] 社区,与其他热爱技术的同行一起交流心得,共同成长!

作者:小码编匠

出处:gitee.com/smallcore/DotNetCore
声明:网络内容,仅供学习,尊重版权,侵权速删,歉意致谢!
END
推荐阅读
WPF 工控 HMI 骨架:界面、通信、数据各干各的
工位检测与追溯系统:不接硬件也能跑通的 WPF 上位机

WinForms 工业上位机自定义控件库:让组态界面不用从零画

WinForms 工业上位机智能储水监测系统

.NET 工业上位机(SCADA)监控系统

WPF 工业设备上位机模板(PLC、SECS/GEM、配方管理)

WinForm 打造的 PLC 通信与边缘网关一体化工具

.NET 10 工业边缘网关:从 PLC 接入到 MQTT/OPC UA 北向

.NET 10 + WPF + DDD 工控上位机监控系统

工业上位机代码越写越乱?这套 WPF 框架给了个解法

工控上位机总在重复造轮子?看看这套开源框架

20 个项目、5 种 PLC 协议,这套产线上位机是怎么把依赖管住的

C# 中 Lock 锁:线程同步的核心机制

.NET 9 三大 LINQ 新招:代码少一半,让数据聚合和索引操作又快又干净

C# 封装海康最新 SDK,实现工业相机高效集成

WPF 工业通信调试工具(串口、TCP、OPC UA、S7 全覆盖)

WinForms 对接 VisionMaster 的视觉打标上位机,断线能自愈

从零搭 WPF 上位机太费劲,我整理了一套起始框架

WPF + ScottPlot 的实时曲线绘制与数据采集

工业上位机界面骨架:WPF、MVVM 与 MD 混合皮肤

一套可二次开发的 WPF 运动控制上位机(点位、Modbus、Lua 和 3D仿真)

不依赖第三方视觉库,用 .NET 10 + WPF 搭一套无代码视觉上位机

S7 数据怎么稳稳落到 SQL Server?一套 WPF + MVVM 的 SCADA 上位机

WPF + OpenCvSharp 工业自动化平台(视觉识别与分拣系统)

.NET 8 弹性管道如何让系统真正抗压

基于 Prism 框架的 WPF 工业通讯系统:集成S7与串口通信

C# 自动化实战:10 分钟掌握 UI Automation 控制桌面软件

C# 准确分离文件路径、文件名与扩展名的两种实现方案

C# + Python(YOLO 模型)视觉识别项目(采集、标注、训练、识别)

中后台的权限、租户、审计,这个 .NET + Vue 项目都内置了

告别老旧 Chart 控件:试试这个面向 WPF 的开源图表库

WPF + Prism 工业上位机骨架:通讯、报警与运控抽象

智能仓储环境监控系统(WinForm 上位机)

觉得有收获?不妨分享让更多人受益

关注「DotNet技术匠」,共同提升技术实力

收藏
点赞
分享
在看

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料