波形 dump 控制:$dumpvars 与 $fsdbDumpvars 的范围层级控制、条件 dump 与回归环境波形策略
更新时间:2026-10-05。波形 dump 控制是每个验证工程师都会写、却很少有人写对的那几行代码:测试台里随手一句
$fsdbDumpvars(0, tb)全程开 dump,一条用例跑出几十 GB 的 FSDB 文件,回归农场一晚上把磁盘打满,仿真速度还被 dump 拖慢两三成。真相是——dump 语句的每个参数都有明确语义,范围给多大、层级给多深、什么时候开什么时候关,直接决定磁盘占用、仿真吞吐和事后 debug 的可用性这三件事的平衡。站内的 测试台性能剖析 讲怎么定位测试台热点,dump 开销往往是剖析结果里的头号大户;这一篇把波形 dump 本身讲透:$dumpvars 与 $fsdbDumpvars 的参数语义、范围与层级怎么给、条件 dump 怎么写、回归环境应该按什么策略分级开波形。
本文要回答的问题
- $dumpvars 的 level 参数和 scope 参数到底是什么语义,
0和1差在哪? - $fsdbDumpvars 相比标准 VCD 的 dump 多哪些开关,哪些开关对性能影响最大?
- 条件 dump(按时间窗、按事件、按错误触发)怎么写,各自适合什么场景?
- dump 对仿真速度和磁盘的开销量级是多少,怎么量化?
- 回归环境里波形策略应该怎么分级——冒烟、夜间回归、失败重跑各开多少?
一、$dumpvars 语义:level 与 scope 的组合含义
标准 Verilog 的 $dumpvars 只有两个关键参数,但组合语义常被搞错。原型是 $dumpvars(level, scope1, scope2, ...):scope 指定 dump 哪个层次实例,level 指定从该实例向下钻几层。核心规则是:level 为 0 表示「该 scope 及其以下所有层级」,level 为 N(N≥1)表示「该 scope 及以下 N-1 层」——也就是说 level=1 只 dump scope 本层的信号,子模块一个不进。
举几个具体组合。$dumpvars(0, tb) ——tb 及以下全部层级、全部信号,这是最暴力也最贵的写法;$dumpvars(1, tb) ——只 dump tb 顶层的信号,DUT 内部完全不进;$dumpvars(2, tb.u_dut) ——dump DUT 顶层加第一级子模块,再深的内部信号不记;$dumpvars(0, tb.u_dut.u_core, tb.u_dut.u_bus) ——可以列多个 scope,core 和 bus 两个子树全量 dump,其余部分不管。最后这种「多 scope 白名单」写法是工程上最值得养成的习惯:与其全量 dump 再事后翻文件,不如一开始只 dump 关心的子树,文件体积常常能差一个数量级。
还有两个容易踩的细节。第一,$dumpvars 必须在 $dumpfile 之后调用,否则波形写到默认的 verilog.dump 里,多并行用例互相覆盖。第二,对同一个 scope 重复调用 $dumpvars 以后一次为准,不会叠加——想扩大范围就要重新给完整列表。第三,VCD(Value Change Dump,值变 dump)格式只记 4 态逻辑值的变化,不记断言、不记 interface 里的 modport 视图、对 SystemVerilog 的 class 句柄更是完全无感——这就是为什么 UVM 环境基本不用 VCD,而是用厂商专有格式,下面一节专门讲。

