SuperAPI AI Directory

soc-openroad

Coding & development

View repository

Updated 10-16 09:29

About this skill

SoC OpenROAD

Overview

Use the registered soc-openroad MCP server. Keep OpenROAD-flow-scripts and OpenROAD source trees independent from the SoC repository; store design-owned handoff files under pd/openroad/<platform>/<design>/.

Layout contract

Use this scheme for vibe_soc-style projects:

<project>/
└── pd/openroad/
    ├── <platform>/<design>/
    │   ├── config.mk
    │   └── constraint.sdc
    └── work/                 # ORFS logs/objects/reports/results; ignored by Git

Do not copy RTL into OpenROAD-flow-scripts. The generated config.mk points back to project RTL via $(PROJECT_ROOT)/... paths.

MCP tools

Tool Purpose
soc_openroad_init generate portable ORFS config.mk and constraint.sdc from project filelists
soc_openroad_run run an ORFS Make stage through the MCP process
soc_openroad_status summarize ORFS result/report/log files under pd/openroad/work

Workflow

  1. Ensure RTL/lint/synthesis handoff is already valid through soc-build.
  2. Call soc_openroad_init with project_dir, module_dir, design_name, platform, clock/reset ports, and period. For a top-level vibe_soc run, use module_dir=chip/top, design_name=vibe_soc_top, platform=nangate45.
  3. Review generated pd/openroad/<platform>/<design>/config.mk and constraint.sdc. Fix clock/reset constraints from design requirements, not guesses.
  4. Call soc_openroad_run with orfs_dir=<OpenROAD-flow-scripts>/flow and stage=synth|floorplan|place|cts|route|finish|all.
  5. Call soc_openroad_status and record real report/result paths in pipeline_state.json.

OpenROAD execution must remain in the registered MCP tool. Do not replace it with direct shell make or openroad commands from a stage agent.