FPGA 与数字 IC 设计 / 系统课时
将功能要求写成周期级接口契约
将功能要求写成周期级接口契约
面对“输入有效时处理数据,并在下一周期输出结果”这样的需求,直接编写 RTL 很容易产生延迟定义不清、有效信号错位和无效数据被误读的问题。本课使用一个 8 位数据处理模块,将自然语言需求转换为端口定义、时钟边沿规则、周期时序表和可仿真验证的接口契约。
学习目标
- 将自然语言功能要求拆分为端口、数据运算、采样条件和复位行为。
- 使用时钟边沿表明确输入与输出的有效周期及延迟。
- 编写可综合的 SystemVerilog 模块,并通过仿真检查契约是否得到满足。
将自然语言需求拆成可检查的规则
假设产品需求为:“接收 8 位无符号数据,将其加一,在下一周期输出处理结果。输入可能连续有效,复位时不得输出有效数据。”
这句话仍然存在歧义:下一周期是输入采样边沿之后立即可见,还是再经过一个时钟边沿?连续输入是否允许丢失?加一溢出怎么办?
首先固定本例的周期定义:将输入被上升沿 E_k 采样称为接收事件,要求结果在下一次上升沿 E_k+1 之后成为有效输出。两个边沿之间为一个完整时钟周期。
据此形成以下可执行契约:
- 时钟采用
clk上升沿,示例时钟频率为 100 MHz,周期为 10 ns。 - 当
in_valid=1时,在当前上升沿接收in_data;当in_valid=0时不产生对应的新结果。 - 在接收边沿的下一次上升沿之后,
out_valid=1,out_data等于接收数据加一。 - 连续两个边沿均有有效输入时,输出也必须在对应的连续两个边沿之后有效,不允许漏数或重排。
- 数据宽度固定为 8 位,无符号加法溢出按模 256 截断,例如
8'hFF + 8'd1得到8'h00。 rst_n=0时异步清除内部有效状态并令out_valid=0;复位解除后不会凭空产生有效输出。
本例不提供 ready 信号,因此没有反压能力。上游必须保证每个有效输入都应被接收,模块则必须支持每周期一笔的吞吐率。
定义端口、方向和无效周期行为
接口契约不能只写信号名称,还必须说明方向、宽度、有效条件和无效时的处理方式。
| 端口 | 方向 | 位宽 | 契约 |
|---|---|---|---|
clk |
输入 | 1 | 上升沿驱动所有同步状态更新 |
rst_n |
输入 | 1 | 低有效异步复位 |
in_valid |
输入 | 1 | 为 1 时在上升沿接收输入 |
in_data |
输入 | 8 | 无符号输入,仅在 in_valid=1 的采样边沿有意义 |
out_valid |
输出 | 1 | 标记当前输出数据是否有效 |
out_data |
输出 | 8 | out_valid=1 时表示对应输入加一后的结果 |
对接口使用者而言,out_valid=0 时的 out_data 不具有业务意义。本例 RTL 选择保持上一次输出数据,但下游不得依赖该保持行为进行功能判断。
这一区分能够避免一种常见错误:下游只比较 out_data,发现数值改变就认为收到新结果。正确的消费条件应以 out_valid=1 为准。
时钟频率 100 MHz 是示例工作目标,不代表模块天然满足时序。实际项目还需要根据目标工艺、时钟约束和时序分析结果确认最高可运行频率。输入信号也必须满足接收寄存器的建立时间和保持时间要求。
用边沿表明确输入输出关系
以下验证案例包含两笔连续输入:第一笔为 0x2A,第二笔为 0xFF。复位已解除,表中的输出值均指对应上升沿之后寄存器更新完成时的状态。
| 上升沿 | 采样 in_valid |
采样 in_data |
沿后 out_valid |
沿后 out_data |
|---|---|---|---|---|
| E1 | 1 | 0x2A |
0 | 无效 |
| E2 | 1 | 0xFF |
1 | 0x2B |
| E3 | 0 | 不关心 | 1 | 0x00 |
| E4 | 0 | 不关心 | 0 | 无效 |
E1 接收的 0x2A 在 E2 之后成为有效的 0x2B。E2 接收的 0xFF 在 E3 之后成为有效的 0x00,体现 8 位溢出规则。E4 没有新的结果,因此 out_valid 必须回到 0。

