Add SKIP_DETAILED_ROUTE to skip detailed routing

Needed while bringing up a PDK for which can't yet route.

Signed-off-by: Matt Liberty <[email protected]>

Author: maliberty

docs/user/FlowVariables.md

@@ -214,6 +214,7 @@ configuration file.
 | <a name="SETUP_SLACK_MARGIN"></a>SETUP_SLACK_MARGIN| Specifies a time margin for the slack when fixing setup violations. This option allows you to overfix or underfix(negative value, terminate retiming before 0 or positive slack). See HOLD_SLACK_MARGIN for more details.| 0|
 | <a name="SET_RC_TCL"></a>SET_RC_TCL| Metal & Via RC definition file path.| |
 | <a name="SKIP_CTS_REPAIR_TIMING"></a>SKIP_CTS_REPAIR_TIMING| Skipping CTS repair, which can take a long time, can be useful in architectural exploration or when getting CI up and running.| |
+| <a name="SKIP_DETAILED_ROUTE"></a>SKIP_DETAILED_ROUTE| Skips detailed route.| 0|
 | <a name="SKIP_GATE_CLONING"></a>SKIP_GATE_CLONING| Do not use gate cloning transform to fix timing violations (default: use gate cloning).| |
 | <a name="SKIP_INCREMENTAL_REPAIR"></a>SKIP_INCREMENTAL_REPAIR| Skip incremental repair in global route.| 0|
 | <a name="SKIP_LAST_GASP"></a>SKIP_LAST_GASP| Do not use last gasp optimization to fix timing violations (default: use gate last gasp).| |
@@ -411,6 +412,7 @@ configuration file.
 - [MIN_ROUTING_LAYER](#MIN_ROUTING_LAYER)
 - [REPORT_CLOCK_SKEW](#REPORT_CLOCK_SKEW)
 - [ROUTING_LAYER_ADJUSTMENT](#ROUTING_LAYER_ADJUSTMENT)
+- [SKIP_DETAILED_ROUTE](#SKIP_DETAILED_ROUTE)
 - [SKIP_REPORT_METRICS](#SKIP_REPORT_METRICS)
 
 ## final variables

flow/scripts/detail_route.tcl

@@ -5,6 +5,12 @@ if { ![grt::have_routes] } {
   error "Global routing failed, run `make gui_grt` and load $::global_route_congestion_report \
         in DRC viewer to view congestion"
 }
+
+if { [env_var_exists_and_non_empty SKIP_DRT] } {
+  write_db $::env(RESULTS_DIR)/5_2_route.odb
+  exit
+}
+
 erase_non_stage_variables route
 set_propagated_clock [all_clocks]
 

flow/scripts/final_report.tcl

@@ -18,7 +18,10 @@ write_def $::env(RESULTS_DIR)/6_final.def
 write_verilog $::env(RESULTS_DIR)/6_final.v
 
 # Run extraction and STA
-if { [env_var_exists_and_non_empty RCX_RULES] } {
+if {
+  [env_var_exists_and_non_empty RCX_RULES]
+  && ![env_var_exists_and_non_empty SKIP_DRT]
+} {
   # RCX section
   define_process_corner -ext_model_index 0 X
   extract_parasitics -ext_model_file $::env(RCX_RULES)

flow/scripts/variables.yaml

@@ -998,3 +998,9 @@ RULES_JSON:
     config.mk or from bazel-orfs.
   stages:
     - test
+SKIP_DETAILED_ROUTE:
+  default: 0
+  description: >
+    Skips detailed route.
+  stages:
+    - route