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

用参数构建可配置模块

用参数构建可配置模块

同一类 RTL 往往只在位宽、级数或少量行为上不同。把这些差异写成参数,可以让一份模块在展开阶段生成不同硬件实例,同时用 localparam 固定内部派生常量,避免复制代码后出现版本漂移。

学习目标

  • 使用 parameter 暴露允许实例化时覆盖的配置项。
  • 使用 localparam 保存只应由模块内部决定的派生常量。
  • 通过仿真确认位宽、深度和行为参数确实改变了实例表现。

区分 parameter 与 localparam

parameter 是模块对外公开的展开期常量。实例化模块时,可以使用 #(...) 按名称覆盖默认值;综合工具会据此确定端口宽度、数组规模以及可以被常量折叠的逻辑。

localparam 也是展开期常量,但不能从模块外覆盖,更适合保存由公开参数推导出的内部值。例如深度为 DEPTH 的流水线,最后一级索引可以写成 localparam integer LAST_STAGE = DEPTH - 1;,调用者只需要配置深度,不需要同时维护索引。

构建可配置延迟线

下面的 delay_line 同时演示三类配置:WIDTH 控制数据位宽,DEPTH 控制寄存器级数,BYPASS 控制输出是否绕过流水线。LAST_STAGE 由深度派生,因此使用 localparam,不开放给实例化者修改。

verilog
`timescale 1ns/1ps

module delay_line #(
    parameter integer WIDTH = 8,
    parameter integer DEPTH = 2,
    parameter integer BYPASS = 0
)(
    input  wire             clk,
    input  wire             rst_n,
    input  wire [WIDTH-1:0] din,
    output wire [WIDTH-1:0] dout
);
    localparam integer LAST_STAGE = DEPTH - 1;

    reg [WIDTH-1:0] pipe [0:DEPTH-1];
    integer i;

    always @(posedge clk or negedge rst_n) begin
        if (!rst_n) begin
            for (i = 0; i < DEPTH; i = i + 1)
                pipe[i] <= {WIDTH{1'b0}};
        end else begin
            pipe[0] <= din;
            for (i = 1; i < DEPTH; i = i + 1)
                pipe[i] <= pipe[i-1];
        end
    end

    // BYPASS 是常量参数,综合时可消除未被选择的输出路径。
    assign dout = BYPASS ? din : pipe[LAST_STAGE];
endmodule

module tb_delay_line;
    reg clk;
    reg rst_n;
    reg [7:0] din;
    wire [7:0] dout_pipe;
    wire [7:0] dout_bypass;

    delay_line #(
        .WIDTH(8),
        .DEPTH(2),
        .BYPASS(0)
    ) u_pipe (
        .clk(clk),
        .rst_n(rst_n),
        .din(din),
        .dout(dout_pipe)
    );

    delay_line #(
        .WIDTH(8),
        .DEPTH(2),
        .BYPASS(1)
    ) u_bypass (
        .clk(clk),
        .rst_n(rst_n),
        .din(din),
        .dout(dout_bypass)
    );

    initial begin
        clk = 1'b0;
        forever #5 clk = ~clk;
    end

    initial begin
        rst_n = 1'b0;
        din = 8'h00;
        #12 rst_n = 1'b1;

        @(negedge clk); din = 8'h11;
        @(posedge clk); #1 $display("cycle1 pipe=%h bypass=%h", dout_pipe, dout_bypass);
        @(negedge clk); din = 8'h22;
        @(posedge clk); #1 $display("cycle2 pipe=%h bypass=%h", dout_pipe, dout_bypass);
        @(negedge clk); din = 8'h33;
        @(posedge clk); #1 $display("cycle3 pipe=%h bypass=%h", dout_pipe, dout_bypass);

        $finish;
    end
endmodule

预期输出

text
cycle1 pipe=00 bypass=11
cycle2 pipe=11 bypass=22
cycle3 pipe=22 bypass=33

普通实例的两级延迟使输入在后续周期才到达 dout_pipe;旁路实例则直接输出当前 din。如果改成其他合法的 WIDTH 或 DEPTH,端口和寄存器数组会随参数重新展开,而不需要复制模块源码。

设计参数的边界

参数应描述真正的结构差异,而不是把所有细节都开放出去。像位宽、缓存深度、通道数、是否启用某个固定功能通常适合做 parameter;内部索引、状态编码、由外部参数计算出的常量通常更适合 localparam。

上例要求 WIDTH >= 1 且 DEPTH >= 1,否则端口或数组范围将失去有效含义。工程中应在仿真、综合或静态检查脚本中约束这些参数,尽早阻止非法实例配置。这样,参数化模块才能同时获得复用性和可维护性。

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

目录与阅读设置

阅读设置

17

记录一个想法

用参数构建可配置模块

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

登录哪都通