上图把 level 语义画成了一棵层次树:从 tb 出发,level 像一把尺子量向下钻的深度,level 不够的支路(比如 u_ddr_ctrl 这种三级子模块)直接被挡在 dump 之外;而右侧的白名单写法绕过 tb 直接点名 u_core 和 u_bus 两个子树做 level=0 的全量 dump。这张图对应的工程判断是:层级控制不是省事的手段,而是波形策略的第一刀——先把「我大概率要在哪个子树里找 bug」想清楚,再决定 dump 语句怎么写。
二、$fsdbDumpvars:专有格式的开关全家桶
FSDB(Fast Signal Database)是 Synopsys Verdi 生态的波形格式,相比 VCD 有两个本质优势:压缩存储(同等内容体积通常是 VCD 的十分之一到五分之一)和随机访问(打开几十 GB 波形也能秒级拖到任意时间点,VCD 只能顺序扫)。代价是要在编译和运行时链 Novas 的库,dump 语句也换成 $fsdbDumpvars 全家。
$fsdbDumpvars 的基本参数与 $dumpvars 对齐:$fsdbDumpvars(0, tb) 同样是 tb 全层级。真正的差别在它配套的一串专有开关,按对性能的影响排,最值得掌握的有五个。
第一是 $fsdbDumpvars 的 "+mda" 选项:dump 多维数组和 memory 内部元素。默认不开,数组只记句柄不记内容;开了之后 memory 的每个字都进波形,对带大数组的 DUT(比如内部有几百 KB SRAM 模型的)文件体积可能翻好几倍——除非你确实要在波形里看 memory 内容,否则别开,需要看的时候用 +mda+packed_dim 之类细粒度选项只开 packed 维。
第二是 $fsdbDumpvars 的 "+struct" 与 "+parameter":struct 展开记成员、parameter 记常量值。参数记录几乎免费且 debug 时极有用(不用再翻代码确认配置),建议常开;struct 展开看 DUT 风格,接口里全是 struct 的环境值得开。
第三是 $fsdbDumpSVA:把 SVA 断言的尝试(attempt)、成功、失败统统记进波形。对调断言失败场景价值巨大——Verdi 里能直接看到断言从哪拍开始尝试、在哪拍失败。开销中等,建议夜间回归常开,这条和 SVA 断言实践 里的断言调试流程是配套的。
第四是 $fsdbDumpvarsByFile / 环境变量控制:把 dump 的 scope 列表写进外部文件,运行期读入,不改测试台代码就能调 dump 范围——回归环境做波形分级时这是关键机制,本文第四节会用到。
第五是 $fsdbSuppress:把指定 scope 里「从来不变的信号」压掉不记。对配置寄存器、tie-off 信号特别有效,能再省一截体积。
| 开关 | 作用 | 体积影响 | 性能影响 | 建议 |
|---|---|---|---|---|
| 默认 dump | 4 态信号变化 | 基准 | 基准 | 白名单 scope 常开 |
| +mda | 数组与 memory 内容 | 可翻数倍 | 明显变慢 | 按需定向开 |
| +parameter | 参数常量 | 几乎为零 | 可忽略 | 常开 |
| $fsdbDumpSVA | 断言尝试与结果 | 中等 | 中等 | 夜间回归开 |
| $fsdbSuppress | 压掉不变信号 | 省 5-20% | 略省 | 大 DUT 建议开 |
这张表是 FSDB 开关的速查:核心信息就一条——+mda 是体积杀手,默认别开;其余开关要么便宜要么值得,按场景挑。

上图对比了两条波形通路:同一份信号变化事件,走 $fsdbDumpvars 进 dump 引擎压缩落 FSDB,走 $dumpvars 落成明文 VCD;右侧的访问路径决定了事后 debug 体验——Verdi 对 FSDB 是随机访问,文本工具对 VCD 只能顺序扫。这也是为什么大项目的事实标准是 FSDB 做主力、VCD 只在需要跨工具交换(比如给功耗分析工具喂向量)时才生成。
三、条件 dump:让波形只在需要的时刻存在
全程 dump 是最贵的策略,而绝大多数 bug 的现场只发生在仿真的一小段时间窗里。条件 dump 的思路是:仿真裸跑到「接近出事」的时刻,再开 dump;抓够了就关。SystemVerilog 里有三种典型的条件 dump 写法。
第一种,时间窗 dump:$fsdbDumpoff / $fsdbDumpon 配对,在测试台里按时间或按 phase 控制。比如 UVM 里 reset phase 和 configure phase 的波形基本没人看,可以在 run_phase 开头 $fsdbDumpon、shutdown phase 前 $fsdbDumpoff,单这一条常常省掉 30% 的波形体积——复位阶段信号翻转极密集,恰好是 dump 最贵的时段。
第二种,事件触发 dump:等某个协议事件出现再开。经典场景是调一个偶发死锁——用 $wait 或 fork 起一个监控线程,等到「总线连续 5000 拍无响应」这类征兆条件成立,先 $fsdbDumpon 再让仿真继续跑,波形只覆盖征兆出现之后的窗口。更讲究的写法是配合环形缓冲:FSDB 支持先 dump 再用 $fsdbSwitchDumpfile 切段,征兆前预开一小段、征兆后抓一大段,前后现场都有。
第三种,错误触发 dump:scoreboard 或断言发现 mismatch 时,调用 $fsdbDumpon(如果之前关着)并跑固定拍数后 $finish。这种「事后开 dump」抓不到错误之前的现场,所以工程上的标配是失败重跑机制:第一遍裸跑只记录错误发生的仿真时刻(通过 $time 或 $getsimtime 打进日志),失败后自动用「错误时刻减 N 微秒开 dump」的配置重跑同种子用例——同种子保证场景完全复现,第二遍带着精确时间窗的 dump 跑,文件小、现场全。这个机制和 UVM transaction recording 调试 讲的 transaction 级记录是互补的两层:transaction 流全程记录(便宜),信号波形按需开窗(贵但全)。

