UVM1.2 源码概述合集（5）_uvm_component 深度解析

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

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

立即领取

感谢您参与论坛问题回答

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

+2 论坛币

UVM 组件基石：uvm_component 深度解析

一、系统角色与整体定位

在 UVM 架构体系中，uvm_component 处于继承结构的中层关键位置，是构建验证平台的核心基类。它不仅继承自

uvm_report_object

以获得基础报告能力，还被多个核心类如

uvm_test

、

uvm_env

、

uvm_agent

、

uvm_driver

和

uvm_monitor

所扩展使用。

该组件通过与

uvm_phase

协同工作，实现统一的相位调度机制，并以

uvm_top

作为根节点，构建出整个验证环境的全局树形拓扑结构。

二、功能定位

uvm_component

是所有层次化验证组件的共同父类，可视为搭建验证系统的“积木底座”。在

uvm_object

的基础上，集成了专用于验证环境的关键特性，包括：

• 层次结构管理
• 相位同步控制
• 配置参数传递
• 事务记录支持

这些机制使得原本分散的验证逻辑能够被组织成清晰有序的树状架构，提升复用性与可维护性。

三、典型应用场景

验证环境构建： 所有标准模块如 env、agent、driver、monitor、scoreboard 等均派生自该类。

层次化管理需求： 当需要建立父子关系、执行树遍历或路径查询时，此组件提供完整的接口支持。

相位流程控制： 支持 build → connect → run → check → report 的标准化执行顺序，确保各阶段协调一致。

配置信息分发： 允许从顶层向下游组件传递配置项，例如随机种子、超时阈值、功能使能标志等。

工厂覆盖机制： 可在运行时动态替换组件类型，比如用增强型 driver 替代默认实现，提升灵活性。

四、代码结构剖析

1. 层次管理模块（Hierarchy Interface）

负责维护组件间的父子关联关系。

• 输入： 父组件句柄、子组件名称
• 处理： 利用

  m_children

  关联数组存储层级关系
• 输出： 支持深度计算、路径查找和树形遍历操作

2. 相位执行模块（Phasing Interface）

控制组件生命周期中的各个执行阶段。

• 输入： 相位对象（来自

  uvm_phase

  ）
• 处理： 按照预定义顺序调用虚方法：build → connect → run → check → report
• 输出： 实现组件间时序同步，配合 objection 机制防止相位提前终止

3. 配置管理模块（Configuration Interface）

实现参数的跨层级自动配置。

• 输入： 键值对形式的配置数据（如

  uvm_config_db::set("*.env", "timeout", 1000)

  ）
• 处理： 从全局或父级配置表中匹配并调用

  set_*_local

  完成赋值
• Output： 成员变量自动初始化，无需手动设置

4. 工厂接口模块（Factory Interface）

提供对象创建与类型替换的能力。

• 输入： 类型名、实例路径
• 处理： 调用

  uvm_factory

  创建对象，并应用类型/实例级别的覆盖规则
• 输出： 返回新生成的组件或对象引用

5. 报告控制模块（Hierarchical Reporting）

统一管理日志输出行为。

• 输入： 严重等级、ID 标识、冗余级别、输出文件句柄
• 处理： 递归设置当前组件及其所有子组件的报告属性
• 输出： 实现层次化的日志控制系统

6. Objection 管理模块（Objection Interface）

协调相位结束时机。

• 输入： objection 实例、发起对象、描述信息
• 处理： 提供

  raised

  、

  dropped

  、

  all_dropped

  等回调钩子函数
• 输出： 控制相位是否可以安全退出

7. 事务记录模块（Recording Interface）

支持仿真过程中事务的追踪与可视化。

• 输入： 事务对象、流名称、标签
• 处理： 调用

  begin_tr

  和

  end_tr

  将数据写入仿真数据库
• 输出： 可在波形查看工具中观察到事务发生的时间点与内容

8. 域与调度控制（Phase Domain API）

支持复杂场景下的定制化调度策略。

• 输入： phase domain 对象
• 处理： 允许定义独立的相位执行域（例如电源管理域单独控制）
• 输出： 更加灵活的相位执行方案

五、核心方法详解

1.

new(string name, uvm_component parent)

—— 组件构造函数

目的： 初始化组件并将其挂接到层次树中。

执行逻辑：

• 检查

  parent

  是否已存在同名子组件，若存在则报错
• 当

  parent

  为 null 时，自动将当前组件设为

  uvm_top

