1. 先想清楚再敲 set_svf:形式验证里最不起眼的一条命令
综合跑完,网表拉进 Formality 做形式验证,verify 一跑,unmatched points 几百个,比对点一片红。回头翻脚本,RTL 和网表都读对了,约束也没问题,唯独少了一行 set_svf。在芯片验证这条链路上,SVF 文件和加载它的 set_svf 属于典型的「平时想不起来、出事第一个被怀疑」的角色,也是代码开发工具里最容易被当成配菜的一环——它不产生任何设计逻辑,只负责把综合阶段的优化记录喂给验证工具,让两边的比对点能对上号。这篇写的就是怎么把这条命令用对:单文件怎么指、目录怎么批量扫、两个参数怎么取舍、加载完之后怎么确认它真的生效了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具里的 SVF:它记录了什么,set_svf 又读了什么
2.1 SVF 不是网表,是综合阶段留下的变更记录
综合工具在把 RTL 变成门级网表的过程中,会做一堆结构上的改写:寄存器复制、常量传播、无用逻辑删除、边界优化、端口重命名、层次搬移。这些动作在综合看来是常规优化,在形式验证看来却是「两边对不上了」。RTL 里明明是一个寄存器,网表里变成了并联的两个;RTL 里一根信号线,网表里被一个常量顶掉了;RTL 里某个子模块内部的一小段逻辑,被综合展平到了父模块里。
如果只把 RTL 和网表丢给验证工具,它能依靠的就只有名字匹配和结构相似性,一旦综合动过手,匹配率立刻塌下来。SVF 的存在意义就是补上这段信息差:综合工具每做一次会影响比对关系的变换,就往 SVF 里写一条记录,说明「我在哪一层、把谁改成了什么、原来那个东西现在叫什么」。形式验证工具读进这些记录,在 match 阶段按图索骥,把 RTL 侧的点和网表侧的点重新拴到一起。
所以 SVF 和网表是配套的产物,不是可以随便替换的通用文件。换一版综合、换一套约束、哪怕是同一个 RTL 重跑一次综合,SVF 的内容都可能不一样。这一点在后面讲加载时机和排查时还会反复出现。
从代码开发工具的使用角度看,理解 SVF 的内容结构比记住它的路径重要。它本质上是一份带层次的、按模块划分的变换清单,一个中等规模的设计往往会拆成几十个 SVF,每个模块一份,父模块的清单里还可能引用子模块的变换结果。这就解释了为什么模块一多,手工 set_svf 会变得不现实——不是命令难写,是文件太多、依赖关系太杂。
提示:SVF 是综合侧产出的,不是验证侧生成的。验证脚本里能做的只是「加载」和「控制加载顺序」,没法在验证侧修补综合侧漏掉的变换记录。
2.2 set_svf 的两种写法:指到文件,还是指到目录
set_svf 最基本的用法只有两种形态,一种指到具体文件,一种指到目录。前者适合模块数量少、每个模块的加载时机需要精确控制的情况;后者适合模块数量上去了、逐个指定不现实的场景。
tcl复制# 形态一:直接指到单个 SVF 文件,一次加载一份
set_svf ./svf_files/top.svf
# 形态二:指到一个目录,交给工具自己扫
set_svf ./svf_files/
第一种写法没什么歧义,路径写对、文件存在、后缀对得上,就能加载进去。它真正的价值在于「可控」:当你只想先验证某一个子模块、或者想按自己的节奏分批次加载时,逐个指定是最稳的。缺点是模块一多,脚本会变成几十行重复的 set_svf,改一次目录结构就要全量返工。
第二种写法是批量加载的主力。给一个目录路径,工具自己去扫里面的文件、逐个加载。这一行命令能顶掉几十行手工指定,代价是你必须接受工具默认的扫描规则——它默认只认某个后缀、默认按某个顺序排。这两条默认规则正是下一章要拆开讲的,也是踩坑最集中的地方。
从命令语义上看,set_svf 做的是「把这份变换记录登记到当前验证会话里」,它本身不触发比对,也不校验记录和网表是否真的对得上。这意味着命令执行成功、没有报错,并不等于 SVF 真的生效了。真正暴露问题的时刻是后面的 match 和 verify:如果 SVF 没登记上、或者登记的顺序不对,匹配率和比对结果会直接告诉你,但要等到那一步才发现,往往已经浪费了一轮跑批时间。
我一般的习惯是:脚本里凡是出现目录形态的 set_svf,紧跟着就补一段能打印出「这次到底登记了哪些文件」的检查逻辑,不依赖工具自己默默处理。这段检查逻辑不复杂,但它把「静默失败」变成了「立刻可见」,后面排查章会给出具体写法。
2.3 加载时机与前置条件:为什么它必须卡在 match 之前
set_svf 的位置不是随便放的。它必须发生在两份设计都已经读进当前会话之后、match 正式执行之前。放早了,设计还没进来,记录没有可挂靠的对象;放晚了,match 已经按「没有 SVF」的方式把比对点定死了,再补记录也改不回来。
一个典型的顺序是这样的:读 golden 侧的 RTL,读 revised 侧的网表,加载 SVF,执行匹配,最后 verify。中间任何一步调换,结果都可能不对,而且这种不对往往不报错,只是结果变差。
tcl复制# 读入两侧设计
read_verilog -container rtl ./rtl/top.v
read_verilog -container netlist ./netlist/top.v
# 两侧都进来之后,再登记 SVF
set_svf ./svf_files/
# 登记完才做匹配和比对
match
verify
这段脚本的重点不在语法,在顺序。set_svf 夹在读设计和 match 之间,是有明确原因的:读到一半就加载,工具可能还没建立完整的层次信息;match 之后再加载,等于事后补票。
除了时机,还有一个前置条件容易被忽略——SVF 必须和网表同源。同一版综合产出的网表和 SVF 才是一套东西。如果目录里混着上一轮综合留下的旧 SVF,或者网表重新综合过而 SVF 目录没清干净,加载进去的记录描述的是另一次优化过程,比对点不但对不上,还可能被引到错误的方向上去。这也是我后来坚持在批量加载前先清空目标目录、重新生成的原因,血泪经验换来的习惯。
3. 批量加载的两个开关:代码开发工具默认行为与你的预期差在哪
3.1 默认只吃 .svf:后缀过滤是静默发生的
目录形态的 set_svf 有一个很关键、但不会主动提醒你的默认行为:它只加载 .svf 后缀的文件。目录里其他后缀的东西,不管内容是不是合法的变换记录,都会被跳过,而且跳过的过程通常不产生任何显眼的提示。
这就带来一个很典型的翻车现场:综合流程为了节省空间,把 SVF 压成了别的后缀;或者某个模块的产出脚本用了自定义命名,文件名长得像 ctrl.svf.txt、datapath.svfinfo。你看着目录里文件齐全,set_svf ./svf_files/ 也执行成功,但实际登记进去的只有那部分后缀标准的文件,剩下的全被静默忽略。等到 match 结果不理想,回头查目录,才发现问题不在命令,在后缀。
解决方式是用 -extension 显式告诉工具该认哪些后缀:
tcl复制# 显式指定要加载的后缀,避免默认过滤把文件挡在外面
set_svf -extension .svf.gz ./svf_files/
参数的含义很直白:把「认什么后缀」这件事从工具的默认值改成你指定的值。用的时候有两点要注意。一是别指望指定了一个新后缀之后,默认的 .svf 还会被顺手带上——所以如果目录里两种后缀并存,要么分两次调用,要么把两种后缀都列进去,别只写一个就以为全覆盖了。二是后缀要和实际文件名严格一致,.svf.gz 和 .gz 在过滤时是两回事,写错了照样一个都扫不进来。
我的做法是在跑批脚本里固定加一步「后缀盘点」:加载之前先列出目录里所有文件的扩展名分布,和 -extension 里写的值对一遍。这一步花不了几秒,但能挡掉相当一部分「命令成功、结果异常」的玄学问题。
3.2 -ordered:时间戳顺序为什么会坏事
第二个默认行为更隐蔽:目录批量加载时,文件的加载顺序默认按时间戳走。也就是说,工具是看文件的修改时间来决定先读谁后读谁的。
单模块设计里这无所谓,反正只有一份。但模块数量上去了、模块之间还存在依赖关系时,顺序就成了实打实的影响因素。某个父模块的 SVF 里记录的变换,可能依赖子模块先被登记;如果子模块的 SVF 因为生成得晚、时间戳更新,反而被排到后面加载,前后关系就拧了。表现出来就是:文件全都加载了,日志里也没报错,但匹配结果始终差一截,而且每次重跑综合、重新生成 SVF 之后,差的程度还不一样——因为时间戳变了,顺序也变了。
要按文件名排序,加 -ordered:
tcl复制# 按文件名排序加载,而不是按文件的时间戳
set_svf -ordered ./svf_files/
这个参数本身只是把排序依据从时间戳换成文件名。真正决定成败的是文件名怎么起——如果文件名是 ctrl.svf、datapath.svf、top.svf 这种纯字母序,-ordered 只是把「时间戳顺序」换成了「字典序」,未必等于你想要的依赖顺序。所以我一般会把文件名做成带序号前缀的形式,让字典序天然等于依赖序:
bash复制# 按依赖顺序重命名 SVF,前缀补零保证字典序与依赖序一致
i=1
for m in top ctrl datapath alu; do
src="./svf_raw/${m}.svf"
if [ ! -f "$src" ]; then
echo "missing: $src"
continue
fi
printf -v idx "%03d" "$i"
cp "$src" "./svf_files/${idx}_${m}.svf"
i=$((i + 1))
done
这段脚本做的事很朴素:按人工给定的模块顺序遍历,把原始 SVF 复制到目标目录,并在文件名前补一个三位数的序号。补零是为了让 010 排在 009 之后而不是 0010 排到 002 前面,字典序和数值序保持一致。missing 分支的作用是不让某个模块缺失导致整个循环静默跳过——缺文件必须打出来,否则后面又是一轮无头排查。
配合 -ordered 使用之后,加载顺序就从「看文件什么时候生成的」变成了「看文件名怎么排的」,顺序从此可控、可复现、可写进版本管理。在一个模块数接近三十的设计上,把默认的时间戳顺序换成按依赖关系排好序的文件名之后,同一套 RTL 和网表的验证通过率从七成出头拉到了接近满值,中间没有改任何设计代码,动的只是加载顺序。
3.3 把目录组织成可排序、可核对的结构
参数设对了,还得有配套的目录组织,否则 -ordered 排出来的顺序依然是碰运气。我现在固定用三层结构:一层放综合刚吐出来的原始 SVF,一层放重命名排序后的待加载文件,一层放每次跑批的加载日志。原始层只增不改,排序层每次清空重建,日志层按日期留档。
这样做的直接好处是排查时能快速回答三个问题:这次到底加载了哪些文件、按什么顺序加载的、和上一次相比多了或少了谁。三个问题都能答上来,绝大多数「SVF 好像没生效」的疑问在十分钟内就能定位。
tcl复制# 加载前清空排序层,避免上一轮的残留文件混进来
# 排序层的文件由外部脚本按依赖序重新生成
set_svf -ordered ./svf_files_sorted/
注意:排序层每次重建,不要往里面手动补文件。手动补进去的文件没有序号前缀,在
-ordered下会被排到最前面或最后面,顺序一乱,前面的排序工作就白做了。
4. 排查:set_svf 执行成功却没生效的四条线索
4.1 现象:命令没报错,匹配率一点没动
现象很典型:脚本里 set_svf 那一行执行完,没有任何错误输出,但 match 之后的匹配率和没加载时几乎一样。原因通常出在后缀过滤上——目录里的文件后缀不符合默认规则,被静默跳过,等于这条命令什么也没登记进去。
解决分两步。第一步先把目录里实际有哪些后缀列出来,和预期对一遍;第二步用 -extension 显式指定,再重跑一次。验的时候不要只看命令有没有报错,要看加载之后登记的条目数有没有变化,这个数不动,说明还是没进去。
4.2 现象:文件都加载了,结果每次跑都不一样
同一套设计,同样的脚本,今天跑和明天跑,匹配结果有差异。原因几乎可以锁定在加载顺序上——默认按时间戳排序,而时间戳会随着文件重新生成而变化,顺序一变,依赖关系就跟着变。
解决办法就是 -ordered 加上带序号前缀的文件名,把顺序从「文件系统决定」改成「脚本决定」。这一步做完之后,同样的输入必须得到同样的结果,如果还有波动,那就不是顺序问题,得往 SVF 和网表是否同源上查。
4.3 现象:报找不到路径,但文件明明在那儿
现象是命令直接报路径不存在。原因多数是相对路径的基准目录和你以为的不一样——脚本是以调用时的工作目录为基准解析 ./svf_files/,而不是以脚本文件所在目录为基准。在本地交互式跑没问题,一放进跑批环境,工作目录变了,路径就失效。
解决方式有两种:要么在脚本开头显式切到固定目录,要么干脆全部写绝对路径。我倾向前者,因为路径写死之后换机器又要改一遍。无论用哪种,跑批脚本里都应该把当前工作目录打出来,出问题时第一眼就能确认基准在哪。
4.4 现象:模块一多,总有那么几个模块的 SVF 没被加载
现象是整体匹配率上不去,逐个模块查下来,发现总是固定几个模块缺记录。原因在于手工逐个 set_svf 的写法——模块数量上去之后,脚本靠人复制粘贴维护,漏一行、改错一个文件名都很正常,而且漏了不会报错。
解决办法是彻底放弃逐个指定,改成目录批量加载加清单核对。加载前用脚本生成一份期望加载的文件清单,加载后把实际登记的条目和清单比一遍,差集不为空就不往下走。这一步加上之后,漏加载这类问题基本绝迹。
4.5 现象:新加的 SVF 加进去了,结果反而更差
现象是补了一份 SVF 之后,匹配率不升反降。原因通常是目录里混着历史残留——上一轮综合留下的旧文件没清,和新文件一起被扫了进去,两套描述互相打架。
解决方式是把「清空待加载目录」做成流程里的固定动作,每次加载前先删后建,绝不在旧目录上叠加。目录里出现来源不明的文件时,宁可先移走重跑一轮,也不要抱着「多加载一份总没坏处」的想法——在 SVF 这件事上,多一份错的比少一份更麻烦。
5. 加载完别急着 verify:三步确认它真的进去了
set_svf 最容易骗人的地方,是它的成功与否和结果的好坏之间隔了一整轮 match。等 verify 跑完再回头查,成本已经付出去了。所以我后来固定加了三步确认,放在 match 之前,每步都很轻。
第一步是清单核对。加载前由脚本生成一份期望清单,加载后把实际登记的文件名抓出来,两份做差集。差集为空才继续,不为空就直接停下来看是哪几个文件没进去,而不是让它带着残缺的 SVF 往下跑。
bash复制# 加载前生成期望清单,加载后做差集比对
ls ./svf_files_sorted/*.svf | sort > /tmp/expected.lst
# 实际登记的文件名由跑批日志抓取后写入 /tmp/actual.lst
comm -23 /tmp/expected.lst /tmp/actual.lst
comm -23 输出的是「在期望清单里、但不在实际清单里」的部分,也就是漏加载的文件。这个命令的好处是把「有没有漏」变成一个可以直接看的列表,而不是靠肉眼扫几千行日志。
第二步是顺序抽样。清单对上之后,从日志里抽头三条和尾三条的加载记录,确认顺序和文件名序号一致。如果头三条不是 001_、002_、003_ 开头,说明 -ordered 没生效或者文件名前缀没起作用。
第三步是基线对比。同一套设计在 SVF 没加载时的匹配率是多少,加载后应该是多少,这两个数要留档。不是为了追求某个具体数字,而是为了在结果异常时能立刻判断「是这次加载出了问题」还是「设计本身变了」。基线一旦建立起来,后面每次跑批只需要看偏离。
| 检查项 | 什么时候做 | 不通过时的第一动作 |
|---|---|---|
| 期望清单与实际清单差集 | 加载后、match 前 | 查后缀过滤和路径基准 |
| 首尾加载顺序抽样 | 加载后、match 前 | 查 -ordered 和文件名前缀 |
| 匹配率与历史基线对比 | verify 后 | 查 SVF 与网表是否同源 |
这三步加起来不到一分钟,但把「事后翻日志找原因」变成了「事前就知道有没有问题」。从那以后我每次写形式验证脚本,set_svf 后面都强制跟一段清单核对,不管这次设计有多少个模块——宁可多跑一条 comm,也不想再经历一次 verify 跑完一片红、然后从头怀疑 RTL 的下午。希望帮到你。
