UVM 寄存器覆盖率采样:内建 covergroup、sample 时机与模型合并
更新时间:2026-09-29。覆盖率模型:covergroup 与 bins 设计 讲了 covergroup 怎么设计才不多不漏;UVM 寄存器模型集成:RAL 接入验证环境 讲了寄存器模型怎么挂进环境。这一篇解决两者交叉处的一个具体痛点:RAL 模型建好了、frontdoor/backdoor 都通了,可回归跑完寄存器覆盖率是零——因为
uvm_reg自带的 covergroup 从没被采样过。开模型、接采样链、合并数据,三步缺一不可。
本文要回答的问题
uvm_reg/uvm_reg_block内建的覆盖率模型包含什么,怎么打开?- 覆盖率到底是「谁」在什么时候调用
sample()采的? - 总线 monitor 到 predictor 这条采样链少了哪一环会静默失效?
- 多个 reg block、多次仿真的覆盖率数据怎么合并成一份报告?
一、内建覆盖模型里有什么
UVM 的寄存器抽象层(RAL)不只是读写通路,每个 uvm_reg 对象内部可以挂一个由工具自动生成的 covergroup,覆盖内容围绕「这个寄存器的每个字段被写过/读过哪些值」。它不是默认就有的——覆盖模型要显式构建,采样要显式触发,这是新手最容易漏的两步。
打开方式分两层。先在编译或 elaboration 阶段声明你要哪一类覆盖:
// 在 test base 的 build_phase 最前面设置
uvm_reg::include_coverage("*", UVM_CVR_ALL);UVM_CVR_ALL 展开后是几类覆盖的或集:UVM_CVR_REG_BITS(寄存器每一位的 0/1 翻转)、UVM_CVR_ADDR_MAP(地址映射里每个寄存器被访问到)、UVM_CVR_FIELD_VALS(每个字段取到的具体值,配合字段级 covergroup 或自动 bins)。然后在寄存器模型 build() 之后显式构建覆盖模型:
function void build_phase(uvm_phase phase);
super.build_phase(phase);
reg_model = my_reg_block::type_id::create("reg_model");
reg_model.build();
reg_model.lock_model(); // 锁定后才能 build coverage
reg_model.build_coverage(UVM_CVR_ALL);
endfunction漏掉 include_coverage 或 build_coverage 中任何一个,后面 sample() 调用全是空调用,回归全绿、覆盖率全零——这是最典型的静默失效现场。
二、sample 时机:四条触发路径
模型有了,什么时候采?uvm_reg 提供两个采样入口:sample_values() 采「当前镜像值」,sample(addr, data, is_read, map) 采「一次访问事件」。工程上有四条触发路径,行为差别很大:
| 触发路径 | 谁调用 sample | 采到的是什么 | 适用场景 |
|---|---|---|---|
显式 read()/write() | RAL 内部在操作完成时自动调 | 本次 frontdoor 访问的地址与数据 | 用 RAL API 做寄存器配置的环境 |
| backdoor 访问 | 不自动采样,需手动补 | 需 sample_values() 采镜像 | peek/poke 为主的调试序列 |
| 总线 monitor → predictor | predictor 收到 uvm_reg_item 后调 | 总线上实际发生的访问 | 覆盖必须反映 DUT 真实行为时 |
手动 sample_values() | 测试序列自行调用 | 镜像快照 | 检查「某配置组合出现过」的场景 |
关键辨析:前两条采的是「验证环境想干什么」,第三条采的是「DUT 实际被干了什么」。如果寄存器序列绕开 RAL 直接驱动总线(比如用 VIP 的 sequence 发 raw transaction),路径一根本采不到;如果 DUT 内部逻辑自己改写状态寄存器(硬件置位的中断标志位),路径一、二同样看不到。所以覆盖率收口必须走路径三——把总线 monitor 看到的每一笔访问经 predictor 喂给寄存器模型。

