Merge pull request #9083 from gadfort/rdl-control

pad: add DB property to enable/disable RDL routing to specific iterms

Author: maliberty

src/pad/README.md

@@ -410,6 +410,18 @@ rdl_route
 | `-allow45` | Specifies that 45 degree routing is permitted. |
 | `nets` | Nets to route. |
 
+### Selectively routing terminals
+
+If some of of the terminals in the design do not need to be RDL routed, this can be done by assigning `RDL_ROUTE 0` to a terminal.
+
+```tcl
+# Assumes iterm is the pin to be not be routed
+set prop [odb::dbBoolProperty_create $iterm RDL_ROUTE 0]
+
+# Change to route iterm
+$prop setValue 1
+```
+
 ## Useful Developer Commands
 
 If you are a developer, you might find these useful. More details can be found in the [source file](./src/ICeWall.cpp) or the [swig file](./src/pad.i).

src/pad/src/RDLRouter.cpp

@@ -1892,6 +1892,18 @@ RDLRouter::generateRoutingTargets(odb::dbNet* net) const
       continue;
     }
 
+    auto* prop = odb::dbBoolProperty::find(iterm, kRouteProperty);
+    if (prop && !prop->getValue()) {
+      debugPrint(logger_,
+                 utl::PAD,
+                 "Router",
+                 2,
+                 "Skipping termininal on {}: {}",
+                 net->getName(),
+                 iterm->getName());
+      continue;
+    }
+
     odb::dbTechLayer* other_layer;
     odb::dbTechVia* via;
     if (isCoverTerm(iterm)) {

src/pad/src/RDLRouter.h

@@ -246,6 +246,9 @@ class RDLRouter
   // Debugging
   RDLGui* gui_;
   odb::dbNet* debug_net_{nullptr};
+
+  // Consts
+  static constexpr const char* kRouteProperty = "RDL_ROUTE";
 };
 
 }  // namespace pad

src/pad/test/BUILD

@@ -55,6 +55,7 @@ COMPULSORY_TESTS = [
     "rdl_route_max_iterations",
     "rdl_route_ports",
     "rdl_route_single_target",
+    "rdl_route_skip_iterm",
     "rdl_route_via",
     "skywater130_caravel",
     "skywater130_coyote_tc",

src/pad/test/CMakeLists.txt

@@ -50,6 +50,7 @@ or_integration_tests(
     rdl_route_max_iterations
     rdl_route_ports
     rdl_route_single_target
+    rdl_route_skip_iterm
     rdl_route_via
     skywater130_caravel
     skywater130_coyote_tc

src/pad/test/rdl_route_skip_iterm.defok

@@ -0,0 +1,10 @@
+[INFO ODB-0227] LEF file: Nangate45/Nangate45.lef, created 22 layers, 27 vias, 135 library cells
+[INFO ODB-0227] LEF file: Nangate45_io/dummy_pads.lef, created 29 library cells
+[INFO ODB-0128] Design: soc_bsg_black_parrot
+[INFO ODB-0130]     Created 139 pins.
+[INFO ODB-0131]     Created 1452 components and 8011 component-terminals.
+[INFO ODB-0132]     Created 4 special nets and 4706 connections.
+[INFO ODB-0133]     Created 354 nets and 627 connections.
+[INFO PAD-0005] Routing 1 nets
+[INFO PAD-0037] End of routing iteration 1: 100.0% complete
+No differences found.

src/pad/test/rdl_route_skip_iterm.ok

@@ -0,0 +1,14 @@
+# Test for RDL router skipping with "RDL_ROUTE"
+source "helpers.tcl"
+read_lef Nangate45/Nangate45.lef
+read_lef Nangate45_io/dummy_pads.lef
+
+read_def Nangate45_blackparrot/floorplan_flipchip.def
+
+odb::dbBoolProperty_create [[ord::get_db_block] findITerm BUMP_2_4/PAD] RDL_ROUTE 1
+
+rdl_route -layer metal10 -width 4 -spacing 4 "VDD"
+
+set def_file [make_result_file "rdl_route_skip_iterm.def"]
+write_def $def_file
+diff_files $def_file "rdl_route_skip_iterm.defok"