FPGA 与数字 IC 设计 / 系统课时
用参考模型逐拍核对输出序列
用参考模型逐拍核对输出序列
RTL 模块即使最终输出数值正确,也可能提前一拍、延迟一拍或在连续请求时丢失结果。本课用一个两拍延迟的加法模块建立参考模型,通过事务队列记录预期数据与输出周期,让仿真自动发现数值错误、时序偏移和多余输出。
学习目标
- 根据输入握手周期和模块延迟计算每笔事务的预期输出周期。
- 使用 SystemVerilog 参考模型与事务队列逐拍检查输出数据和有效信号。
- 通过连续输入、空闲周期和故障注入验证检查器能够定位错误。
明确参考模型与时序契约
参考模型(Reference Model)负责独立计算正确结果,计分板(Scoreboard)负责把正确结果与 RTL 的实际输出匹配。二者通常组合使用,但不能直接读取被测模块内部结果寄存器作为预期值,否则可能把同一处设计错误复制到检查器中。
假设被测模块每个时钟周期最多接受一组 8 位无符号操作数,计算 a_i + b_i,输出 9 位结果;in_valid 为 1 表示输入有效,out_valid 为 1 表示输出有效。模块没有背压,复位期间不处理事务。
本例规定:在上升沿 E1 接受的输入,于 E3 上升沿之后出现在输出寄存器,固定延迟为 2 个时钟周期。允许连续周期输入,输出顺序与输入顺序相同。
| 输入采样沿 | 输入数据 | 预期输出沿 | 预期结果 |
|---|---|---|---|
| E1 | 10 + 20 | E3 | 30 |
| E2 | 255 + 1 | E4 | 256 |
| E4 | 7 + 8 | E6 | 15 |
注意第二笔的结果需要 9 位保存,不能因为输入操作数只有 8 位就截断最高进位。没有输入有效信号的 E3 不会创建新事务,但已有事务仍要按时输出。

