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,不开放给实例化者修改。
`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预期输出
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,否则端口或数组范围将失去有效含义。工程中应在仿真、综合或静态检查脚本中约束这些参数,尽早阻止非法实例配置。这样,参数化模块才能同时获得复用性和可维护性。