📚 课程目录第4章 SignalTap触发与采集策略

4. SignalTap触发与采集策略

在FPGA在线调试中，SignalTap能否抓到问题，往往不取决于采样深度有多大，而取决于触发条件是否设置得足够“准”。尤其是偶发故障，例如每几秒甚至几分钟才出现一次的握手超时、状态机跑飞、FIFO偶发溢出，如果只靠“立即采样”或单一电平触发，几乎不可能稳定捕获。本节围绕SignalTap的触发与采集策略展开，重点说明基本触发、边沿触发、多级触发、触发位置控制、分段采集与循环缓冲的工作机制，并给出针对偶发故障的捕获方案设计方法。

一、触发条件的本质：在时间轴上“打一个标记”

SignalTap的采集过程可以理解为：FPGA内部持续把被测信号写入片上RAM缓冲区，而触发条件决定“从哪个时刻开始，把缓冲区中的哪些数据保留下来”。触发并不是让信号开始产生，而是给采集过程一个时间基准点。理解这一点，才能正确设置触发位置和循环缓冲。

基本触发（Basic Trigger）是最简单的形式，通常对单个信号设置高电平、低电平或边沿条件。例如要捕获fifo_overflow拉高的瞬间，可将其设为上升沿触发。边沿触发（Edge Trigger）则进一步区分上升沿、下降沿和双边沿，适合捕获脉冲、握手信号跳变和异步事件。对于偶发故障，边沿触发通常比电平触发更有效，因为故障往往表现为某个控制信号的异常跳变，而不是持续电平。

二、多级触发：把“多个条件”组合成一次捕获

偶发故障很少由单一信号直接暴露。例如一个状态机跑飞，可能表现为state进入非法值，同时err_pulse拉高，并且fifo_overflow在若干周期后出现。此时单条件触发要么抓不到，要么抓到大量无关数据。多级触发（Multi-Level Trigger）允许设置多个触发级别，每一级可以包含多个信号的条件组合，并支持顺序关系。

SignalTap的多级触发通常支持最多4级，每级可设置多个条件，条件之间支持AND、OR、NAND、NOR等逻辑组合。更关键的是，级别之间可以设置“顺序触发”：例如第1级等待state == 4'b1010（非法状态），第2级等待err_pulse == 1，第3级等待fifo_overflow == 1。只有按顺序满足这些条件，才真正触发采集。这样可以把偶发故障的“前因后果”串起来，避免被无关事件干扰。

实际设置时，建议把最不容易误触发的条件放在第1级，把最接近故障结果的条件放在最后一级。例如第1级用state非法值作为入口条件，第2级用err_pulse上升沿，第3级用fifo_overflow上升沿。这样即使err_pulse偶尔单独出现，也不会触发采集。

三、触发位置控制：决定“看到故障前还是故障后”

触发位置（Trigger Position）决定触发点在采样缓冲区中的位置。SignalTap通常用百分比表示，例如0%、25%、50%、75%、100%。0%表示触发点位于缓冲区开头，采集到的几乎都是触发后的数据；100%表示触发点位于缓冲区末尾，采集到的几乎都是触发前的数据；50%则前后各占一半。

对于偶发故障，触发位置的选择非常关键。如果故障表现为“某个信号异常后系统才崩溃”，应把触发位置设在25%～50%，保留足够的触发前数据，以便观察故障发生前的状态变化。如果故障表现为“某个信号异常后很快恢复”，则应把触发位置设在75%左右，重点保留触发后的响应过程。例如要捕获err_pulse拉高后状态机如何恢复，触发位置可设为75%，这样能看到触发后约75%缓冲区的数据。

触发位置不是“采样深度”的替代。采样深度决定能看多长的时间窗口，触发位置决定这个窗口如何围绕触发点分布。两者需要配合设置。

四、分段采集与循环缓冲：应对长时间偶发故障