读这张图抓两条链:实线是主采样链——无论谁发起访问,monitor 看到总线事务就广播给 predictor,predictor 一边更新镜像一边触发 sample(),所有真实访问一笔不漏;虚线是补丁链——backdoor peek/poke 不上总线,monitor 看不见,只能在序列里手动补一次 sample_values(),否则后门写进去的配置覆盖率永远统计不到。环境搭建时先问自己:寄存器访问有几条通路?每条通路最终有没有汇入 predictor 或手动采样点?漏一条就是一个覆盖盲区。
三、采样链的三个断点
「monitor 到 predictor」一句话,落地有三个具体断点,按出现频率排序:
第一,predictor 的 map 没设。uvm_reg_predictor 拿到一笔总线事务后,要靠地址反查是哪个寄存器,反查用的地址映射必须显式给:
function void connect_phase(uvm_phase phase);
reg_predictor = uvm_reg_predictor#(bus_tr)::type_id::create("reg_predictor", this);
reg_predictor.map = reg_model.default_map; // 断点一:漏这行反查不到地址
reg_predictor.adapter = reg_adapter; // 断点二:漏这行事务转不成 reg_item
bus_monitor.ap.connect(reg_predictor.bus_in); // 断点三:analysis 连接漏接
endfunction三行各管一段:adapter 负责把总线 transaction 翻译成 uvm_reg_item,map 负责按地址定位寄存器,connect 负责把数据流接起来。任何一个缺失都不报 elaboration 错误——predictor 安静地收不到数据或翻译不出来,覆盖率表上一片零,只能靠覆盖率审查才发现。
第二,monitor 只广播了它「认得出」的事务。有些总线 VIP 的 monitor 对 reset 期间或错误响应的事务不发 analysis 消息。如果你的测试专门写非法地址验证错误响应(aliasing、权限寄存器),这部分访问天然采不到,需要在 covergroup 之外单独用定向 coverpoint 补。
第三,多总线多 map 接错。一个 reg block 挂在两条总线下(配置口 + 维护口),每条总线一个 predictor,各自要设对应的 uvm_reg_map。把 A 总线的 predictor 设成 B 总线的 map,地址反查结果错位,覆盖率记到错误的寄存器头上——这比采不到更糟,是采错。
四、多模型与多次仿真的覆盖率合并
大项目里寄存器不止一个 block:子系统级环境各自有 reg model,芯片级再集成;回归又是成百上千个种子并行跑。合并分两个层次。
模型内合并由 UVM 自动完成——同一 reg block 里所有 uvm_reg 的 covergroup 都属于同一棵层次树,uvm_reg_block::sample() 会递归触发整棵树,报告工具按层次聚合。
跨仿真合并交给仿真器的覆盖数据库:所有种子把 UCDB(或等价格式)落盘,回归结束后 merge。这里有个寄存器覆盖特有的坑:merge 前确认每个种子的覆盖模型结构一致。如果不同 test 用不同的 include_coverage 范围(有的只开 REG_BITS,有的全开),merge 时工具要么报类型冲突要么按子集合并丢掉数据。纪律是:include_coverage 只在 base test 设一次,所有 test 继承,禁止单个 test 私自改覆盖范围。

合并之后的缺口分析才是终点。寄存器覆盖的典型缺口有两类:字段的某些合法值从未写过(回填定向 sequence 写一遍即可),以及某些位从未翻转过(常见于保留位误开了覆盖——这类应该在 covergroup 里用 ignore_bins 或干脆不建模,而不是硬写测试去打)。缺口处理前先分类,别让「打保留位」这种无效测试污染回归。
五、验收清单
一套寄存器覆盖采样链验收时过这五条:include_coverage 在 base test 统一设置;build_coverage 在 lock_model 之后调用;predictor 三行(map/adapter/connect)齐全且每条总线一个 predictor;backdoor 通路有手动 sample_values() 补丁;merge 后按字段级报告做缺口分类。五条全过,寄存器覆盖率才是一个可信的验证收口指标,而不是一个好看的零。实际项目里这个清单适合直接贴进环境验收 checklist,每个新人接手环境时照着重走一遍,半小时就能排除绝大多数「采不到」的隐患。
这一篇在知识体系里的位置
- 上游基础:覆盖率模型:covergroup 与 bins 设计 讲 covergroup/coverpoint/bins 的通用设计方法,本篇是其「自动生成版」在寄存器场景的落地。
- 模型搭建:UVM 寄存器模型集成:RAL 接入验证环境 讲 adapter/predictor/frontdoor 的接入,本篇聚焦接入后覆盖采样链的验收。
- 验证收口:寄存器覆盖率与功能覆盖率、代码覆盖率共同构成签核三视图,缺口分析方法可横向借用。
总结
UVM 寄存器覆盖率采样的全部要点是三步闭环:先在 base test 用 include_coverage + build_coverage 打开 uvm_reg 内建 covergroup,再把总线 monitor 经 predictor 的采样链(adapter、map、analysis connect 三行缺一不可)接通,让每一笔真实总线访问自动触发 sample(),backdoor 通路手动补 sample_values();最后统一覆盖范围后 merge 各种子 UCDB,按字段级报告分类回填缺口——做到这些,寄存器覆盖率从零噪声指标变成可信的验证签核依据。