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

定义模块与端口方向

定义模块与端口方向

这一节解决 Verilog 代码最基本的边界问题:一个模块向外暴露哪些信号,以及每个信号由谁驱动。掌握 module、input、output 和 inout 后,你就能写出接口清楚、可以被其他模块实例化和连接的 RTL 单元。

学习目标

  • 能用 ANSI 风格端口列表定义 Verilog 模块边界
  • 能根据“谁驱动、谁读取”选择 input、output 或 inout
  • 能理解 inout 的高阻态要求,并避免多驱动冲突

模块先定义边界再写逻辑

Verilog 的 module ... endmodule 描述一个硬件单元。端口列表不是普通函数参数:它代表真正的硬件连线方向。判断方向时应站在当前模块内部看信号流向,而不是按变量名称猜。

input 表示信号由模块外部驱动、模块内部读取;output 表示模块内部产生信号、外部读取;inout 表示同一根物理连线在不同时间既可能输入也可能输出,常见于双向 GPIO 或外部总线数据线。

方向 当前模块的角色 常见声明 关键约束
input 读取外部信号 input wire a 当前模块不应驱动它
output 向外产生信号 output wire y 连续赋值时通常使用网络类型
inout 分时输入或输出 inout wire pad 输出关闭时必须释放为高阻态 1'bz

用一个完整示例声明并验证端口

Verilog-2001 支持在模块头部直接写方向和类型。下面用一个 gpio_bridge 主示例同时覆盖 ANSI 风格端口声明、双向端口的三态控制,以及测试平台中的外部驱动模拟。把代码保存为 gpio_bridge_tb.v 即可直接仿真。

verilog
`timescale 1ns/1ps

module gpio_bridge (
    input  wire drive_en,
    input  wire drive_value,
    output wire observed_value,
    inout  wire pad
);
    // 只有获得驱动权时才输出;否则释放 pad,让外部器件可以驱动。
    assign pad = drive_en ? drive_value : 1'bz;

    // 无论当前由哪一方驱动,都读取 pad 的实际解析值。
    assign observed_value = pad;
endmodule

module gpio_bridge_tb;
    reg  drive_en;
    reg  drive_value;
    reg  ext_drive_en;
    reg  ext_value;
    wire observed_value;
    tri  pad;

    // 模拟模块外部的另一个器件,只在 ext_drive_en=1 时驱动 pad。
    assign pad = ext_drive_en ? ext_value : 1'bz;

    gpio_bridge dut (
        .drive_en(drive_en),
        .drive_value(drive_value),
        .observed_value(observed_value),
        .pad(pad)
    );

    initial begin
        drive_en = 0;
        drive_value = 0;
        ext_drive_en = 1;
        ext_value = 1;
        #1 $display("external drive: pad=%b observed=%b", pad, observed_value);

        ext_drive_en = 0;
        drive_en = 1;
        drive_value = 0;
        #1 $display("module drive:   pad=%b observed=%b", pad, observed_value);

        drive_en = 0;
        #1 $display("released:       pad=%b observed=%b", pad, observed_value);
        $finish(0);
    end
endmodule

这里 drive_en 和 drive_value 都从外部进入模块,所以是 input;observed_value 只由模块内部连续赋值产生,所以是 output;pad 既可能被本模块驱动,也可能被外部驱动,因此使用 inout。当本模块不驱动 pad 时,必须输出 1'bz 释放连线,而不是输出 0。

编译并观察三种状态

使用 Icarus Verilog 编译并运行:

bash
iverilog -g2005 -o gpio_bridge_tb gpio_bridge_tb.v && vvp gpio_bridge_tb

预期输出

text
external drive: pad=1 observed=1
module drive:   pad=0 observed=0
released:       pad=z observed=z

前三组刺激分别验证外部驱动、本模块驱动和双方释放。最后一行的 z 表示没有任何一方驱动这根线,它不是逻辑 0。若两个驱动器在同一时刻输出相反电平,仿真通常会解析为 x,因此双向端口必须用“驱动使能”管理所有权。

端口类型的两个常见边界

output wire 适合 assign 这样的连续赋值。如果输出在 always 过程块中被赋值,传统 Verilog 通常要把端口声明成 output reg。这里的 reg 表示过程赋值变量,并不等于一定综合成寄存器;最终是否形成触发器取决于时序逻辑和赋值条件。

模块实例化时,端口方向不会因为连接方式改变:上层逻辑驱动子模块的 input,子模块驱动自己的 output。如果一个普通内部信号被声明成 inout,应先检查接口职责是否没有拆清楚。清晰的方向定义能在综合前暴露大量连接问题,也是后续层次化设计的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义模块与端口方向

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

登录哪都通