编写被测模块与独立参考模型
下面使用 SystemVerilog 编写完整示例。测试环境采用支持 SystemVerilog 队列与动态数据结构的仿真器,例如 Questa 或 VCS。保存为 scoreboard_demo.sv,其中 add_pipe 是被测模块,tb 是测试平台。
被测模块使用三级寄存器更新边沿形成两拍输出延迟:输入在 E1 写入第一级,E2 进入第二级,E3 更新输出级。这里的延迟按输入采样沿与输出更新沿之差计算。
module add_pipe (
input logic clk,
input logic rst_n,
input logic in_valid,
input logic [7:0] a_i,
input logic [7:0] b_i,
output logic out_valid,
output logic [8:0] sum_o
);
logic [8:0] sum_s0, sum_s1;
logic valid_s0, valid_s1;
always_ff @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
sum_s0 <= '0;
sum_s1 <= '0;
sum_o <= '0;
valid_s0 <= 1'b0;
valid_s1 <= 1'b0;
out_valid <= 1'b0;
end else begin
// 显式扩展操作数,保留第九位进位。
sum_s0 <= {1'b0, a_i} + {1'b0, b_i};
sum_s1 <= sum_s0;
sum_o <= sum_s1;
valid_s0 <= in_valid;
valid_s1 <= valid_s0;
out_valid <= valid_s1;
end
end
endmodule这是完整的被测模块定义,单独编译不会启动仿真。验证其行为需要接入下面的测试平台。预期结果是每笔有效输入经过两拍后产生一拍 out_valid,且 sum_o 保留完整 9 位加法结果。
参考模型不复制三级寄存器结构,而是直接用整数加法得到预期数值,再把预期输出周期记录在事务队列中。这样能分别检查运算结果和时间契约。
使用事务队列逐拍检查
测试平台在下降沿设置下一周期输入,在上升沿将有效输入加入预期队列,并在非阻塞赋值完成后检查输出。每个队列元素同时保存 due_cycle 与 expected_sum,避免仅比较数值而忽略输出时刻。
以下代码接在同一文件的 add_pipe 模块之后。
module tb;
logic clk = 1'b0;
always #5 clk = ~clk;
logic rst_n = 1'b0;
logic in_valid = 1'b0;
logic [7:0] a_i = '0, b_i = '0;
logic out_valid;
logic [8:0] sum_o;
int cycle = 0;
int checked = 0;
typedef struct packed {
int due_cycle;
logic [8:0] expected_sum;
} expected_t;
expected_t pending[$];
expected_t item;
logic should_output;
add_pipe dut (.*);
// 在同一采样沿建立事务,并在NBA更新后核对输出。
always @(posedge clk) begin
if (!rst_n) begin
cycle = 0;
pending.delete();
end else begin
cycle++;
if (in_valid) begin
item.due_cycle = cycle + 2;
item.expected_sum = {1'b0, a_i} + {1'b0, b_i};
pending.push_back(item);
end
end
#1;
if (rst_n) begin
should_output = (pending.size() != 0);
if (should_output)
should_output = (pending[0].due_cycle == cycle);
if (out_valid !== should_output)
$fatal(1, "cycle=%0d valid mismatch", cycle);
if (should_output) begin
item = pending.pop_front();
if (sum_o !== item.expected_sum)
$fatal(1, "cycle=%0d expected=%0d actual=%0d",
cycle, item.expected_sum, sum_o);
checked++;
$display("PASS cycle=%0d sum=%0d", cycle, sum_o);
end
end
end
// 每组输入在下降沿设置,避免与上升沿采样竞争。
task automatic drive(input logic v,
input logic [7:0] a, b);
@(negedge clk);
in_valid = v;
a_i = a;
b_i = b;
endtask
initial begin
repeat (2) @(negedge clk);
rst_n = 1'b1;
drive(1, 10, 20);
drive(1, 255, 1);
drive(0, 0, 0);
drive(1, 7, 8);
drive(0, 0, 0);
drive(0, 0, 0);
drive(0, 0, 0);
@(negedge clk);
if (pending.size() != 0 || checked != 3)
$fatal(1, "transaction count mismatch");
$display("ALL PASS checked=%0d", checked);
$finish;
end
endmodule预期输出(周期从复位释放后的首个有效采样沿开始计数):
PASS cycle=3 sum=30
PASS cycle=4 sum=256
PASS cycle=6 sum=15
ALL PASS checked=3仿真器还可能打印启动与结束信息,但上述四行是测试平台自身产生的确定性输出。这里 #1 只用于测试平台等待当前时刻的非阻塞赋值完成,不应写进可综合 RTL;示例假设时钟周期为 10 个仿真时间单位。
检查提前、延迟和多余输出
单纯在每次 out_valid 时弹出一个预期结果,只能判断输出顺序和数据,不能保证时刻正确。例如模块把 E3 的结果拖到 E4,只按顺序比较仍有可能通过。
本例同时检查三个条件:
- 当前周期到期却没有
out_valid,立即报告有效信号不匹配。 - 当前没有到期事务却出现
out_valid,识别提前或多余输出。 - 到期周期的
out_valid正确,但sum_o不等于预期值,报告数据错误。
可以做两次故障注入,确认检查器不是只会报告成功。第一次把被测模块的 sum_s0 加法改成减法,输入 10 + 20 应在第 3 周期触发数据错误。第二次让 out_valid 直接取 valid_s0 而非 valid_s1,应在第 2 周期触发时序错误。每次测试后恢复原始 RTL。
对于变长延迟模块,不能简单使用 cycle + 2。应按照设计契约记录最早或最晚允许周期,或者依据事务 ID、实际握手事件匹配输出。对于 ready-valid 接口,只有 valid && ready 在采样沿同时为真才算完成传输;不能把 valid 单独为真当成已接收或已输出。
补齐回归测试的边界条件
当前示例覆盖了连续输入、输入气泡、最大加法进位和完整输出排空。正式回归还应加入以下检查:
| 测试场景 | 输入安排 | 验收标准 |
|---|---|---|
| 长连续流 | 连续 100 拍有效输入 | 正好检查 100 笔,不丢不重 |
| 零值与上界 | 0+0、255+255 | 分别输出 0、510 |
| 随机气泡 | 每拍随机决定输入是否有效 | 只在对应到期周期输出 |
| 复位打断 | 队列尚有事务时拉低复位 | 清空未完成事务,不输出复位前旧结果 |
参考模型应与 RTL 使用同一份接口契约,但尽量采用不同的实现方法。实际工程还要增加超时保护,避免因 DUT 停止响应导致测试无限运行;对含背压的设计则要在输出握手成功后再移除预期事务。
只要检查器同时掌握预期数据、预期周期和事务数量,就能把原本依赖人工查看波形的验证转化为可重复、可定位的自动化回归。