Day 3 - 报文结构、帧边界与校验
建议用时：150-210 分钟
你将学会什么
- 设计帧头、长度、数据和校验
- 从缓冲区提取完整帧
- 理解校验和与 CRC 的用途
串口和 TCP 都只提供连续字节流，程序必须自己知道一帧从哪里开始、到哪里结束。 今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。
标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。
学习衔接
这是 Week 13 的第 3 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。
今天的最低通过线
| 顺序 | 必须掌握 | 怎么证明 |
|---|---|---|
| 1 | 设计帧头、长度、数据和校验 | 能用自己的话解释并完成对应例子 |
| 2 | 从缓冲区提取完整帧 | 能用自己的话解释并完成对应例子 |
| 3 | 理解校验和与 CRC 的用途 | 能用自己的话解释并完成对应例子 |
先用大白话理解
串口和 TCP 都只提供连续字节流，程序必须自己知道一帧从哪里开始、到哪里结束。
学习时固定按这个顺序：
先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目例子 1：计算最小校验和
文件：Program.cs
byte[] data = [0x01, 0x02, 0x03];
byte checksum = (byte)(data.Sum(x => x) & 0xFF);
Console.WriteLine($"0x{checksum:X2}");运行结果或界面效果：
0x06必须改一次： 把最后一个字节改成 FF。
例子 2：使用长度字段判断完整帧
文件：Program.cs
byte[] buffer = [0xAA, 0x03, 0x10, 0x20, 0x30];
int payloadLength = buffer[1];
int totalLength = 2 + payloadLength;
Console.WriteLine(buffer.Length >= totalLength ? "完整帧" : "继续等待");运行结果或界面效果：
完整帧必须改一次： 删除最后一个字节，确认继续等待。
例子 3：验证帧头
文件：Program.cs
byte[] frame = [0xAA, 0x55, 0x01, 0x02];
bool validHeader = frame.Length >= 2 && frame[0] == 0xAA && frame[1] == 0x55;
Console.WriteLine(validHeader);运行结果或界面效果：
True必须改一次： 在错误帧头前加入丢弃脏数据的循环。
常见错误和修法
- 把一次 Read 当成一整帧
- 没有长度上限导致错误数据撑大缓冲区
- 只计算校验却没有比较接收值
修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。
小白重复敲写训练
- 不看上面的代码，重新敲“计算最小校验和”。
- 不看上面的代码，重新敲“使用长度字段判断完整帧”。
- 不看上面的代码，重新敲“验证帧头”。
- 完成改动任务：把最后一个字节改成 FF。
- 完成改动任务：删除最后一个字节，确认继续等待。
- 完成改动任务：在错误帧头前加入丢弃脏数据的循环。
每日小测
- 今天的知识在上位机里解决什么问题？
- 三个例子分别输入了什么，输出了什么？
- 如果运行结果不对，你第一步检查什么？
- 哪一段代码负责停止、超时或错误处理？
小测答案
答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。
今日作业
- 新建空项目，不复制地重做三个例子。
- 每个例子都完成“必须改一次”。
- 故意制造一个错误，记录错误文字和修复办法。
- 把今天代码提交到自己的练习仓库。
作业验收
- 三个例子都能运行或显示预期界面。
- 能解释关键数据从哪里来、经过什么处理、最后去哪里。
- 失败时不会让程序无提示崩溃。
- 能说出今天内容如何进入“Avalonia 串口调试助手”。