• 调用父组件的

  m_add_child(this)

  方法建立父子链接
• 继承父组件的 phase domain 设置
• 调用

  reseed()

  生成具有确定性的随机种子

常用参数示例：

name="my_driver"

,

parent=agent_inst

,

function uvm_component::new(string name, uvm_component parent);
  if (parent == null) parent = uvm_top;  // 自动挂到根节点
  m_parent = parent;
  parent.m_add_child(this);  // 加入父组件的子组件列表
  m_domain = parent.m_domain;  // 继承相位域
  reseed();  // 基于层次路径生成种子
endfunction

关键限制：

• 禁止在

  build_phase

  结束后创建组件（否则触发

  ILLCRT

  错误）
• 不允许将自身设置为自己的父组件（引发

  THISPARENT

  异常）

2.

get_full_name()

—— 获取完整层次路径

目的： 返回从根节点到当前组件的全路径名称。

实现方式： 首次调用时构建缓存字符串（如

"uvm_test_top.env.agent.driver"

），后续直接返回缓存结果。

对比说明：

• uvm_object

  ：仅返回对象本地名称

• uvm_component

  ：返回包含路径的全名

function string get_full_name();
  if (m_name == "") return get_name();  // uvm_top 的情况
  else return m_name;  // 返回预先构建的全路径
endfunction

3.

build_phase(uvm_phase phase)

—— 构建相位执行入口

目的： 创建子级组件并完成初始配置。

内部流程：

• 自动调用

  apply_config_settings()

  应用配置项
• 兼容性调用

  build()

  支持旧版本代码迁移
• 用户通常在派生类中重写该方法以实例化具体子组件

典型用法：

class my_agent extends uvm_agent;
  my_driver drv;
  my_monitor mon;
  
  function void build_phase(uvm_phase phase);
    super.build_phase(phase);  // 必须调用 super
    drv = my_driver::type_id::create("drv", this);
    mon = my_monitor::type_id::create("mon", this);
  endfunction
endclass

4.

run_phase(uvm_phase phase)

—— 运行相位主逻辑

目的： 执行测试主体动作，如发送激励、采集信号。

特点说明：

• 这是一个消耗仿真时间的 task 类型方法
• 必须通过

  phase.raise_objection(this)

  提升 objection 计数，防止相位过早结束
• 任务完成后需调用

  phase.drop_objection(this)

  释放 objection，允许相位正常退出

使用示例：

task run_phase(uvm_phase phase);
  phase.raise_objection(this, "driver sending transactions");
  repeat(100) begin
    @(posedge vif.clk);
    vif.data <= $random;
  end
  phase.drop_objection(this);
endtask

注意事项：

run_phase

返回并不代表相位终止，只有当所有相关组件都 drop 了 objection 后，相位才会真正结束。

5.

lookup(string name)

—— 路径查找功能

目的： 根据相对或绝对路径定位目标组件。

解析逻辑：

• 如果路径

  name

  以

  .

  开头，则从

  uvm_top

  开始搜索（绝对路径模式）
• 否则从当前组件出发进行查找（相对路径模式）

uvm_component

uvm_object

uvm_report_object

uvm_test

uvm_env

uvm_agent

uvm_driver

uvm_monitor

uvm_phase

uvm_top

m_children

uvm_config_db::set("*.env", "timeout", 1000)

set_*_local

uvm_factory

raised

dropped

all_dropped

begin_tr

end_tr

new(string name, uvm_component parent)

parent

null

uvm_top

m_add_child(this)

reseed()

name="my_driver"

parent=agent_inst

function uvm_component::new(string name, uvm_component parent);
  if (parent == null) parent = uvm_top;  // 自动挂到根节点
  m_parent = parent;
  parent.m_add_child(this);  // 加入父组件的子组件列表
  m_domain = parent.m_domain;  // 继承相位域
  reseed();  // 基于层次路径生成种子
endfunction

build_phase

ILLCRT

THISPARENT

get_full_name()

m_name

"uvm_test_top.env.agent.driver"

uvm_object::get_full_name()

uvm_object

uvm_component

function string get_full_name();
  if (m_name == "") return get_name();  // uvm_top 的情况
  else return m_name;  // 返回预先构建的全路径
endfunction

build_phase(uvm_phase phase)

apply_config_settings()

build()