当故障间隔很长时，如果一直用连续采集，缓冲区很快被填满，真正有用的数据可能被覆盖。SignalTap提供两种有效手段：分段采集（Segmented Acquisition）和循环缓冲（Circular Buffer）。

分段采集把采样缓冲区划分为多个段，每段独立存储一次触发事件。例如设置8段，每段256个采样点，总深度2048。每当触发条件满足，就写入一段，直到所有段写满后停止。这样可以在一次运行中捕获多次偶发事件，便于对比分析。分段采集特别适合“同一故障反复出现”的场景，例如每段记录一次err_pulse触发前后的波形，观察是否每次都在相同状态后出现。

循环缓冲则让采样缓冲区循环写入，触发后继续采集直到缓冲区再次写满或手动停止。循环缓冲适合“触发后还需要观察较长时间”的场景。例如触发位置设为0%，循环缓冲开启后，触发后持续采集，直到缓冲区写满，这样可以看到触发后完整的恢复过程。需要注意的是，循环缓冲会覆盖旧数据，因此触发位置和停止条件要配合设置。

五、针对偶发故障的捕获方案设计

综合以上机制，针对偶发故障可以按以下思路设计捕获方案：

明确故障特征信号。先通过逻辑分析或仿真确定故障最直接的表现，例如某个非法状态、某个错误脉冲、某个溢出标志。不要一上来就抓几十个信号，先聚焦2～3个关键信号。
选择触发类型。如果故障是电平持续，用基本触发；如果是跳变或脉冲，用边沿触发；如果是多个条件顺序出现，用多级触发。
设置触发位置。需要看故障前因，触发位置设为25%～50%；需要看故障后果，设为75%～100%；需要前后兼顾，设为50%。
选择采集模式。故障反复出现且需要多次对比，用分段采集；故障单次出现且需要观察较长时间，用循环缓冲。
设置采样深度与时钟。采样深度要覆盖故障前后所需的时间窗口。例如系统时钟100MHz，采样深度2048，则时间窗口约20.48μs。如果故障前后需要观察1ms，则深度至少需要100000点，此时应改用分段采集或降低采样时钟。
验证触发条件。先用手动触发或强制触发确认信号连接和采样时钟正确，再切换到自动触发，避免因触发条件过严而一直等不到数据。

下面给出一个针对“状态机偶发跑飞”的SignalTap配置示例，供参考：

采样时钟：sys_clk（100MHz）
采样深度：4096
触发位置：50%
触发级别：3级
  第1级：state == 4'b1010（非法状态），条件满足后进入第2级
  第2级：err_pulse == 1（上升沿），条件满足后进入第3级
  第3级：fifo_overflow == 1（上升沿），触发采集
采集模式：分段采集，8段，每段512点
观察信号：state[3:0]、err_pulse、fifo_overflow、wr_ptr[7:0]、rd_ptr[7:0]

该配置的含义是：只有当状态机先进入非法状态，随后出现错误脉冲，再出现FIFO溢出时，才触发一次采集。触发位置50%保证能看到非法状态出现前后的状态变化，分段采集8段则允许连续捕获8次这样的事件，便于判断故障是否具有重复性。实际调试时，如果发现第1级条件长期不满足，可以适当放宽为state != 4'b0000 && state != 4'b0001等更宽的条件，先确认触发链路是否正常工作，再逐步收紧。

触发条件设置过严是偶发故障调试中最常见的问题。如果长时间等不到触发，不要盲目加大采样深度，应先检查触发级别之间的顺序关系是否写反、信号极性是否搞错、采样时钟是否真的在翻转。可以先用“手动触发”确认采集链路正常，再恢复自动触发。

最后需要强调，SignalTap的触发与采集策略不是孤立的配置项，而是围绕“故障特征”组织起来的一套观察方案。基本触发和边沿触发解决“抓什么”，多级触发解决“按什么顺序抓”，触发位置解决“抓故障前还是故障后”，分段采集和循环缓冲解决“抓多少次、抓多久”。把这五者组合起来，才能对偶发故障形成有效的捕获能力。