Day 7 - Avalonia Modbus 监控器

建议用时：150-210 分钟

你将学会什么

用配置描述点位
周期读取并更新 ViewModel
写命令必须校验和确认

把点表配置、周期轮询、实时值、质量码、写入确认和通信日志组合成可用监控器。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。

学习衔接

这是 Week 15 的第 7 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。

今天的最低通过线

顺序	必须掌握	怎么证明
1	用配置描述点位	能用自己的话解释并完成对应例子
2	周期读取并更新 ViewModel	能用自己的话解释并完成对应例子
3	写命令必须校验和确认	能用自己的话解释并完成对应例子

先用大白话理解

把点表配置、周期轮询、实时值、质量码、写入确认和通信日志组合成可用监控器。

学习时固定按这个顺序：


先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目

例子 1：定义点位配置

文件：Program.cs


public record TagConfig(
    string Name,
    byte UnitId,
    ushort Address,
    double Scale,
    string Unit);

运行结果或界面效果：


一个点位包含名称、站号、地址、比例和单位

必须改一次： 增加 FunctionCode 和 DataType。

例子 2：显示点位表

文件：ModbusPage.axaml


<DataGrid ItemsSource="{Binding Tags}" AutoGenerateColumns="False">
  <DataGrid.Columns>
    <DataGridTextColumn Header="点位" Binding="{Binding Name}" />
    <DataGridTextColumn Header="实时值" Binding="{Binding ValueText}" />
    <DataGridTextColumn Header="质量" Binding="{Binding Quality}" />
  </DataGrid.Columns>
</DataGrid>

运行结果或界面效果：


点位列表显示值和通信质量

必须改一次： 增加最后更新时间。

例子 3：安全写入前确认

文件：TagWriteService.cs


if (!userCanWrite) return;
if (!await dialog.ConfirmAsync($"确认写入 {tag.Name} = {newValue} 吗？")) return;
await client.WriteSingleRegisterAsync(tag.UnitId, tag.Address, rawValue, token);
audit.Write("写寄存器", tag.Name, newValue.ToString());

运行结果或界面效果：


写入前检查权限和确认，写入后记录审计

必须改一次： 写后回读并比较实际值。

常见错误和修法

界面直接使用 40001 作为协议地址
通信失败仍显示旧值为正常
危险写入没有权限、确认和审计

修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。

小白重复敲写训练

不看上面的代码，重新敲“定义点位配置”。
不看上面的代码，重新敲“显示点位表”。
不看上面的代码，重新敲“安全写入前确认”。
完成改动任务：增加 FunctionCode 和 DataType。
完成改动任务：增加最后更新时间。
完成改动任务：写后回读并比较实际值。

每日小测

今天的知识在上位机里解决什么问题？
三个例子分别输入了什么，输出了什么？
如果运行结果不对，你第一步检查什么？
哪一段代码负责停止、超时或错误处理？

小测答案

答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。

今日作业

新建空项目，不复制地重做三个例子。
每个例子都完成“必须改一次”。
故意制造一个错误，记录错误文字和修复办法。
把今天代码提交到自己的练习仓库。

作业验收

三个例子都能运行或显示预期界面。
能解释关键数据从哪里来、经过什么处理、最后去哪里。
失败时不会让程序无提示崩溃。
能说出今天内容如何进入“Avalonia Modbus 设备监控器”。