周期表描述的是对外可观察行为,而不是强制内部必须使用某一种寄存器结构。只要实现满足每个输入与对应输出的边沿关系,就符合当前接口契约。
将周期契约实现为可综合 RTL
下面使用两个寄存器级实现契约:第一级保存输入有效标志和运算结果,第二级将保存的数据送到输出。两个级别在同一个上升沿使用非阻塞赋值更新,因此第二级读取的是第一级更新前的值。
以下是完整的 SystemVerilog 示例,包含可综合模块和仅用于仿真的自检测试模块。综合时以 inc8_pipe 为顶层,不综合测试模块 tb。
`timescale 1ns/1ps
module inc8_pipe (
input logic clk,
input logic rst_n,
input logic in_valid,
input logic [7:0] in_data,
output logic out_valid,
output logic [7:0] out_data
);
logic stage_valid;
logic [7:0] stage_data;
always_ff @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
stage_valid <= 1'b0;
stage_data <= '0;
out_valid <= 1'b0;
out_data <= '0;
end else begin
// 第一级在当前边沿接收输入。
stage_valid <= in_valid;
if (in_valid)
stage_data <= in_data + 8'd1;
// 第二级取得上一边沿保存的结果。
out_valid <= stage_valid;
if (stage_valid)
out_data <= stage_data;
end
end
endmodule
module tb;
logic clk = 0;
logic rst_n = 1;
logic in_valid = 0;
logic [7:0] in_data = 0;
wire out_valid;
wire [7:0] out_data;
inc8_pipe dut (
.clk(clk),
.rst_n(rst_n),
.in_valid(in_valid),
.in_data(in_data),
.out_valid(out_valid),
.out_data(out_data)
);
always #5 clk = ~clk;
initial begin
#2 rst_n = 0;
@(negedge clk);
rst_n = 1;
in_valid = 1;
in_data = 8'h2A;
// 在采样边沿之后检查非阻塞赋值更新的结果。
@(posedge clk); #1;
if (out_valid !== 1'b0) $fatal(1, "E1 mismatch");
$display("E1 valid=%0b", out_valid);
@(negedge clk);
in_data = 8'hFF;
@(posedge clk); #1;
if (out_valid !== 1'b1 || out_data !== 8'h2B)
$fatal(1, "E2 mismatch");
$display("E2 valid=%0b data=%02h", out_valid, out_data);
@(negedge clk);
in_valid = 0;
@(posedge clk); #1;
if (out_valid !== 1'b1 || out_data !== 8'h00)
$fatal(1, "E3 mismatch");
$display("E3 valid=%0b data=%02h", out_valid, out_data);
@(posedge clk); #1;
if (out_valid !== 1'b0) $fatal(1, "E4 mismatch");
$display("E4 valid=%0b", out_valid);
$finish;
end
endmodule预期结果:将代码保存为 inc8_pipe.sv,使用支持 SystemVerilog 的 Icarus Verilog 执行 iverilog -g2012 -s tb -o sim inc8_pipe.sv,编译成功后执行 vvp sim。关键控制台输出如下,仿真器可能另外显示结束提示。
E1 valid=0
E2 valid=1 data=2b
E3 valid=1 data=00
E4 valid=0其中 #5 产生半周期为 5 ns 的仿真时钟,#1 用于避开边沿上的非阻塞赋值更新阶段。它们只存在于测试模块中,不属于可综合硬件逻辑。
如果错误地把 out_valid <= stage_valid 改为 out_valid <= in_valid,第一笔输入就会在 E1 之后立即报告有效,与约定的 E2 输出不符,自检会在 E1 失败。这说明周期契约能直接变成自动化检查条件。
验收接口契约的边界行为
通过一组正常数据并不代表模块已经符合接口要求。至少还应检查以下边界场景。
| 场景 | 输入动作 | 必须满足的结果 |
|---|---|---|
| 连续有效 | 连续 4 个上升沿输入有效 | 从第二个边沿开始,连续 4 个边沿之后各产生一笔对应输出 |
| 输入空洞 | 有效、无效、有效 | 输出有效周期保持相同间隔,不插入伪造结果 |
| 数据溢出 | 输入 0xFF |
下一边沿输出有效数据 0x00 |
| 中途复位 | 存在待输出数据时拉低 rst_n |
异步清除有效状态,旧请求不得在复位后输出 |
| 无效输出 | out_valid=0 |
下游忽略 out_data,不能当作新结果 |
复位解除也有硬件时序约束:异步复位的释放需要满足相关寄存器的恢复时间和移除时间要求。实际芯片设计通常还需按复位架构进行同步释放处理,本例假设测试环境已经保证释放时序合法。
最后,进行一次需求到验证的对应检查:每条需求都应能找到端口定义、明确的采样边沿、预期输出周期和至少一项验收条件。对于本例,最终交付的接口契约就是:输入在 E_k 被有效采样,结果在 E_k+1 之后有效;连续输入不丢失;无效输出不参与消费;复位清除所有未完成请求。 这组规则可直接作为 RTL 实现、仿真测试和后续模块集成的共同依据。