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

划分顶层模块与接口契约

划分顶层模块与接口契约

综合项目最容易在“都能连起来”之后变得难以维护:解析器直接改 PWM、UART 逻辑夹带寄存器语义,任何改动都会牵动全局。本节把 UART、命令解析、控制寄存器、PWM 与顶层连接拆成稳定边界,并用可编译骨架验证端口方向、位宽与发送背压契约。

学习目标

  • 能按职责拆分 UART、命令解析、控制寄存器、PWM 与顶层模块。
  • 能用 valid/ready、单周期请求脉冲和明确位宽定义模块间接口。
  • 能让顶层只负责连接与时钟复位分发,避免把业务逻辑重新堆回顶层。

先确定职责边界

一个可维护的顶层不是“最大的模块”,而是模块之间的装配点。UART 负责串行位流与字节流转换;命令解析器只把字节流解释成读写请求与响应;控制寄存器保存可配置状态并提供读回值;PWM 只消费占空比配置并产生波形;顶层负责连接这些模块。

FPGA 顶层模块职责与数据流

模块之间只交换“对方真正需要知道的信息”。PWM 不应该认识 UART 命令字符,命令解析器也不应该直接操作 PWM 计数器;通过寄存器接口解耦后,协议层、状态层和执行单元都可以独立替换或仿真。

把接口写成可检查的契约

接口契约至少要写清方向、位宽、有效时机、持续时间,以及存在背压时的接受条件。下面这组信号覆盖最小 UART 控制项目。

接口 方向 契约
rx_data[7:0] + rx_valid UART → 解析器 rx_valid 拉高 1 个时钟周期时,rx_data 在该周期有效;若解析器不能逐字节接收,应在两者之间增加 FIFO
cfg_wr_en + cfg_addr + cfg_wdata 解析器 → 寄存器 cfg_wr_en 为单周期写脉冲,地址与数据同周期稳定
cfg_rd_en + cfg_addr 解析器 → 寄存器 cfg_rd_en 发起一次读请求;本骨架采用组合读回,cfg_rdata 在该请求周期由地址决定
pwm_duty[7:0] 寄存器 → PWM 稳定配置值,可在任意周期被 PWM 读取
tx_data[7:0] + tx_valid + tx_ready 解析器 ↔ UART 只有 tx_valid && tx_ready 同时为 1 的周期才算发送请求被 UART 接受;等待期间解析器必须保持 tx_valid=1 且 tx_data 不变

让顶层只做连接

下面的代码是一个可综合、可编译的接口骨架。uart_core 与 cmd_parser 故意只保留壳行为,目的是验证模块边界、端口方向、位宽以及 tx_ready 反馈路径;后续替换真实 UART 或解析状态机时,不需要修改 PWM 与寄存器模块。

