UVM 中 virtual 关键字的使用详解

UVM 中virtual关键字的使用详解一、概述在 UVM 验证环境中virtual关键字出现在两个核心场景场景用法作用虚接口virtual axi_if将 RTL 接口与验证组件解耦虚方法virtual function/task实现多态Polymorphism支撑 UVM 的工厂机制和回调体系这两个场景看似不同但背后遵循同一个设计哲学面向接口编程依赖抽象而非具体实现。二、virtual interface— 虚接口2.1 为什么需要虚接口在 SystemVerilog 中interface是一个硬件构造可以包含modport、clocking、always块等而 UVM 组件是软件对象class。// interface 是硬件不是对象 interface axi_if(input clk, rst_n); logic [31:0] addr; logic [31:0] wdata; logic wr_en; // ... endinterface // UVM 组件是软件 class不能直接包含 interface class my_driver extends uvm_driver; // ❌ 不能这样声明 // axi_if vif; // axi_if 不是数据类型不能用作 class 的成员 endclass解决方案使用virtual interface它本质上是一个句柄指向一个实际的 interface 实例可以被赋值、传递、存储在 class 中。class my_driver extends uvm_driver; virtual axi_if vif; // ✅ 正确virtual interface 是一个句柄 endclass2.2 没有virtual会怎样// ❌ 错误代码 interface my_if; logic [31:0] data; logic valid; endinterface class bad_driver; my_if vif; // 编译错误interface 不能作为 class 非虚成员 task drive(); vif.data 32h1234; // 永远到不了这里 endtask endclass编译错误Non-interface Port / Interface not allowed in class non-virtual member。2.3 实际含义对比// 在 module 中硬件世界 axi_if vif(); // 实例化一个 interface → 实际生成硬件连线 // 在 class 中软件世界 virtual axi_if vif; // 声明一个句柄 → 指向已有的 interface 实例 // 不生成任何硬件只是一个指针2.4 虚接口的传递链路┌─────────────────────────────────────────────────────────┐ │ tb_top (module) │ │ axi_if dut_if(); ← 硬件实例化 │ │ initial begin │ │ uvm_config_db#(virtual axi_if)::set(...); │ │ run_test(); │ │ end │ └─────────────────────────────────────────────────────────┘ │ │ uvm_config_db ▼ ┌─────────────────────────────────────────────────────────┐ │ my_driver (class) │ │ virtual axi_if vif; ← 软件句柄指向 dut_if │ │ task run_phase(...); │ │ vif.addr tx.addr; ← 通过句柄驱动硬件 │ │ endtask │ └─────────────────────────────────────────────────────────┘2.5 为什么必须用uvm_config_db传递因为virtual interface是句柄不能通过构造函数传递function new的参数列表固定UVM 也没有为每个组件预留set_interface方法所以必须通过全局配置数据库传递// tb_top initial begin uvm_config_db#(virtual axi_if)::set(null, uvm_test_top, vif, dut_if); run_test(); end // test class my_test extends uvm_test; virtual axi_if vif; function void build_phase(uvm_phase phase); super.build_phase(phase); uvm_config_db#(virtual axi_if)::get(this, , vif, vif); uvm_config_db#(virtual axi_if)::set(this, env.agent.driver, vif, vif); endfunction endclass // driver class my_driver extends uvm_driver#(my_transaction); virtual axi_if vif; function void build_phase(uvm_phase phase); super.build_phase(phase); uvm_config_db#(virtual axi_if)::get(this, , vif, vif); // 获取句柄 endfunction endclass2.6 虚接口的核心优势优势说明软硬件分离RTL 和验证环境可以独立开发、独立编译接口切换更换 DUT 接口时只需修改tb_top和 driver 的信号驱动部分组件结构无需变化多接口支持同一个 driver 可以通过不同的虚接口句柄驱动多个实例仿真加速通过virtual interface的clocking块可以实现 cycle-level 驱动与具体时序无关2.7 多态接口的典型用法// 定义统一的虚接口基类 virtual class virtual_if_base; pure virtual task reset(); pure virtual task drive_one_pkt(bit [31:0] data[]); endclass // 不同的 DUT 接口各自继承并实现 class axi_vif_wrapper extends virtual_if_base; virtual axi_if vif; task reset(); vif.rst_n 1b0; repeat(10) (posedge vif.clk); vif.rst_n 1b1; endtask task drive_one_pkt(bit [31:0] data[]); foreach(data[i]) begin (posedge vif.clk); vif.addr i; vif.wdata data[i]; vif.wr_en 1b1; end endtask endclass这样driver 只需持有virtual_if_base句柄而无需关心具体是 AXI 还是 AHBclass my_driver extends uvm_driver; virtual_if_base vif_wrapper; // 面向抽象编程 task drive(); vif_wrapper.reset(); vif_wrapper.drive_one_pkt(tx.data); endtask endclass三、virtual method— 虚方法3.1 什么是虚方法!!!virtual function/virtual task是 SystemVerilog OOP 的多态机制。声明为virtual的方法在通过基类句柄调用时实际执行的是对象实际类型的方法。3.2 没有virtual会怎样// 基类 class packet extends uvm_object; function void my_print(); // ❌ 非虚函数 $display(This is a packet); endfunction endclass // 派生类 class eth_packet extends packet; function void my_print(); // 同名函数但不是 override $display(This is an eth_packet); endfunction endclass // 测试 packet p; eth_packet e; e new(); p e; // 基类句柄指向派生类对象 p.my_print(); // 输出This is a packet ❌ 调用了基类版本 e.my_print(); // 输出This is an eth_packet没有virtual多态失效。基类句柄永远只能调用基类的方法无法调用派生类的重写版本。3.3 加上virtualclass packet extends uvm_object; virtual function void my_print(); // ✅ 虚函数 $display(This is a packet); endfunction endclass class eth_packet extends packet; virtual function void my_print(); // ✅ override $display(This is an eth_packet); endfunction endclass packet p; eth_packet e; e new(); p e; // 基类句柄指向派生类对象 p.my_print(); // 输出This is an eth_packet ✅ 多态正确工作3.4 UVM 中必须用virtual的关键方法UVM 的整个框架依赖多态以下方法是 UVM 架构正常运行的基石(1) Phase 方法class uvm_component; virtual function void build_phase(uvm_phase phase); // ✅ 必须 virtual virtual function void connect_phase(uvm_phase phase); virtual task run_phase(uvm_phase phase); virtual function void report_phase(uvm_phase phase); // ... endclass class my_test extends uvm_test; virtual function void build_phase(uvm_phase phase); // ✅ override super.build_phase(phase); // 用户代码 endfunction endclassUVM 内核通过uvm_component句柄调用 phase 方法// UVM 内部伪代码 uvm_component comp_list[$]; foreach(comp_list[i]) comp_list[i].build_phase(phase); // 如果没有 virtual永远调用 uvm_component::build_phase // 用户写的派生类重写版本永远不会被执行(2)do_*field automation 方法class uvm_object; virtual function void do_copy(uvm_object rhs); virtual function bit do_compare(uvm_object rhs, uvm_comparer comparer); virtual function void do_print(uvm_printer printer); virtual function void do_pack(uvm_packer packer); // ... endclass // 用户重写这些 do_* 来实现自定义行为 class my_packet extends uvm_object; virtual function void do_print(uvm_printer printer); super.do_print(printer); printer.print_field(crc, crc, 32, UVM_HEX); endfunction endclass(3)convert2stringclass uvm_object; virtual function string convert2string(); endclass class my_transaction extends uvm_sequence_item; virtual function string convert2string(); return $sformatf(addr%0h data%0h, addr, data); endfunction endclass3.5 如果不加virtualUVM 会直接崩溃考虑 UVM 的print()实现// UVM 内部 function void uvm_object::print(uvm_printer printer null); // ... do_print(printer); // ✅ do_print 是 virtual → 调用实际类型的版本 // ... endfunction如果do_print不是virtual那么无论对象是什么类型print()都只会调用uvm_object::do_print打印出空内容。用户重写的do_print永远不会被执行。四、virtual class— 虚类抽象类4.1 什么是虚类virtual class也称为抽象类是不能被直接实例化的类只能作为基类使用。它通常包含pure virtual method纯虚方法强制派生类实现。4.2 在 UVM 中的使用// ❌ 错误virtual class 不能被实例化 // packet p packet::type_id::create(p); // 编译错误 // 定义抽象基类 virtual class packet_base extends uvm_sequence_item; pure virtual function bit [31:0] get_addr(); pure virtual function bit [31:0] get_data(); endclass // 具体的派生类必须实现所有 pure virtual 方法 class axi_packet extends packet_base; rand bit [31:0] addr; rand bit [31:0] data; virtual function bit [31:0] get_addr(); return addr; endfunction virtual function bit [31:0] get_data(); return data; endfunction endclass class ahb_packet extends packet_base; rand bit [31:0] addr; rand bit [31:0] wdata; virtual function bit [31:0] get_addr(); return addr; endfunction virtual function bit [31:0] get_data(); return wdata; // AHB 用 wdata 表示写数据 endfunction endclass这样monitor / scoreboard 就可以面向抽象编程class generic_monitor extends uvm_monitor; packet_base pkt; task run_phase(uvm_phase phase); forever begin // 收集到的数据无论什么协议都通过抽象接口读取 $display(addr%0h data%0h, pkt.get_addr(), pkt.get_data()); end endtask endclass4.3 UVM 中的预定义虚类UVM 大量使用了虚类来定义接口虚类说明uvm_object所有 UVO 数据对象的基类虽然不是virtual class但不可直接实例化使用uvm_component所有 UVM 组件的基类uvm_sequence_item所有 sequence item 的基类uvm_sequence_baseuvm_sequence的基类uvm_monitor所有 monitor 的基类uvm_subscriber所有 subscriber如 scoreboard的基类五、pure virtual— 纯虚方法5.1 定义class abstract_base; pure virtual function void must_implement(); pure virtual task must_implement_task(); endclasspure virtual方法没有实现体包含pure virtual方法的类必须是virtual class派生类必须实现所有pure virtual方法否则编译错误用于定义契约或接口规范5.2 使用场景定义验证组件接口规范virtual class driver_base extends uvm_driver#(uvm_sequence_item); // 所有 driver 必须实现的接口 pure virtual task reset_dut(); pure virtual task drive_item(uvm_sequence_item item); pure virtual function void check_protocol(); endclass // 具体实现 class axi_driver extends driver_base; virtual task reset_dut(); // AXI 复位时序 endtask virtual task drive_item(uvm_sequence_item item); // AXI 驱动逻辑 endtask virtual function void check_protocol(); // AXI 协议检查 endfunction endclass六、完整对比总结6.1 三种virtual用法的对比类型语法作用不用的后果virtual interfacevirtual axi_if vif将 interface 作为句柄传入 class编译错误完全不能用virtual function/taskvirtual function void foo()实现方法多态多态失效基类句柄调不到派生类方法UVM 的 phase / print 等机制全部崩溃virtual classvirtual class foo定义抽象基类不能被实例化可以被实例化失去了抽象约束的意义pure virtual methodpure virtual function foo()强制派生类实现派生类可以忘记实现编译不报错但运行出错6.2 UVM 的生命线UVM 的核心机制全部依赖virtualUVM 核心机制 依赖的 virtual ───────────────────────────────────────── Phase 自动调度 virtual function build_phase() Factory 创建 virtual function create() Field automation virtual function do_print/do_copy/do_compare() Callback 机制 virtual function pre/post_* Report 机制 virtual function convert2string() Sequence 执行 virtual task body() Interface 传递 virtual interface任何一个去掉virtualUVM 的相应功能就会完全失效。6.3 一句话总结// 没有 virtual // class 中不能使用 interface编译失败 // 基类句柄无法调用派生类方法多态失效 // UVM 的 phase、factory、field automation 全部无法工作 // // 加上 virtual // 硬件接口可以通过句柄传递到软件 class 中 // 基类句柄→派生类方法多态完美工作 // UVM 的所有核心机制正常运行virtual是 UVM 的基石。没有它UVM 就不存在了。