实数容差比对:SystemVerilog real 比较为什么必须带容差、$bitstoreal 精度与断言写法速查
更新时间:2026-10-05。在验证带模拟行为模型、DDS(直接数字频率合成)、滤波器系数或 PLL 小数分频比的 testbench 时,
real类型几乎绕不开。新手最常见的翻车现场是:DUT 输出0.30000000000000004,reference model 期望0.3,一句if (dut_out == exp)断言红成一片,查了半天发现两边算法都对——错的是比较方式本身。这一篇是 L 层速查,把「实数为什么不能直接==」「容差怎么选」「$bitstoreal的位级语义」「断言和 scoreboard 里怎么写」四件事一次讲清。更宽的断言方法论见 SVA 断言实践,scoreboard 整体框架见 UVM sequence、driver 与 scoreboard。
本文要回答的问题
- 为什么 SystemVerilog 的
real用==比较几乎必然误报? $bitstoreal/$realtobits转换前后精度是否守恒,位级比较什么时候可用?- 绝对容差、相对容差、ULP 容差各适用什么场景,阈值怎么定?
- 断言和 scoreboard 里的容差比对有哪些可直接抄的写法?
一、为什么 real 不能直接 ==
SystemVerilog 的 real 就是 IEEE 754 双精度浮点:1 位符号、11 位指数、52 位尾数。它的问题不是「不准」,而是「表示不全覆盖」——十进制的 0.1 在二进制里是无限循环小数,硬件里只能存成最近的可表示值。于是三个后果接踵而来:同一数学值经不同运算顺序得到不同位型(a+b+c 与 c+b+a 结果可能差最后一个尾数位);不同工具、不同精度模式的数学函数($sin、$exp、$sqrt)返回值可能不同;DUT 内部的定点实现和 reference model 的浮点实现天然有量化差。
还要补一刀:shortreal(单精度,32 位)问题更尖锐,尾数只有 23 位,有效精度约 1.2e-7,凡是走 shortreal 的通路容差要再放宽一个数量级以上。
在这种现实下,dut == exp 等价于「两边 64 位每一位都相同」,这在跨实现、跨运算顺序时几乎是个不可能条件。真实事故里,某小数 NCO 验证用 == 比对相位累加值,仿真跑了十万个周期后断言全红,最后定位到 reference 用了 $sin 而 DUT 用 CORDIC 迭代——算法都正确,差异在第 50 个尾数位上。结论只有一条:real 比较必须带容差,没有例外。

上图说明误报链条:DUT 与 reference 走了两条不同的计算路径,尾数低位天然有差,== 把这个差放大成断言失败;补上容差比较才是闭环。
二、$bitstoreal 与 $realtobits:位级语义速查
$realtobits(r) 把 real 按 IEEE 754 编码成 64 位 bit [63:0],$bitstoreal(b) 反向解码。这两个系统任务的价值在于:转换本身是无损的——$bitstoreal($realtobits(r)) === r 恒成立,位型原样往返。所以它俩常用于两个场景:一是把 real 打包进 DPI 或 mailbox 传输(real 不能直接过某些接口,位型可以);二是需要严格相等判定时比较位型而不是数值。
但要分清「位级比较可用」和「该用位级比较」是两回事。位型相等比数值相等更严格——0.0 和 -0.0 数值相等但位型不同;NaN 有上百万种位型。所以速查规则是:同一实现内的数据搬运校验可以用位型 === 比较(比如 backdoor 写读一致性);跨实现、跨算法的正确性检查必须回到数值容差。这一点和 scoreboard 乱序匹配 里「按 key 匹配再按字段容差」的分层思路一致:先定匹配键,再定字段的比较严格度。
| 场景 | 推荐比较方式 | 理由 |
|---|---|---|
| 同一模型内部数据回读 | 位型 === | 无损往返,严格可查 |
| DUT vs reference 浮点结果 | 数值容差 | 实现路径不同,位型必然不同 |
| 含 NaN / Inf 的特殊值 | 先 $isunknown 加分类判 NaN | NaN 不等于自身,容差公式失效 |
| 定点输出 vs 浮点期望 | 按量化步长取容差 | 量化误差天然是半个 LSB |
三、容差三选一:abs、rel、ULP
工程上有三种容差口径,选型看数值的动态范围。绝对容差 abs(a-b) <= tol 最简单,适合输出幅度已知且稳定的场景(比如归一化到 ±1 的滤波器输出,tol 取 1e-6)。相对容差 abs(a-b) <= tol * max(abs(a), abs(b)) 适合跨数量级的量(比如频率字从几 Hz 到几百 MHz),避免小数值时相对误差爆炸。ULP(unit in the last place,尾数末位单位)容差最严谨,直接数两边位型之间隔几个可表示值,适合验证数学库函数本身,日常 scoreboard 用得少。
定阈值的实用方法:先让 reference 自比对(跑两遍不同表达式顺序),量出「模型自身噪声底」;再让 DUT 对 reference 跑一组典型激励,统计误差分布的 99% 分位;阈值取分位值的 2 到 3 倍,既盖住正常离散又留得住真 bug。别拍脑袋写 1e-9——双精度在 1.0 附近的机器精度约 2.2e-16,1e-9 对纯浮点过松、对 16 位定点又过紧。这个「先测噪声底再定阈值」的纪律,与 UART 波特率容差验证 里按时钟误差预算倒推阈值的做法完全同构。

