yosys stat 报表解读:从 wires/cells 数字到等效门面积估算
这是「EDA 开源工具实操」系列综合段的第二篇。上一组文章把仿真跑通了(iverilog 仿真入门),综合段的第一篇讲 yosys show 怎么把网表画成图(el-yosys-show-netlist,同池即将发布)。图给人直觉,数字给人判断——stat 命令打印的那张统计表,是综合流程里第一个能告诉你「这个设计有多大」的东西。看懂 yosys stat 报表,后面做工艺映射、比方案、估成本都有了落点。
很多教程贴一张 stat 截图就过了,读者记住的只有「cells 越少越好」。这篇换种做法:拿两个真实设计(一个 8 位计数器、一个带 FSM 的四模块 UART 波特率发生器)在容器里真实综合,把 stat 输出逐行拆开,每一行数字对应到 RTL 里的哪一段都讲清楚,最后再回答一个工程上最常被问的问题:这些单元数换算成「等效门」大概是多少,数量级怎么感。
本文要回答的问题
synth之后跑stat,打印的 wires / wire bits / public wires / memories / processes / cells 各行到底是什么意思?- 单元清单里的
$_SDFFE_PN0P_、$_ANDNOT_这些名字怎么读?为什么我的计数器里会有$_XOR_? - 多模块设计打平(
-flatten)和保留层级两种综合方式,stat 报表各长什么样?select怎么只看一个子模块? - stat 里的单元数怎么粗估成「等效门」?一个 146 单元的设计大概是几百门还是几千门?
- 看 stat 报表时最容易误读的三件事是什么?
一、环境:geek-eda:0.1 容器一键复现
实验统一跑在 Docker 容器 geek-eda:0.1(Ubuntu 24.04.5 LTS)里,综合器为 Yosys 0.33 (git sha1 2584903a060)(yosys -V 实测输出,存在 out/version.txt)。一条命令复现全部六组运行:
docker run --rm --user $(id -u):$(id -g) -e HOME=/tmp \
-v ~/Project/geek-doc.cn/experiments:/work \
-w /work/eda-lab-yosys-stat-report geek-eda:0.1 make run代码获取:本实验完整代码(
counter.v、波特率发生器四个模块)、Makefile 与全部真实 stat 输出(out/stat_*.txt、out/synth_*.log)见公开仓库 derekzhuo/geek-doc.cn 的experiments/eda-lab-yosys-stat-report/。克隆后make run即可复现。
Makefile 里每个目标就是一条 yosys -p '...' 命令,用 tee -o 把 stat 段存盘。tee 是 yosys 内建命令,作用是把后面那条命令的输出同时打印到终端和写进文件——比 shell 重定向干净,因为日志里其余的综合过程信息不会被卷进来。
二、实验设计:一个小计数器,一个小系统
两个设计的规模刻意拉开一个档次,好让 stat 报表的「读法差异」显出来。
第一个是被老读者摸熟的 8 位计数器 counter(同步低有效复位、使能、全 1 溢出输出),复用 M0 样例。第二个 baud_top 是个真实小系统:baud_clk_div 把 50 MHz 系统时钟分到 16 倍波特率的 tick(DIV=27,误差约 0.5%),baud_tx_fsm 用 IDLE→START→DATA→STOP 四状态状态机发字节,baud_bit_cnt 数发到第几位。三个子模块有来有回地连,正好用来演示分层统计。
这里先埋一个伏笔:baud_tx_fsm 里有 2 位 state、4 位 oversample、8 位 shreg 加 4 个 1 位输出寄存器,共 18 位;baud_clk_div 6 位;baud_bit_cnt 3 位——全系统 27 位寄存器。记住这个数字,后面要在 stat 报表里把它找出来。
三、计数器 stat 逐行解读
综合命令是最标准的一条:yosys -p 'read_verilog counter.v; synth -top counter; stat'。synth 是 yosys 的「默认综合剧本」,内部按顺序调 proc(过程转逻辑)、opt(常量折叠、化简)、techmap(映射到通用门)等几十个 pass;出来的网表由通用单元(generic cells,以 $_ 开头的二输入门和触发器)组成,还没绑定任何具体工艺库。下面是真实输出(out/stat_counter.txt 原文):
=== counter ===
Number of wires: 17
Number of wire bits: 38
Number of public wires: 5
Number of public wire bits: 12
Number of memories: 0
Number of memory bits: 0
Number of processes: 0
Number of cells: 27
$_ANDNOT_ 3
$_AND_ 3
$_NAND_ 3
$_NOT_ 1
$_ORNOT_ 1
$_OR_ 1
$_SDFFE_PN0P_ 8
$_XNOR_ 1
$_XOR_ 6逐行拆:
- wires = 17 / wire bits = 38:网表里有 17 根「具名线」,合计 38 个比特位。对比一下 RTL:端口 5 个(clk/rst_n/en/count/overflow),其中 count 是 8 位,端口共 5 根线、12 比特——正好是下面 public 那两行。剩下 12 根内部线、26 个比特,是
proc把 always 块翻译成数据流时生成的中间节点(加法器的进位链、复用器的条件线之类)。wire bits 反映的是连接规模,不是面积,别拿它当主指标。 - public wires = 5 / public wire bits = 12:「public」即可从模块端口外部访问的线。5 根端口、12 比特,和 RTL 端口表一一对上。分层设计里这两行能帮你确认「综合器有没有把端口优化丢」。
- memories = 0 / memory bits = 0:设计里没有数组型存储(
reg [7:0] mem [0:255]这类)。如果有,memorypass 会把它保留成$mem单元记在这里,而不是摊成触发器。 - processes = 0:这是综合是否干净的重要健康指标。
proc的职责就是把 always/initial 过程块全部消化成逻辑;还剩 process 说明某段 RTL 没法转成硬件(比如 TB 写法混进了设计),在 ASIC 流程里这等于综合失败。看到非 0 先回去查 RTL。 - cells = 27:实例化的单元总数,stat 报表的「主指标」。下面缩进的清单是分类明细:9 种单元合计 3+3+3+1+1+1+8+1+6 = 27。
单元名怎么读?$_AND_/$_OR_/$_XOR_/$_NAND_/$_NOT_ 就是对应的两输入门;$_ANDNOT_ 是「A 与 非B」,$_ORNOT_ 是「A 或 非B」——yosys 把带一个反相输入的组合门合并成单单元,比拆成 NOT+AND 两个单元更省。最有信息量的是 $_SDFFE_PN0P_:同步复位 D 触发器,带使能。名字是编码:SDFF = synchronous-reset D flip-flop,结尾的 E 表示带使能端,中间四位依次是时钟极性(P=上升沿)、复位极性(N=低有效)、复位值(0)、……正好对应 RTL 里 if (!rst_n) count <= 0; else if (en) count <= count+1 这三个特征。8 个 $_SDFFE_ 一一对应 8 位 count——RTL 里的每一个 reg 比特,综合后都该能在 stat 里找到对应的触发器,这是最实用的一条交叉验证法。
那张 6 个 $_XOR_ 也不神秘:count + 1 的加法器按位就是 XOR(半加),进位链产生 AND/OR 系列。8 位加 1 理论上是 8 个 XOR,优化后第 0 位退化成 NOT(加 1 必翻转)、高位共享部分进位,剩 6 个 XOR + 1 个 XNOR,数字完全合理。
四、多模块设计:flatten 与分层两种报表
现在换 baud_top。同样一条 synth 剧本,加不加 -flatten 结果完全不同。先看打平版(synth -top baud_top -flatten,out/stat_baud_flat.txt)的关键行:wires 144、wire bits 194、cells 146,单元清单 15 种。再看保留层级版(synth -top baud_top,out/stat_baud_hier.txt),它给的是每个模块一张分表,末尾附一段 === design hierarchy === 汇总。把两张表的关键数字摆在一起:
| 指标 | flatten 打平 | 分层 hierarchy 汇总 | 各模块分表(分层) |
|---|---|---|---|
| wires / wire bits | 144 / 194 | 142 / 192 | div 15/27,bitcnt 10/16,fsm 106/129,top 11/20 |
| cells 总数 | 146 | 145 | 20 + 9 + 116 + 3(top 的 3 个是子模块实例) |
| 触发器位数 | 29 | 29 | div 6 + bitcnt 3 + fsm 20 |
| 顶层 cells 含义 | 全是门 | 同上 | top 表只有 3 行:三个子模块各 1 个实例 |
三个观察点。第一,触发器总数两种跑法都是 29。第二节数过 RTL 是 27 位寄存器,多出来的 2 位是 opt 在做 FSM 编码和输出寄存器复制时的合理出入(复位极性转换会把一些位拆成「寄存器 + 反相」再合并)——重点是数量级对得上,27 与 29 之间不是 bug,是优化。第二,wires 打平后反而比分层汇总多 2 根:层级边界处的端口线在打平时被展开重命名,连接关系等价但具名线数会有微小差异,这正是「wire 数不能当面积指标」的实锤。第三,分层报表里 top 自己的 cells 是 3 个子模块实例而不是门——它如实告诉你「这一层只干了例化这一件事」。
注意分层表里分频器模块名变成了 $paramod\baud_clk_div\DIV=s32'...00011011:因为 baud_top 传了参数 DIV=27,yosys 为这组参数生成了一份参数化特例(paramod)。如果你的模块被两处以不同参数例化,stat 里会出现两张 paramod 分表——看分层报表时这是定位「同模块多配置各占多少面积」的入口。
想只看一个子模块的报表,不用单独建工程:顺带解释 synth 剧本和 stat 的关系。在 yosys 交互模式里敲 help synth,能看到它按固定顺序调一串 pass:proc 消过程块、fsm 识别并编码状态机、memory 处理数组、opt 系列做常量折叠与死逻辑删除、techmap 把 $add、$mux 这类高层算子拆成二输入门。stat 报表里出现 $_AND_、$_MUX_ 这种最底层的单元,就是 techmap 走完的标志——如果 stat 里还躺着 $add、$sub 这种「半成品」,说明综合剧本没跑完整。有兴趣可以只跑 proc; stat 和完整 synth; stat 各一次对比,前者会看到 $add 和一堆 $mux,单元数也大得多,这是理解「优化到底干了什么」最直观的一课。
想只看一个子模块的报表,不用单独建工程:select baud_tx_fsm 之后跑 stat,输出就只剩 FSM 那张表(out/stat_baud_fsm_sel.txt,116 cells、13 个 $_SDFFE_PN0P_ 带使能触发器——正是 shreg 8 位 + state 2 位 + oversample 的高位段)。Makefile 里还各跑了一次 baud_clk_div 和 baud_tx_fsm 单独 synth 的对照组(out/stat_div.txt / out/stat_fsm.txt),单独综合与分层分表的数字几乎一致(fsm 个别门数差 1-2 个,因为层级版里边界常量传播程度不同),说明 stat 分表可以直接当「模块面积预算」用。
五、面积粗估:从 cells 数到等效门
stat 本身不报面积(还没映射工艺库,报不了平方微米),但工程上常用的粗估单位是等效门(GE,Gate Equivalent):把每种单元按「相当于几个两输入 NAND」折算,再加总。折算系数是行业经验值而非测量值,这里明确标注为经验权重:
| 单元类型 | 经验权重(GE) | 依据 |
|---|---|---|
$_NOT_ | 0.5 | 反相器约半个 NAND2 |
| 两输入 AND/OR/NAND/NOR/ANDNOT/ORNOT | 1 | 基准门 |
$_XOR_ / $_XNOR_ | 3 | 约 3 个 NAND2 |
$_MUX_ | 2 | 二选一约 2 个 NAND2 |
$_DFF_P_(普通触发器) | 6 | 主从结构约 6 门 |
$_SDFF_*(带同步复位) | 6 | 复位逻辑常并入数据端 |
$_SDFFE_*(复位+使能) | 8 | 多一级使能复用 |
套到两个真实设计上(单元数全部来自上面的 stat 原文):
| 设计 | 简单门 | XOR/XNOR | MUX | 触发器 | 粗估总量 |
|---|---|---|---|---|---|
| counter(27 cells) | 12×1 + 1×0.5 | 7×3 = 21 | 0 | 8×8 = 64 | 约 98 GE ≈ 百门级 |
| baud_top flatten(146 cells) | 100×1 + 6×0.5 | 9×3 = 27 | 8×2 = 16 | 29 个共 206 | 约 352 GE ≈ 数百门级 |
baud_top 的触发器小计这么来:4 个普通 DFF ×6 + 13 个 SDFFE ×8 + 3 个 SDFFE_PP0P ×8 + 6 个 SDFF ×6 = 206 GE,占全系统一半还多——寄存器通常是小设计面积的大头,这是这张表给出的第一个工程直觉。第二个直觉是数量级感:一个 UART 发送通路约 350 门,反推一颗百万门级的 SoC 可以塞下几千个这种规模的外设。粗估就是粗估,映射到真实工艺库后还要乘布线开销(常见做法是 GE 数再乘 1.5~2 当最终面积上限),但作为方案比较和汇报里的第一刀,stat + 经验权重已经够用。
再给一个验证这种粗估有没有用的视角:把 baud_top 拆开看,FSM 一个模块 116 cells 就占了全系统 146 cells 的八成,分频器 20、位计数器 9。如果哪天要砍面积,看这张分布就知道优化力气该花在 FSM 上(比如把 oversample 从 4 位换成复用分频器的计数器),而不是去抠分频器那 20 个门。stat 分表 + 等效门权重,本质上是给设计画了一张「面积地形图」——哪个模块是山、哪个是平地,一眼可判。这种判断在架构评审会上比任何形容词都有说服力。
六、看 stat 报表最容易踩的三个坑
坑一:拿 wires 当面积。 第四节实测打平与分层 wires 数不同、触发器与 cells 却稳定,原因就是 wires 是「具名连接」的计数,优化器改写法它就变。汇报面积永远用 cells(和触发器位数),wires 只用来看连接规模有没有异常膨胀。
坑二:processes 非 0 被忽略。 小设计里 proc 总能消化干净,但真实项目里只要 RTL 混进不可综合写法(# 延时、TB 残留),processes 就会非 0 而综合照样「跑完」。养成习惯:stat 第一眼先扫 processes,非 0 即停。
坑三:把 $_ 通用单元数当最终门数。 stat 报的是工艺无关的通用网表,同一设计映射到不同工艺库后单元数会重排(比如 XOR 映射成工艺专用单元后计数口径全变)。做跨工艺对比时,要在 abc/dfflibmap 映射之后再跑 stat,那时的 cells 才是真实标准单元数。本篇的数字全部停留在通用网表层级,这是它的边界。
这一篇在知识体系里的位置
本篇是「EDA 开源工具实操」综合段的报表篇:往左接 iverilog 仿真入门(仿真验证行为对不对),往右接 yosys show 网表图(show 把这张 stat 对应的网表画成结构图,两篇对照读效果最好);synth 内部各 pass 对报表数字的逐步影响见 yosys synth 流程拆解;想看商用流程里综合与报表的完整语境,可对照 EDA 专区 的综合知识文。同系列还有 lint 篇 verilator lint 实操,讲综合之前怎么先用静态检查把 RTL 洗干净。
总结
yosys stat 报表的读法就四步:先看 processes 是否为 0(综合干不干净),再看 cells 总数与触发器位数(和 RTL 的 reg 位数交叉验证),分层设计用 hierarchy 分表或 select 拆到模块级算面积预算,最后按经验权重把单元数折成等效门——本篇两个真实设计的答案是:8 位计数器约百门,带 FSM 的波特率发生器约 350 门,寄存器占了一半。