class my_agent extends uvm_agent;
  my_driver drv;
  my_monitor mon;
  
  function void build_phase(uvm_phase phase);
    super.build_phase(phase);  // 必须调用 super
    drv = my_driver::type_id::create("drv", this);
    mon = my_monitor::type_id::create("mon", this);
  endfunction
endclass

run_phase(uvm_phase phase)

phase.raise_objection(this)

phase.drop_objection(this)

task run_phase(uvm_phase phase);
  phase.raise_objection(this, "driver sending transactions");
  repeat(100) begin
    @(posedge vif.clk);
    vif.data <= $random;
  end
  phase.drop_objection(this);
endtask

run_phase

lookup(string name)

name

.

递归查找各级子组件

示例参数：

".uvm_test_top.env"

→ 使用绝对路径进行查找

"agent.driver"

→ 从当前组件开始向下逐层搜索

uvm_component comp = this.lookup("env.agent.driver");
if (comp != null) $display("Found: %s", comp.get_full_name());

核心变量说明

1. 层次关系维护机制

m_parent

/

m_children

类型：

uvm_component m_parent

/

uvm_component m_children[string]

作用：

m_parent

：指向父级组件（根节点指向

null

）

m_children

：关联数组，键为子组件名称，值为对应子组件句柄
设计目的：支持树形结构的遍历、路径定位及递归操作

2. 全路径缓存机制

m_name

类型：

string

作用：保存完整的层次路径（例如

"top.env.agent.driver"

），避免重复拼接路径字符串
易混淆点：

m_leaf_name

（继承自

uvm_object

）仅存储叶子节点名称

m_name

存储的是完整路径信息

3. 相位域设置

m_domain

类型：

uvm_domain

作用：决定组件执行哪一套相位调度流程（默认为

uvm_domain

，可自定义如电源管理域等）
继承规则：子组件默认继承父组件的相位域配置

4. 事务记录详细程度控制

recording_detail

类型：

int

（包括

UVM_NONE

、

UVM_LOW

、

UVM_MEDIUM

、

UVM_HIGH

、

UVM_FULL

）
作用：调节事务是否以及以何种粒度写入波形文件
配置方式：

uvm_config_db#(int)::set(this, "*", "recording_detail", UVM_FULL);

5. 配置调试开关

print_config_matches

类型：

static bit

（全局变量）
作用：当设置为 1 时，

apply_config_settings

将打印所有匹配到的配置项
调试用途：用于排查配置未生效的问题

关键技术实现原理

1. 层次树的双向索引机制

uvm_component

采用双向关联数组来维护父子组件之间的连接关系。
实现原理：

m_children[string]

：通过名称索引子组件，实现快速查找

m_children_by_handle[uvm_component]

：通过句柄索引，防止同一组件被重复添加
优势体现：
- 利用

m_children.exists(name)

可快速检测组件重名情况
- 借助

m_children_by_handle.exists(child)

可有效阻止组件多次注册
代码验证：

function bit m_add_child(uvm_component child);
  if (m_children.exists(child.get_name())) begin
    `uvm_warning("BDCLD", "A child with this name already exists")
    return 0;
  end
  if (m_children_by_handle.exists(child)) begin
    `uvm_warning("BDCHLD", "This child is already registered")
    return 0;
  end
  m_children[child.get_name()] = child;
  m_children_by_handle[child] = child;
  return 1;
endfunction

2. 相位中 Objection 同步机制

相位不会自动终止，必须依赖 objection 计数归零 才能结束。
工作原理：
- 每个组件调用

phase.raise_objection(this)

时，计数加 1
- 调用

phase.drop_objection(this)

时，计数减 1
- 当全局 objection 计数为 0 并持续一个 delta 周期后，当前相位才正式结束
优势分析：
- 支持动态长度的测试场景（如“发送完 N 个数据包即停止”）
- 避免父组件提前退出导致子组件被强制中断
与固定时长对比：

// 方案1：固定时长（不灵活）
task run_phase(uvm_phase phase);
  #1000ns;  // 必须等满1000ns
endtask

// 方案2：Objection机制（灵活）
task run_phase(uvm_phase phase);
  phase.raise_objection(this);
  send_n_transactions(100);  // 发完就结束
  phase.drop_objection(this);
endtask

3. 配置优先级匹配算法

apply_config_settings

采用“自上而下、精确优先”的查找策略。
匹配流程：
- 首先查询全局配置表（最高优先级）
- 然后从

uvm_top

