yosys synth 流程拆解:proc/fsm/techmap/abc 单步执行与各步 stat 资源变化实测
本篇是 eda-lab 开源 EDA 工具实操系列「综合段」的一篇,主题是 yosys synth 流程拆解。synth -top xxx 是绝大多数人用 yosys 的唯一姿势——一条命令进去、一份门级网表出来,中间发生了什么全靠猜。其实 help synth 会把这条命令内部执行的 30 多条子命令原样列出来,本篇就按这份真实步骤序列把它拆成 10 个分段单步执行,每段结束 stat 落盘,看线网数、单元数、进程数在每一步如何变化。商用工具侧对应的方法论(综合约束、QoR 报表怎么读)见 逻辑综合 Design Compiler 和 综合 QoR 报告解读,本篇用开源工具把「综合器在每一步干了什么」这件事亲手量出来。
本文要回答的问题
synth -top内部到底按什么顺序执行哪些子命令?yosys 0.33 的真实步骤序列是什么?- 怎么把它拆成单步执行,让每一步的设计快照能接力到下一步?
- proc、opt、fsm、wreduce、alumacc、memory、techmap、abc 各自干了什么?每步之后 stat 的数字怎么变?
- 为什么有时 fsm 步骤跑完 stat 毫无变化?「自复位电路」是什么坑?
- 逐步执行和
synth -top一把梭的最终网表一致吗?实测差多少?
环境
实验统一跑在 Docker 容器 geek-eda:0.1(ubuntu:24.04 基底)里,工具版本实测:
$ yosys --version
Yosys 0.33 (git sha1 2584903a060, ...)复现命令(挂载实验目录,容器内跑 Makefile):
docker run --rm --user $(id -u):$(id -g) -e HOME=/tmp \
-v ~/Project/geek-doc.cn/experiments:/work \
-w /work/eda-lab-yosys-synth-steps geek-eda:0.1 make run代码获取:本实验完整 RTL(
uart_rx.v与变体uart_rx_noselfreset.v)、逐步拆解 Makefile、全部 stat 日志见公开仓库 derekzhuo/geek-doc.cn 的experiments/eda-lab-yosys-synth-steps/。克隆后make run即可复现。
一、实验设计:一个带 FSM 的串口接收器
实验设计要满足一个条件:能触发尽量多的综合步骤。纯组合逻辑让 fsm、memory 整段空跑,纯状态机又让 alumacc/share 无事可做。最后选了经典的 3 倍过采样串口接收器 uart_rx.v(约 120 行),它同时含有:
| 设计成分 | 触发哪些综合步骤 | 说明 |
|---|---|---|
| 5 状态 FSM(IDLE/START/DATA/STOP/CLEANUP) | proc、fsm | case 编码的状态寄存器 |
位内计数器 clk_cnt、比特序号 bit_idx | wreduce、alumacc、share | 加法与比较运算 |
8 位移位寄存器 shift 按位写入 | proc(bitselwrite)、memory 段观察项 | shift[bit_idx] <= rxd |
| 两级输入同步器 | opt(触发器合并) | 普通时序逻辑 |
data_valid 单拍脉冲(默认赋 0) | opt_expr 常量传播 | 每拍先清 0 再条件置 1 |
拆解方式上有一个工程细节:yosys 没有「断点续跑」机制,所以逐步执行靠 write_ilang / read_ilang 接力——每步把当前设计写成 RTLIL 中间格式快照(out/s00.il 到 s09.il),下一步从快照读入继续。这和一把梭在内存里连续跑有细微差别,最终一致性对比那一节会用数字说话。
分段边界严格照抄 yosys -p "help synth" 在 0.33 版打印的命令序列(begin / coarse / fine / check 四段),归并成 10 个可观察的分段:
这张图就是 synth 命令的骨架:粗粒度段把 RTL 层面的结构(过程块、状态机、存储器、算术运算)逐一消化成通用单元,细粒度段再把通用单元拍平成门级网表并交给 ABC 做逻辑优化。下面的每一步 stat 数字都是这条流水线上的真实采样。
二、各步 stat 实测:资源变化总表
make run 跑完后,10 个分段的 stat 全部落盘(out/step_00_read.log 到 step_10_check.log),汇总成一张「步骤 × 资源变化」表。所有数字来自本次真实运行,yosys 0.33、geek-eda:0.1 容器:
| 分段 | 执行的命令 | 线网数 | 单元数 | 进程数 | 关键动作 |
|---|---|---|---|---|---|
| 0 读入 | read_verilog; hierarchy | 61 | 22 | 2 | 两个 always 块还是「进程」 |
| 1 proc | proc | 130 | 84 | 0 | 过程块展开,进程清零 |
| 2 opt 初轮 | opt_expr; opt_clean; opt -nodffe -nosdff | 47 | 44 | 0 | 常量传播,单元数砍半 |
| 3 fsm | fsm | 47 | 44 | 0 | 无变化(原因见第四节) |
| 4 wreduce | opt; wreduce; peepopt; opt_clean | 56 | 53 | 0 | 单元数反升(减法拆位宽) |
| 5 alumacc/share | alumacc; share; opt | 62 | 53 | 0 | 3 个加法器合成 $alu |
| 6 memory | memory -nomap; opt_clean | 62 | 53 | 0 | 无存储器可识别,空跑 |
| 7 fine 前半 | opt -fast -full; memory_map; opt -full | 54 | 45 | 0 | 全量优化再收敛 |
| 8 techmap | techmap | 560 | 1022 | 0 | 高阶单元炸成门级 |
| 9 abc | opt -fast; abc -fast; opt -fast | 190 | 223 | 0 | ABC 重优化,收敛 |
| 10 check | hierarchy -check; stat; check | 190 | 223 | 0 | 一致性检查 0 问题 |
这张表里藏着三条值得单独展开的规律,下面三节逐个说。
三、三条曲线:proc 展开、techmap 爆炸、abc 收敛
第一条曲线发生在 proc。 读入时 stat 显示 Number of processes: 2——两个 always 块(同步器一个、状态机加数据通路一个)在 RTLIL 里还是「进程」这种带语义的高阶对象。proc 一步把它们彻底展开:case 语句变成 $pmux 和一堆 $eq 比较器,寄存器变成 $adff(带异步复位的触发器),移位寄存器的按位写入 shift[bit_idx] <= rxd 变成 bitselwrite 辅助逻辑。展开后单元数从 22 涨到 84($mux×28、$adff×12、$eq×21),线网从 61 涨到 130,同时进程数归零——从这一步起,设计里不再有任何 Verilog 过程语义,只剩单元和连线。
第二条曲线是 opt 初轮的「砍半」。 84 个单元里有大量展开瞬间产生、实际可被常量折叠的逻辑(比如 CLKS_PER_BIT=16 这类参数参与的比较)。opt_expr 做表达式级常量传播,opt_clean 删死代码,一轮下来单元 84→44、线网 130→47。这也是为什么 data_valid <= 1'b0 这种「默认赋值再条件覆盖」的写法综合后没有额外代价——默认值会被 opt 直接并进选择逻辑。
第三条曲线最戏剧性:techmap 爆炸与 abc 收敛。 到 fine 段前半结束时,设计是 45 个「高阶单元」($add、$alu、$mux、$adff 这类 RTL 级算子)。techmap 一步把它们全部映射成内部门级单元:单元数 45→1022、线网 54→560。看构成就知道炸得多碎——$_MUX_×364、$_AND_×191、$_OR_×190、$_XOR_×185,一个 8 位加法器就能展开成几十个异或和进位门。随后 abc -fast(伯克利 ABC 逻辑综合工具,做逻辑重构与再映射)把这 1022 个门重新优化,收敛到 223 个单元、190 根线网,触发器原样保留($_DFFE_PN0P_×30 等 33 个存储元)。一炸一收之间,逻辑深度和门数都被压过一轮——这是整个 synth 流程里对最终 QoR 贡献最大的一段。
四、fsm 步骤为什么 stat 零变化:自复位陷阱
按直觉,5 状态 FSM 应该让 fsm 步骤大显身手,但实测第 3 步前后 stat 一模一样(44 单元、47 线网)。看日志才找到原因:
2.1. Executing FSM_DETECT pass (finding FSMs in design).
Not marking uart_rx.state as FSM state register:
Circuit seems to be self-resetting.fsm_detect 拒绝把 state 寄存器标记为状态机,理由是「电路看起来是自复位的」。问题出在状态机的写法上:case 里有一行 default: state <= IDLE;。从综合器视角看,任何非法状态都会一拍之内回到 IDLE,状态图存在「默认出口」,fsm_detect 据此认为这套逻辑不依赖固定状态编码、无法安全重编码,于是整个 fsm 段(detect/extract/recode/map)全部空跑。
为了验证这个判断,实验里放了一个变体 uart_rx_noselfreset.v,唯一改动是把 default 分支改成 default: state <= state;(非法状态保持)。重跑到 fsm 步骤,这次成功提取(out/fsm_variant.log):
Found FSM state register uart_rx.state.
Extracting FSM `\state' from module `\uart_rx'.
found reset state: 3'000 (from async reset)
found state code: 3'100 ... 3'001
Recoding FSM `$fsm$\state$180' from module `\uart_rx' using `auto' encoding:fsm_extract 把 5 个状态码、10 条转移边全部解析成转移表,随后 fsm_recode 用 auto 编码重新分配状态值。代价是单元数从 44 涨到 57——重编码后的译码逻辑暂时变多,是否划算要交给后续 opt/abc 去平衡。
这带来一条写 RTL 的实用结论:想让综合器做状态机优化(重编码为 one-hot、提取转移表做验证),就别写「自复位」风格的 default 分支;反过来,如果设计刻意要求任何异常都一拍回家(某些安全场景),那 fsm 段空跑正是你想要的行为,但要知道这是你放弃了状态机优化换来的。
五、逐步执行 vs 一把梭:最终网表一致吗
拆解最大的疑问是:经过 9 次 write_ilang/read_ilang 快照接力,逐步执行的最终结果和 synth -top uart_rx 一把梭还是不是同一个网表?对照组日志 out/oneshot_synth.log,两边最终 stat 摆在一起:
| 指标 | 逐步执行(step_10) | 一把梭(synth -top) | 差异 |
|---|---|---|---|
| 线网数 | 190 | 187 | +3 |
| 单元数 | 223 | 220 | +3 |
| 触发器($_DFF* 合计) | 33 | 33 | 0 |
| memories / processes | 0 / 0 | 0 / 0 | 0 |
| check 结果 | 0 problems | 0 problems | 一致 |
结论如实写:不逐比特一致,但差异极小且功能等价。逐步版多 3 个单元、3 根线网(差距约 1.4%),触发器数量和 check 结果完全相同。差异来源是快照边界——一把梭在内存里连续执行,某些 pass 看到的是上一步刚优化完的「热」设计;逐步版每一步从 .il 文本重新读入,属性与选择的细微差别会让个别 opt 决策不同。单元构成上两边也只是分布微调(逐步版 $_OR_×73 vs 一把梭 ×66,$_NAND_×8 vs ×7)。
对实践的启示:拆解适合学习和定位问题(哪一步把单元数搞炸了一目了然),生产跑批仍用一把梭——既少一次磁盘接力,最终结果还略优。如果拆解只是为了中途检查,更省事的姿势是 synth -run begin:coarse 这类 -run <from>:<to> 参数,它按 help 输出里的标签区间执行,不用手工接力。
六、常见报错排查
1. 逐步接力时 read_ilang 报模块重复或属性冲突。 快照文件里带着完整的模块定义,下一步脚本里不要再 read_verilog 原始 RTL,否则同名模块冲突。处置:接力链上只有第 0 步读 RTL,之后一律 read_ilang。
2. fsm 段空跑、Not marking ... as FSM state register。 多半是本篇第四节的自复位写法,或状态寄存器被其他逻辑直接赋值/读出(比如把 state 接到输出端口)。处置:看 fsm_detect 给出的具体理由,要优化就改写法,要保留行为就用 synth -nofsm 显式跳过、消除歧义。
3. techmap 后单元数暴涨以为「综合变差了」。 这是正常中间态:techmap 的职责就是把高阶算子拍成门级,数字必然暴涨,衡量最终质量要看 abc 之后那一行 stat。处置:别在中间步骤下结论,对比永远用最终网表。
4. abc 报 ERROR: ABC: execution of command ... failed。 容器里 ABC 以子进程方式调用,HOME 不可写或临时目录权限不对会炸。处置:像本篇复现命令一样显式 -e HOME=/tmp,并保证 /tmp 可写。
这一篇在知识体系里的位置
本篇是 eda-lab「综合段」的流程骨架篇:它回答「synth 这条命令内部是什么」,同池的 yosys stat 报表解读 接着回答「最终报表每个字段怎么读」,yosys show 网表图 把各步网表画成结构图。商用流程侧,步骤语义对照 逻辑综合 Design Compiler,算术单元抽取与共享对照 综合数据通路的算子选择,最终网表质量评估对照 综合 QoR 报告解读;上游仿真段的实验见 iverilog 仿真入门 与 verilator lint 实操。
总结
yosys synth 流程拆解的实测结论是:synth -top 就是 help 打印的 30 余条子命令按 begin/coarse/fine/check 四段顺序执行——proc 把过程块展开成单元(进程数 2→0)、opt 初轮常量传播砍半(84→44)、techmap 把高阶算子炸成 1022 个门、abc 再收敛到 223 个单元;逐步执行靠 write_ilang 快照接力,最终网表与一把梭功能等价但计数差 3(223 vs 220),适合学习定位不适合生产;另外写状态机时注意,default: state <= IDLE 的自复位写法会让 fsm 步骤判定「自复位」而整体空跑,想要状态机重编码优化就得改掉它。