mirror 与 desired:UVM 寄存器模型两个影子值的差异、rw.check() 用法与同步时机速查
更新时间:2026-10-06。UVM 寄存器模型里每个 field 存两份值:
desired(想让它成为的值)和mirrored(认为 DUT 里现在的值)。新手最容易写出的 bug 是:用set()改了值就get()回来比对,全程没碰硬件,测试绿得毫无意义——因为get()返回的是 desired,不是硬件真值。这一篇是 L 层速查,把两份值的语义、更新时机、rw.check()与同步接口一次讲清。完整语义长文见 desired 与 mirror 语义,预测器接线见 adapter 与 predictor 接线。
本文要回答的问题
- desired 与 mirrored 各代表什么,何时各自更新?
- 为什么
set()后立刻get()比对是假绿? read/write/update/mirror/predict五个接口分别动哪份值?rw.check()怎么用,背后比的是什么?
一、两份值的语义
desired 是「软件意图」:下次往硬件写的时候想写进去的值。调用 reg.set(v) 或 field.set(v) 只改它,不发起任何总线事务。mirrored 是「模型对硬件的认知」:模型相信 DUT 里此刻的值。它只能被三条途径更新——总线事务完成(frontdoor 读写后按结果更新)、backdoor 访问完成、显式 predict() 调用。
这个区分的价值在「意图与现实的差」本身就是信息:desired != mirrored 意味着「想写的还没写进去」或「硬件被别的途径改了」。UVM 的 update() 接口正是利用这个差做惰性写:只把有差异的字段发总线事务写下去,没差异的跳过——大寄存器块的写效率全靠它。
| 接口 | 动 desired | 动 mirrored | 发总线事务 |
|---|---|---|---|
set(v) | 是 | 否 | 否 |
get() | 返回 desired | — | 否 |
get_mirrored_value() | — | 返回 mirrored | 否 |
write(v) | 是 | 完成后更新 | 是 |
read() | 否 | 完成后更新 | 是 |
update() | — | 完成后更新 | 仅差异字段 |
mirror(check) | 否 | 完成后更新 | 是(读) |
predict(v) | 否 | 是 | 否 |
二、假绿测试的典型长相
最常见的错误测试长这样:
// 假绿:全程没碰硬件
ctrl_reg.set(32'hDEAD_BEEF);
if (ctrl_reg.get() !== 32'hDEAD_BEEF) `uvm_error(...) // 永远通过set() 之后 get() 拿到的就是自己刚写的值,比对恒真。正确的寄存器读写测试必须走总线:
ctrl_reg.write(status, 32'hDEAD_BEEF, .parent(this));
ctrl_reg.read(status, rd_data, .parent(this));
if (rd_data !== 32'hDEAD_BEEF)
`uvm_error("REG", $sformatf("readback %h != written %h", rd_data, 32'hDEAD_BEEF))
// 或更省力:让模型自己比
ctrl_reg.mirror(status, .check(UVM_CHECK), .parent(this));mirror() 发起一次读,把读回值更新进 mirrored;带 UVM_CHECK 时还会拿读回值和原 mirrored 比对——语义是「硬件现在的值和模型以为的值一致吗」。这正是 rw.check() 在背后做的事:内建 uvm_reg_hw_reset_seq / bit-bash 序列里的 check,本质都是对 mirrored 与硬件读回值的一致性检查,字段级的访问策略(RO/W1C/WO)在比对时被考虑——RO 字段期望复位值、WO 字段跳过读比对。字段策略建模见 寄存器访问策略建模。
上图是两份值的关系速查:desired 由软件意图推动、mirrored 由硬件现实推动(显式访问或 predictor 被动同步);update 消费两者之差,mirror 用硬件读回校正认知——假绿测试的病根是只在 desired 一侧打转。
三、mirrored 的被动同步:predictor 的意义
显式 read/write 之外的硬件变化——别的 master 写了同一寄存器、DUT 内部逻辑自清(W1C 被硬件置位后自清)、中断状态位硬件置位——都要靠 predictor 更新 mirrored,否则模型认知与现实漂移。标准接法是 monitor 把观测到的总线事务广播给 uvm_reg_predictor,predictor 调 predict() 更新 mirrored。auto-predict 与 explicit-predict 的取舍见 auto predict 与 explicit predict:开 auto-predict 时 frontdoor 访问自己更新 mirrored,简单但漏掉「旁路写」;explicit 模式一切经 predictor,认知最准。
volatile 字段(硬件可能随时改,如状态位、FIFO 计数)的纪律:比对其 mirrored 之前必须 mirror() 或 read() 刷新,拿陈旧 mirrored 比对是误报的第一来源;这类字段的访问套路见 volatile 字段访问。backdoor 路径(见 backdoor HDL path)读写同样更新 mirrored,常用于不耗总线带宽的快速预置——但预置完用 frontdoor 读回验证,才算真正测到物理路径。
四、rw.check() 使用速查
rw.check() 在 uvm_reg_single_access_seq 等内建序列里做「写完读回比对」,工程上直接调用它的场景不如理解其语义重要,三条实用建议:
- 字段级豁免进模型不进代码:WO 字段、写后会变的 volatile 字段,靠字段策略和
set_compare(UVM_NO_CHECK)在模型里声明,别在 sequence 里写特判; - 中断类 W1C 字段的检查窗口:写 1 清零到读回之间硬件可能又置位,检查序列要接受「读回 0 或新置位」两种合法值,做法是把该字段比较掩码放开、用断言单独盯;
- 复位值普查用
uvm_reg_hw_reset_seq,它逐寄存器mirror(check)对复位 mirrored,跑通它就是 mirrored 初始化正确的证明——mirrored 的初值来自模型reset(),不是自动等于硬件复位值,序列前记得regmodel.reset()。
寄存器验证的整体方法学见 UVM 寄存器验证方法学,内建序列清单见 寄存器内建序列库。
五、调试速查:mirrored 漂移的四种来源
当 mirror(check) 或内建序列报「读回值与 mirrored 不符」,按四种来源依次排查能覆盖九成现场。来源一「初始化没对齐」:模型 reset() 没调或调用时机早于 DUT 复位完成,mirrored 初值与硬件复位值错位——症状是从第一个寄存器检查起就成片报错,先确认 regmodel.reset() 在 DUT 出复位之后执行。来源二「旁路写没走 predictor」:环境里固件路径或另一个 master 写了寄存器,总线 monitor 没接 predictor 或 analysis 连接漏了一路——症状是报错集中在被固件碰过的寄存器,且报错的旧值恰好是固件写入前的值;检查 adapter 与 predictor 接线 的 analysis port 拓扑。来源三「volatile 字段拿陈旧值比」:状态寄存器在两次采样间被硬件改了——症状是误报随机出现、重跑位置漂移;对该字段比对前先刷新或按第四节放开比较掩码。来源四「访问策略建模错」:W1C 建成长 RW、RC(read-clear)建成普通 RO,模型按错策略预测 mirrored——症状是报错字段固定、读回值恒为「策略语义推演后的另一值」;对着 spec 核字段策略,建模清单见 寄存器访问策略建模。
顺手给一个模型自检脚本思路:回归前跑一次「mirrored 一致性冒烟」——regmodel.reset() 后对所有寄存器 mirror(UVM_CHECK),全绿才说明初始化路径、predictor 接线、字段策略三者健康;它只要几十秒,却能把四类来源里的前三类挡在正式回归之前。把这个冒烟塞进每日回归的第一棒,寄存器类误报的噪音会低一个数量级。
六、多 map 与共享寄存器的注意点
寄存器出现在多个 address map(多总线接口都能访问同一物理寄存器)时,desired 只有一份,mirrored 也是一份,但访问路径有多条:从 A 总线 write 会更新 mirrored,若 B 总线的 monitor 也接了 predictor,同一事务不会被重复预测(predictor 按寄存器而非按 map 更新);但如果两条总线可能并发写,模型看到的 mirrored 是「最后一次被预测的值」,并发语义本身要靠 scoreboard 或断言约束,模型不替你做仲裁。多 map 的建模细节见 多 map 地址建模。间接索引寄存器(index-data 窗口对)场景下 mirrored 语义同理,但访问序列是两拍总线事务,predictor 要按展开后的物理地址预测,见 间接索引访问。这两类结构里 mirrored 漂移的排查路径与第五节相同,只是「旁路写」的来源更多——多 map 环境里每条总线都是潜在的旁路。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录的一篇 L 层速查,主关键词 mirror 与 desired。它是 desired 与 mirror 语义 长文的速查伴侣,向上承接 UVM 寄存器验证方法学;横向与 adapter 与 predictor 接线(mirrored 的同步硬件)、auto predict 与 explicit predict(更新策略取舍)、寄存器访问策略建模(字段级比对豁免)同属寄存器模型治理;backdoor 预置见 backdoor HDL path。
总结
mirror 与 desired 的分工就一句:desired 是软件想写的值(set 只改它、不发事务),mirrored 是模型对硬件的认知(只被总线完成、backdoor 或 predict 更新);set 后 get 比对是恒真假绿,真测试必须 write/read 走总线或 mirror(UVM_CHECK);旁路写靠 predictor 被动同步 mirrored,volatile 字段比对前先刷新——意图与现实的差是信息不是噪声,用 update 消费它、用 mirror 校正它。