开始，沿层次结构逐级向上查找父组件中的配置
- 若字段名匹配成功（支持通配符

*

），则调用

set_*_local

进行赋值
优先级示例：

// 全局配置（优先级最高）
uvm_config_db#(int)::set(null, "*", "timeout", 500);

// 父组件配置
uvm_config_db#(int)::set(this, "env.*", "timeout", 1000);

// 精确路径配置（优先级最高）
uvm_config_db#(int)::set(null, "top.env.agent", "timeout", 2000);

最终结果：

top.env.agent

的

timeout

值为 2000（因精确匹配优先于模糊匹配）

4. 工厂覆盖的查找顺序机制

create_component

遵循“实例覆盖优先于类型覆盖”的原则。
查找逻辑：
- 先检查是否存在实例级别的覆盖（如

"top.env.agent.drv"

→

my_driver

）
- 若无，则查看是否有类型级别的覆盖（如

driver

→

my_driver

）
- 若两者皆无，则创建原始类型的对象
代码示例：

// 类型覆盖：所有 driver 都用 my_driver
set_type_override_by_type(driver::get_type(), my_driver::get_type());

// 实例覆盖：只有 "agent.drv" 用 turbo_driver（优先级更高）
set_inst_override_by_type("agent.drv", driver::get_type(), turbo_driver::get_type());

常见问题与易错点解析

疑难点 1：构造函数中遗漏调用

super.new(name, parent)

导致层次断裂

现象描述：

class my_env extends uvm_env;
  function new(string name, uvm_component parent);
    // 忘记调用 super.new(name, parent)
  endfunction
endclass

实际后果：

my_env

未被正确加入父组件的

m_children

中，导致

get_full_name()

返回错误路径
根本原因：

super.new(name, parent)

是建立父子关系的关键步骤，跳过将使该组件处于孤立状态
解决方案：

function new(string name, uvm_component parent);
  super.new(name, parent);  // 必须第一行调用
endfunction

避坑口诀：“组件构造第一行，

super.new

不能忘。”

疑难点 2：在

build_phase

中创建组件但未传入

parent

现象描述：

function void build_phase(uvm_phase phase);
  drv = my_driver::type_id::create("drv");  // 缺少第二个参数
endfunction

实际后果：

drv

的父组件变成了

uvm_top

，而非预期的当前组件
根本原因：

create

的第二个参数是

parent

，若省略则默认使用

null

，从而自动挂载到

uvm_top

解决方案：

drv = my_driver::type_id::create("drv", this);  // 正确传递 parent

调试技巧：打印

drv.get_full_name()

，若路径异常则说明父组件设置有误
避坑口诀：“创建组件传

this

，层次结构不会飞。”

疑难点 3：

run_phase

返回后相位立即结束，导致子组件被终止

现象描述：

task run_phase(uvm_phase phase);
  fork
    send_data();  // 后台线程
  join_none
endtask  // run_phase 立即返回，子线程被杀

根本原因：
一旦

run_phase

执行完毕，若此时所有 objection 都已被 drop，则相位会立刻结束，并强制杀死所有子进程
解决方案：使用 objection 机制延长生命周期：

task run_phase(uvm_phase phase);
  phase.raise_objection(this);
  fork
    send_data();
  join_none
  wait_for_completion();  // 等待后台线程结束
  phase.drop_objection(this);
endtask

避坑口诀：“

run_phase

返回不算完，objection 归零才收摊。”

疑难点 4：使用

lookup

查找路径时缺少前导

.

现象描述：

// 当前组件是 top.env.agent
uvm_component comp = lookup("uvm_test_top.env");  // 返回 null

根本原因：
未添加

.

的路径被视为相对路径，只能从当前组件

top.env.agent

向下查找，因此无法定位到

uvm_test_top

解决方案：使用绝对路径时必须加上前导

.

：

uvm_component comp = lookup(".uvm_test_top.env");  // 正确

避坑口诀：“绝对路径加点号，相对路径从自己找。”

疑难点 5：配置未生效，因字段名拼写错误

现象描述：

// 设置配置
uvm_config_db#(int)::set(this, "*", "time_out", 1000);  // 拼写错误

// 获取配置
class my_comp extends uvm_component;
  int timeout;  // 字段名不匹配
  function void build_phase(uvm_phase phase);
    super.build_phase(phase);  // timeout 仍为默认值
  endfunction
endclass

根本原因：配置项中的字段名称存在拼写错误，导致匹配失败，赋值未执行

