Merge branch 'master' into pdn-pins-layer

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

Author: maliberty

.github/workflows/github-actions-lint-tcl.yml

@@ -0,0 +1,29 @@
+name: Lint Tcl code
+
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+    branches:
+    - master
+
+jobs:
+  build:
+    runs-on: ${{ vars.USE_SELF_HOSTED == 'true' && 'self-hosted' || 'ubuntu-latest' }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Dependencies
+        run: |
+          python3 -m venv venv
+          venv/bin/pip install tclint==0.4.2
+
+      - name: Lint
+        run: |
+          source venv/bin/activate
+          tclfmt --version
+          tclfmt --in-place .
+          git diff --exit-code
+          tclint --no-check-style .

.github/workflows/github-actions-manual-update-rules.yml

@@ -22,12 +22,14 @@ jobs:
           python-version: "3.10"
       - name: Install Python Packages
         run: |
-          pip install firebase-admin
+          python3 -m venv venv
+          venv/bin/pip install firebase-admin
       - name: Execute Python Script Update
         env:
           CREDS_FILE: ${{ secrets.CREDS_FILE }}
           API_BASE_URL: ${{ secrets.API_BASE_URL }}
         run: |
+          source venv/bin/activate
           if [[ "${{ github.event.inputs.type }}" == "overwrite" ]]; then
             python flow/util/updateRules.py --keyFile "${CREDS_FILE}" --apiURL ${API_BASE_URL} --commitSHA $(git rev-parse HEAD) --overwrite
           else

.github/workflows/github-actions-update-rules.yml

@@ -24,12 +24,14 @@ jobs:
           python-version: "3.10"
       - name: Install Python Packages
         run: |
-          pip install firebase-admin
+          python3 -m venv venv
+          venv/bin/pip install firebase-admin
       - name: Execute Python Script Update
         env:
           CREDS_FILE: ${{ secrets.CREDS_FILE }}
           API_BASE_URL: ${{ secrets.API_BASE_URL }}
         run: |
+          source ./venv/bin/activate
           echo ${{ github.event_name }}
           echo ${{ github.event.client_payload.type }}
           if [[ "${{ github.event_name }}" == "repository_dispatch" && "${{ github.event.client_payload.type }}" == "overwrite" ]]; then

.github/workflows/github-actions-yaml-test.yml

@@ -23,9 +23,13 @@ jobs:
     - name: Check if FlowVariables.md is up to date
       run: |
         git diff --exit-code docs/user/FlowVariables.md
+    - name: Install dependencies
+      run: |
+        python3 -m venv venv
+        venv/bin/pip install --quiet yamlfix==1.17.0
     - name: Run yamlfix check
       run: |
-        pip install --quiet yamlfix==1.17.0
+        source venv/bin/activate
         yamlfix --version
         set -x
         yamlfix -c yamlfix.toml flow/scripts/variables.yaml

.gitignore

@@ -29,7 +29,6 @@ flow/rc_model.bin
 flow/*.tif.gz
 flow/*.def.v
 
-
 # RePlAce deps
 *PORT9.dat
 *POST9.dat
@@ -103,3 +102,6 @@ bazel-bin
 bazel-out
 bazel-OpenROAD-flow-scripts
 bazel-testlogs
+
+# python venv
+venv/

MODULE.bazel

@@ -11,7 +11,7 @@ bazel_dep(name = "bazel-orfs")
 # To bump version, run: bazelisk run @bazel-orfs//:bump
 git_override(
     module_name = "bazel-orfs",
-    commit = "9a3778bdbe63106a894a03e865335a31ebc860d1",
+    commit = "f8a4b694b37c8f5322323eba9a9ae37f9541ee17",
     remote = "https://github.com/The-OpenROAD-Project/bazel-orfs.git",
 )
 
@@ -20,13 +20,13 @@ bazel_dep(name = "rules_python", version = "1.2.0")
 python = use_extension("@rules_python//python/extensions:python.bzl", "python")
 python.toolchain(
     ignore_root_user_error = True,
-    python_version = "3.12",
+    python_version = "3.13",
 )
 
 pip = use_extension("@rules_python//python/extensions:pip.bzl", "pip")
 pip.parse(
     hub_name = "orfs-pip",
-    python_version = "3.12",
+    python_version = "3.13",
     requirements_lock = "//flow:util/requirements_lock.txt",
 )
 use_repo(pip, "orfs-pip")
@@ -35,12 +35,12 @@ orfs = use_extension("@bazel-orfs//:extension.bzl", "orfs_repositories")
 
 # To bump version, run: bazelisk run @bazel-orfs//:bump
 orfs.default(
-    image = "docker.io/openroad/orfs:v3.0-3190-g5ac9869c",
+    image = "docker.io/openroad/orfs:v3.0-3273-gedf3d6bf",
     # Use local files instead of docker image
     makefile = "//flow:makefile",
     makefile_yosys = "//flow:makefile_yosys",
     pdk = "//flow:asap7",
-    sha256 = "2ca999699bc91144074b7f23f42da9330d7279437c386a1413fba4a6a7520916",
+    sha256 = "f5692c6325ebcf27cc348e033355ec95c82c35ace1af7e72a0d352624ada143e",
 )
 use_repo(orfs, "com_github_nixos_patchelf_download")
 use_repo(orfs, "docker_orfs")

MODULE.bazel.lock

@@ -46,6 +46,14 @@ timeline
 
 ## Tool Installation
 
+There are different ways to install and develop OpenROAD and ORFS, which is the best fit depends use-case, experience and personal taste.
+
+### Use Bazel, avoid installing anything at all and adapt the flow to your needs in your own repository
+
+[bazel-orfs](https://github.com/The-OpenROAD-Project/bazel-orfs) provides a seamless, reproducible way to manage dependencies and adapt the flow without requiring manual installations(no Docker images, sudo bash scripts, etc.)
+
+By leveraging [Bazel](https://bazel.build/)'s robust build system, all dependencies are automatically resolved, versioned, and built in a consistent environment. This eliminates setup complexity, ensures fast incremental builds, and allows for easy customization of the flow, making it an efficient choice for both [beginners](https://github.com/Pinata-Consulting/RegFileStudy) and [advanced](https://github.com/The-OpenROAD-Project/megaboom) users.
+
 ### Docker Based Installation
 
 To ease dependency installation issues, ORFS uses docker images.

README.md

@@ -3,7 +3,7 @@
 # Set developer paths and environment variables here,
 # user settings go in ./env.sh
 function __setpaths() {
-    local DIR=$(readlink -f "$(dirname "${BASH_SOURCE[0]}")")
+    local DIR=$(readlink -f "$(dirname "${BASH_SOURCE[0]:-${(%):-%x}}")")
     [ "$(find $DIR/dependencies -type f -user root)" ] && echo "WARNING! Files set up by sudo found in $DIR"
     export PATH="$DIR/dependencies/bin:$PATH"
     export CMAKE_INSTALL_RPATH=$DIR/dependencies/lib:$DIR/dependencies/lib64