2. 接口封装原则：高内聚低耦合、信号分组、接口与 agent 的绑定关系

接口封装是 UVM 验证环境中最关键的架构决策之一。一个设计良好的接口封装，能够显著提升验证组件的可复用性、可维护性和调试效率。本节围绕三条核心原则展开：高内聚低耦合、信号分组、接口与 agent 的绑定关系。

2.1 高内聚低耦合：接口封装的基石

高内聚（High Cohesion）指接口内部的功能紧密相关，职责单一；低耦合（Low Coupling）指接口与外部组件的依赖最小化。在 UVM 接口封装中，这两条原则指导我们如何划分接口边界、分配信号职责。

2.2 信号分组：提升可读性与可维护性

一个复杂的协议接口可能包含数十甚至上百个信号。合理的信号分组能够大幅提升代码的可读性和调试效率。推荐按照以下维度进行分组：

• 按方向分组：输入信号组、输出信号组、双向信号组（inout）。
• 按功能分组：控制信号组、数据信号组、状态信号组、时钟/复位组。
• 按协议层次分组：物理层信号组、链路层信号组、传输层信号组。

在 SystemVerilog interface 中，可以使用 modport 和 struct 实现信号分组：

interface axi_if (input clk, input rst_n);
  // 时钟与复位组
  logic clk;
  logic rst_n;

  // 写地址通道组
  struct packed {
    logic [3:0]  id;
    logic [31:0] addr;
    logic [7:0]  len;
    logic [2:0]  size;
    logic [1:0]  burst;
    logic        valid;
    logic        ready;
  } write_addr;

  // 写数据通道组
  struct packed {
    logic [3:0]  id;
    logic [31:0] data;
    logic [3:0]  strb;
    logic        last;
    logic        valid;
    logic        ready;
  } write_data;

  // 写响应通道组
  struct packed {
    logic [3:0]  id;
    logic [1:0]  resp;
    logic        valid;
    logic        ready;
  } write_resp;

  // modport 分组：面向 master 和 slave 的不同视角
  modport master (
    input  clk, rst_n,
    output write_addr,
    output write_data,
    input  write_resp
  );

  modport slave (
    input  clk, rst_n,
    input  write_addr,
    input  write_data,
    output write_resp
  );
endinterface

2.3 接口与 agent 的绑定关系

在 UVM 环境中，interface 是物理信号通路，agent 是协议处理单元。两者之间的绑定关系决定了验证环境的架构灵活性。常见的绑定模式有三种：

在 UVM 中，接口通过 uvm_config_db 传递给 agent，agent 在 build_phase 中获取接口句柄：

class my_agent extends uvm_agent;
  virtual axi_if vif;

  function void build_phase(uvm_phase phase);
    super.build_phase(phase);
    if (!uvm_config_db#(virtual axi_if)::get(this, "", "vif", vif))
      `uvm_fatal("AGENT", "No virtual interface found for agent")
  endfunction

  // agent 内部将 vif 传递给 driver 和 monitor
  function void connect_phase(uvm_phase phase);
    driver.vif = vif;
    monitor.vif = vif;
  endfunction
endclass

2.4 接口封装的最佳实践清单

综合以上原则，以下是接口封装时需要检查的实践清单：

1. 接口职责单一：一个 interface 只封装一个协议或一个功能域。
2. 使用 modport 定义视角：为 master、slave、monitor 等不同角色定义独立的 modport。
3. 信号分组使用 struct：将功能相关的信号打包成 struct，提升代码可读性。
4. 避免在 interface 中实现逻辑：interface 只做信号通路，驱动和监测逻辑放在 driver/monitor 中。
5. 通过 uvm_config_db 传递接口：不要在 agent 内部直接实例化 interface，保持灵活性。
6. 绑定关系文档化：在验证计划中明确记录每个 agent 与 interface 的绑定模式。
7. 接口版本管理：当协议升级时，创建新的 interface 版本，避免修改已有接口导致回归风险。