配置键与字段名不匹配问题

当配置键与字段名称不一致时，系统将无法找到对应的字段，导致配置失效。

"time_out"

"timeout"

apply_config_settings

解决方案：统一字段命名

确保配置键和目标字段的名称完全一致，避免因大小写或拼写差异引发匹配失败。

uvm_config_db#(int)::set(this, "*", "timeout", 1000);  // 正确

调试技巧：查看匹配过程

通过开启调试模式，可以追踪配置键的匹配流程，定位具体出错环节。

print_config_matches = 1

uvm_component::print_config_matches = 1;

避坑口诀

“配置键名严格匹配，拼写错误白费力气。”

疑难点 6：多次调用引发组件错误

在组件构造完成后再次尝试修改其名称，会触发运行时异常。

set_name

my_comp comp = new("comp1", this);
comp.set_name("comp2");  // 报错：INVSTNM

根本原因分析

UVM 框架禁止在构造阶段之后更改组件名称，原因如下：

• 父组件依赖旧名称进行索引查找，导致索引失效
• 层次路径出现不一致，破坏树形结构完整性

m_children

解决方案：构造期确定名称

组件的名称必须在构造函数中一次性设定，后续不允许任何形式的修改。

new

避坑口诀

“组件名称一次定，构造之后不可更。”

疑难点 7：在 build_phase 之后创建组件导致错误

若在 build_phase 阶段结束后才创建组件，将违反 UVM 的构建规则。

build_phase

ILLCRT

class my_test extends uvm_test;
  function void end_of_elaboration_phase(uvm_phase phase);
    my_driver drv = my_driver::type_id::create("drv", this);  // 错误！
  endfunction
endclass

根本原因

UVM 要求所有组件必须在 build_phase 中完成实例化，以保证测试平台的层次结构在 run_phase 开始前已完全固定。

connect_phase

解决方案：提前至 build_phase 创建

将组件的创建逻辑迁移至 build_phase 内执行，确保符合构建时序要求。

function void build_phase(uvm_phase phase);
  drv = my_driver::type_id::create("drv", this);
endfunction

边界条件处理

如需实现动态创建功能，可在 build_phase 中预设占位组件，并利用工厂机制在后期进行替换。

避坑口诀

“组件创建在 build，后期创建会报废。”

五、使用建议与最佳实践

1. 子组件应始终在 build_phase 中创建，保障层级正确建立。
   

   build_phase

   
   

   class my_agent extends uvm_agent;
     my_driver drv;
     my_monitor mon;
     
     function void build_phase(uvm_phase phase);
       super.build_phase(phase);
       if (is_active == UVM_ACTIVE)
         drv = my_driver::type_id::create("drv", this);
       mon = my_monitor::type_id::create("mon", this);
     endfunction
   endclass

2. 合理使用 objection 机制控制相位执行时长，避免过早结束。
   

   task run_phase(uvm_phase phase);
     phase.raise_objection(this, "Sending packets");
     fork
       send_packets();
     join
     phase.drop_objection(this, "All packets sent");
   endtask

3. 通过配置数据库传递参数，提升环境灵活性与可重用性。
   

   // 在 test 中配置
   uvm_config_db#(int)::set(this, "env.agent.*", "num_trans", 100);
   
   // 在 driver 中读取
   class my_driver extends uvm_driver;
     int num_trans = 10;  // 默认值
     
     function void build_phase(uvm_phase phase);
       super.build_phase(phase);
       // super.build_phase 会自动调用 apply_config_settings
     endfunction
   endclass

4. 利用工厂覆盖实现组件的灵活替换，支持场景多样化。
   

   // 在 test 中覆盖
   function void build_phase(uvm_phase phase);
     set_inst_override_by_type("env.agent.drv", 
                                driver::get_type(), 
                                turbo_driver::get_type());
     super.build_phase(phase);
   endfunction

5. 定期打印整个测试平台的层次结构，辅助排查连接问题。
   

   function void end_of_elaboration_phase(uvm_phase phase);
     uvm_top.print_topology();  // 打印完整层次树
     print_config();  // 打印当前组件的配置
   endfunction

文档信息

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

源文件路径：

uvm1_2_src/src/base/uvm_component.svh

代码行数：3639 行

核心文件大小：122.6KB

扫码加我 拉你入群

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

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

分享0 收藏0 回帖

关键词：Component comp COM OMP Transactions