Merge remote-tracking branch 'origin/master' into web-lockup

Author: gadfort

docs/conf.py

@@ -35,6 +35,7 @@
     "myst_parser",
     "sphinxcontrib.mermaid",
     "sphinx_tabs.tabs",
+    "sphinx_llm.txt",
 ]
 
 myst_enable_extensions = [

docs/requirements.in

@@ -6,3 +6,4 @@ sphinxcontrib-mermaid
 sphinx-book-theme
 sphinx-copybutton
 sphinx-tabs
+sphinx-llm

docs/requirements.txt

@@ -180,6 +180,7 @@ docutils==0.19 \
     #   myst-parser
     #   pydata-sphinx-theme
     #   sphinx
+    #   sphinx-markdown-builder
     #   sphinx-tabs
 exceptiongroup==1.3.1 \
     --hash=sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219 \
@@ -189,9 +190,9 @@ h11==0.16.0 \
     --hash=sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1 \
     --hash=sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86
     # via uvicorn
-idna==3.17 \
-    --hash=sha256:466e48829084efe2548012b855df21540b96f2e20e51bd124c851536556a592c \
-    --hash=sha256:5eb0cb53bc467c12eadcf6de83163ad8527cec9416f44b9b61b19caedad2b87f
+idna==3.18 \
+    --hash=sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2 \
+    --hash=sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848
     # via
     #   anyio
     #   requests
@@ -415,9 +416,9 @@ requests==2.34.2 \
     --hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
     --hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
     # via sphinx
-snowballstemmer==3.1.0 \
-    --hash=sha256:17e6d1da216aa07db6dad37139ea70cf13c4b2e9a096f6e64a9648fc657d3154 \
-    --hash=sha256:fd9e34526b23340cd23ffea6c9f9760974ecc2c2ac9e1d81401443ccdb2a801f
+snowballstemmer==3.1.1 \
+    --hash=sha256:7e207fa178741da09cdee59d3ecec3827ad5f92b1fc5c9ff3755b639f71f5752 \
+    --hash=sha256:e07bbc54a0d798fe6010a12398422e62a8bfbba95c394fd0956ef58cb4d3e260
     # via sphinx
 soupsieve==2.8.4 \
     --hash=sha256:e121fd02e975c695e4e9e8774a5ee35d74714b59307868dcc5319ad2d9e3328e \
@@ -434,6 +435,8 @@ sphinx==5.3.0 \
     #   sphinx-book-theme
     #   sphinx-copybutton
     #   sphinx-external-toc
+    #   sphinx-llm
+    #   sphinx-markdown-builder
     #   sphinx-tabs
     #   sphinxcontrib-mermaid
 sphinx-autobuild==2024.10.3 \
@@ -452,6 +455,14 @@ sphinx-external-toc==0.3.1 \
     --hash=sha256:9c8ea9980ea0e57bf3ce98f6a400f9b69eb1df808f7dd796c9c8cc1873d8b355 \
     --hash=sha256:cd93c1e7599327b2a728db12d9819068ce719c4b037ffc62e47f20ffb6310fb3
     # via -r docs/requirements.in
+sphinx-llm==0.4.1 \
+    --hash=sha256:0789185dcbbecc00b5e25aa3db6342b98dad6a9def96088a9e50fa0203fda090 \
+    --hash=sha256:d7c8ee2a6335636b628ea2b26cd1e1dee1f0cf9c40fe51b20f201af1c05b95f5
+    # via -r docs/requirements.in
+sphinx-markdown-builder==0.6.10 \
+    --hash=sha256:16d86738b9ac69fcbc86e373c31c6402c30af1fa8d98d0f62cc5f38bfe5fc26e \
+    --hash=sha256:cd5acf88d52ea0146a712fd557404f10326dff3428a78ba928e59b1727fd4a86
+    # via sphinx-llm
 sphinx-tabs==3.4.7 \
     --hash=sha256:991ad4a424ff54119799ba1491701aa8130dd43509474aef45a81c42d889784d \
     --hash=sha256:c12d7a36fd413b369e9e9967a0a4015781b71a9c393575419834f19204bd1915
@@ -484,10 +495,14 @@ sphinxcontrib-serializinghtml==2.0.0 \
     --hash=sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331 \
     --hash=sha256:e9d912827f872c029017a53f0ef2180b327c3f7fd23c87229f7a8e8b70031d4d
     # via sphinx
-starlette==1.2.0 \
-    --hash=sha256:36e0c76ac59157e75dc4b3bdeafba97fb04eaf1878045f15dbef666a6f092ed7 \
-    --hash=sha256:3c5a6b23fff42492914e93890bb80cbfea72dbf37de268eec06185d62a4ca553
+starlette==1.2.1 \
+    --hash=sha256:4de0082d08c8f6764a85a54cf1120d6939507a19905c7768acad2a9f875d2b89 \
+    --hash=sha256:9b9b5ebb992e67d6093741e63c2f59e4f6fff986f81163c087867bd7b924b3f6
     # via sphinx-autobuild
+tabulate==0.10.0 \
+    --hash=sha256:e2cfde8f79420f6deeffdeda9aaec3b6bc5abce947655d17ac662b126e48a60d \
+    --hash=sha256:f0b0622e567335c8fabaaa659f1b33bcb6ddfe2e496071b743aa113f8774f2d3
+    # via sphinx-markdown-builder
 typing-extensions==4.15.0 \
     --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
     --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
@@ -502,9 +517,9 @@ urllib3==2.7.0 \
     --hash=sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c \
     --hash=sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897
     # via requests
-uvicorn==0.48.0 \
-    --hash=sha256:48097851328b87ec36117d3d575234519eb58c2b22d79666e9bbc6c49a761dad \
-    --hash=sha256:a5504207195d08c2511bf9125ede5ac4a4b71725d519e758d01dcf0bc2d31c37
+uvicorn==0.49.0 \
+    --hash=sha256:ba3d14c3ee7e41c6c654c46c9eb489d33213cdd30aa1696eab1374337c13f68f \
+    --hash=sha256:ebf4271aa580d9de97f93192d4595176df6e91f9aae919ca73e4fc07df1e66a3
     # via sphinx-autobuild
 watchfiles==1.2.0 \
     --hash=sha256:01859b11fd9fbca670f4d5da00fbac282cfea9bd67a2125d8b2833a3b5617ea9 \

src/dbSta/include/db_sta/dbNetwork.hh

@@ -405,6 +405,44 @@ class dbNetwork : public ConcreteNetwork
   double dbuToMeters(int dist) const;
   int metersToDbu(double dist) const;
 
+  ////////////////////////////////////////////////////////////////
+  // Sequential / Flop / Scan flop utility functions
+  // clock pin functions
+  bool isClockPin(odb::dbITerm* iterm) const;
+  bool clockOn(odb::dbInst* inst) const;
+
+  // d pin functions
+  bool isDPin(odb::dbITerm* iterm) const;
+  int getNumD(odb::dbInst* inst) const;
+
+  // q(n) pin functions
+  bool isQPin(odb::dbITerm* iterm) const;
+  bool isInvertingQPin(odb::dbITerm* iterm) const;
+  int getNumQ(odb::dbInst* inst) const;
+
+  // clear/preset pin functions
+  bool hasClear(odb::dbInst* inst) const;
+  bool isClearPin(odb::dbITerm* iterm) const;
+  bool hasPreset(odb::dbInst* inst) const;
+  bool isPresetPin(odb::dbITerm* iterm) const;
+
+  // scan cell/pin functions
+  bool isScanCell(odb::dbInst* inst) const;
+  bool isScanIn(odb::dbITerm* iterm) const;
+  odb::dbITerm* getScanIn(odb::dbInst* inst) const;
+  bool isScanEnable(odb::dbITerm* iterm) const;
+  odb::dbITerm* getScanEnable(odb::dbInst* inst) const;
+  LibertyPort* getLibertyScanEnable(const LibertyCell* lib_cell) const;
+  LibertyPort* getLibertyScanIn(const LibertyCell* lib_cell) const;
+  LibertyPort* getLibertyScanOut(const LibertyCell* lib_cell) const;
+
+  // supply pin functions
+  bool isSupplyPin(odb::dbITerm* iterm) const;
+  bool isValidFlop(odb::dbInst* FF) const;
+  bool isValidTray(odb::dbInst* tray) const;
+
+  ////////////////////////////////////////////////////////////////
+
   // hierarchy handler, set in openroad tested in network child traverserser
 
   void setHierarchy() { db_->setHierarchy(true); }
@@ -483,6 +521,7 @@ class dbNetwork : public ConcreteNetwork
   static constexpr unsigned DBIDTAG_WIDTH = 0x4;
 
  private:
+  const LibertyCell* getLibertyCell(const Cell* cell) const;
   void addDriverToCacheIfPresent(const Net* net, const Pin* drvr);
   void removeDriverFromCache(const Net* net);
   void removeDriverFromCache(const Net* net, const Pin* drvr);

src/dbSta/include/db_sta/dbSta.hh

@@ -11,6 +11,7 @@
 #include <vector>
 
 #include "db_sta/DelayFmt.hh"  // IWYU pragma: keep
+#include "db_sta/dbNetwork.hh"
 #include "odb/PtrSetMap.h"
 #include "odb/db.h"
 #include "odb/dbBlockCallBackObj.h"
@@ -258,10 +259,4 @@ class dbSta : public Sta, public odb::dbDatabaseObserver
   bool drvr_vertices_level_valid_ = false;
 };
 
-// Utilities for TestCell
-
-sta::LibertyPort* getLibertyScanEnable(const LibertyCell* lib_cell);
-sta::LibertyPort* getLibertyScanIn(const LibertyCell* lib_cell);
-sta::LibertyPort* getLibertyScanOut(const LibertyCell* lib_cell);
-
 }  // namespace sta