pad: add user control of mode

Signed-off-by: Peter Gadfort <[email protected]>

Author: gadfort

src/pad/README.md

@@ -219,6 +219,7 @@ place_pads -row IO_SOUTH u_reset.u_in u_reset.u_out
 ```tcl
 place_pads
     -row row_name
+    [-mode mode]
     pads
 ```
 
@@ -227,6 +228,7 @@ place_pads
 | Switch Name | Description |
 | ----- | ----- |
 | `-row` | Name of the row to place the pad into, examples include: `IO_NORTH`, `IO_SOUTH`, `IO_WEST`, `IO_EAST`, `IO_NORTH_0`, `IO_NORTH_1`. |
+| `-mode` | Select the mode to use during pad placement, choices are `bump_aligned` and `uniform`. Default will select `bump_aligned` if possible, otherwise fallback to `uniform`. |
 | `pads` | Name of the instances in the order they should be placed (left to right for `IO_SOUTH` and `IO_NORTH` and bottom to top for `IO_WEST` and `IO_EAST`). |
 
 

src/pad/include/pad/ICeWall.h

@@ -26,6 +26,13 @@ namespace pad {
 class RDLRouter;
 class RDLGui;
 
+enum class PlacementStrategy
+{
+  DEFAULT,
+  BUMP_ALIGNED,
+  UNIFORM
+};
+
 class ICeWall
 {
  public:
@@ -67,7 +74,9 @@ class ICeWall
                 odb::dbRow* row,
                 int location,
                 bool mirror);
-  void placePads(const std::vector<odb::dbInst*>& insts, odb::dbRow* row);
+  void placePads(const std::vector<odb::dbInst*>& insts,
+                 odb::dbRow* row,
+                 const PlacementStrategy& mode);
   void placeCorner(odb::dbMaster* master, int ring_index);
   void placeFiller(const std::vector<odb::dbMaster*>& masters,
                    odb::dbRow* row,

src/pad/src/ICeWall.cpp

@@ -679,7 +679,9 @@ int64_t ICeWall::computePadBumpDistance(odb::dbInst* inst,
   return std::numeric_limits<int64_t>::max();
 }
 
-void ICeWall::placePads(const std::vector<odb::dbInst*>& insts, odb::dbRow* row)
+void ICeWall::placePads(const std::vector<odb::dbInst*>& insts,
+                        odb::dbRow* row,
+                        const PlacementStrategy& mode)
 {
   auto* block = getBlock();
   if (block == nullptr) {
@@ -761,17 +763,34 @@ void ICeWall::placePads(const std::vector<odb::dbInst*>& insts, odb::dbRow* row)
     }
   }
 
-  if (!iterm_connections.empty()) {
-    placePadsBumpAligned(insts,
-                         row,
-                         inst_widths,
-                         total_width,
-                         row_width,
-                         row_start,
-                         iterm_connections);
-  } else {
-    placePadsUniform(
-        insts, row, inst_widths, total_width, row_width, row_start);
+  PlacementStrategy use_mode = mode;
+  if (use_mode == PlacementStrategy::DEFAULT) {
+    if (!iterm_connections.empty()) {
+      use_mode = PlacementStrategy::BUMP_ALIGNED;
+    }
+  }
+  if (use_mode == PlacementStrategy::BUMP_ALIGNED
+      && iterm_connections.empty()) {
+    logger_->warn(
+        utl::PAD, 9, "Unable to use bump_aligned mode, switching to uniform");
+    use_mode = PlacementStrategy::UNIFORM;
+  }
+
+  switch (use_mode) {
+    case PlacementStrategy::BUMP_ALIGNED:
+      placePadsBumpAligned(insts,
+                           row,
+                           inst_widths,
+                           total_width,
+                           row_width,
+                           row_start,
+                           iterm_connections);
+      break;
+    case PlacementStrategy::UNIFORM:
+    case PlacementStrategy::DEFAULT:
+      placePadsUniform(
+          insts, row, inst_widths, total_width, row_width, row_start);
+      break;
   }
 
   logger_->info(

src/pad/src/pad.i

@@ -26,6 +26,18 @@ utl::Logger* getLogger();
 %include "exception.i"
 %include "../../Exception.i"
 
+%typemap(in) pad::PlacementStrategy {
+  char *str = Tcl_GetStringFromObj($input, 0);
+  if (strcasecmp(str, "bump_aligned") == 0) {
+    $1 = pad::PlacementStrategy::BUMP_ALIGNED;
+  } else if (strcasecmp(str, "uniform") == 0) {
+    $1 = pad::PlacementStrategy::UNIFORM;
+  } else if (strcasecmp(str, "default") == 0) {
+    $1 = pad::PlacementStrategy::DEFAULT;
+  } else {
+    $1 = pad::PlacementStrategy::DEFAULT;
+  }
+}
 
 %inline %{
 
@@ -77,9 +89,9 @@ void place_pad(odb::dbMaster* master, const char* name, odb::dbRow* row, int loc
   ord::getICeWall()->placePad(master, name, row, location, mirror);
 }
 
-void place_pads(const std::vector<odb::dbInst*>& insts, odb::dbRow* row)
+void place_pads(const std::vector<odb::dbInst*>& insts, odb::dbRow* row, pad::PlacementStrategy mode)
 {
-  ord::getICeWall()->placePads(insts, row);
+  ord::getICeWall()->placePads(insts, row, mode);
 }
 
 void place_corner(odb::dbMaster* master, int ring_index)

src/pad/src/pad.tcl

@@ -234,11 +234,12 @@ proc place_pad { args } {
 }
 
 sta::define_cmd_args "place_pads" {-row row_name \
+                                   [-mode mode] \
                                    pads}
 
 proc place_pads { args } {
   sta::parse_key_args "place_pads" args \
-    keys {-row} \
+    keys {-row -mode} \
     flags {}
 
   if { $args == {} } {
@@ -249,6 +250,11 @@ proc place_pads { args } {
     set args [lindex $args 0]
   }
 
+  set mode "default"
+  if { [info exists keys(-mode)] } {
+    set mode $keys(-mode)
+  }
+
   set insts []
   foreach inst $args {
     lappend insts [pad::find_instance $inst]
@@ -257,7 +263,8 @@ proc place_pads { args } {
   pad::assert_required place_pads -row
   pad::place_pads \
     $insts \
-    [pad::get_row $keys(-row)]
+    [pad::get_row $keys(-row)] \
+    $mode
 }
 
 sta::define_cmd_args "place_io_fill" {-row row_name \

src/pad/test/BUILD

@@ -34,6 +34,7 @@ COMPULSORY_TESTS = [
     "place_pad_wrong_master",
     "place_pads_bumps",
     "place_pads_bumps_bump_overlap",
+    "place_pads_bumps_strategy",
     "place_pads_too_many",
     "place_pads_uniform",
     "place_pads_uniform_slip",

src/pad/test/CMakeLists.txt

@@ -27,6 +27,7 @@ or_integration_tests(
     place_pad_overblockage
     place_pad_with_bumps
     place_pads_bumps_bump_overlap
+    place_pads_bumps_strategy
     place_pad_wrong_master
     place_pads_bumps
     place_pads_too_many