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

组织 RTL、Testbench 与约束文件

组织 RTL、Testbench 与约束文件

本节建立一个适合小型 FPGA 练习的目录约定,把可综合 RTL、Testbench、板级约束和生成产物分开。完成后,你可以从固定位置编译仿真,也不会把波形、临时文件或综合结果混进源码目录。

学习目标

  • 能区分 RTL、Testbench、约束文件和构建产物的职责
  • 能创建一套可重复使用的工程目录并完成一次仿真
  • 知道哪些文件应该进入版本控制,哪些文件应排除

按职责拆分目录

一个最小工程只需要四类内容:rtl/ 放可综合设计源码,tb/ 放 Testbench,constraints/ 放引脚与时钟等板级约束,build/ 放编译、仿真和后续综合生成的临时产物。

源码与生成物分开的核心价值是可清理和可复现。删除 build/ 后,工程仍应能仅凭源码、约束和构建命令恢复;如果删除某个自动生成文件会导致无法重新构建,说明工程依赖还没有整理清楚。

约束文件格式取决于所用 FPGA 厂商和工具链,例如常见的 XDC、SDC 或其他器件约束格式。本节只规定它们放在 constraints/,不把某一种格式强行设为所有工具的统一标准。

建立最小工程骨架

在空目录中执行下面的命令:

bash
mkdir -p rtl tb constraints build
touch rtl/blink.v tb/blink_tb.v constraints/board.constraints

预期结果:

text
当前目录包含 rtl、tb、constraints、build 四个子目录,
并包含 rtl/blink.v、tb/blink_tb.v、constraints/board.constraints 三个文件。

board.constraints 这里只是占位名称,进入具体 FPGA 工程时应换成该工具实际支持的约束扩展名,并填写真实器件引脚和时钟约束。

从固定位置编译仿真

下面用一个简单翻转寄存器验证目录结构。rtl/blink.v:

verilog
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
endmodule

tb/blink_tb.v:

verilog
`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

从工程根目录执行:

bash
iverilog -g2005 -o build/blink_sim rtl/blink.v tb/blink_tb.v
vvp build/blink_sim

预期输出:

text
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,可在工程根目录加入:

text
build/
*.vcd

这段内容是 .gitignore 配置片段,生效后 Git 会忽略构建目录和波形文件。验证方法是执行 git status:修改 rtl/、tb/ 或 constraints/ 下的源码应被识别,而新生成的 build/blink_sim 和 build/blink.vcd 不应进入待提交列表。

保持这一目录约定后,后续无论增加多个 RTL 模块、更多 Testbench,还是换成厂商 IDE 做综合,都能清楚判断“输入源码在哪里、约束在哪里、生成物在哪里”,清理工程时也只需要处理构建目录。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织 RTL、Testbench 与约束文件

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

登录哪都通