nextpnr-iCE40 布局种子扫描:五轮 --seed 实测 Fmax 与绕线收敛
更新时间:2026-11-22。Yosys synth_ice40 流程 已经把 RTL、JSON、PCF、ASC 串成一条完整链路,本篇继续追问后端的一个常见操作:同一份网表换几个 nextpnr-iCE40 布局种子扫描,结果会不会变化,应该怎样判断绕线收敛。实验只改变
--seed,依次运行 0 到 4,保留五份完整日志和 ASC。实测出现了一个同样有价值的答案:五轮物理产物不同,但最终 Fmax 完全相同。
本文要回答的问题
- 做种子扫描时,必须固定哪些输入,才能把差异归因到后端搜索过程?
- 同一份计数器 JSON 在
--seed 0..4下,布局后估计与布线后 Fmax 各是多少? - 路由弧数、拆线重绕数、剩余弧数能说明什么,为什么不能虚构一个拥塞分?
- 五份 ASC 哈希不同但 Fmax 相同,这两个事实是否矛盾?
- 哪类结果可以支持选择种子,哪些结论必须留到更大设计和更多样本中验证?
一、nextpnr-iCE40 布局种子扫描的假设与控制变量
nextpnr 的布局不是把逻辑单元按网表顺序直接摆进芯片。它要建立初始布局、进行合法化和优化,再由路由器为线网寻找物理路径。--seed 给随机过程一个确定起点:相同版本、相同输入和相同种子应能复现同一次搜索;换种子则可能走到另一个合法解。这里的关键词是“可能”,不是“必然更好”。
实验开始前只提出两个待检验假设。第一,换种子可能改变布局布线产物;第二,产物变化可能反映到 Fmax 或绕线过程。它们不是预设结论。如果五轮 Fmax 一样,就应报告一样,不能为了画出差序图而调整坐标、挑选中间估计或编造小数。
读这张图先看蓝色与紫色之间的边界:JSON、器件、封装、PCF 和时序目标都在边界左侧,只有种子在右侧。如果每一轮重新综合,或者顺手改了目标频率,那么最终差异就混入了网表和时序预算变化,不能再称为单纯的种子对照。
本次固定项及核验方法如下。
| 项目 | 固定值 | 核验方式 |
|---|---|---|
| RTL 与综合流程 | 24 位异步低有效复位计数器,synth_ice40 -top top | 综合只执行一次,保留完整 Yosys 日志 |
| 输入网表 | build/top.json | 五轮前后计算 SHA-256,均为 44e1e58a…c5cbd0 |
| 器件与封装 | iCE40 HX1K,TQ144 | 每轮都显式传 --hx1k --package tq144 |
| 引脚约束 | 同一份 top.pcf,六个端口逐位绑定 | 每份日志都有六条 constrained 记录 |
| 时序目标 | clk 为 50 MHz | 每轮都传 --freq 50,报告写明 PASS/FAIL 的参照值 |
| 唯一自变量 | nextpnr --seed | 依次取 0、1、2、3、4 |
50 MHz 是人为设定的实验预算,不是这块小设计的实测极限。它让五轮都按同一时序目标做布局与报告,同时留下足够大的余量观察 PASS 是否等于 Fmax 相同。
二、实验设计:一次综合,五次后端搜索
RTL 只有一个 24 位寄存器和一条加一进位链,最高四位接到 LED。这个设计规模小、结构透明,适合检查脚本是否真的做到控制变量;它不用于代表高利用率 SoC 或复杂多时钟设计。
module top (
input wire clk,
input wire rst_n,
output wire [3:0] led
);
reg [23:0] count;
always @(posedge clk or negedge rst_n) begin
if (!rst_n) count <= 24'd0;
else count <= count + 24'd1;
end
assign led = count[23:20];
endmodulePCF 使用 HX1K-TQ144 的六个合法引脚,时钟为 21,复位为 8,四位输出依次为 99、98、97、96。综合脚本只有读入与 synth_ice40 -json 两步,五轮后端共享生成的 JSON,而不是各自回到 RTL 重来。
read_verilog top.v
synth_ice40 -top top -json build/top.json单轮命令如下,循环时只替换种子编号和 ASC 文件名:
nextpnr-ice40 --hx1k --package tq144 \
--json build/top.json --pcf top.pcf --freq 50 \
--seed 0 --asc results/top-seed-0.asc日志提取也坚持“工具写了什么才统计什么”。本版本明确输出了下面的字段,汇总脚本直接从文本取数,并同时保存原始记录,避免只留下无法回查的一张表。
| 字段 | 报告位置 | 本文用途 |
|---|---|---|
布局后、布线后 Max frequency | 布局结束和路由结束各一次 | 区分搜索阶段估计与最终布线结果 |
ICESTORM_LC、SB_IO、SB_GB | Device utilisation | 检查物理资源是否随种子改变 |
Routing 85 arcs | 路由队列初始化 | 给出本轮需要连接的弧数 |
路由表中的 w/ripup | 路由迭代表 | 记录经历过拆线重绕的弧数 |
remaining arcs | 路由迭代表 | 判断是否还有未连接弧,0 才表示路由完成 |
Program finished normally、退出码 | 日志末尾 | 与 ASC 非空一起确认运行闭环 |
| ASC 字节数与 SHA-256 | 输出文件 | 判断物理产物是否相同,不把它当时序指标 |
三、五轮结果:Fmax 没有波动,产物确实不同
五轮都正常结束,没有警告或错误,五份 ASC 都非空。终端汇总保留了输入 JSON 哈希、工具版本和每轮关键字段;ripup 是拆线重绕弧数,left 是最终剩余弧数。
把完整 CSV 中与读者决策最相关的列展开,结果如下。ASC 哈希只列前十二位便于排版,完整值保存在 summary.csv 与 summary.json。
| seed | 布局后 Fmax(MHz) | 布线后 Fmax(MHz) | LC | 路由弧 | 拆线重绕 | 剩余弧 | 时序 | ASC 哈希前缀 |
|---|---|---|---|---|---|---|---|---|
| 0 | 190.33 | 194.33 | 28/1280 | 85 | 1 | 0 | PASS | debe84bc5605 |
| 1 | 190.33 | 194.33 | 28/1280 | 85 | 0 | 0 | PASS | 86d4c7118d59 |
| 2 | 190.33 | 194.33 | 28/1280 | 85 | 0 | 0 | PASS | 0a44b2f91717 |
| 3 | 190.33 | 194.33 | 28/1280 | 85 | 0 | 0 | PASS | 928b3b2c67a2 |
| 4 | 190.33 | 194.33 | 28/1280 | 85 | 0 | 0 | PASS | 342bc8785b80 |
这张图的上半部分纵轴从 0 开始,五根柱子都停在 194.33 MHz,红色虚线是固定的 50 MHz 目标。没有用截断纵轴放大细微差别,因为原始报告根本没有差别。下半部分唯一可见的变化是 seed 0 的拆线重绕计数为 1,其余四轮为 0;五轮剩余弧数都为 0,因此这一点过程差异没有演化成未绕通或时序失败。
布局后估计都是 190.33 MHz,布线后都是 194.33 MHz,向上变化 4.00 MHz。这里的合理读法是:路由器完成后,工具拿到真实物理连线延迟,最终关键路径估计与布局阶段的线长模型不同。不能反过来说“布线必然提升 Fmax”,更不能把这 4 MHz 归功于某个种子,因为五轮完全一样。
194.33 MHz 对应的周期约为 5.15 ns,日志中时钟到时钟关键路径汇总为 3.9 ns 逻辑延迟加 1.2 ns 路由延迟。相对 50 MHz 的 20 ns 周期余量很大,所以这是一个容易通过的时序场景。资源侧同样稳定:28 个逻辑单元、6 个 IO、2 条全局网络,五轮没有任何面积交换。
四、绕线收敛怎么看:先看闭环,再谈搜索质量
“工具返回 0”不是唯一检查点。可靠读法应把进程状态、剩余弧、时序结果和产物存在性放在一起。nextpnr 0.6 的这份日志没有输出可跨设计比较的全局拥塞分,因此本文不创造“拥塞下降百分之多少”之类的结论,只使用路由表真实存在的字段。
seed 0 的路由表显示 86 这一迭代计数、1 条带拆线重绕的连接、65 条无拆线重绕连接,最终剩余 0;其余种子对应计数为 85、0、65、0。这里的 85 也是待路由弧总数,不能把迭代计数误读成用了 85 秒,也不能把一次拆线重绕等同于芯片出现普遍性拥塞。路由耗时在该报告中显示到两位小数,多次为 0.00 秒,精度不足以支持性能排名,故不纳入结论。
$ nextpnr-ice40 --hx1k --package tq144 --json build/top.json --pcf top.pcf --freq 50 --seed 0 --asc results/top-seed-0.asc
Info: Routing..
Info: Setting up routing queue.
Info: Routing 85 arcs.
Info: | (re-)routed arcs | delta | remaining| time spent |
Info: IterCnt | w/ripup wo/ripup | w/r wo/r | arcs| batch(sec) total(sec)|
Info: 86 | 1 65 | 1 65 | 0| 0.00 0.00|
Info: Routing complete.
Info: Router1 time 0.00s这段原始表把三个计数放在同一行:IterCnt 是路由内部计数,w/ripup 是经历拆线重绕的弧数,最后的 remaining arcs 才是未绕通数量。读表时按列名对齐,不把第一列或耗时列当成拥塞程度。
按这条链读,PASS 位于“正常结束且没有剩余弧”之后,而不是替代它们。若某轮失败,汇总应保留失败状态、错误数和缺失产物,不能只把成功轮次挑出来算平均值。若目标频率下 FAIL,但工具仍完成 ASC,也应把“可生成配置流”和“时序未达标”分开记录。
五份 ASC 的 SHA-256 全部不同,文件字节数也在 189451 到 189579 之间变化;这与 Fmax 相同并不冲突。ASC 描述的是具体物理配置,多个合法布局可以拥有相同的资源总量和相同的关键路径延迟。尤其在低位计数器中,进位链受物理结构约束,真正决定最差路径的部分可能落到了等效位置,其他单元的移动只改变配置位,没有改变最坏延迟。
因此,ASC 哈希适合回答“这次产物是否与上一轮逐字节一致”,不适合回答“这次时序是否更好”。时序要看最终报告,资源要看利用率,路由是否完成要看剩余弧,三者各管一件事。
五、失败与边界:五次小设计不是普遍收敛定律
本次结果最容易被误写成“nextpnr 换 seed 不影响 Fmax”。这句话超出了证据范围。实验只有一个小设计、五个种子、一个器件和一个较宽松的目标;28/1280 的逻辑占用约为 2.2%,大量物理位置可供选择,五轮零波动只说明该场景对这几个种子不敏感。
| 观察或边界 | 能支持的判断 | 不能推出的结论 |
|---|---|---|
| 五轮 Fmax 都为 194.33 MHz | 本设计在本版本、本约束下对 seed 0..4 不敏感 | 任意设计换 seed 都不会改变 Fmax |
| seed 0 多一次拆线重绕 | 搜索过程存在可记录差异 | seed 0 拥塞更严重或质量更差 |
| 五份 ASC 哈希不同 | 物理配置不是同一份文件 | 哈希差异越大,时序差异越大 |
| 50 MHz 全部 PASS | 本实验时序预算均得到满足 | 接近器件极限时仍有同样余量 |
| 五轮 LC 都是 28 | 本设计的物理资源计数稳定 | 其他设计的种子扫描不会交换面积与时序 |
| 路由时间多为 0.00 秒 | 小设计运行很快,日志精度有限 | 各种子运行时完全相等 |
把扫描用于实际工程时,样本和指标都应随问题升级。如果设计已接近时序目标,可以扩大种子数量,同时记录成功率和 Fmax 分布,而不是只报最大值;如果利用率逐渐升高,应按相近占用区间分组比较,避免把不同网表的差异混进种子分布;如果存在多个时钟,要分别保存各时钟域结果和跨域路径,不能用一个最高 Fmax 代表整个设计。
遇到边界结果时,可以按下表决定下一步。这里的种子选择是正常操作面的质量探索,不涉及约束缺失或工具报错的处置。
| 单轮结果 | 下一步动作 |
|---|---|
| 退出码非 0 或 ASC 缺失 | 保留该轮失败记录,先恢复可运行输入,不纳入成功样本统计 |
| 正常结束但剩余弧非 0 | 视为未形成完整路由结果,不用后续表面数字证明收敛 |
| 路由完成但时序 FAIL | 保存 Fmax 和关键路径,继续检查逻辑与物理优化空间 |
| 多轮 PASS 且 Fmax 相同 | 任选一个可复现种子,把版本、输入哈希和命令一起记录 |
| 多轮结果有差异 | 报告中位数、范围和失败数,再决定是否需要扩大样本 |
还要保留版本边界。本次是 nextpnr-ice40 0.6-3build5,布局器实现和报告字段都可能随版本变化。跨版本比较时,即使种子和 JSON 相同,也属于另一个实验条件。最稳妥的交付方式不是只说“用了 seed 2”,而是保存工具版本、输入哈希、完整命令和最终报告,让另一位工程师能得到同一份可核验结果。
实验环境
- 机器/系统:macOS 宿主机启动 linux/amd64 Docker 容器,容器内 Ubuntu 24.04
- 工具版本:
Yosys 0.33 (git sha1 2584903a060)、nextpnr-ice40 0.6-3build5、Python 3.12.3,镜像geek-eda:0.4-flow - 日期:2026-11-22
- 完整命令:实验目录执行
bash run.sh;脚本先运行一次yosys -s synth.ys,再对 seed 0、1、2、3、4 分别执行nextpnr-ice40 --hx1k --package tq144 --json build/top.json --pcf top.pcf --freq 50 --seed <n> --asc results/top-seed-<n>.asc,最后运行python3 scripts/summarize.py --results results --csv results/summary.csv --json results/summary.json - 原始记录:五份完整 nextpnr 日志、综合日志、工具版本、JSON 哈希、汇总表与五份 ASC 均随实验保存;正文终端卡直接摘自汇总记录
代码获取
RTL、PCF、JSON 生成脚本、五轮运行与汇总脚本、完整结果和绘图脚本位于公开仓库:geek-doc.cn/experiments/flow-nextpnr-ice40-seed-sweep。取得相同镜像后进入目录执行 make run 即可复现;结果图可由 summary.csv 重新绘制,绘图数据不依赖手工填写。
这一篇在知识体系里的位置
- 还没有走通 iCE40 开源链路:先读 nextpnr-iCE40 布局种子扫描的前置 synth_ice40 流程,弄清 JSON、PCF、ASC 各自承担的角色;
- 需要核对器件族、封装和 nextpnr 输入输出参数:读 nextpnr-ice40 命令行参数与器件族选择,本篇固定这些条件,只比较种子;
- 想自动提取更多结构指标:读 nextpnr-iCE40 布局种子扫描的上游 JSON QoR 统计,本篇则面向后端日志与物理产物;
- PCF 端口尚未约束时应先恢复完整输入:见 nextpnr 顶层端口未约束 PCF 报错,不要把约束问题当作种子波动;
- 更多综合、布局布线流程从 EDA 工具实践目录 进入。
总结
nextpnr-iCE40 布局种子扫描必须建立在控制变量之上:本实验固定同一 JSON 哈希、HX1K-TQ144、PCF 和 50 MHz 目标,只改变 --seed 0..4。五轮都正常完成,布线后 Fmax 都是 194.33 MHz,资源都是 28 个 LC、6 个 IO 和 2 条全局网络,85 条路由弧最终剩余均为 0;seed 0 有 1 条拆线重绕,其余为 0,五份 ASC 哈希则全部不同。这说明物理配置变化不必然带来 Fmax 变化,一次拆线重绕也不是独立拥塞结论。低占用小设计的五次零波动不能外推成普遍规律;工程上应保存失败样本、最终时序、剩余弧和产物哈希,在接近时序或资源边界时扩大样本,用分布而不是单个最好值选择可复现结果。