odb, rcx: add set_extraction_rules_file and deprecate -ext_model_file option

Signed-off-by: Arthur Koucher <arthurkoucher@precisioninno.com>

Author: AcKoucher

src/odb/README.md

@@ -490,6 +490,25 @@ add_3dblox_alignment_marker_rule
 | `-tolerance` | Maximum allowed center-to-center misalignment in microns. Must be positive. Defaults to 0 (exact alignment required). |
 | `-relative_orientations` | Optional Tcl list of allowed orientations of master_b relative to master_a (e.g. `{R0 MY}`). When omitted, orientations are not constrained. |
 
+### Set Extraction Rules File
+
+Sets the path to the parasitics extraction rules file. For a design in which
+multiple technologies are used, the user must specify the technology for which
+they want to set the rules path.
+
+```tcl
+set_extraction_rules_file
+    [-tech tech_name]
+    rules_file
+```
+
+#### Options
+
+| Switch Name | Description |
+| ----- | ----- |
+| `-tech` | Technology for which to set the extraction rules path. |
+| `rules_file` | Path to the extraction rules file. |
+
 ## Regression tests
 
 There are a set of regression tests in `./test`. For more information, refer to this [section](../../README.md#regression-tests). 

src/odb/include/odb/db.h

@@ -5889,6 +5889,10 @@ class dbTech : public dbObject
   ///
   std::string getName();
 
+  void setExtractionRulesFile(const std::string& path);
+
+  std::string getExtractionRulesFile();
+
   ///
   /// Get the Database units per micron.
   ///
@@ -7588,6 +7592,8 @@ class dbDatabase : public dbObject
 
   dbChip* findChip(const char* name) const;
 
+  bool hasHierarchicalChip() const;
+
   dbSet<dbProperty> getProperties() const;
 
   dbSet<dbChipInst> getChipInsts() const;

src/odb/src/db/dbDatabase.cpp

@@ -704,6 +704,17 @@ dbChip* dbDatabase::findChip(const char* name) const
   return (dbChip*) obj->chip_hash_.find(name);
 }
 
+bool dbDatabase::hasHierarchicalChip() const
+{
+  for (dbChip* chip : getChips()) {
+    if (chip->getChipType() == dbChip::ChipType::HIER) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 dbSet<dbProperty> dbDatabase::getProperties() const
 {
   _dbDatabase* obj = (_dbDatabase*) this;

src/odb/src/db/dbDatabase.h

@@ -50,7 +50,10 @@ namespace odb {
 inline constexpr uint32_t kSchemaMajor = 0;  // Not used...
 inline constexpr uint32_t kSchemaInitial = 57;
 
-inline constexpr uint32_t kSchemaMinor = 134;  // Current revision number
+inline constexpr uint32_t kSchemaMinor = 135;  // Current revision number
+
+// Revision where dbTech::extraction_rules_file_ was added
+inline constexpr uint32_t kSchemaTechExtractionRulesFile = 135;
 
 // Revision where the per-corner child-block feature for parasitics was removed
 inline constexpr uint32_t kSchemaRemovePerCornerBlock = 134;

src/odb/src/db/dbTech.cpp

@@ -86,6 +86,10 @@ bool _dbTech::operator==(const _dbTech& rhs) const
     return false;
   }
 
+  if (extraction_rules_file_ != rhs.extraction_rules_file_) {
+    return false;
+  }
+
   if (via_cnt_ != rhs.via_cnt_) {
     return false;
   }
@@ -330,6 +334,7 @@ dbOStream& operator<<(dbOStream& stream, const _dbTech& tech)
   stream << NamedTable("cell_edge_spacing_tbl_", tech.cell_edge_spacing_tbl_);
   stream << *tech.name_cache_;
   stream << tech.via_hash_;
+  stream << tech.extraction_rules_file_;
   return stream;
 }
 
@@ -381,6 +386,9 @@ dbIStream& operator>>(dbIStream& stream, _dbTech& tech)
   }
   stream >> *tech.name_cache_;
   stream >> tech.via_hash_;
+  if (db->isSchema(kSchemaTechExtractionRulesFile)) {
+    stream >> tech.extraction_rules_file_;
+  }
 
   return stream;
 }