这张时序图把三种条件 dump 串成了一条完整的工程流:上半段是单次仿真内的时间窗控制(Dumpon/Dumpoff 配对),下半段是失败后的自动重跑路径——scoreboard 报错时刻进日志,回归脚本拿同种子加时间窗配置重跑,最终落盘的是一份只覆盖错误现场的小波形。注意图中两个 Dumpon 的语义差别:第一个是「已知不关心的段不开」,省的是确定性的体积;第二个是「只有可能出事的段才开」,省的是不确定性带来的浪费。
四、开销量化与回归环境的波形分级策略
dump 开销到底多大?给一组量级参考(具体数字随 DUT 规模和信号翻转率浮动,但比例关系稳定):全程全层级 FSDB dump 通常让仿真墙钟时间增加 30%-100%——信号翻转率越高(门级仿真、DFT 移位)越靠近上限,RTL 级、低翻转场景靠近下限;文件体积上,一个中型 SoC 子系统跑 10 毫秒仿真,全层级 FSDB 在 5-50 GB 量级,同内容 VCD 在 50-300 GB 量级。回归农场一晚几百条用例,全量 dump 是直接把存储打穿的节奏,这正是 LSF 网格回归 里专门讲作业磁盘配额管理的原因。
所以回归环境必须做波形分级,按用例层级给不同的 dump 策略。业界比较成熟的分法是四级。第一级,冒烟回归(smoke):完全不开 dump,只跑 pass/fail。冒烟的意义是快速筛出环境性错误,失败了反正要交互式复现,留波形也没用——这一级要顶住「顺手开个 dump 保险」的诱惑,冒烟的量最大,开了就是纯浪费。第二级,夜间回归(nightly):默认不开 dump,失败用例自动进重跑队列,同种子加时间窗 dump 重跑(第三节的机制);同时为 5%-10% 的用例随机开白名单子树 dump,作为「没报错但行为异常」这类隐性问题的抽查样本。第三级,周回归(weekly):白名单 dump 常开,关键用例全层级 dump 但做时间窗裁剪,$fsdbDumpSVA 常开——周回归量小,可以花钱买 debug 体验。第四级,签核前专项(gate sim、低功耗仿真):全层级全程 dump,这时候仿真本身就慢一个量级(参考 门级仿真 SDF 与 X 传播),dump 开销占比反而小,而且签核阶段一个 bug 的代价远超磁盘钱。
| 回归层级 | dump 策略 | 时间窗 | 失败处理 | 磁盘预算 |
|---|---|---|---|---|
| 冒烟 | 全关 | 无 | 交互复现 | 零 |
| 夜间 | 默认关加随机抽查 | 抽查用例白名单 | 同种子重跑开窗 | 每夜数十 GB |
| 周回归 | 白名单常开 | 裁剪复位段 | 直接有波形 | 每周数百 GB |
| 签核专项 | 全层级全程 | 无裁剪 | 直接有波形 | 专项配额 |

上图把四级波形分级画成了一条分发流水线:用例带着层级标签进来,策略选择器按外部配置文件把用例分发到四条 dump 通道——冒烟零开销直通,夜间默认不开但失败自动进同种子重跑队列,周回归和签核逐级加码,所有波形最终汇入按层级配额管理的存储。这张图要强调的判断是:分级不是四份测试台代码,而是一套骨架加四份配置——通道之间的差别只在 $fsdbDumpvars 的 scope 文件和时间窗参数,这也是为什么本节反复强调配置外置。
最后一条落地建议:把 dump 配置做成外部文件而不是写死在测试台。用 plusarg(+fsdb_file=xxx +dump_scope_file=yyy)或环境变量传入,回归脚本按用例层级生成不同的 scope 文件——冒烟不生成、夜间生成白名单、签核生成全量。测试台代码里只留一套「读配置、按配置调 $fsdbDumpvars」的骨架,策略调整完全不动 RTL 和测试台,这与 回归管理方法论 里「配置外置、策略脚本化」的总原则一致。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录下仿真调试线的一篇 S 层深文,主关键词波形 dump 控制。向上衔接 测试台性能剖析——那一篇解决「怎么发现 dump 是热点」,本篇解决「发现之后怎么把 dump 开销压下去」。横向与 UVM transaction recording 调试(transaction 级记录与信号级波形的两层互补)、SVA 断言实践($fsdbDumpSVA 的调试流程配套)、回归管理方法论(波形分级策略的回归管理视角)互为补充。向下,门级与 DFT 场景的 dump 开销特性见 门级仿真 SDF 与 X 传播 和 LSF 网格回归 的磁盘配额管理。
总结
波形 dump 控制的核心是「范围、层级、时机」三件事:$dumpvars/$fsdbDumpvars 的 level=0 是全层级、level=N 是向下 N 层,多 scope 白名单写法比全量 dump 省一个数量级体积;FSDB 开关里 +mda 是体积杀手默认别开、+parameter 几乎免费建议常开、$fsdbDumpSVA 夜间回归值得开;条件 dump 用 Dumpon/Dumpoff 时间窗加「失败同种子重跑开窗」机制把波形压到只在错误现场存在;回归环境按冒烟全关、夜间抽查加重跑、周回归白名单、签核全量做四级波形分级,配置一律外置成文件——记住,波形是最贵的调试资产,只在该花的时刻花。