2. Protocol Trace 概念与重要性
咱们做UCIe调试，抓到的信号总不能是原始二进制吧？那就得聊Protocol Trace了。
这东西说白了，就是把UCIe链路上跑的协议层数据，按照事务的维度记录下来。我个人的习惯是，把它看作是“协议层的行车记录仪”。它能回放每个 clock 周期里，芯片之间到底在聊什么。
2.1 Protocol Trace 到底是什么？
嗯，我们先别急着定义。你可以想象这样一个场景：你的UCIe系统忽然不通了。你拿着逻辑分析仪，抓到一堆 flit 数据。里面是若干 64B 的 flit，每个 flit 都有头、有尾，还有 payload。
你对着 spec 去解析，能看懂一些，但效率太低了。Protocol Trace 做的事情，就是把这层层的协议包裹去掉，展示出“这件事情的本质”。
举个小例子：
- 原始数据：0x4A5B_3C2D_1E0F_8877...
- Protocol Trace展示：
WriteReq - Addr: 0x8000_1234 - Data: 0xDEAD_BEEF - FlitID: 234
你看，一个读请求、一个写响应，清清楚楚。这就是 Protocol Trace 的核心价值——从比特流中提取出语义。
核心定义：Protocol Trace 是将 UCIe 物理/逻辑层传输的 flit 流，解析重组为事务级（Transaction Level）记录的过程。
它不只是记录数据。它还记录了时间戳、协议状态、错误码、重传信息。我记得有次调一个链路，死活搞不定地址映射。后来就是靠 Trace 里的几个连续的 Non-Posted Write 请求，才定位到问题。
2.2 Protocol Trace 的核心要素
一个完整的 UCIe Protocol Trace，通常包含下面这些要素。你手上如果有一个成熟的 Trace 工具，对照这个清单去检查，能快速判断它的能力边界。
| 要素 | 说明 | 调试作用 |
|---|---|---|
| 时间戳 | 每条记录产生的时刻，通常精确到 flit 周期 | 分析时序，确认是否超时 |
| 事务类型 | ReadReq、WriteReq、Completion、Message 等 | 确认期望的事务是否发出 |
| 地址 | 目标地址或源地址 | 验证地址转换是否正确 |
| 数据 | 有效载荷，长度可变 | 确认数据一致性 |
| 控制字段 | Poison、Snoop、NP、S 等 tag/flag | 检查协议约束是否满足 |
| 错误信息 | CRC 错误、重传指示、协议违规标志 | 快速定位故障点 |
个人经验：在调试初期，我建议你重点关注 事务类型 和 错误信息。这两个要素最直观，能让你快速判断链路是否进入正常协议状态。
2.3 为什么 Protocol Trace 如此重要？
你想想看，UCIe 是 Die-to-Die 的互联。出了问题，封在同一个封装里，怎么去点 probe？怎么去看信号？
我刚开始做几个项目的验证时，理解不够深。觉得只要 monitor 能跑过 basic test 就行了。直到有一次，一个 SoC 内部的 cache coherence 协议越过了 chiplet 边界，结果一致性事务在 flit 层被“截胡”了。要不是 Trace 记录下了那个非法的 ReadReq 重传，我们真不知道从何查起。
它的重要性，可以从 3 个层面来看：
- 可观性：UCIe 是SerDes + 协议栈，内部信号不能直接引出。Trace 提供了唯一的“窗口”。
- 可复现性：有了 Trace dump，你可以在仿真中反复回放相同的数据流。这个特性在做回归调试时非常有用。
- 根因定位：很多 bug 不会立即在错误点暴露。比如
CRC 错误本身，可能是因为前一个 flit 的Sequence Number没被正确更新。Trace 能帮你建立事务间的因果链。
避坑指南：我曾经遇到过一种情况，Trace 工具只在错误发生时记录，不记录正常流。结果我拿到手的 trace 只有错误 flit，完全不知道前后上下文。调试效率极低。记住，一定要保证 Trace 能够记录足够深的上下文深度，至少能覆盖一个重传窗口。
2.4 Protocol Trace 在调试中的典型应用
在实际项目中，我一般会在几个特定场景下“祭出” Protocol Trace：
- 链路 training 异常：看 Trace 中是否在规定时间内收到 Training Pattern，以及 TS0/TS1 序列是否正确。
- 地址映射错误：当 chiplet 的地址空间重叠时，Trace 能清晰展示请求究竟去了哪个 Die。
- 数据一致性破坏：比如写垮了、读回了旧数据。Trace + 数据比较可以快速锁定。
- 协议死锁或活锁：如果看到某个 Non-Posted 请求一直没得到 Completion，那大概率是死锁了。Trace 能记录下每个请求的生命周期。
说白了，没有 Protocol Trace，你就像在黑暗中摸索。有了 Trace，你至少有了一个手电筒。接下来我们具体看看，如何让这个“手电筒”更亮、更聚焦。