Avalonia与Modbus TCP:构建Linux工控机监控面板实战
接这个项目之前,UI 框架对我来说从来不是选择题:桌面监控界面,WPF 就完了。模板、自定义控件、图表库全是现成的,闭着眼睛都能写。直到客户甩过来一条硬性要求——新产线的工控机统一用 Linux,现场不允许装 Windows。一个监控面板要从 Windows 迁到 Linux,设备侧又一水儿是支持 Modbus TCP 的 PLC 和仪表,于是我在 Avalonia 里泡了三个多月,踩的坑比过去三年写 WPF 还多。这篇记录就是把那段经历完整梳理一遍:为什么换框架、通信层怎么封、UI 刷新的坑怎么填、断线重连怎么设计、最后怎么部署到工控机上。打算用 Avalonia 接 Modbus TCP 做工业监控面板的朋友,或者只是好奇 .NET 跨平台桌面这条路靠不靠谱的人,应该都能从这里拿到点东西。
先交代背景:现场 26 套设备,PLC、智能电表、温控仪都有,全部通过网线接到一台带 15 寸触摸屏的工控机上,统一走 Modbus TCP。面板要轮询显示温度、电流、运行状态,同时画实时曲线、记录报警。工控机配置很一般,赛扬双核加 4G 内存,跑不了 Electron 那种吃内存的东西,这也是选 Avalonia 而不是 Web 方案的一个重要原因。
1. 从 WinForms 转 Avalonia:这个项目让我换了 UI 框架
1.1 为什么不是 WPF、MAUI 或者 Web
先把选型这件事说清楚,因为后面所有的坑都是从这个决定开始的。客户不让装 Windows,WPF 这条路等于直接堵死。有人可能会想用 WPF 跑在 Mono 上,我劝你别赌——Mono 对 WPF 的支持从来没完整过,工业项目最怕的就是框架半死不活,出了问题找不到人也没法解释。
MAUI 当时对 Linux 的支持基本是空白,微软官方都没放开,不用考虑。Electron 倒是能跑,但工控机就 4G 内存,Chromium 一启动就吃掉几百兆,现场又多是在内网隔离环境运行,Web 方案的部署和更新反而更麻烦。最后锁定了 Avalonia,理由很实际:XAML 语法和 WPF 很接近,MVVM 经验能直接搬;Skia 原生渲染,没有浏览器那一层,内存占用比 Electron 小一个数量级;而且 Avalonia 在 2023 年底正式发布了 11.0,跨平台能力和 API 稳定性已经过了那个"天天改接口"的阶段。
如果你也在纠结这个问题,我的建议是:先不看框架的"高级特性",先确认三件事——目标系统上的运行稳定性、团队能不能快速上手、社区和商业支持是否还在活跃更新。Avalonia 这三条在 2024 年都没什么问题,至少在 .NET 系里,它是跨平台桌面唯一一个能正经投入生产的选项。
1.2 工程结构与开发环境
工程结构一开始就要摆好,别等项目写大了再重构。这是我的项目结构,你可以直接抄:
Services/Modbus 只管通信,不掺任何 UI 逻辑;ViewModels 只认数据模型,不直接碰 Socket;界面层全部通过绑定拿数据。这个分层在踩坑阶段帮了大忙,因为通信层和 UI 层的问题通常是独立的,分开后排查起来快很多。
开发环境方面,Visual Studio 2022 上有官方 Avalonia 扩展,带 XAML 预览器和模板,Windows 上开发体验已经很接近 WPF。如果你在 Linux 上开发,VS Code 装官方 Avalonia 扩展,配合 dotnet watch 也能获得接近热重载的体验。我后来在工控机上改界面,就是 SSH 进去直接改 XAML 然后用 dotnet watch 刷新,比来回拷文件省事多了。
NuGet 包这块有个容易忽略的点:Avalonia 11 之后,Avalonia.Desktop、Avalonia.Diagnostics、Avalonia.Fonts.Inter 这些包的版本必须严格和主包一致,哪怕差一个小版本都可能跑出诡异的 XAML 解析错误。我用的是 CommunityToolkit.Mvvm 做 MVVM,没有额外引第三方控件库。控件库方面像 SukiUI、Ursa.Avalonia 确实能快速出好看的效果,但工业界面的交互逻辑和主题风格往往要按客户要求定制,第三方库引入得越多,版本冲突的风险就越大,最后我全部用内置控件加自定义 Style 搞定。
2. Modbus TCP 通信层:寄存器、字节序和轮询的三重坑
2.1 寄存器地址偏移:手册上的 40001 到手报文的 0x0000
Modbus 协议本身不难,难的是设备手册和协议报文对不上。最常见的一个问题就是寄存器地址偏移。
很多仪表和 PLC 手册会把地址写成"保持寄存器 40001、40002……"这种形式,这是 PLC 数据模型的习惯写法:4 开头表示保持寄存器,后面的数字从 1 开始。但真正发到 Modbus TCP 报文里的起始地址字段是 16 位、从 0 开始算的。也就是说,手册写的 40001 在报文中对应地址 0x0000,40011 对应 0x000A。
这个偏移坑死了多少人我都不意外。如果直接在代码里传 40001 给协议库,轻则库帮你原样塞进 16 位地址字段,得到 0x9C41,设备根本不认;重则某些库直接溢出或者静默截断,你排查半天都不知道问题在哪。用 NModbus 的时候,ReadHoldingRegistersAsync 的第一参数是从 0 开始的:
更坑的是,有些设备手册用 4 位十六进制(0x0000~0x0009),有些直接写"起始地址 0",有些国产设备干脆不按规矩来,手册给了 40001 但固件实际从地址 1 开始。所以接任何新设备,第一件事就是拿 Modbus Poll 之类的调试工具,手动填地址试一遍,确认报文层的真实地址和手册之间的对应关系,再写进配置文件。
我的做法是在设备配置里单独做一层地址映射,让 PLCAddress 和 ProtocolAddress 显式分开:
配置从 Excel 导入时直接用脚本算好 ProtocolAddress,不在运行时再做减法,减少出错面。
2.2 字节序:大端小端和字序排列,一个都不能省
Modbus 规范本身规定 16 位寄存器按大端传输,高字节在前。但设备厂商不一定遵守,尤其是国产仪表,经常给你整个反的。更麻烦的是 32 位浮点数,比如温度、压力这种带小数的参数,它占两个 16 位寄存器,于是字节序问题变成两层:寄存器内部的字节序(byte order),以及两个寄存器之间的顺序(word order)。
我遇到过的组合就有四种,用两个寄存器的字节序列表示就是:
| 组合 | 含义 | 说明 |
|---|---|---|
| ABCD | 无交换 | 大端标准顺序,寄存器 1 高字节在前 |
| BADC | 字节交换 | 每个寄存器内部高低字节互换 |
| CDAB | 字交换 | 两个寄存器顺序互换 |
| DCBA | 字节+字都交换 | 完全反序 |
第一次调试某温控仪的时候,读到的浮点数全是 1.0E-30 这种天文数字,当时我一度以为是地址错了。后来把原始寄存器值打出来,才发现它把高字和低字发了反的,明明是 0x3F800000(浮点 1.0)却被拆成 0x0000 和 0x3F80 两个寄存器返回。加了一个字交换才正常。
代码里务必要把字节序做成可配置,别写死:
每个设备单独配 ByteOrder,现场增加新设备时只需要在配置里改一行,不用改代码重新编译。这个设计让我后面接新设备时省了大量时间。
2.3 轮询策略:既要数据快,又不能把设备问死
Modbus TCP 本质上就是一问一答,你发请求,设备回响应,没有服务端主动推送的概念。所以监控面板的核心就是一个轮询引擎,我的设计思路分成三层:
第一层,单连接串行请求。同一个设备的所有请求都必须排队,用 SemaphoreSlim(1, 1) 串行化,绝不在同一连接上并发发多个请求。因为 Modbus TCP 的响应靠 Transaction ID 来对应请求,并发一出,响应顺序一乱,轻则丢帧重则把数据解析错。串行轮询在 26 台设备的规模下完全够用。
第二层,快慢标签分离。温度、电流这种需要实时刷新的参数,每个周期 100~200ms 读一次;设备标识、累计运行时间这种低频参数,1~5 秒读一次就够了。把两类标签拆成两个轮询循环,避免高频读一组低频数据白白占用带宽。
第三层,超时和重试分开处理。一个典型的读请求流程是:
这里有个细节:单次超时不要立刻判设备离线。现场电磁干扰、设备忙的时候,偶发超时很正常。我一般做"连续 3 次超时或 5 秒内超时率达到 50%"才切换设备状态,能显著减少误报。
3. Avalonia 线程模型与 MVVM 绑定:UI 刷新翻车全记录
3.1 跨线程更新 UI:不报错才是最大的坑
WinForms 里跨线程访问 UI 控件会直接抛 InvalidOperationException,虽然烦,但至少让你知道错了。Avalonia 不一样,从后台线程往 ObservableCollection 里 Add 数据,或者给绑定属性赋个值,经常不报错,界面却纹丝不动,或者有时候能动、有时候不动,再现性差得让你怀疑人生。
我第一版就是直接在轮询线程里更新 ViewModel 的属性,结果曲线图一会儿有数据一会儿没数据,数据表格半天不刷新。排查了大半天才发现是线程问题。Avalonia 的绑定引擎虽然内部会帮你把一部分变化调度到 UI 线程,但绝不是全部场景都覆盖,最安全也最规范的做法是,所有触发属性变更和集合变更的操作都明确丢到 UI 线程:
用 CommunityToolkit.Mvvm 的源生成器实现 INPC 非常方便,[ObservableProperty] 直接生成属性变更逻辑,省掉手写大段 SetProperty 的样板代码。但注意,源生成器生成的通知逻辑本身不关心线程,所以该用 Dispatcher 的地方还是得用。
另外如果绑定的是 ObservableCollection,并且从后台线程直接操作集合,即使暂时没崩溃,也不能保证列表和绑定视图一致。我后来统一封装了一个 UiThreadExecutor,所有从通信层发出的数据更新都走它,UI 线程问题才算彻底根治。
3.2 绑定静默失效的几个隐蔽原因
Avalonia 11 默认启用编译绑定(Compiled Bindings),性能好,但代价是绑定路径写错时,编译期只警告、运行期直接静默失败。我有一次从后台数据层拿到的设备状态集合,界面一直不更新,最后发现是 ViewModel 的属性类型写了 IReadOnlyList<T>,而 XAML 里绑定的控件在编译绑定解析时找不到匹配的属性和导航路径,绑定直接失效。解决办法是在 XAML 根节点显式声明 x:DataType,尽量让绑定路径精确对应到 ViewModel 的公开属性:
另一个隐蔽问题是 DataContext 继承。Avalonia 里 Window 的 DataContext 会被子控件继承,但如果你在某个 UserControl 里手动设置了 DataContext,它内部所有控件就都走这个新的上下文了,外部传进来的数据被整体屏蔽,界面表现为"全是空白但没有任何报错"。排查这类问题最快的办法是开 Avalonia 的 DevTools(F12 呼出),看每个控件的 DataContext 到底是谁,比猜快十倍。
3.3 高频刷新与页面性能的平衡
监控面板的性能目标和普通 App 不一样:页面要常驻,数据要流水一样刷,但 CPU 又不能吃满,否则工控机上别的服务跟着遭殃。我踩过几个具体的性能坑。
一是别给几十个 TextBlock 同时高频改文本。26 台设备再加上各项参数,一刷就是上百个绑定更新,UI 线程吃紧。我的做法是:高频数值(100~200ms 刷新)只在界面上保留 10~20 个关键参数,其余参数降到 1 秒一刷;表格类的列表尽量用虚拟化容器,避免一次性生成几百个可视化元素。
二是非交互文本控件都设 IsHitTestVisible="False"。监控面板里大部分数值只是展示,不需要鼠标交互,关掉命中测试可以减少大量的布局计算。这个优化在一次 1920x1080 全屏面板上立竿见影,帧率从十几帧直接升到满帧。
三是关掉监控页面上不必要的动画和阴影。Avalonia 的模糊、阴影、动画效果确实能做得很漂亮,但都消耗 GPU 和 CPU。工业现场的基层工控机显卡都是亮机卡,这些效果能省则省。
4. 实时曲线图表的选型折腾
4.1 LiveCharts2 和 OxyPlot:版本兼容是道门槛
实时曲线是监控面板最直观的展示方式,图表库选型我折腾了将近一周。先说结论:如果你的需求主要是"稳定地把实时数据画成线",直接用 OxyPlot;如果你要的是漂亮的大屏仪表盘,再考虑 LiveCharts2,但要做好版本对不上导致 XAML 解析失败的心理准备。
LiveCharts2 对 Avalonia 也有官方支持包,样式确实现代,动画顺滑,适合做看板。但它和 Avalonia 的版本绑定很紧。当时我装 LiveCharts.Avalonia 的预览版配 Avalonia 11 正式版,一运行就报 XAML 解析异常,往深里查才发现库内部引用的是某个预览版的 Avalonia API,类型都对不上。后来翻 issues 才知道,必须先查 LiveCharts 支持的 Avalonia 版本号,严格对齐,不能想当然地"装最新的就行"。
OxyPlot 则有专门的 OxyPlot.Avalonia 包,版本兼容性好得多,而且绘图模型非常成熟,工业场景里用了很多年,对实时刷新、多坐标轴、标注这些都有完善支持。界面没那么炫,但做监控面板够用。最后我全项目统一用 OxyPlot,把 LiveCharts2 从依赖里摘掉了。
4.2 实时曲线实现要点:环形缓冲和抽稀
实时曲线的核心不是图表库,而是数据缓存结构。我每个测点维护一个固定容量的环形缓冲,只保留最近 N 个点,避免 List 无限增长导致内存抖动:
刷新时把环形缓冲的数据转换成 LineSeries 的 Points,然后调用 PlotModel.InvalidatePlot(true) 让图表重绘。注意 InvalidatePlot 要在 UI 线程调,数据源准备好之后用 Dispatcher 丢上去,否则又回到上一节的线程问题。
还有一个很实际的优化:抽稀。屏幕上曲线区域的像素宽度就那么多,给 1 万条数据全部渲染毫无意义。我的做法是,数据点数量超过像素宽度时就做等距抽稀,每像素只保留一个点。画面精度人眼根本分辨不出来,但渲染开销降了一个数量级。曲线刷新频率也不用跟数据轮询频率一致,100ms 采数、250ms 刷一次图,视觉上完全流畅。
5. 断线重连与设备异常:工业现场不配合的日常
5.1 TCP 假死与超时判定
工业现场的坏设备比你想的多:PLC 重启、仪表断电、交换机端口接触不良,随便一个都能让 TCP 连接变成假死状态。所谓假死,就是 TcpClient.Connected 这个属性依然返回 true,但对面早就不响应了。因为它只是反映"最近一次 I/O 操作时的连接状态",不代表现在通不通。
所以绝对不能靠 Connected 判断设备状态,要用实际的读写超时。读超时设 1000ms,如果连续读到超时,才能确定连接有问题。对 Modbus TCP 来说,一个请求发出后没有响应,最干净的处理是给 Socket 设 ReceiveTimeout,配合 SocketException 捕获:
超时和连接异常要区分对待,单次超时记录一下就行,连接异常则要把整个连接标记为死亡并立即进入重连流程。
5.2 重连状态机
重连方案一开始我写得非常粗暴:检测到异常,立刻 new TcpClient() 重连。结果就是设备还在重启,客户端已经在疯狂握手,日志刷屏、界面状态乱跳,还把工控机的端口资源耗了一堆。后来改成状态机才消停。
基本状态是 Disconnected -> Connecting -> Connected -> Waiting,外加指数退避。每次重连失败,等待时间翻倍:1 秒、2 秒、4 秒……最长 30 秒封顶;一旦连上并成功完成一次读操作,等待时间立刻重置回 1 秒。用伪代码描述就是:
重连成功后的第一件事是读一次完整快照,把所有标签刷一遍,同时把界面上之前标灰的设备状态恢复正常。这个细节很关键:设备离线期间参数可能已经变了,如果不重新拉快照,UI 里显示的还是断开前的旧值,操作员看到错数据会出大问题。
5.3 设备侧的花式不守规矩
协议做久了你会发现,设备厂商对"标准"的理解千差万别。我这一路遇到的怪事包括:请求 slaveId=1,设备回包填的是 slaveId=2;声明 16 个寄存器,实际返回 18 个寄存器的数据;浮点位远超出合理物理范围(比如温度读到 6e38);某些设备上电后要等十几秒才能响应第一个请求。
这些问题的通用解法是:在通信层把所有原始报文放到统一入口做校验,任何解析异常都单独计数,不直接导致整个轮询崩溃。同时对关键测点做"合理性检查",配置里给每个 Tag 设最大最小值,超出就标注为异常并报警,而不是把夸张数值直接显示给操作员。
有一台温控仪特别折腾,它的浮点数值在设备内部按工程单位存储,但手册没写清楚换算系数,读回来的原始值整整大了 10 倍。这种问题只能靠对比设备面板上的显示值和程序读到的值来校正,排查过程没有捷径,但一定要把这类"设备自身特异性"放到配置而不是写死在代码里。
6. 部署到工控机:Linux 下最后一脚
6.1 自包含发布与系统依赖
开发调试都在 Windows 上,部署到 Linux 工控机时我以为把编译产物拷过去就能跑,结果碰了第一个钉子:目标机器没装 .NET 运行时。虽然可以用 dotnet publish 发布框架依赖版然后装 SDK,但工控机通常禁止连外网,装 SDK 也麻烦。最省事的是自包含发布:
这样产物里带上完整的 .NET 运行时,拷到工控机上就能跑。产物体积会大一些,两三百兆很正常,但对于离线工控环境来说,换来的是部署一步到位,非常值。
第二个钉子是中国字体问题。Avalonia 在 Linux 上通过 fontconfig 找字体,系统里没有中文字体的话,界面所有中文全部变成方框。解决办法是装中文字体包:
装完之后记得检查 LANG 和 LC_ALL 环境变量,启动脚本里显式设成 zh_CN.UTF-8,避免生成日志时语言环境不对。
第三个容易踩的是渲染问题。有些工控机的集成显卡驱动不完整,Avalonia 启动时 OpenGL 上下文初始化失败,表现是窗口黑屏或者启动直接崩。看启动日志会有一大段 EGL/OpenGL 相关报错。这种情况基本只能禁硬件加速走软件渲染,Avalonia 官方文档里有启动参数方式可以关掉 GPU 加速,虽然帧率会降一点,但监控面板这种场景完全够用。遇到花屏、黑屏的工控机,第一个就该怀疑渲染后端,而不是去查业务代码。
6.2 systemd 守护与触摸屏适配
工控机没人天天守着,程序必须做到开机自启、崩溃自动拉起。Linux 下用 systemd 非常合适,写一个服务文件放在 /etc/systemd/system/monitor-panel.service:
Restart=always 加 RestartSec=5 是我实测下来最稳的组合:程序崩溃 5 秒后自动重启,网络服务还没就绪时启动失败也不怕,因为 systemd 会一直重试。配合日志输出到文件,远程排查问题比直接跑在终端里靠谱得多。
触摸屏适配算是最后一道细节关。15 寸屏分辨率只有 1024x768,我第一版界面是按桌面端习惯做的,字体小、按钮间距窄,上了触摸屏以后点错按钮的概率很高。后来把全局字体调大一号,所有可点击元素最小尺寸做到 40x40 像素以上,关键操作按钮间距加大。还有一点:完整隐藏鼠标指针,设置成无人值守全屏模式,界面上只留下必须的提示信息,这样操作员在车间里戴着手套也点得准。窗口样式设成无边框全屏,直接覆盖桌面,避免误触到系统任务栏。
整个项目做下来,我最深的体会是:Avalonia 本身并没有想象中难,大部分时间其实耗在了"设备不守规矩"和"现场环境千奇百怪"这两件事上。通信层把协议封装得越早、配置化做得越好,后面现场调试就越省心。
最后分享一个我自己的习惯:每次改动通信层或者 UI 层之后,我都会用一台自己写的 Modbus TCP 模拟器(能模拟超时、乱序、回错字节那种)跑一整夜,第二天看日志里有没有异常的断连或解析记录。这个习惯帮我挡掉了不少现场才暴露的坑。如果你也在做类似的工业监控项目,强烈建议花半天时间做一个"会捣乱"的模拟器,它会比你手头任何一台真设备都更能帮你写出健壮的代码。