FPGA 与数字 IC 设计 / 系统课时

将功能要求写成周期级接口契约

将功能要求写成周期级接口契约

面对“输入有效时处理数据,并在下一周期输出结果”这样的需求,直接编写 RTL 很容易产生延迟定义不清、有效信号错位和无效数据被误读的问题。本课使用一个 8 位数据处理模块,将自然语言需求转换为端口定义、时钟边沿规则、周期时序表和可仿真验证的接口契约。

学习目标

  • 将自然语言功能要求拆分为端口、数据运算、采样条件和复位行为。
  • 使用时钟边沿表明确输入与输出的有效周期及延迟。
  • 编写可综合的 SystemVerilog 模块,并通过仿真检查契约是否得到满足。

将自然语言需求拆成可检查的规则

假设产品需求为:“接收 8 位无符号数据,将其加一,在下一周期输出处理结果。输入可能连续有效,复位时不得输出有效数据。”

这句话仍然存在歧义:下一周期是输入采样边沿之后立即可见,还是再经过一个时钟边沿?连续输入是否允许丢失?加一溢出怎么办?

首先固定本例的周期定义:将输入被上升沿 E_k 采样称为接收事件,要求结果在下一次上升沿 E_k+1 之后成为有效输出。两个边沿之间为一个完整时钟周期。

据此形成以下可执行契约:

  1. 时钟采用 clk 上升沿,示例时钟频率为 100 MHz,周期为 10 ns。
  2. 当 in_valid=1 时,在当前上升沿接收 in_data;当 in_valid=0 时不产生对应的新结果。
  3. 在接收边沿的下一次上升沿之后,out_valid=1,out_data 等于接收数据加一。
  4. 连续两个边沿均有有效输入时,输出也必须在对应的连续两个边沿之后有效,不允许漏数或重排。
  5. 数据宽度固定为 8 位,无符号加法溢出按模 256 截断,例如 8'hFF + 8'd1 得到 8'h00。
  6. 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。

systemverilog
`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。关键控制台输出如下,仿真器可能另外显示结束提示。

text
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 实现、仿真测试和后续模块集成的共同依据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将功能要求写成周期级接口契约

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通