UVM1.2 源码概述合集（4）：uvm_object 深度解析

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

UVM 基类核心：uvm_object 深度解析

一、总体概述

功能定位

uvm_object

作为 UVM 验证方法学中所有数据对象与层次化类的根类，uvm_object 扮演着“通用基础模块”的角色。它为所有派生类提供了一套标准化的操作接口，包括创建、复制、比对、打印和记录等功能，堪称验证环境中各类对象的“基因模板”。

适用场景

• 数据建模：用于定义事务包（transaction）、配置实体及复杂数据结构。
• 组件开发：是所有 UVM 组件（如 driver、monitor、scoreboard 等）的间接父类。
• 对象统一管理：在需要实现一致性的实例生成、拷贝或比较操作时使用。
• 调试与可视化支持：当需输出对象内容、进行波形记录或差异分析时发挥关键作用。

系统架构中的角色

在 UVM 的继承体系中，

uvm_object

处于最底层（仅高于

uvm_void

），几乎所有验证相关的类都直接或间接地继承自该基类。它确立了对象行为的基本规范，子类通过重写虚方法来扩展具体功能，从而实现灵活且可复用的设计模式。

二、代码结构剖析

模块化设计

整个类按功能划分为八个主要模块，每个模块专注于一类通用服务：

1. 身份识别模块（Identification）
   输入：对象初始化时传入的名称字符串
   处理：维护对象名、实例ID与类型名
   输出：返回唯一标识信息
2. 对象创建模块（Creation）
   输入：指定的对象名称
   处理：利用工厂机制生成新实例
   输出：返回新建对象的句柄
3. 对象拷贝模块（Copying）
   输入：源对象引用
   处理：执行深拷贝，并检测循环引用
   输出：目标对象完整复制源对象状态
4. 对象比较模块（Comparing）
   输入：两个待比较对象 + 比较策略
   处理：逐字段对比，包含类型校验与循环处理
   输出：输出是否相等的结果及不匹配详情
5. 打印输出模块（Printing）
   输入：对象本身 + 打印格式设置（表格/树状/行式）
   处理：递归遍历对象层级并格式化内容
   输出：生成标准调试信息文本
6. 打包/解包模块（Packing/Unpacking）
   输入：对象或原始比特流
   处理：将对象序列化为字节流或从流中恢复对象
   输出：可用于传输的数据流或重建后的对象
7. 记录模块（Recording）
   输入：目标对象 + 记录器实例
   处理：调用仿真器特定 API 实现波形追踪
   输出：在波形工具中显示对象状态变化
8. 配置访问模块（Configuration）
   输入：字段路径（支持通配符）+ 新值
   处理：动态修改运行时成员变量
   输出：更新后生效的对象状态

核心方法详解

1. create(string name="")

   - 工厂创建方法
   目的：创建当前类型的实例，支持工厂覆盖机制
   逻辑：必须在子类中实现，返回由

   new

   构造的对象
   示例参数：

   • name="my_transaction"

   • virtual function uvm_object create(string name="");
       mytype t = new(name);
       return t;
     endfunction

2. copy(uvm_object rhs)

   - 深拷贝实现
   目的：将源对象

   rhs

   的全部成员复制到当前实例
   逻辑：结合

   __m_uvm_field_automation

   与

   do_copy

   完成拷贝过程，具备循环引用防护机制
   关键机制：借助全局

   uvm_global_copy_map

   避免无限递归
   

   function void copy(uvm_object rhs);
     uvm_global_copy_map[rhs] = this;  // 标记已拷贝
     __m_uvm_field_automation(rhs, UVM_COPY, "");  // 宏自动拷贝
     do_copy(rhs);  // 用户自定义拷贝
     if(depth==0) uvm_global_copy_map.delete();  // 清理
   endfunction

3. compare(uvm_object rhs, uvm_comparer comparer=null)

   - 对象比较函数
   目的：判断两对象是否一致，并记录差异字段
   逻辑：
   • 确认

     rhs

     不为空且为

     null

   • 验证类型一致性（

     get_type_name()

     ）
   • 通过

     comparer

     进行字段级比对
   • 将不匹配项写入

     comparer.miscompares

   示例参数：

   • rhs=expected_obj

   • comparer=uvm_default_comparer

4. print(uvm_printer printer=null)

   - 格式化打印方法
   目的：以表格或树形结构输出对象内容至控制台
   逻辑：调用

   sprint()

   获取字符串表示，并写入

   printer.knobs.mcd

   文件描述符
   默认行为：采用

   uvm_default_printer

   设置的格式（可通过全局配置更改）

