4. 适配器封装模式：事务级到信号级转换的两种典型封装方式

在 UVM 验证环境中，TLM 适配器（Adapter）的核心职责是将事务级（TLM）的数据对象转换为信号级（Pin-Level）的接口时序，反之亦然。根据转换方向与封装策略的不同，业界形成了两种典型的封装模式：单向转换封装与双向转换封装。理解这两种模式的区别与适用场景，是精准定位适配器接口封装问题的前提。

4.1 两种封装模式对比

4.2 单向转换封装（Unidirectional Adapter）

单向封装模式通常用于验证组件中只负责驱动或只负责监测的场景。例如，一个 AXI4-Stream 的 driver 只需要将 TLM 的 put 操作转换为信号级的数据发送时序，而不需要接收来自 DUT 的响应。

class my_driver extends uvm_driver #(my_transaction);
  `uvm_component_utils(my_driver)

  // TLM 接收端口
  uvm_tlm_put_imp #(my_transaction, my_driver) put_export;

  function new(string name, uvm_component parent);
    super.new(name, parent);
    put_export = new("put_export", this);
  endfunction

  // TLM put 实现：将事务存入队列
  function void write(my_transaction t);
    // 将事务存入内部 FIFO
    tx_queue.push_back(t);
  endfunction

  virtual task run_phase(uvm_phase phase);
    my_transaction tx;
    forever begin
      wait(tx_queue.size() > 0);
      tx = tx_queue.pop_front();
      // 转换为信号级时序
      drive_signal(tx);
    end
  endtask
endclass

4.3 双向转换封装（Bidirectional Adapter）

双向封装模式要求适配器同时处理前向路径（TLM → 信号）和后向路径（信号 → TLM）。这在寄存器模型访问、AHB/APB 等需要读写响应的协议中尤为常见。UVM 的 uvm_reg_adapter 就是双向封装的标准实现。

class my_reg_adapter extends uvm_reg_adapter;
  `uvm_object_utils(my_reg_adapter)

  function new(string name = "my_reg_adapter");
    super.new(name);
    // 设置转换模式
    supports_byte_enable = 0;
    provides_responses   = 1;
  endfunction

  // 前向转换：reg_item → 总线事务
  function uvm_sequence_item reg2bus(const ref uvm_reg_bus_op rw);
    my_bus_transaction t = my_bus_transaction::type_id::create("t");
    t.addr   = rw.addr;
    t.data   = rw.data;
    t.kind   = (rw.kind == UVM_READ) ? READ : WRITE;
    return t;
  endfunction

  // 后向转换：总线事务 → reg_item
  function void bus2reg(uvm_sequence_item bus_item, ref uvm_reg_bus_op rw);
    my_bus_transaction t;
    if (!$cast(t, bus_item)) begin
      `uvm_fatal("CAST_FAIL", "bus_item type mismatch")
    end
    rw.kind  = (t.kind == READ) ? UVM_READ : UVM_WRITE;
    rw.addr  = t.addr;
    rw.data  = t.data;
    rw.status = UVM_IS_OK;
  endfunction
endclass

4.4 两种封装模式的架构对比

下图展示了单向封装与双向封装在 UVM 验证环境中的组件连接关系与数据流向差异。

4.5 封装模式选择决策树

在实际项目中，选择哪种封装模式取决于 DUT 接口协议与验证需求。以下决策树可帮助快速判断：

1. 是否需要读写响应？
   • 是 → 进入步骤 2
   • 否 → 选择单向封装（如 AXI4-Stream、简单 FIFO 接口）
2. 是否用于寄存器模型访问？
   • 是 → 选择双向封装，继承 uvm_reg_adapter
   • 否 → 进入步骤 3
3. 驱动与监测是否分离？
   • 是 → 可拆分为两个单向封装（driver 用单向 put，monitor 用单向 get）
   • 否 → 选择双向封装，确保前向与后向路径在同一组件内同步