FPGA 与数字 IC 设计 / 系统课时
从失败断言定位首个异常周期
从失败断言定位首个异常周期
仿真报出断言失败时,报错周期往往只是错误被检测到的时刻,不一定是设计首次出错的时刻。本文通过一个带背压的 ready-valid 缓冲实例,从断言采样语义、波形回溯和状态更新三个角度定位首个异常周期,最终找到引入错误的 RTL 赋值条件,并通过回归验证修复。
学习目标
- 区分断言失败周期、首次违反协议周期和错误根因周期。
- 使用
$past、$stable与波形定位背压期间的首次非法更新。 - 按输入驱动、寄存器状态、输出传播的顺序修复并验证 RTL。
先判断断言究竟在哪个周期失败
SystemVerilog 并发断言通常在时钟事件的 Preponed 区域采样表达式,在 Observed 区域求值,失败动作在 Reactive 区域执行。因此,日志显示的时间对应采样触发的时间,而不是该时刻非阻塞赋值更新后的寄存器状态。
以 ready-valid 协议为例:当某个时钟上升沿采样到 m_valid=1 且 m_ready=0,表示该事务尚未被接收。下一个上升沿采样时,m_valid 必须仍为 1,m_data 必须保持不变,即使此时 m_ready 已变为 1。
下面是可以直接放入 SystemVerilog 测试平台的协议断言。片段示例依赖测试平台中已声明的 clk、rst_n、m_valid、m_ready 和 m_data 信号。
property p_hold_when_stalled;
@(posedge clk) disable iff (!rst_n)
(m_valid && !m_ready) |=>
(m_valid && $stable(m_data));
endproperty
ap_hold: assert property (p_hold_when_stalled)
else $error("OUTPUT_HOLD_FAIL");这里的 |=> 是非重叠蕴含:前件在 E3 成立,后件在 E4 检查。$stable(m_data) 比较 E4 与 E3 两次采样的数据,不是比较 E4 上升沿前后的瞬时变化。
假设 E3 采样到 m_valid=1、m_ready=0、m_data=8'hA5,而 E4 采样到 m_valid=1、m_ready=1、m_data=8'h3C,断言会在 E4 失败。第一次异常数据更新通常需要回看 E3 上升沿的状态更新逻辑。
用完整测试复现错误
下面的单槽输出缓冲在时钟上升沿接收数据。其输入 s_valid/s_ready 和输出 m_valid/m_ready 都使用 ready-valid 握手。为了突出问题,示例故意保留一个错误:输出受阻时仍然允许新数据覆盖寄存器。
将以下内容保存为 hold_debug.sv。适用工具为支持 SystemVerilog 并发断言的仿真器,例如启用断言支持的 Questa 或兼容版本的商业仿真器。
module hold_debug;
logic clk = 0;
logic rst_n = 0;
logic s_valid = 0;
logic s_ready;
logic [7:0] s_data = 0;
logic m_valid;
logic m_ready = 0;
logic [7:0] m_data;
always #5 clk = ~clk;
assign s_ready = !m_valid || m_ready;
always_ff @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
m_valid <= 0;
m_data <= 0;
end else begin
// 故意引入错误:忽略 s_ready,可能覆盖未消费数据
if (s_valid) begin
m_data <= s_data;
m_valid <= 1;
end else if (m_ready) begin
m_valid <= 0;
end
end
end
property p_hold_when_stalled;
@(posedge clk) disable iff (!rst_n)
(m_valid && !m_ready) |=>
(m_valid && $stable(m_data));
endproperty
ap_hold: assert property (p_hold_when_stalled)
else $error("OUTPUT_HOLD_FAIL");
initial begin
// 在下降沿驱动,避免与上升沿采样竞争
repeat (2) @(negedge clk);
rst_n = 1;
s_valid = 1;
s_data = 8'hA5;
@(negedge clk);
s_data = 8'h3C;
@(negedge clk);
s_valid = 0;
m_ready = 1;
repeat (2) @(negedge clk);
$finish;
end
endmodule使用 Questa 的常见命令运行:
vlib work
vlog -sv hold_debug.sv
vsim -c work.hold_debug -do "run -all; quit -f"预期结果:仿真在 45 ns 的上升沿触发 OUTPUT_HOLD_FAIL,随后在测试平台安排的结束时间退出。不同版本的完整日志、错误前缀和进程退出码可能不同;关键是断言名称、错误内容与失败时间。
# ** Error: OUTPUT_HOLD_FAIL
# Time: 45 ns具体错误格式以仿真器为准。这个例子中复位释放后,25 ns 捕获 A5,35 ns 错误覆盖为 3C,45 ns 的断言检查才发现前后两次采样不一致。
从失败采样沿向前回溯
排查时至少同时查看 s_valid、s_ready、s_data、m_valid、m_ready、m_data 和 rst_n。先确定失败断言的前件在哪个周期成立,再检查后件失败时的输入和状态,而不是只截取报错时间附近的一条输出波形。
对于本例,时间关系如下。表中的寄存器值采用该上升沿到达前的采样值;末列展示该上升沿非阻塞赋值生效后的 m_data。
| 上升沿 | s_valid | s_ready | s_data | m_ready | 采样 m_data | 更新后 m_data |
|---|---|---|---|---|---|---|
| 25 ns | 1 | 1 | A5 | 0 | 00 | A5 |
| 35 ns | 1 | 0 | 3C | 0 | A5 | 3C |
| 45 ns | 0 | 1 | 3C | 1 | 3C | 3C |