5. pack/unpack

   系列 - 序列化与反序列化操作
   目的：实现对象与比特流之间的双向转换，适用于存储或通信场景
   逻辑：

   • pack

     ：调用

     do_pack

     将各字段压入

     packer

     缓冲区

   • unpack

     ：从

     packer

     中提取比特并还原字段值
   支持格式：
   

   bit[]

   、

   byte[]

   、

   int[]

   
   元数据要求：
   动态数组需先打包长度；对象需携带

   null

   标志位

关键成员变量说明

1. m_inst_id

   /

   m_inst_count

   - 实例标识追踪
   类型：

   int

   （实例变量） /

   static int

   （静态类变量）
   作用：为每个对象分配唯一的数值 ID，便于调试和区分不同实例
   设计考量：避免依赖内存地址（易变），提供稳定可靠的标识机制

2. m_leaf_name

   - 对象名称存储
   类型：

   string

   
   作用：保存对象的局部名称（非完整层次路径）
   易混淆点：
   

   get_name()

   返回的是

   m_leaf_name

   ；
   在多数上下文中

   get_full_name()

   也返回此值；但在

   uvm_object

   中返回局部名，而

   uvm_component

   则返回全路径名

3. use_uvm_seeding

   - 随机种子控制开关
   类型：

   static bit

   （全局标志）
   作用：启用或关闭基于类型和名称的确定性随机种子机制
   性能影响：若关闭，则可能导致多次仿真间随机行为不可重现

4. uvm_global_copy_map

   - 循环引用检测机制
   类型：

   static uvm_object [uvm_object]

   （关联数组）
   作用：在拷贝过程中记录已处理的对象，防止因 A 包含 B、B 又引用 A 导致的无限递归
   生命周期：仅在单次拷贝操作期间有效，结束后自动清理

copy

调用期间有效，调用结束后自动清空。

三、关键技术点与实现原理

1. 虚函数模板方法模式

在 uvm_object 中广泛采用模板方法模式，其核心是定义一个固定的公共接口（如

copy

、

compare

），并在内部通过虚函数钩子（如

do_copy

、

do_compare

）实现可定制行为，供派生类扩展。

实现原理：
公共方法（例如

copy

）负责处理通用流程，包括循环检测和参数校验；
而具体的字段操作则交由虚函数钩子（如

do_copy

）完成，仅关注自身逻辑。

优势体现：
- 防止用户覆盖公共方法，从而破坏框架整体结构
- 统一错误处理机制与资源管理策略

代码验证示例：

// copy 是固定实现，用户不应覆盖
function void copy(uvm_object rhs);
  uvm_global_copy_map[rhs] = this;  // 框架逻辑：防循环
  do_copy(rhs);                      // 用户逻辑：具体拷贝
endfunction

// do_copy 是虚函数，用户必须覆盖
virtual function void do_copy(uvm_object rhs);
  // 派生类实现具体字段拷贝
endfunction

2. 策略模式（Policy Pattern）

诸如

uvm_printer

、

uvm_comparer

、

uvm_packer

均为典型的策略对象，其作用在于将算法逻辑（如打印格式）从数据实体中分离，实现解耦。

运行机制：
当对象执行

print(printer)

操作时，传入不同的

printer

策略实例；

uvm_table_printer

、

uvm_tree_printer

、

uvm_line_printer

分别代表不同策略的具体实现。

主要优势：
- 无需修改原有类代码即可灵活切换输出格式（如文本、JSON、XML）
- 支持用户自定义策略类型，提升扩展性

性能对比参考：

// 默认表格格式
obj.print(uvm_default_printer);  // 输出表格
// 切换为树形格式
obj.print(uvm_default_tree_printer);  // 输出树形

3. 宏自动化机制

结合

__m_uvm_field_automation

与

