librelane 2.4.0.dev0__py3-none-any.whl

librelane/scripts/openroad/common/io.tcl

@@ -0,0 +1,476 @@
+# Copyright 2022-2024 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+source $::env(_TCL_ENV_IN)
+source $::env(SCRIPTS_DIR)/openroad/common/set_global_connections.tcl
+
+proc string_in_file {file_path substring} {
+    set f [open $file_path r]
+    set data [read $f]
+    close $f
+
+    if { [string first $substring $data] != -1} {
+        return 1
+    }
+    return 0
+}
+
+proc env_var_used {file var} {
+    return [string_in_file $file "\$::env($var)"]
+}
+
+proc set_global_vars {} {
+    if { [namespace exists ::ord] } {
+        set ::db [::ord::get_db]
+        set ::chip [$::db getChip]
+        set ::tech [$::db getTech]
+        set ::block [$::chip getBlock]
+        set ::dbu [$::tech getDbUnitsPerMicron]
+        set ::libs [$::db getLibs]
+    }
+}
+
+proc read_current_sdc {} {
+    if { ![info exists ::env(_SDC_IN)]} {
+        puts "\[INFO\] _SDC_IN not found. Not reading an SDC file."
+        return
+    }
+
+    # Compatibility Layer for Deprecated Variables That May Still Be Used By
+    # User Files
+    set ::env(IO_PCT) [expr $::env(IO_DELAY_CONSTRAINT) / 100]
+    set ::env(SYNTH_TIMING_DERATE) [expr $::env(TIME_DERATING_CONSTRAINT) / 100]
+    set ::env(SYNTH_MAX_FANOUT) $::env(MAX_FANOUT_CONSTRAINT)
+    set ::env(SYNTH_CLOCK_UNCERTAINTY) $::env(CLOCK_UNCERTAINTY_CONSTRAINT)
+    set ::env(SYNTH_CLOCK_TRANSITION) $::env(CLOCK_TRANSITION_CONSTRAINT)
+    set ::env(SYNTH_CAP_LOAD) $::env(OUTPUT_CAP_LOAD)
+    if { [info exists ::env(MAX_TRANSITION_CONSTRAINT)] } {
+        set ::env(SYNTH_MAX_TRAN) $::env(MAX_TRANSITION_CONSTRAINT)
+    }
+    if { [env_var_used $::env(_SDC_IN) SYNTH_DRIVING_CELL_PIN] == 1 } {
+        set synth_driving_cell_bk $::env(SYNTH_DRIVING_CELL)
+        set ::env(SYNTH_DRIVING_CELL_PIN) [lindex [split $::env(SYNTH_DRIVING_CELL) "/"] 1]
+        set ::env(SYNTH_DRIVING_CELL) [lindex [split $::env(SYNTH_DRIVING_CELL) "/"] 0]
+    }
+
+    puts "Reading design constraints file at '$::env(_SDC_IN)'…"
+    if {[catch {read_sdc $::env(_SDC_IN)} errmsg]} {
+        puts stderr $errmsg
+        exit 1
+    }
+
+    if { ![string_in_file $::env(_SDC_IN) "set_propagated_clock"] && ![string_in_file $::env(_SDC_IN) "unset_propagated_clock"] } {
+        if { [info exists ::env(OPENLANE_SDC_IDEAL_CLOCKS)] && $::env(OPENLANE_SDC_IDEAL_CLOCKS) } {
+            puts "\[INFO\] No information on clock propagation in input SDC file-- unpropagating all clocks."
+            unset_propagated_clock [all_clocks]
+        } else {
+            puts "\[INFO\] No information on clock propagation in input SDC file-- propagating all clocks."
+            set_propagated_clock [all_clocks]
+        }
+    }
+
+    # Restore Environment
+    unset ::env(IO_PCT)
+    unset ::env(SYNTH_TIMING_DERATE)
+    unset ::env(SYNTH_MAX_FANOUT)
+    unset ::env(SYNTH_CLOCK_UNCERTAINTY)
+    unset ::env(SYNTH_CLOCK_TRANSITION)
+    unset ::env(SYNTH_CAP_LOAD)
+    if { [info exists ::env(SYNTH_MAX_TRAN)] } {
+        unset ::env(SYNTH_MAX_TRAN)
+    }
+    if { [info exists ::env(SYNTH_DRIVING_CELL_PIN)] } {
+        unset ::env(SYNTH_DRIVING_CELL_PIN)
+        set ::env(SYNTH_DRIVING_CELL) $synth_driving_cell_bk
+    }
+}
+
+proc read_pdn_cfg {} {
+
+    # Compatibility Layer for Deprecated Variables That May Still Be Used By
+    # User Files
+    set ::env(DESIGN_IS_CORE) $::env(FP_PDN_MULTILAYER)
+    set ::env(FP_PDN_ENABLE_MACROS_GRID) $::env(PDN_CONNECT_MACROS_TO_GRID)
+    set ::env(FP_PDN_RAILS_LAYER) $::env(FP_PDN_RAIL_LAYER)
+    set ::env(FP_PDN_UPPER_LAYER) $::env(FP_PDN_HORIZONTAL_LAYER)
+    set ::env(FP_PDN_LOWER_LAYER) $::env(FP_PDN_VERTICAL_LAYER)
+
+    if {[catch {source $::env(FP_PDN_CFG)} errmsg]} {
+        puts stderr $errmsg
+        exit 1
+    }
+
+    # Restore Environment
+    unset ::env(DESIGN_IS_CORE)
+    unset ::env(FP_PDN_ENABLE_MACROS_GRID)
+    unset ::env(FP_PDN_RAILS_LAYER)
+    unset ::env(FP_PDN_UPPER_LAYER)
+    unset ::env(FP_PDN_LOWER_LAYER)
+}
+
+
+proc read_current_netlist {args} {
+    sta::parse_key_args "read_current_netlist" args \
+        keys {}\
+        flags {-powered}
+
+    if { [info exists flags(-powered)] } {
+        puts "Reading top-level powered netlist at '$::env(CURRENT_POWERED_NETLIST)'…"
+        if {[catch {read_verilog $::env(CURRENT_POWERED_NETLIST)} errmsg]} {
+            puts stderr $errmsg
+            exit 1
+        }
+    } else {
+        puts "Reading top-level netlist at '$::env(CURRENT_NETLIST)'…"
+        if {[catch {read_verilog $::env(CURRENT_NETLIST)} errmsg]} {
+            puts stderr $errmsg
+            exit 1
+        }
+    }
+
+    puts "Linking design '$::env(DESIGN_NAME)' from netlist…"
+    link_design $::env(DESIGN_NAME)
+    set_global_vars
+    read_current_sdc
+}
+
+proc read_timing_info {args} {
+    sta::parse_key_args "read_timing_info" args \
+        keys {}\
+        flags {-powered}
+
+    if { ![info exists ::env(_CURRENT_CORNER_NAME)] } {
+        return
+    }
+    set corner_name $::env(_CURRENT_CORNER_NAME)
+    define_corners $corner_name
+
+    puts "Reading timing models for corner $corner_name…"
+
+    foreach lib $::env(_CURRENT_CORNER_LIBS) {
+        puts "Reading cell library for the '$corner_name' corner at '$lib'…"
+        read_liberty -corner $corner_name $lib
+    }
+
+    if { [info exists ::env(EXTRA_LIBS) ] } {
+        puts "Reading explicitly-specified extra libs for $corner_name…"
+        foreach extra_lib $::env(EXTRA_LIBS) {
+            puts "Reading extra timing library for the '$corner_name' corner at '$extra_lib'…"
+            read_liberty -corner $corner_name $extra_lib
+        }
+    }
+
+    set blackbox_wildcard {/// sta-blackbox}
+    foreach nl $::env(_CURRENT_CORNER_NETLISTS) {
+        puts "Reading macro netlist at '$nl'…"
+        if { [catch {read_verilog $nl} err] } {
+            puts "Error while reading macro netlist '$nl':"
+            puts $err
+            puts "Make sure that this a gate-level netlist and not an RTL file."
+            exit 1
+        }
+    }
+    if { [info exists ::env(EXTRA_VERILOG_MODELS)] } {
+        foreach verilog_file $::env(EXTRA_VERILOG_MODELS) {
+            if { [string_in_file $verilog_file $blackbox_wildcard] } {
+                puts "Found '$blackbox_wildcard' in '$verilog_file', skipping…"
+            } elseif { [catch {puts "Reading Verilog model at '$verilog_file'…"; read_verilog $verilog_file} err] } {
+                puts "Error while reading $verilog_file:"
+                puts $err
+                puts "Make sure that this a gate-level netlist and not an RTL file, otherwise, you can add the following comment '$blackbox_wildcard' in the file to skip it and blackbox the modules inside if needed."
+                exit 1
+            }
+        }
+    }
+    if { [info exists flags(-powered)] } {
+        read_current_netlist -powered
+    } else {
+        read_current_netlist
+    }
+}
+
+proc lshift {inputlist} {
+    upvar $inputlist argv
+    set arg  [lindex $argv 0]
+    #set argv [lrange $argv 1 end] ;# below is much faster - lreplace can make use of unshared Tcl_Obj to avoid alloc'ing the result
+    set argv [lreplace $argv[set argv {}] 0 0]
+    return $arg
+}
+
+proc read_spefs {} {
+    if { [info exists ::env(_CURRENT_SPEF_BY_CORNER)] } {
+        set corner_name $::env(_CURRENT_CORNER_NAME)
+        puts "Reading top-level design parasitics for the '$corner_name' corner at '$::env(_CURRENT_SPEF_BY_CORNER)'…"
+        read_spef -corner $corner_name $::env(_CURRENT_SPEF_BY_CORNER)
+    }
+    if { [info exists ::env(_CURRENT_CORNER_SPEFS)] } {
+        set corner_name $::env(_CURRENT_CORNER_NAME)
+        foreach spefs $::env(_CURRENT_CORNER_SPEFS) {
+            set instance_path [lshift spefs]
+            foreach spef $spefs {
+                puts "Reading '$instance_path' parasitics for the '$corner_name' corner at '$spef'…"
+                read_spef -corner $corner_name -path $instance_path $spef
+            }
+        }
+    }
+    if { [info exists ::env(_CURRENT_CORNER_EXTRA_SPEFS_BACKCOMPAT)] } {
+        set corner_name $::env(_CURRENT_CORNER_NAME)
+        foreach pair $::env(_CURRENT_CORNER_EXTRA_SPEFS_BACKCOMPAT) {
+            set module_name [lindex $pair 0]
+            set spef [lindex $pair 1]
+            foreach cell [get_cells * -hierarchical] {
+                if { "[get_property $cell ref_name]" eq "$module_name"} {
+                    set instance_path [get_property $cell full_name]
+                    puts "Reading '$instance_path' parasitics for the '$corner_name' corner at '$spef'…"
+                    read_spef -corner $corner_name -path $instance_path $spef
+                }
+            }
+        }
+    }
+}
+
+proc read_pnr_libs {args} {
+    # _PNR_LIBS contains all libs and extra libs but with known-bad cells
+    # excluded, so OpenROAD can use cells by functionality and come up
+    # with a valid design.
+
+    # If there are ANY libs already read- just leave
+    if { [get_libs -quiet *] != {} } {
+        return
+    }
+
+    define_corners $::env(DEFAULT_CORNER)
+
+    foreach lib $::env(_PNR_LIBS) {
+        puts "Reading library file at '$lib'…"
+        read_liberty $lib
+    }
+    if { [info exists ::env(_MACRO_LIBS) ] } {
+        foreach macro_lib $::env(_MACRO_LIBS) {
+            puts "Reading macro library file at '$macro_lib'…"
+            read_liberty $macro_lib
+        }
+    }
+    if { [info exists ::env(EXTRA_LIBS) ] } {
+        foreach extra_lib $::env(EXTRA_LIBS) {
+            puts "Reading extra library file at '$extra_lib'…"
+            read_liberty $extra_lib
+        }
+    }
+}
+
+proc read_lefs {{tlef_key "TECH_LEF"}} {
+    set tlef $::env($tlef_key)
+
+    puts "Reading technology LEF file at '$tlef'…"
+    read_lef $tlef
+
+    foreach lef $::env(CELL_LEFS) {
+        puts "Reading cell LEF file at '$lef'…"
+        read_lef $lef
+    }
+    if { [info exist ::env(MACRO_LEFS)] } {
+        foreach lef $::env(MACRO_LEFS) {
+            puts "Reading macro LEF file at '$lef'…"
+            read_lef $lef
+        }
+    }
+    if { [info exist ::env(EXTRA_LEFS)] } {
+        foreach lef $::env(EXTRA_LEFS) {
+            puts "Reading extra LEF file at '$lef'…"
+            read_lef $lef
+        }
+    }
+}
+
+proc set_dont_use_cells {} {
+    set_dont_use $::env(_PNR_EXCLUDED_CELLS)
+}
+
+proc read_current_odb {args} {
+    sta::parse_key_args "read_current_odb" args \
+        keys {}\
+        flags {}
+
+    puts "Reading OpenROAD database at '$::env(CURRENT_ODB)'…"
+    if { [ catch {read_db $::env(CURRENT_ODB)} errmsg ]} {
+        puts stderr $errmsg
+        exit 1
+    }
+
+    set_global_vars
+
+    # Read supporting views (if applicable)
+    read_pnr_libs
+    read_current_sdc
+    set_dont_use_cells
+}
+
+proc write_views {args} {
+    # This script will attempt to write views based on existing "SAVE_"
+    # environment variables. If the SAVE_ variable exists, the script will
+    # attempt to write a corresponding view to the specified location.
+    sta::parse_key_args "write_views" args \
+        keys {}\
+        flags {-no_global_connect}
+
+
+    source $::env(SCRIPTS_DIR)/openroad/common/set_power_nets.tcl
+    puts "Setting global connections for newly added cells…"
+    set_global_connections
+
+    puts "Updating metrics…"
+    report_design_area_metrics
+    report_cell_usage
+
+    if { [info exists ::env(SAVE_ODB)] } {
+        puts "Writing OpenROAD database to '$::env(SAVE_ODB)'…"
+        write_db $::env(SAVE_ODB)
+    }
+
+    if { [info exists ::env(SAVE_NETLIST)] } {
+        puts "Writing netlist to '$::env(SAVE_NETLIST)'…"
+        write_verilog $::env(SAVE_NETLIST)
+    }
+
+    if { [info exists ::env(SAVE_POWERED_NETLIST)] } {
+        puts "Writing powered netlist to '$::env(SAVE_POWERED_NETLIST)'…"
+        write_verilog -include_pwr_gnd $::env(SAVE_POWERED_NETLIST)
+    }
+
+    if { [info exists ::env(SAVE_POWERED_NETLIST_SDF_FRIENDLY)] } {
+        set exclude_cells "[join $::env(FILL_CELL)] [join $::env(DECAP_CELL)] [join $::env(WELLTAP_CELL)] [join $::env(ENDCAP_CELL)]"
+        puts "Writing nofill powered netlist to '$::env(SAVE_POWERED_NETLIST_SDF_FRIENDLY)'…"
+        puts "Excluding $exclude_cells"
+        write_verilog -include_pwr_gnd \
+            -remove_cells "$exclude_cells"\
+            $::env(SAVE_POWERED_NETLIST_SDF_FRIENDLY)
+    }
+
+    if { [info exists ::env(SAVE_POWERED_NETLIST_NO_PHYSICAL_CELLS)] } {
+        set exclude_cells "[join [lindex [split $::env(DIODE_CELL) "/"] 0]] [join $::env(FILL_CELL)] [join $::env(DECAP_CELL)] [join $::env(WELLTAP_CELL)] [join $::env(ENDCAP_CELL)]"
+        puts "Writing nofilldiode powered netlist to '$::env(SAVE_POWERED_NETLIST_NO_PHYSICAL_CELLS)'…"
+        puts "Excluding $exclude_cells"
+        write_verilog -include_pwr_gnd \
+            -remove_cells "$exclude_cells"\
+            $::env(SAVE_POWERED_NETLIST_NO_PHYSICAL_CELLS)
+    }
+
+    if { [info exists ::env(SAVE_OPENROAD_LEF)] } {
+        puts "Writing LEF to '$::env(SAVE_OPENROAD_LEF)'…"
+        set arg_list [list]
+        if {$::env(OPENROAD_LEF_BLOAT_OCCUPIED_LAYERS)} {
+            lappend arg_list -bloat_occupied_layers
+        }
+        write_abstract_lef {*}$arg_list $::env(SAVE_OPENROAD_LEF)
+    }
+
+    if { [info exists ::env(SAVE_DEF)] } {
+        puts "Writing layout to '$::env(SAVE_DEF)'…"
+        write_def $::env(SAVE_DEF)
+    }
+
+    if { [info exists ::env(SAVE_SDC)] } {
+        puts "Writing timing constraints to '$::env(SAVE_SDC)'…"
+        write_sdc -no_timestamp $::env(SAVE_SDC)
+    }
+
+    if { [info exists ::env(SAVE_SPEF)] } {
+        puts "Writing extracted parasitics to '$::env(SAVE_SPEF)'…"
+        write_spef $::env(SAVE_SPEF)
+    }
+
+    if { [info exists ::env(SAVE_GUIDE)] } {
+        puts "Writing routing guides to '$::env(SAVE_GUIDE)'…"
+        write_guides $::env(SAVE_GUIDE)
+    }
+
+    if { [info exists ::env(SAVE_SDF)] } {
+        set corners [sta::corners]
+        if { [llength $corners] > 1 } {
+        } else {
+            puts "Writing SDF to '$::env(SAVE_SDF)'…"
+            write_sdf -include_typ -divider . $::env(SAVE_SDF)
+        }
+    }
+}
+
+proc write_sdfs {} {
+    if { [info exists ::env(_SDF_SAVE_DIR)] } {
+        set corners [sta::corners]
+
+        puts "Writing SDF files for all corners…"
+        foreach corner $corners {
+            set corner_name [$corner name]
+            set target $::env(_SDF_SAVE_DIR)/$::env(DESIGN_NAME)__$corner_name.sdf
+            write_sdf -include_typ -divider . -corner $corner_name $target
+        }
+    }
+}
+
+proc write_libs {} {
+    if { [info exists ::env(_LIB_SAVE_DIR)] } {
+        puts "Removing Clock latencies before writing libs…"
+        # This is to avoid OpenSTA writing a context-dependent timing model
+        set_clock_latency -source -max 0 [all_clocks]
+        set_clock_latency -source -min 0 [all_clocks]
+        set corners [sta::corners]
+        puts "Writing timing models for all corners…"
+        foreach corner $corners {
+            set corner_name [$corner name]
+            set target $::env(_LIB_SAVE_DIR)/$::env(DESIGN_NAME)__$corner_name.lib
+            puts "Writing timing models for the $corner_name corner to $target…"
+            write_timing_model -corner $corner_name $target
+        }
+    }
+}
+
+proc max {a b} {
+    if { $a > $b } {
+        return $a
+    } else {
+        return $b
+    }
+}
+
+set ::metric_count 0
+set ::metrics_file ""
+if { [namespace exists utl] } {
+    proc write_metric_str {metric value} {
+        puts "Writing metric $metric: $value"
+        utl::metric $metric $value
+    }
+    proc write_metric_int {metric value} {
+        puts "Writing metric $metric: $value"
+        utl::metric_int $metric $value
+    }
+    proc write_metric_num {metric value} {
+        puts "Writing metric $metric: $value"
+        utl::metric_float $metric $value
+    }
+} else {
+    proc write_metric_num {metric value} {
+        if { $value == 1e30 } {
+            set value inf
+        } elseif { $value == -1e30 } {
+            set value -inf
+        }
+        puts "%OL_METRIC_F $metric $value"
+    }
+    proc write_metric_int {metric value} {
+        puts "%OL_METRIC_I $metric $value"
+    }
+    proc write_metric_str {metric value} {
+        puts "%OL_METRIC $metric $value"
+    }
+}

librelane/scripts/openroad/common/pdn_cfg.tcl

@@ -0,0 +1,135 @@
+# Copyright 2020-2022 Efabless Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+source $::env(SCRIPTS_DIR)/openroad/common/set_global_connections.tcl
+set_global_connections
+
+set secondary []
+foreach vdd $::env(VDD_NETS) gnd $::env(GND_NETS) {
+    if { $vdd != $::env(VDD_NET)} {
+        lappend secondary $vdd
+
+        set db_net [[ord::get_db_block] findNet $vdd]
+        if {$db_net == "NULL"} {
+            set net [odb::dbNet_create [ord::get_db_block] $vdd]
+            $net setSpecial
+            $net setSigType "POWER"
+        }
+    }
+
+    if { $gnd != $::env(GND_NET)} {
+        lappend secondary $gnd
+
+        set db_net [[ord::get_db_block] findNet $gnd]
+        if {$db_net == "NULL"} {
+            set net [odb::dbNet_create [ord::get_db_block] $gnd]
+            $net setSpecial
+            $net setSigType "GROUND"
+        }
+    }
+}
+
+set_voltage_domain -name CORE -power $::env(VDD_NET) -ground $::env(GND_NET) \
+    -secondary_power $secondary
+
+if { $::env(FP_PDN_MULTILAYER) == 1 } {
+    define_pdn_grid \
+        -name stdcell_grid \
+        -starts_with POWER \
+        -voltage_domain CORE \
+        -pins "$::env(FP_PDN_VERTICAL_LAYER) $::env(FP_PDN_HORIZONTAL_LAYER)"
+
+    add_pdn_stripe \
+        -grid stdcell_grid \
+        -layer $::env(FP_PDN_VERTICAL_LAYER) \
+        -width $::env(FP_PDN_VWIDTH) \
+        -pitch $::env(FP_PDN_VPITCH) \
+        -offset $::env(FP_PDN_VOFFSET) \
+        -spacing $::env(FP_PDN_VSPACING) \
+        -starts_with POWER -extend_to_core_ring
+
+    add_pdn_stripe \
+        -grid stdcell_grid \
+        -layer $::env(FP_PDN_HORIZONTAL_LAYER) \
+        -width $::env(FP_PDN_HWIDTH) \
+        -pitch $::env(FP_PDN_HPITCH) \
+        -offset $::env(FP_PDN_HOFFSET) \
+        -spacing $::env(FP_PDN_HSPACING) \
+        -starts_with POWER -extend_to_core_ring
+
+    add_pdn_connect \
+        -grid stdcell_grid \
+        -layers "$::env(FP_PDN_VERTICAL_LAYER) $::env(FP_PDN_HORIZONTAL_LAYER)"
+} else {
+    define_pdn_grid \
+        -name stdcell_grid \
+        -starts_with POWER \
+        -voltage_domain CORE \
+        -pins $::env(FP_PDN_VERTICAL_LAYER)
+
+    add_pdn_stripe \
+        -grid stdcell_grid \
+        -layer $::env(FP_PDN_VERTICAL_LAYER) \
+        -width $::env(FP_PDN_VWIDTH) \
+        -pitch $::env(FP_PDN_VPITCH) \
+        -offset $::env(FP_PDN_VOFFSET) \
+        -spacing $::env(FP_PDN_VSPACING) \
+        -starts_with POWER -extend_to_core_ring
+}
+
+# Adds the standard cell rails if enabled.
+if { $::env(FP_PDN_ENABLE_RAILS) == 1 } {
+    add_pdn_stripe \
+        -grid stdcell_grid \
+        -layer $::env(FP_PDN_RAIL_LAYER) \
+        -width $::env(FP_PDN_RAIL_WIDTH) \
+        -followpins \
+        -starts_with POWER
+
+    add_pdn_connect \
+        -grid stdcell_grid \
+        -layers "$::env(FP_PDN_RAIL_LAYER) $::env(FP_PDN_VERTICAL_LAYER)"
+}
+
+
+# Adds the core ring if enabled.
+if { $::env(FP_PDN_CORE_RING) == 1 } {
+    if { $::env(FP_PDN_MULTILAYER) == 1 } {
+        add_pdn_ring \
+            -grid stdcell_grid \
+            -layers "$::env(FP_PDN_VERTICAL_LAYER) $::env(FP_PDN_HORIZONTAL_LAYER)" \
+            -widths "$::env(FP_PDN_CORE_RING_VWIDTH) $::env(FP_PDN_CORE_RING_HWIDTH)" \
+            -spacings "$::env(FP_PDN_CORE_RING_VSPACING) $::env(FP_PDN_CORE_RING_HSPACING)" \
+            -core_offset "$::env(FP_PDN_CORE_RING_VOFFSET) $::env(FP_PDN_CORE_RING_HOFFSET)"
+    } else {
+        throw APPLICATION "FP_PDN_CORE_RING cannot be used when FP_PDN_MULTILAYER is set to false."
+        # add_pdn_ring \
+        #     -grid stdcell_grid \
+        #     -layers "$::env(FP_PDN_VERTICAL_LAYER)" \
+        #     -widths "$::env(FP_PDN_CORE_RING_VWIDTH)" \
+        #     -spacings "$::env(FP_PDN_CORE_RING_VSPACING)" \
+        #     -core_offset "$::env(FP_PDN_CORE_RING_VOFFSET)"
+    }
+}
+
+define_pdn_grid \
+    -macro \
+    -default \
+    -name macro \
+    -starts_with POWER \
+    -halo "$::env(FP_PDN_HORIZONTAL_HALO) $::env(FP_PDN_VERTICAL_HALO)"
+
+add_pdn_connect \
+    -grid macro \
+    -layers "$::env(FP_PDN_VERTICAL_LAYER) $::env(FP_PDN_HORIZONTAL_LAYER)"