这里能得到三个不同结论:
- 触发条件周期:35 ns 采样到
m_valid=1且m_ready=0,启动保持检查。 - 首次非法状态更新:35 ns 上升沿后的 NBA 更新把 A5 覆盖为 3C。
- 断言失败周期:45 ns 检查发现数据没有保持,输出错误日志。
定位复杂流水线时也按这一方法逆向追踪:先找失败输出的直接驱动寄存器,再检查该寄存器的写使能、输入数据来源和上游握手,直到找到第一处违反设计约束的赋值。
用采样打印确认根因
波形查看器可能同时显示某个上升沿的采样前值与更新后值,若只看光标位置容易把两个时序阶段混淆。可以增加一条仅在上升沿打印采样值的监控语句。
下面是片段示例,放入 hold_debug 模块内部,依赖前文定义的信号。
always @(posedge clk) begin
if (rst_n)
$display("t=%0t sv=%b sr=%b mv=%b mr=%b data=%h",
$time, s_valid, s_ready,
m_valid, m_ready, m_data);
end预期输出中的关键三行如下;它们体现的是上升沿采样时的旧寄存器值,不包含同一时刻 NBA 更新后的结果。
t=25 sv=1 sr=1 mv=0 mr=0 data=00
t=35 sv=1 sr=0 mv=1 mr=0 data=a5
t=45 sv=0 sr=1 mv=1 mr=1 data=3c35 ns 采样时 s_ready=0,说明缓冲不能接收新事务,但 DUT 中的 if (s_valid) 仍然为真。这就是可定位到源代码的最小根因。若要查看 NBA 更新后的值,可在波形中展开 delta cycle,或者使用 $strobe 在当前时间槽结束时打印,而不要把普通 $display 的输出误认为更新后状态。
修正写使能并完成回归
单槽缓冲只有在空槽或下游准备接收旧数据时才能接受新输入。已有的 s_ready = !m_valid || m_ready 正是这个允许条件,因此修复时应让数据寄存器写使能与真正的输入握手一致。
将 DUT 中原有的 always_ff 整块替换为下面的代码,其余测试平台和断言保持不变。这是依赖 hold_debug 中既有信号的替换片段。
always_ff @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
m_valid <= 0;
m_data <= 0;
end else if (s_ready) begin
// 可接收新事务或释放已消费事务时才更新状态
m_valid <= s_valid;
if (s_valid)
m_data <= s_data;
end
// 背压时不赋值,保持有效标志与数据
end重新执行之前的 vlog 和 vsim 命令。预期结果是仿真正常结束,不再出现 OUTPUT_HOLD_FAIL;25 ns 写入 A5 后,35 ns 因 s_ready=0 而拒绝 3C,直到 45 ns 下游准备接收时,A5 仍然保持在输出端。
这次修复还需要做三个边界检查:
- 下游连续两拍
m_ready=0,确认m_valid和m_data都不改变。 - 下游从阻塞恢复为
m_ready=1,确认此前保持的事务只交付一次。 - 输出当前事务被消费的同时,上游提供新事务,确认允许同拍替换,不会引入多余空拍。
最终排障记录应同时写清失败断言、触发采样沿、首次错误状态更新、对应 RTL 条件以及修复后的回归结果。这样才能把一次断言报错转化为可以复现、定位和验证的具体缺陷。