FPGA 与数字 IC 设计 / 系统课时
组织 RTL、Testbench 与约束文件
组织 RTL、Testbench 与约束文件
本节建立一个适合小型 FPGA 练习的目录约定,把可综合 RTL、Testbench、板级约束和生成产物分开。完成后,你可以从固定位置编译仿真,也不会把波形、临时文件或综合结果混进源码目录。
学习目标
- 能区分 RTL、Testbench、约束文件和构建产物的职责
- 能创建一套可重复使用的工程目录并完成一次仿真
- 知道哪些文件应该进入版本控制,哪些文件应排除
按职责拆分目录
一个最小工程只需要四类内容:rtl/ 放可综合设计源码,tb/ 放 Testbench,constraints/ 放引脚与时钟等板级约束,build/ 放编译、仿真和后续综合生成的临时产物。
源码与生成物分开的核心价值是可清理和可复现。删除 build/ 后,工程仍应能仅凭源码、约束和构建命令恢复;如果删除某个自动生成文件会导致无法重新构建,说明工程依赖还没有整理清楚。
约束文件格式取决于所用 FPGA 厂商和工具链,例如常见的 XDC、SDC 或其他器件约束格式。本节只规定它们放在 constraints/,不把某一种格式强行设为所有工具的统一标准。
建立最小工程骨架
在空目录中执行下面的命令:
mkdir -p rtl tb constraints build
touch rtl/blink.v tb/blink_tb.v constraints/board.constraints预期结果:
当前目录包含 rtl、tb、constraints、build 四个子目录,
并包含 rtl/blink.v、tb/blink_tb.v、constraints/board.constraints 三个文件。board.constraints 这里只是占位名称,进入具体 FPGA 工程时应换成该工具实际支持的约束扩展名,并填写真实器件引脚和时钟约束。
从固定位置编译仿真
下面用一个简单翻转寄存器验证目录结构。rtl/blink.v:
module blink (
input wire clk,
input wire rst_n,
output reg led
);
always @(posedge clk or negedge rst_n) begin
if (!rst_n)
led <= 1'b0;
else
led <= ~led;
end
endmoduletb/blink_tb.v:
`timescale 1ns/1ps
module blink_tb;
reg clk = 1'b0;
reg rst_n = 1'b0;
wire led;
blink dut (
.clk(clk),
.rst_n(rst_n),
.led(led)
);
always #5 clk = ~clk;
initial begin
$dumpfile("build/blink.vcd");
$dumpvars(0, blink_tb);
#12 rst_n = 1'b1;
#40 $finish;
end
initial begin
$monitor("t=%0t rst_n=%b led=%b", $time, rst_n, led);
end
endmodule从工程根目录执行:
iverilog -g2005 -o build/blink_sim rtl/blink.v tb/blink_tb.v
vvp build/blink_sim预期输出:
VCD info: dumpfile build/blink.vcd opened for output.
t=0 rst_n=0 led=0
t=<TIME> rst_n=1 led=0
t=<TIME> rst_n=1 led=1
t=<TIME> rst_n=1 led=0实际时间值会随激励安排和仿真器显示单位变化,但释放复位后 led 应在时钟上升沿持续翻转,且 build/blink.vcd 应被生成。这样可以确认源码路径、Testbench 路径和构建产物目录都已按约定工作。
让版本控制只保留源文件
build/ 中通常是可以重新生成的文件,不应与源码一起长期维护。若使用 Git,可在工程根目录加入:
build/
*.vcd这段内容是 .gitignore 配置片段,生效后 Git 会忽略构建目录和波形文件。验证方法是执行 git status:修改 rtl/、tb/ 或 constraints/ 下的源码应被识别,而新生成的 build/blink_sim 和 build/blink.vcd 不应进入待提交列表。
保持这一目录约定后,后续无论增加多个 RTL 模块、更多 Testbench,还是换成厂商 IDE 做综合,都能清楚判断“输入源码在哪里、约束在哪里、生成物在哪里”,清理工程时也只需要处理构建目录。