verilog
`default_nettype none

module fpga_top (
    input  wire clk,
    input  wire rst_n,
    input  wire uart_rx,
    output wire uart_tx,
    output wire pwm_out
);
    wire [7:0] rx_data;
    wire       rx_valid;
    wire [7:0] tx_data;
    wire       tx_valid;
    wire       tx_ready;
    wire       cfg_wr_en;
    wire       cfg_rd_en;
    wire [3:0] cfg_addr;
    wire [7:0] cfg_wdata;
    wire [7:0] cfg_rdata;
    wire [7:0] pwm_duty;

    uart_core u_uart (
        .clk(clk), .rst_n(rst_n), .rx(uart_rx), .tx(uart_tx),
        .rx_data(rx_data), .rx_valid(rx_valid),
        .tx_data(tx_data), .tx_valid(tx_valid), .tx_ready(tx_ready)
    );

    cmd_parser u_parser (
        .clk(clk), .rst_n(rst_n),
        .rx_data(rx_data), .rx_valid(rx_valid),
        .wr_en(cfg_wr_en), .rd_en(cfg_rd_en),
        .addr(cfg_addr), .wdata(cfg_wdata), .rdata(cfg_rdata),
        .tx_data(tx_data), .tx_valid(tx_valid), .tx_ready(tx_ready)
    );

    control_regs u_regs (
        .clk(clk), .rst_n(rst_n),
        .wr_en(cfg_wr_en), .rd_en(cfg_rd_en),
        .addr(cfg_addr), .wdata(cfg_wdata), .rdata(cfg_rdata),
        .pwm_duty(pwm_duty)
    );

    pwm_core u_pwm (
        .clk(clk), .rst_n(rst_n),
        .duty(pwm_duty), .pwm_out(pwm_out)
    );
endmodule

module uart_core (
    input  wire clk,
    input  wire rst_n,
    input  wire rx,
    output wire tx,
    output wire [7:0] rx_data,
    output wire rx_valid,
    input  wire [7:0] tx_data,
    input  wire tx_valid,
    output wire tx_ready
);
    // 接口骨架:真实发送器忙时必须把 tx_ready 拉低。
    assign tx = 1'b1;
    assign rx_data = 8'h00;
    assign rx_valid = 1'b0;
    assign tx_ready = 1'b1;
endmodule

module cmd_parser (
    input  wire clk,
    input  wire rst_n,
    input  wire [7:0] rx_data,
    input  wire rx_valid,
    output wire wr_en,
    output wire rd_en,
    output wire [3:0] addr,
    output wire [7:0] wdata,
    input  wire [7:0] rdata,
    output wire [7:0] tx_data,
    output wire tx_valid,
    input  wire tx_ready
);
    // 这里只固定协议层端口;真实实现必须保持响应直到 tx_valid && tx_ready。
    assign wr_en = 1'b0;
    assign rd_en = 1'b0;
    assign addr = 4'h0;
    assign wdata = 8'h00;
    assign tx_data = 8'h00;
    assign tx_valid = 1'b0;
endmodule

module control_regs (
    input  wire clk,
    input  wire rst_n,
    input  wire wr_en,
    input  wire rd_en,
    input  wire [3:0] addr,
    input  wire [7:0] wdata,
    output reg  [7:0] rdata,
    output reg  [7:0] pwm_duty
);
    always @(posedge clk or negedge rst_n) begin
        if (!rst_n)
            pwm_duty <= 8'd0;
        else if (wr_en && addr == 4'h0)
            pwm_duty <= wdata;
    end

    always @* begin
        rdata = (rd_en && addr == 4'h0) ? pwm_duty : 8'hFF;
    end
endmodule

module pwm_core (
    input  wire clk,
    input  wire rst_n,
    input  wire [7:0] duty,
    output wire pwm_out
);
    reg [7:0] counter;

    always @(posedge clk or negedge rst_n) begin
        if (!rst_n)
            counter <= 8'd0;
        else
            counter <= counter + 8'd1;
    end

    assign pwm_out = (counter < duty);
endmodule

`default_nettype wire

保存为 fpga_top.v 后,先做纯编译检查。这里不要求真实串口工作,只验证模块实例、端口、位宽和新增的 tx_ready 链路是否自洽。

bash
iverilog -g2012 -s fpga_top -t null fpga_top.v && echo compile-ok

预期输出:

text
compile-ok

如果出现 port ... is not a port of ...、位宽错误或隐式网络错误,应先修正接口契约,而不是在顶层增加临时转换逻辑掩盖问题。纯编译只能证明连接成立;发送端是否真的遵守握手,还要在真实 uart_tx 与解析器实现中验证“未 ready 时保持 valid 和 data”这一时序约束。

用边界而不是文件名约束工程

真正有价值的拆分标准是“谁拥有状态、谁解释协议、谁驱动硬件”。控制寄存器拥有配置状态,解析器拥有协议状态,PWM 拥有计数状态,UART 拥有串行收发状态。顶层如果开始判断命令码、修改占空比或处理寄存器地址,就说明职责又发生了泄漏。

后续若引入多个时钟域,现有契约还要补上 CDC 规则:跨域单比特控制使用同步器,跨域脉冲使用握手或脉冲展宽,多比特数据使用握手或 FIFO。先把边界和接受条件写清,再实现模块,排障时才能迅速判断错误属于链路、协议、寄存器还是执行单元。

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

目录与阅读设置

阅读设置

17

记录一个想法

划分顶层模块与接口契约

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

登录哪都通