3. TLM适配器工程案例1：基于FIFO的Producer-Consumer模型，使用uvm_tlm_adapter连接不同协议端口

3.1 案例背景与设计目标

在UVM验证环境中，不同验证组件往往采用不同的TLM通信协议。本案例通过一个经典的Producer-Consumer（生产者-消费者）模型，演示如何使用uvm_tlm_adapter将单向阻塞PUT端口（Producer端）与单向非阻塞GET端口（Consumer端）桥接起来，并通过FIFO实现数据缓冲。

3.2 整体架构与数据流

下图展示了本案例的组件连接关系与TLM端口协议转换路径：

3.3 核心组件实现

3.3.1 Producer组件（阻塞PUT端）

Producer通过uvm_blocking_put_port发送事务，每次调用put()方法会阻塞直到数据被下游接收。

class producer extends uvm_component;
  `uvm_component_utils(producer)
  
  uvm_blocking_put_port #(my_transaction) put_port;
  
  function new(string name, uvm_component parent);
    super.new(name, parent);
    put_port = new("put_port", this);
  endfunction
  
  virtual task run_phase(uvm_phase phase);
    my_transaction tr;
    for (int i = 0; i < 10; i++) begin
      tr = my_transaction::type_id::create($sformatf("tr_%0d", i));
      tr.data = i;
      `uvm_info("PRODUCER", $sformatf("Sending data: %0d", tr.data), UVM_LOW)
      put_port.put(tr);  // 阻塞调用
    end
  endtask
endclass

3.3.2 Consumer组件（非阻塞GET端）

Consumer通过uvm_nonblocking_get_port接收数据，try_get()方法立即返回，通过返回值判断是否成功获取数据。

class consumer extends uvm_component;
  `uvm_component_utils(consumer)
  
  uvm_nonblocking_get_port #(my_transaction) get_port;
  
  function new(string name, uvm_component parent);
    super.new(name, parent);
    get_port = new("get_port", this);
  endfunction
  
  virtual task run_phase(uvm_phase phase);
    my_transaction tr;
    int count = 0;
    while (count < 10) begin
      tr = my_transaction::type_id::create("tr");
      if (get_port.try_get(tr)) begin  // 非阻塞调用
        `uvm_info("CONSUMER", $sformatf("Received data: %0d", tr.data), UVM_LOW)
        count++;
      end else begin
        #10;  // 等待后重试
      end
    end
  endtask
endclass

3.3.3 uvm_tlm_adapter桥接实现

适配器将Producer的阻塞PUT端口转换为非阻塞PUT端口，从而与FIFO的非阻塞接口匹配。

class my_adapter extends uvm_component;
  `uvm_component_utils(my_adapter)
  
  // 上游：阻塞PUT端口（连接Producer）
  uvm_blocking_put_export #(my_transaction) blocking_put_export;
  // 下游：非阻塞PUT端口（连接FIFO）
  uvm_nonblocking_put_port #(my_transaction) nb_put_port;
  
  function new(string name, uvm_component parent);
    super.new(name, parent);
    blocking_put_export = new("blocking_put_export", this);
    nb_put_port = new("nb_put_port", this);
  endfunction
  
  // 实现阻塞put方法，内部调用非阻塞put
  virtual task put(my_transaction t);
    bit success;
    while (!success) begin
      success = nb_put_port.try_put(t);
      if (!success) #10;  // 等待后重试
    end
  endtask
  
  // 将export连接到task实现
  function void build_phase(uvm_phase phase);
    blocking_put_export.connect(this);
  endfunction
endclass

3.4 顶层环境连接

在env中完成所有组件的实例化与TLM端口连接：

class my_env extends uvm_env;
  `uvm_component_utils(my_env)
  
  producer            prod;
  consumer            cons;
  my_adapter          adapter;
  uvm_tlm_fifo #(my_transaction) fifo;
  
  function new(string name, uvm_component parent);
    super.new(name, parent);
  endfunction
  
  function void build_phase(uvm_phase phase);
    prod    = producer::type_id::create("prod", this);
    cons    = consumer::type_id::create("cons", this);
    adapter = my_adapter::type_id::create("adapter", this);
    fifo    = uvm_tlm_fifo #(my_transaction)::type_id::create("fifo", this);
  endfunction
  
  function void connect_phase(uvm_phase phase);
    // Producer → Adapter（阻塞PUT）
    prod.put_port.connect(adapter.blocking_put_export);
    // Adapter → FIFO（非阻塞PUT）
    adapter.nb_put_port.connect(fifo.put_export);
    // FIFO → Consumer（非阻塞GET）
    cons.get_port.connect(fifo.get_export);
  endfunction
endclass

3.5 协议转换对照表

下表总结了本案例中涉及的TLM端口协议转换关系：

3.6 常见问题与避坑指南

3.7 仿真结果验证

运行仿真后，典型输出日志如下：

UVM_INFO @ 0: [PRODUCER] Sending data: 0
UVM_INFO @ 0: [PRODUCER] Sending data: 1
UVM_INFO @ 10: [CONSUMER] Received data: 0
UVM_INFO @ 10: [PRODUCER] Sending data: 2
UVM_INFO @ 20: [CONSUMER] Received data: 1
...
UVM_INFO @ 90: [PRODUCER] Sending data: 9
UVM_INFO @ 100: [CONSUMER] Received data: 9

日志显示Producer连续发送前两个事务后，Consumer开始消费，后续Producer与Consumer交替执行，验证了适配器正确完成了阻塞到非阻塞的协议转换。

3.8 案例总结

本案例通过一个完整的Producer-Consumer模型，展示了uvm_tlm_adapter在异构TLM协议桥接中的核心作用。关键要点：

• 协议转换本质：适配器将上游的阻塞语义转换为下游的非阻塞语义，通过内部循环重试机制保证数据不丢失。
• FIFO解耦：uvm_tlm_fifo作为中间缓冲，允许生产者和消费者以不同速率工作，提升系统吞吐量。
• 连接规则：port→export→fifo→export→port的链式连接必须严格匹配TLM接口方向。
• 工程权衡：阻塞接口编程简单但可能引入死锁；非阻塞接口灵活但需处理轮询开销。适配器提供了两者之间的平滑过渡方案。