上图是容差选型的速查树:先问输出动态范围,稳定走绝对容差、跨数量级走相对容差、验数学库才上 ULP;阈值永远从实测误差分布倒推,不拍脑袋。
四、断言与 scoreboard 里的可直接抄写法
最常用的封装是一个带容差的比较函数,断言和 scoreboard 共用:
function automatic bit real_eq(input real a, input real b,
input real abs_tol, input real rel_tol);
real diff, scale;
if ($isunknown(a) || $isunknown(b)) return 0;
if (a == b) return 1; // 快速路径,也兜住 Inf 相等
if (a != a || b != b) return 0; // NaN 永远不匹配
diff = (a > b) ? (a - b) : (b - a);
scale = (a > 0 ? a : -a) > (b > 0 ? b : -b) ? (a > 0 ? a : -a) : (b > 0 ? b : -b);
return (diff <= abs_tol) || (diff <= rel_tol * scale);
endfunction几个细节值得说透。a == b 快速路径不是冗余:它兜住了 Inf == Inf(差为 NaN,容差公式会误判)。NaN 检查用「不等于自身」的 IEEE 性质,比位型判指数字段简洁。绝对、相对容差取「或」关系:数值靠近 0 时相对容差失效,靠绝对容差兜底;数值巨大时绝对容差失效,靠相对容差兜底。在 SVA 里包一层就是断言:
property p_freq_match;
@(posedge clk) disable iff (!rst_n)
valid |-> real_eq(dut_freq, exp_freq, 1.0, 1e-6); // 1Hz 或 1ppm
endproperty
a_freq: assert property (p_freq_match)
else $error("freq mismatch: dut=%g exp=%g", dut_freq, exp_freq);scoreboard 侧(实现框架见 scoreboard predictor 模型),把 real_eq 作为字段级比较策略注入,和 uvm compare 与 do hooks 讲的字段比较定制正好衔接:uvm_field 宏不直接支持 real 容差,在 do_compare 里对 real 字段改调 real_eq,其余字段走默认比较。日志里务必把 dut、exp、实际差值、所用容差四项都打印出来——误报排查时缺一个都得多跑一轮仿真。最后提醒一条纪律:容差参数放进 config 集中管理,别散在各断言里写魔法数字;评审时容差表就是验证完备性的一部分,和 断言覆盖密度 一样要过评审关。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录的一篇 L 层速查,主关键词实数容差比对。它向 SVA 断言实践 与 SVA 断言完整指南 输送「real 字段的断言前提」,向 scoreboard predictor 模型 与 UVM compare 机制 输送「real 字段的比较策略」;横向与 UART 波特率容差验证(误差预算倒推阈值)、scoreboard 乱序匹配(匹配键与字段容差分层)共享同一套「容差必须有据」的纪律。
总结
实数容差比对的核心就一句:real 永远不用 ==,跨实现比较必须带容差——$bitstoreal/$realtobits 只在同一实现内做无损搬运时用位型严格判等;容差按动态范围三选一(幅度稳定用绝对容差、跨数量级用相对容差、验数学库才用 ULP),阈值从实测误差分布的 99% 分位放大 2 到 3 倍倒推;落地时封装一个同时兜住 NaN/Inf 的 real_eq 函数,断言和 scoreboard 共用,容差参数进 config 集中评审——容差写对了,红的就是真 bug。