@@ -391,6 +399,18 @@ std::string dbTech::getName()
   return tech->name_;
 }
 
+void dbTech::setExtractionRulesFile(const std::string& path)
+{
+  _dbTech* tech = (_dbTech*) this;
+  tech->extraction_rules_file_ = path;
+}
+
+std::string dbTech::getExtractionRulesFile()
+{
+  _dbTech* tech = (_dbTech*) this;
+  return tech->extraction_rules_file_;
+}
+
 double _dbTech::getLefVersion() const
 {
   return version_;

src/odb/src/db/dbTech.h

@@ -73,6 +73,7 @@ class _dbTech : public _dbObject
  public:
   // PERSISTANT-MEMBERS
   std::string name_;
+  std::string extraction_rules_file_;
   int via_cnt_;
   int layer_cnt_;
   int rlayer_cnt_;

src/odb/src/swig/tcl/odb.tcl

@@ -1210,6 +1210,32 @@ proc add_3dblox_alignment_marker_rule { args } {
   }
 }
 
+sta::define_cmd_args "set_extraction_rules_file" {
+    [-tech tech_name] rules_file
+}
+
+proc set_extraction_rules_file { args } {
+  sta::parse_key_args "set_extraction_rules_file" args \
+    keys {-tech} flags {}
+  sta::check_argc_eq1 "set_extraction_rules_file" $args
+
+  set db [ord::get_db]
+  if { [info exists keys(-tech)] } {
+    set tech [$db findTech $keys(-tech)]
+  } elseif { [$db hasHierarchicalChip] } {
+    utl::error ODB 478 "Could not set extraction rules file.\
+      Use -tech to specify a technology in a 3D design."
+  } else {
+    set tech [$db getTech]
+  }
+
+  if { $tech == "NULL" } {
+    utl::error ODB 477 "Could not set extraction rules file. Tech not found."
+  }
+
+  $tech setExtractionRulesFile $args
+}
+
 namespace eval odb {
 proc resolve_master { cell { lib_name "" } } {
   set db [ord::get_db]

src/rcx/README.md

@@ -50,7 +50,7 @@ returned.
 
 ```tcl
 extract_parasitics
-    [-ext_model_file filename]      
+    [-ext_model_file filename]
     [-corner cornerIndex]
     [-corner_cnt count]            
     [-max_res ohms]               
@@ -70,7 +70,7 @@ extract_parasitics
 
 | Switch Name | Description |
 | ----- | ----- |
-| `-ext_model_file` | Specify the Extraction Rules file used for the extraction. |
+| `-ext_model_file` | Deprecated. Use the `set_extraction_rules_file` command instead. |
 | `-corner cornerIndex` | Corner to extract.  Default -1. |
 | `-corner_cnt` | Defines the number of corners used during the parasitic extraction. |
 | `-max_res` | Combines resistors in series up to the threshold value. |

src/rcx/src/OpenRCX.tcl

@@ -83,7 +83,9 @@ proc extract_parasitics { args } {
 
   set ext_model_file ""
   if { [info exists keys(-ext_model_file)] } {
-    set ext_model_file $keys(-ext_model_file)
+    utl::warn RCX 514 "-ext_model_file is deprecated, use\
+                       set_extraction_rules_file instead."
+    set_extraction_rules_file $keys(-ext_model_file)
   }
 
   set corner_cnt 1

src/rcx/src/ext.cpp

@@ -216,6 +216,11 @@ void Ext::extract(ExtractOptions options)
 
   odb::orderWires(logger_, block);
 
+  std::string rules_file = block->getTech()->getExtractionRulesFile();
+  if (!rules_file.empty()) {
+    options.ext_model_file = rules_file.c_str();
+  }
+
   _ext->set_debug_nets(options.debug_net);
 
   _ext->_lef_res = options.lef_res;