FPGA 与数字 IC 设计 / 系统课时
用参考模型和断言联合验收
用参考模型和断言联合验收
双时钟流式统计模块即使能够正常仿真,也可能在 FIFO 满空切换、跨域复位或输出背压时丢失事件。本课建立独立参考模型,结合 SystemVerilog 断言和自动回归,逐项验收事件顺序、统计数值、快照握手与无重复输出,并让错误能够定位到具体事务和时钟周期。
学习目标
- 建立与 DUT 实现解耦的事务级参考模型,核对事件顺序及统计快照。
- 使用 SVA 检查输入输出握手、背压保持和 FIFO 访问边界。
- 执行双时钟随机回归,覆盖复位扰动并形成可复现的验收结果。
冻结验收契约与参考模型边界
先明确被测模块的接口协议。假设源域使用 s_clk、s_rst_n、s_valid、s_ready、s_data[7:0],处理域使用 proc_clk、proc_rst_n,结果端使用 m_valid、m_ready、m_count、m_sum。异步 FIFO 负责跨域传递事件,处理域按顺序累计数量和数值,并在规定的快照请求边界输出统计结果。
本课采用以下可检验的示例契约:s_valid && s_ready 表示接受一个事件;处理端只对实际从 FIFO 接收的事件更新统计;每次快照请求对应一个输出结果,输出握手后不得重复发送;背压期间结果保持不变。假设快照请求在处理域排队,并且在本周期事件处理完成后捕获统计值。这是示例定义,实际验收必须以项目冻结的周期级规格为准。
| 验收对象 | 通过标准 | 失败含义 |
|---|---|---|
| 输入事件 | 每次握手恰好入参考队列一次 | 重复采集或漏采 |
| FIFO 顺序 | 读出事件等于队首事件 | 乱序、覆盖或指针错误 |
| 统计值 | count 为事件数,sum 为数据累加值 | 漏算、重复算或截断 |
| 快照输出 | 每个请求恰好产生一个匹配结果 | 丢快照或重复输出 |
| 输出背压 | valid 保持且数据不变 | 数据被覆盖或提前撤销 |
| 复位恢复 | 按规定清空或恢复事务状态 | 旧数据泄漏或跨域状态不一致 |
统计位宽必须在测试前冻结。例如,m_count 与 m_sum 均为 32 位时,可约定按无符号 32 位模加法计算;如果需求规定饱和累加,就必须修改参考模型,不能让测试自行决定语义。

