FPGA 与数字 IC 设计 / 系统课时
划分顶层模块与接口契约
划分顶层模块与接口契约
综合项目最容易在“都能连起来”之后变得难以维护:解析器直接改 PWM、UART 逻辑夹带寄存器语义,任何改动都会牵动全局。本节把 UART、命令解析、控制寄存器、PWM 与顶层连接拆成稳定边界,并用可编译骨架验证端口方向、位宽与发送背压契约。
学习目标
- 能按职责拆分 UART、命令解析、控制寄存器、PWM 与顶层模块。
- 能用
valid/ready、单周期请求脉冲和明确位宽定义模块间接口。 - 能让顶层只负责连接与时钟复位分发,避免把业务逻辑重新堆回顶层。
先确定职责边界
一个可维护的顶层不是“最大的模块”,而是模块之间的装配点。UART 负责串行位流与字节流转换;命令解析器只把字节流解释成读写请求与响应;控制寄存器保存可配置状态并提供读回值;PWM 只消费占空比配置并产生波形;顶层负责连接这些模块。

模块之间只交换“对方真正需要知道的信息”。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 与寄存器模块。
`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 链路是否自洽。
iverilog -g2012 -s fpga_top -t null fpga_top.v && echo compile-ok预期输出:
compile-ok如果出现 port ... is not a port of ...、位宽错误或隐式网络错误,应先修正接口契约,而不是在顶层增加临时转换逻辑掩盖问题。纯编译只能证明连接成立;发送端是否真的遵守握手,还要在真实 uart_tx 与解析器实现中验证“未 ready 时保持 valid 和 data”这一时序约束。
用边界而不是文件名约束工程
真正有价值的拆分标准是“谁拥有状态、谁解释协议、谁驱动硬件”。控制寄存器拥有配置状态,解析器拥有协议状态,PWM 拥有计数状态,UART 拥有串行收发状态。顶层如果开始判断命令码、修改占空比或处理寄存器地址,就说明职责又发生了泄漏。
后续若引入多个时钟域,现有契约还要补上 CDC 规则:跨域单比特控制使用同步器,跨域脉冲使用握手或脉冲展宽,多比特数据使用握手或 FIFO。先把边界和接受条件写清,再实现模块,排障时才能迅速判断错误属于链路、协议、寄存器还是执行单元。