The script supports Ubuntu 20.04. It is not recommended to use the version below 20.04.
Tools
- build-essential 12.8
- cmake 3.16.3
- clang 10.0
- bison 3.5.1
- flex 2.6.4
- swig 4.0
- klayout 0.26
Library
- libeigen3-dev 3.3.7-2
- libboost-all-dev 1.71.0
- libffi-dev 3.3-4
- libreadline-dev 8.0-4
- libspdlog-dev 1.5.0
- lemon 1.3.1
git clone https://github.com/PCNL-EDA/iFlow.git //构建iFlow目录结构
cd iFlow
不使用代理下载
./build_iflow.sh //运行脚本下载EDA工具
使用代理下载,代理可自定义。例如代理为hub.fastgit.xyz
./build_iflow.sh -mirror hub.fastgit.xyz //运行脚本下载EDA工具
完成后即可使用iFlow。
存放工艺库,按不同工艺命名,包括lef、lib、Verilog(instance仿真用)和gds等库文件。
存放flow每一步产生的log,命名格式为$design.$step.$tools.$track(eg. HD/uHD).$corner(eg. MAX/MIN).$version.log。
存放每一步输出的报告,文件夹命名格式类似为$design.$step.$tools.$track(eg. HD/uHD).$corner(eg. MAX/MIN).$version。
存放每一步输出的结果,如$design.v,$design.def,$design.gds,文件夹命名格式为$design.$step.$tools.$track(eg. HD/uHD).$corner(eg. MAX/MIN).$version。
存放design的rtl文件和sdc文件,按不同的design命名。
├─cfg //库文件配置、工具配置、flow配置脚本存放目录
├─common //对文件操作的通用脚本存放目录
├─ run_flow.py //整个flow的运行脚本
├─ $design //对应design每一步的脚本存放目录
存放各个工具的文件。
存放跑flow过程中生成的临时文件,沿用商业工具的习惯。
下载安装EDA工具。
iFlow使用说明。
run_flow.py -d aes_cipher_top -s synth -f sky130 -t HS -c TYP
命令参数:
-d (design):
design name;
-s (step):
flow可选step:synth、floorplan、tapcell、pdn、gplace、resize、dplace、cts、filler、groute、droute、layout;
-p (previous step):
用于调用前一步的结果;
-f (foundry):
工艺选择,可选:sky130;
-t (track):
标准单元track选择,可选:sky130[HS HD];
-c (corner):
工艺角,可选:sky130 [TYP];
-v (version):
追加到log/result rpt的版本号;
-l :
前一步的版本号。
step command:
synth:
run_flow.py -d $design -s synth -f $foundry -t $track -c $corner
floorplan:
run_flow.py -d $design -s floorplan -f $foundry -t $track -c $corner
tapcell:
run_flow.py -d $design -s tapcell -f $foundry -t $track -c $corner
pdn:
run_flow.py -d $design -s pdn -f $foundry -t $track -c $corner
gplace:
run_flow.py -d $design -s gplace -f $foundry -t $track -c $corner
resize:
run_flow.py -d $design -s resize -f $foundry -t $track -c $corner
dplace:
run_flow.py -d $design -s dplace -f $foundry -t $track -c $corner
cts:
run_flow.py -d $design -s cts -f $foundry -t $track -c $corner
filler:
run_flow.py -d $design -s filler -f $foundry -t $track -c $corner
groute:
run_flow.py -d $design -s groute -f $foundry -t $track -c $corner
droute:
run_flow.py -d $design -s droute -f $foundry -t $track -c $corner
layout:
run_flow.py -d $design -s layout -f $foundry -t $track -c $corner
进入“/iFlow/scripts/”目录,输入命令:
./run_flow.py -d aes_cipher_top -s synth,floorplan,tapcell,pdn,gplace,resize,dplace,cts,filler,groute,droute,layout -f sky130 -t HS -c TYP -v 1.0 -l 1.0
(这里的版本号为1.0),进行aes_cipher_top设计的全流程running,注意log中有无Error。运行结束后,会打开klayout并显示最终design的版图,如图1所示,滚动鼠标滑轮可以缩放版图,按住“鼠标中键”可以移动版图。在图2中对“Layers”选择hide/show可以隐藏和显示对应的layer层,层数较多时加载会比较慢,可以右键选择“hide all”全部隐藏后,再逐层打开查看。
图1:
图2:
Klayout支持直接打开def文件,gds载入比较慢,可以直接用klayout打开def文件。输入命令“klayout”打开klayout的GUI,在菜单“File/Import”的子菜单中找到导入功能,选择DEF/LEF导入def文件以及lef文件。如图3所示,在弹窗的“Import File”中选择detail route生成的def文件导入,在“With LEF files:”中添加design中用到的lef文件,在“/iFlow/foundry/sky130/lef/中可以找到”,添加完毕后点“OK”即可导入。产生的结果如图4所示,由于def中没有merge “std cell”和“marcro”的gds文件,因此只有metal层和via,看不到底层的NW、CT、GT等,“std cell”和“marcro”的内部结构是固定的,直接调用,一般我们只关心布线结果,所以这里看def的结果足矣。
图3:
图4:
每一步的结果将输出到“/iFlow/result”目录下,如图5所示。
synth:RTL综合,生成综合后的网表文件;
floorplan:布局规划,生成描述物理位置关系的def和更新网表文件;
tapcell:插入physical cell,生成描述物理位置关系的def和更新网表文件;
pdn:构建电源网络,生成描述物理位置关系的def和更新网表文件;
gplace:放置标准单元,生成描述物理位置关系的def和更新网表文件;
resize:优化标准单元的尺寸,生成描述物理位置关系的def和更新网表文件;
dplace:优化标准单元的摆放,消除overflow,生成描述物理位置关系的def和更新网表文件;
cts:构建时钟树,生成描述物理位置关系的def和更新网表文件;
filler:插入filler cell,生成描述物理位置关系的def和更新网表文件;
groute:为detail rout生成引导guide文件,生成描述物理位置关系的def和更新网表文件;
droute:根据guide文件进行布线,生成描述物理位置关系的def和更新网表文件;
layout:生成gds文件。
图5:
每一步输出的报告可以在“/iFlow/report/”目录下查看,例如,进入“/iFlow/report/aes_cipher_top.floorplan.openroad_1.1.0.HS.TYP.1.0”目录下,查看floorplan生成的报告“init.rpt”,如图6所示,可以得到floorplan后的wns、tns以及utilization等参数。
图6:
为了验证某一步的结果是否满足我们的要求,可以对单步的结果进行检查。例如,我们可以查看detail place之后的结果。和前面提过的步骤一样,打开klayout,在“Import File”中导入dplace结果中的def文件,如图7所示。
图7:
点击“OK”后,可以先在“Layers”选择“hide all”,再双击打开“OUTLINE”层,即可看到detail place后的结果(这里金属层为电源网络,隐藏金属层可以方便我们查看detail place的结果),如图8所示。同样的方法可以查看其他步的结果。
图8:
“/iFlow/scripts/cfg”目录下,“data_def.py”脚本定义了iFlow使用的三个主要数据:Foundry、Tools、Flow,如图9所示,定义了每一步使用的默认工具。
图9:
在“/iFlow/scripts/cfg”目录下,“foundry_cfg.py”脚本配置flow需要用到的工艺库文件(lib、lef、gds),如图10和图11所示,当需要更换工艺库时,可以在此脚本中添加配置即可。
图10:
图11:
进入到“/iFlow/scripts/”目录下,创建相应design的脚本文件目录,将“aes_cipher_top”文件夹中“synth.yosys_0.9.tcl”脚本拷贝到新的design目录下,修改“synth.yosys_0.9.tcl”脚本中的RTL配置即可,如图12所示,更换design的Verilog文件。
图12:
在“/iFlow/scripts/cfg”目录下,“tools_cfg.py”脚本中配置了每一步可以使用的工具及其所在路径,如图13所示。当要更换工具或者更换新版本工具时,增加新的工具的定义即可。
图13:
主要说明“run_flow.py”这个脚本每一步大概作用,
开头部分为参数的解析和验证,如图14所示,这里定义了“run_flow.py”这个脚本运行时需要的参数,包括:“design、step、prestep、foundry、track、corner、version、preversion”。输入命令:
run_flow.py -h
可以得到可选参数的具体说明,如图15所示,当需要跑aes_cipher_top的综合时,我们可以输入命令:
./run_flow.py -d aes_cipher_top -s synth -f sky130 -t HS -c TYP -v 1.0
生成的log、report和result也会以相应的参数命名,如:“aes_cipher_top.synth.yosys_0.9.HS.TYP.1.0.log”。
·当需要同时跑多步时,可以以逗号“,”分隔,如同时跑synth和floorplan时,可以输入命令:
./run_flow.py -d aes_cipher_top -s synth,floorplan -f sky130 -t HS -c TYP -v 1.0
·当需要指定使用工具openroad_0.9.0进行floorplan时(默认使用openroad_1.1.0),可以输入命令:
./run_flow.py -d aes_cipher_top -s floorplan=openroad_0.9.0
图14:
图15:
如图16所示,这里主要设置环境变量以及创建相应的工作路径、结果输出的的路径以及库文件所在路径。
图16:
如图17所示,由于yosys中的abc工具只能读一个.lib文件,因此在使用yosys要先执行mergeLib.pl脚本,将所有用到的.lib文件合并为一个.lib文件“merged.lib”。同样的,TritonRoute工具也只能读入一个.lef文件,需要将所用到的.lef文件合并为一个.lef文件“merged_spacing.lef”。
图17:
如图18所示,根据不同的“step”运行不同的工具以及脚本,Openroad中不包含detailroute和看版图的工具,detailroute使用TritonRoute工具,看版图使用klayout工具。
图18:
每一步跑完后更新变量“prestep_sel”和“pre_tool_name”,如图19所示。
图19: