用途:为 silicon-crew SoC 项目准备并运行 OpenROAD-flow-scripts(ORFS)物理设计交接流程,供 Codex 在需要生成 ORFS config/SDC 等场景使用。
目录约定:OpenROAD-flow-scripts 与 OpenROAD 源码树须与 SoC 仓库相互独立;设计自有交接文件放在 pd/openroad/<platform>/<design>/ 下,含 config.mk 与 constraint.sdc;pd/openroad/work/ 存放 ORFS 日志/对象/报告/结果,由 Git 忽略。不要把 RTL 复制进 OpenROAD-flow-scripts,生成的 config.mk 通过 $(PROJECT_ROOT)/... 路径回指项目 RTL。
MCP 工具:soc_openroad_init 依据项目 filelist 生成可移植的 ORFS config.mk 与 constraint.sdc;soc_openroad_run 通过 MCP 进程运行 ORFS Make 阶段;soc_openroad_status 汇总 pd/openroad/work 下的结果、报告与日志文件。
使用方式:先确保 RTL/lint/综合交接已通过 soc-build 有效;调用 soc_openroad_init,提供 project_dir、module_dir、design_name、platform、时钟/复位端口与周期(顶层 vibe_soc 运行可用 module_dir=chip/top、design_name=vibe_soc_top、platform=nangate45);检查生成的 config.mk 与 constraint.sdc,按设计需求而非猜测修正时钟/复位约束;调用 soc_openroad_run,orfs_dir=<OpenROAD-flow-scripts>/flow,stage 可选 synth|floorplan|place|cts|route|finish|all;再调用 soc_openroad_status,将真实报告/结果路径记入 pipeline_state.json。
限制:OpenROAD 执行必须保留在已注册的 MCP 工具中,不得用来自阶段代理的直接 shell make 或 openroad 命令替代。