`uvm_field_int

等宏，UVM 实现了零代码字段操作的自动化能力。

底层原理：
- 编译阶段，宏展开生成字段注册代码
-

__m_uvm_field_automation

根据操作类型（如

UVM_COPY

、

UVM_COMPARE

）遍历所有已注册字段
- 自动触发对应的操作函数（如

comparer.compare_field_int()

）

实际好处：
- 显著减少重复代码编写（无需逐一手动实现每个字段的

do_copy

/

do_compare

）
- 降低维护成本：新增字段只需添加相应宏即可

使用示例：

class my_trans extends uvm_object;
  int addr;
  int data;
  `uvm_object_utils_begin(my_trans)
    `uvm_field_int(addr, UVM_ALL_ON)  // 自动支持拷贝/比较/打印
    `uvm_field_int(data, UVM_ALL_ON)
  `uvm_object_utils_end
endclass

4. 深拷贝与浅拷贝机制

UVM 中

copy()

实现的是深拷贝，即递归复制所有嵌套子对象；而

clone()

则通过

create

和

copy

的组合方式完成。

概念区分：
浅拷贝：仅复制对象句柄（指针），副本与原对象共享同一数据，修改互有影响
深拷贝：递归复制整个对象树，确保副本完全独立

特殊处理：
对于存在循环引用的情况，系统具备识别与处理机制：

class A;
  B b_obj;
endclass
class B;
  A a_obj;  // B 引用 A
endclass

// copy 时通过 uvm_global_copy_map 检测循环
if(uvm_global_copy_map.exists(rhs)) return;  // 已拷贝，跳过

四、疑难点与易错点拆解

疑难点 1：未实现

create

和

get_type_name

导致工厂创建失败

典型现象：
调用

uvm_object::create_object_by_name()

返回

null

，或打印对象时显示

<unknown>

。

根本原因分析：

uvm_object

中的

create

与

get_type_name

为纯虚函数，默认返回

null

或

"<unknown>"

，要求所有派生类必须重写。

解决办法：
使用

`uvm_object_utils

宏来自动生成实现，或手动编写对应函数：

class my_trans extends uvm_object;
  `uvm_object_utils(my_trans)  // 自动实现 create/get_type_name
  
  // 或手动实现：
  virtual function uvm_object create(string name="");
    my_trans t = new(name);
    return t;
  endfunction
  
  virtual function string get_type_name();
    return "my_trans";
  endfunction
endclass

避坑口诀：
“定义对象先加宏，

create

和类型名不能少。”

疑难点 2：

compare

返回 1 但

comparer.result != 0

不成立

问题表现：

if(obj1.compare(obj2)) 
  uvm_info("PASS", "Objects match", UVM_LOW);  // 未执行
else
  $display("Mismatches: %0d", comparer.result);  // 输出 5

深层原因：

compare

的最终返回值取决于

comparer.result == 0 && do_compare == 1

—— 即“无字段不匹配且用户逻辑通过”。即使

do_compare

返回 1，若

comparer.result

非零，整体仍会返回 0。

排查方案：
查看

comparer.result

和

comparer.miscompares

获取具体差异信息：

uvm_comparer comp = new();
if(!obj1.compare(obj2, comp)) begin
  `uvm_error("CMP", $sformatf("Compare failed: %0d mismatches\n%s", 
                               comp.result, comp.miscompares))
end

易混点提醒：

compare

返回布尔值（0 表示失败，1 表示成功）

comparer.result

返回整型数值（表示不匹配的字段数量）

避坑口诀：
“比较结果看返回值，详细不匹配查

result

。”

疑难点 3：拷贝后对象名称丢失

现象描述：

obj2.copy(obj1);
$display(obj2.get_name());  // 输出空字符串，而非 obj1 的名称

原因解析：

copy

方法默认不复制对象名称（

m_leaf_name

），因为名称属于对象标识范畴，而非数据内容的一部分。

应对措施：
若需保留名称，应使用

clone

或在拷贝后手动设置：

// 方案 1：使用 clone（会保留名称）
obj2 = obj1.clone();

// 方案 2：手动设置名称
obj2.copy(obj1);
obj2.set_name(obj1.get_name());

避坑口诀：
“拷贝数据不拷名，名称需要手动传。”

疑难点 4：打包与解包顺序不一致引发数据错乱

异常表现：

// 打包时：先打包 data，再打包 addr
function void do_pack(uvm_packer packer);
  packer.pack_field_int(data, 32);
  packer.pack_field_int(addr, 32);
endfunction

// 解包时：先解包 addr，再解包 data（顺序反了！）
function void do_unpack(uvm_packer packer);
  addr = packer.unpack_field_int(32);
  data = packer.unpack_field_int(32);
endfunction

结果导致

addr

与

data

的值发生互换。

根源所在：
打包与解包过程必须严格遵循相同的字段顺序，否则会导致字段映射错误。

解决方案：
保持两边顺序一致，建议在代码中显式注释声明顺序：

function void do_pack(uvm_packer packer);
  packer.pack_field_int(addr, 32);  // 1. 地址
  packer.pack_field_int(data, 32);  // 2. 数据
endfunction

function void do_unpack(uvm_packer packer);
  addr = packer.unpack_field_int(32);  // 1. 地址
  data = packer.unpack_field_int(32);  // 2. 数据
endfunction

边界情况注意：
动态数组或队列需先传输长度信息：

packer.pack_field_int(my_array.size(), 32);  // 先打包长度
foreach(my_array[i]) 
  packer.pack_field_int(my_array[i], 8);

避坑口诀：
“打包解包顺序同，动态数据先传长。”

疑难点 5：

do_compare

未调用

super.do_compare

致基类字段比对遗漏

问题现象：

class base extends uvm_object;
  int base_field;
endclass

class derived extends base;
  int derived_field;
  
  // 错误实现：未调用 super.do_compare
  virtual function bit do_compare(uvm_object rhs, uvm_comparer comparer);
    derived rhs_;
    $cast(rhs_, rhs);
    return comparer.compare_field_int("derived_field", derived_field, 
                                       rhs_.derived_field);
  endfunction
endclass

最终

base_field

的差异被忽略。

本质原因：
在重载

do_compare

时，必须显式调用

super.do_compare

，以确保父类字段参与比较流程。

修复方式：

virtual function bit do_compare(uvm_object rhs, uvm_comparer comparer);
  derived rhs_;
  bit result;
  result = super.do_compare(rhs, comparer);  // 先比较基类
  $cast(rhs_, rhs);
  result &= comparer.compare_field_int("derived_field", derived_field, 
                                        rhs_.derived_field);
  return result;
endfunction

调试建议：
在

do_compare

函数起始处加入日志输出，确认调用链完整：

`uvm_info("DBG", $sformatf("Comparing %s", get_type_name()), UVM_DEBUG)

避坑口诀：
“重载虚函数先调

super

，基类逻辑不能丢。”

疑难点 6：随机种子不稳定造成回归测试失败

常见现象：
相同测试用例在不同运行中产生不同随机序列，导致回归结果不可复现。

根本成因：
未正确调用

reseed()

或...

__m_uvm_status_container

- 操作上下文容器

类型：

static uvm_status_container

（全局单例）

作用：
存储

printer

、

comparer

、

packer

等策略对象，避免频繁传递参数。

易混淆点说明：
所有

uvm_object

共享同一个实例，不具备线程安全性；但由于 SystemVerilog 为单线程执行模型，因此在实际应用中影响有限。

避坑口诀：

“随机对象要稳定，创建之后调

reseed

。”

解决方案：

在对象创建完成后，调用

reseed()

方法，以确保种子值由类型名与实例名共同生成，从而具备确定性：

my_trans trans = my_trans::type_id::create("trans");
trans.reseed();  // 基于 "my_trans" 和 "trans" 生成种子

use_uvm_seeding

对比说明：

• 未调用

  reseed

  ：种子依赖对象的内存分配顺序，结果不稳定；
• 调用

  reseed

  ：种子基于类型名和实例名生成，结果稳定（前提是名称唯一）。

五、使用建议与最佳实践

1. 优先使用宏来简化代码编写；
   

   // 推荐：使用宏自动实现
   `uvm_object_utils_begin(my_trans)
     `uvm_field_int(addr, UVM_ALL_ON)
     `uvm_field_int(data, UVM_ALL_ON)
   `uvm_object_utils_end
   
   // 不推荐：手写所有 do_* 方法

2. 输出调试信息时，推荐使用字段宏或进行方法覆盖；
   

   convert2string

   
   

   // 简单场景：覆盖 convert2string
   virtual function string convert2string();
     return $sformatf("addr=%0h data=%0h", addr, data);
   endfunction
   
   // 复杂场景：使用 do_print + printer API
   virtual function void do_print(uvm_printer printer);
     super.do_print(printer);
     printer.print_field_int("addr", addr, 32, UVM_HEX);
   endfunction

3. 当比较操作失败时，应打印详细的上下文信息以便排查；
   

   uvm_comparer comp = new();
   comp.show_max = 10;  // 最多显示 10 个不匹配
   if(!expected.compare(actual, comp)) 
     `uvm_error("CMP", comp.miscompares)

4. 对动态数组进行序列化打包时，必须显式包含其长度信息；
   

   packer.pack_field_int(queue.size(), 32);
   foreach(queue[i]) packer.pack_field_int(queue[i], 8);

文档生成时间：2025-11-26

源文件路径：

uvm1_2_src/src/base/uvm_object.svh

代码总行数：1331 行

核心文件大小：41.6KB

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：object ect Transaction Automation Scoreboard