实现事务参考模型与逐项比较
参考模型不能直接读取 DUT 的内部计数寄存器作为期望值,否则设计错误可能被同步复制到检查器。测试平台应通过可观察事务构造独立期望,并通过读侧监视接口或绑定到 FIFO 读侧的监视器核对事件流。
下面给出可以独立运行的队列核对核心示例。它使用 iverilog -g2012 支持的普通 SystemVerilog 固定数组和索引,不依赖 UVM。示例聚焦事件顺序与累计值;完整快照请求和结果握手由后续监视器连接实际 DUT。
module tb_scoreboard;
logic [7:0] expected [0:15];
integer head = 0;
integer tail = 0;
logic [31:0] golden_count = 0;
logic [31:0] golden_sum = 0;
task automatic accept_input(input logic [7:0] data);
if (tail >= 16) $fatal(1, "Reference queue overflow");
expected[tail] = data;
tail = tail + 1;
endtask
task automatic consume_fifo(input logic [7:0] data);
if (head >= tail) $fatal(1, "Unexpected FIFO output");
if (data !== expected[head])
$fatal(1, "FIFO order mismatch at %0d", head);
head = head + 1;
golden_count = golden_count + 1;
golden_sum = golden_sum + {24'b0, data};
endtask
initial begin
accept_input(8'd10);
accept_input(8'd20);
accept_input(8'd30);
consume_fifo(8'd10);
consume_fifo(8'd20);
consume_fifo(8'd30);
if (head != tail) $fatal(1, "Unconsumed events");
if (golden_count !== 32'd3 || golden_sum !== 32'd60)
$fatal(1, "Statistics mismatch");
$display("PASS count=%0d sum=%0d", golden_count, golden_sum);
$finish;
end
endmodule预期输出:
PASS count=3 sum=60在实际 DUT 测试平台中,输入监视器只在 s_clk 上升沿且 s_valid && s_ready 时调用 accept_input;FIFO 读侧监视器只在 proc_clk 上升沿发生真实读取握手时调用 consume_fifo。若 FIFO 使用预取寄存器或读延迟,必须按照接口规定的有效数据周期采样,而不是假定发出 rd_en 当拍数据就可用。
快照检查采用第二条期望队列:快照请求真正被接收并完成规定的事件更新时,保存一份 {golden_count, golden_sum};当 m_valid && m_ready 时弹出队首并比较 m_count 和 m_sum。只有输出握手才弹出,m_valid 连续保持多个周期不应视为多个结果。
使用断言锁住周期级协议
参考模型适合检查长事务链的语义,SVA 更适合发现某个时钟边沿违反协议。以下是可复用的断言模块,覆盖背压稳定性、禁止空读以及禁止满写三个条件。
片段示例:依赖 DUT 或监视绑定提供 fifo_full、fifo_empty、fifo_wr_en、fifo_rd_en 信号,以及稳定有效的输出统计信号。fifo_full 与写使能属于 s_clk 域,fifo_empty 与读使能属于 proc_clk 域;这里假定二者都是对应时钟沿的同步采样信号。
module stream_accept_sva (
input logic s_clk, s_rst_n,
input logic proc_clk, proc_rst_n,
input logic fifo_full, fifo_empty,
input logic fifo_wr_en, fifo_rd_en,
input logic m_valid, m_ready,
input logic [31:0] m_count, m_sum
);
// 背压持续时,下一采样周期仍须保持有效数据。
ap_stable: assert property (
@(posedge proc_clk) disable iff (!proc_rst_n)
(m_valid && !m_ready) |=>
(m_valid && $stable({m_count, m_sum}))
);
// 写读保护分别使用所属时钟域的标志。
ap_no_full_write: assert property (
@(posedge s_clk) disable iff (!s_rst_n)
fifo_wr_en |-> !fifo_full
);
ap_no_empty_read: assert property (
@(posedge proc_clk) disable iff (!proc_rst_n)
fifo_rd_en |-> !fifo_empty
);
endmodule预期结果:在支持并启用 SVA 的仿真器中,合法事务不会触发上述断言;当结果端持续背压而 m_sum 提前改变时,ap_stable 会失败并报告对应处理时钟周期。这里是绑定模块片段,并非独立仿真顶层;不同仿真器的断言诊断文本不保证一致。
如果采用 Verilator 5.x,可以使用 --assert 启用相应断言检查,并确认工程实际使用的版本支持相关 SVA 语法。对于不支持所需属性语法的仿真器,应使用等价的逐拍过程检查,不能因为断言被忽略就宣布验收通过。
SVA 不能替代 Scoreboard:ap_stable 可以证明背压期间数据不变,却无法证明数值正确;FIFO 不空读也不能证明顺序正确。两者必须共同判定。
组织跨域回归与异常场景
完整回归至少改变时钟频率、输入负载、输出背压和复位时机。以 FIFO 深度 8 为例,以下参数可以作为初始测试矩阵,而非对所有设计都适用的最终覆盖标准。
| 场景 | s_clk 周期 | proc_clk 周期 | 事务与扰动 | 验收重点 |
|---|---|---|---|---|
| 基准 | 10 ns | 15 ns | 连续发送 100 个事件 | 顺序及累计值 |
| 写快读慢 | 6 ns | 20 ns | 连续发送 200 个事件 | 满标志与反压 |
| 写慢读快 | 20 ns | 7 ns | 间歇发送 100 个事件 | 空标志与无重复读 |
| 输出堵塞 | 10 ns | 13 ns | m_ready 连续拉低 30 个处理周期 | 快照保持与恢复 |
| 复位扰动 | 11 ns | 17 ns | FIFO 非空时分别触发复位 | 事务取消与恢复 |
| 随机回归 | 7 ns | 19 ns | 10 个随机种子,每个 500 次输入尝试 | 并发边界组合 |
随机测试必须记录种子,例如 seed=20261013。使用连续随机输入时,发送端在 s_ready=0 期间必须维持 s_valid=1 与当前数据稳定;否则测试平台自身就违反了握手协议。
对于复位场景,必须先确定设计契约:如果任何一侧复位都会使整个 FIFO 会话失效,参考队列也应在对应的恢复握手确认后重新开始;如果规格承诺另一时钟域已接受事件不会丢失,则不能直接清空队列掩盖数据丢失。必须区分测试主动取消的事务与设计无故丢失的事务。

执行回归并核对最终验收条件
将前述参考模型保存为 tb_scoreboard.sv,可先用 Icarus Verilog 11.x 或支持 SystemVerilog 的更新版本运行独立检查。此命令只验证上面的事务参考模型,不代表已完成真实双时钟 DUT 的全部回归。
iverilog -g2012 -s tb_scoreboard -o sim_scoreboard tb_scoreboard.sv
vvp sim_scoreboard预期输出:
PASS count=3 sum=60集成 DUT 后,应由回归脚本按测试矩阵逐组启动仿真,在每次运行结束时同时检查 $fatal、断言失败、Scoreboard 不匹配和未完成事务。仿真时间达到上限但尚有事务未排空时必须判为失败,不能把仿真正常退出当成业务通过。
最终 PASS 必须同时满足以下条件:
- 所有已接受且按契约应保留的事件均按原顺序消费,参考事件队列为空。
- 每次有效快照输出都与期望队首的计数和累加值一致,期望快照队列为空。
- 有效快照请求数量等于实际输出握手数量,不存在多余输出、漏输出或重复结果。
- 所有启用的周期级断言通过,复位恢复后不存在旧事务泄漏。
- 每个随机种子记录时钟参数、输入事务数、输出事务数、首个失败周期以及最终 PASS 或 FAIL 状态。
另外进行两项故障注入验证:故意交换相邻的 FIFO 数据,确认 Scoreboard 报出顺序错误;故意在 m_valid && !m_ready 时改变 m_sum,确认背压断言失败。若注入故障仍显示 PASS,优先检查监视器是否真正接到了 DUT,以及断言是否在仿真器中启用。
只有协议检查、事件顺序、统计结果、快照一一对应、事务排空和复位恢复全部通过,才可以将双时钟统计模块标记为功能验收通过。该结论不代表已经完成物理时序收敛或 CDC 静态结构签核,这两项仍需分别检查。