librelane 2.4.0__py3-none-any.whl

librelane/scripts/openroad/common/resizer.tcl

@@ -0,0 +1,103 @@
+# Copyright 2022-2023 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.
+proc load_rsz_corners {args} {
+    set i "0"
+    set tc_key "RSZ_CORNER_$i"
+    while { [info exists ::env($tc_key)] } {
+        set corner_name [lindex $::env($tc_key) 0]
+        set corner_libs [lreplace $::env($tc_key) 0 0]
+
+        set corner($corner_name) $corner_libs
+
+        incr i
+        set tc_key "RSZ_CORNER_$i"
+    }
+
+    if { $i == "0" } {
+        puts stderr "\[WARNING\] No resizer-specific timing information read."
+        return
+    }
+
+    define_corners {*}[array name corner]
+
+    foreach corner_name [array name corner] {
+        puts "Reading timing models for corner $corner_name…"
+
+        set corner_models $corner($corner_name)
+        foreach model $corner_models {
+            puts "Reading timing library for the '$corner_name' corner at '$model'…"
+            read_liberty -corner $corner_name $model
+        }
+
+        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
+            }
+        }
+    }
+}
+
+proc set_dont_touch_objects {args} {
+    set rx $::env(RSZ_DONT_TOUCH_RX)
+    if { $rx != {^$} } {
+        set odb_nets [$::block getNets]
+        foreach net $odb_nets {
+            set net_name [odb::dbNet_getName $net]
+            if { [regexp "$rx" $net_name full] } {
+                puts "\[INFO\] Net '$net_name' matched don't touch regular expression, setting as don't touch…"
+                set_dont_touch "$net_name"
+            }
+        }
+
+        set odb_insts [$::block getInsts]
+        foreach inst $odb_insts {
+            set inst_name [odb::dbInst_getName $inst]
+            if { [regexp "$rx" $inst_name full] } {
+                puts "\[INFO\] Instance '$inst_name' matched don't touch regular expression, setting as don't touch..."
+                set_dont_touch "$inst_name"
+            }
+        }
+    }
+
+    if { [info exists ::env(RSZ_DONT_TOUCH_LIST)] } {
+        set_dont_touch $::env(RSZ_DONT_TOUCH_LIST)
+    }
+}
+
+proc unset_dont_touch_objects {args} {
+    set rx $::env(RSZ_DONT_TOUCH_RX)
+    if { $rx != {^$} } {
+        set odb_nets [$::block getNets]
+        foreach net $odb_nets {
+            set net_name [odb::dbNet_getName $net]
+            if { [regexp "$rx" $net_name full] } {
+                unset_dont_touch "$net_name"
+            }
+        }
+
+        set odb_insts [$::block getInsts]
+        foreach inst $odb_insts {
+            set inst_name [odb::dbInst_getName $inst]
+            if { [regexp "$rx" $inst_name full] } {
+                unset_dont_touch "$inst_name"
+            }
+        }
+    }
+
+    if { [info exists ::env(RSZ_DONT_TOUCH_LIST)] } {
+        unset_dont_touch $::env(RSZ_DONT_TOUCH_LIST)
+    }
+}

librelane/scripts/openroad/common/set_global_connections.tcl

@@ -0,0 +1,78 @@
+# 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.
+
+# Power nets
+proc set_global_connections {} {
+    puts "\[INFO\] Setting global connections..."
+    if { [info exists ::env(PDN_ENABLE_GLOBAL_CONNECTIONS) ] } {
+        if { $::env(PDN_ENABLE_GLOBAL_CONNECTIONS) == 1 } {
+            foreach power_pin $::env(SCL_POWER_PINS) {
+                add_global_connection \
+                    -net $::env(VDD_NET) \
+                    -inst_pattern .* \
+                    -pin_pattern $power_pin \
+                    -power
+            }
+            foreach ground_pin $::env(SCL_GROUND_PINS) {
+                add_global_connection \
+                    -net $::env(GND_NET) \
+                    -inst_pattern .* \
+                    -pin_pattern $ground_pin \
+                    -ground
+            }
+        }
+    }
+    if { $::env(PDN_CONNECT_MACROS_TO_GRID) == 1 &&
+        [info exists ::env(PDN_MACRO_CONNECTIONS)]} {
+        foreach pdn_hook $::env(PDN_MACRO_CONNECTIONS) {
+            set pdn_hook [regexp -all -inline {\S+} $pdn_hook]
+            set instance_name [lindex $pdn_hook 0]
+            set power_net [lindex $pdn_hook 1]
+            set ground_net [lindex $pdn_hook 2]
+            set power_pin [lindex $pdn_hook 3]
+            set ground_pin [lindex $pdn_hook 4]
+
+            if { $power_pin == "" || $ground_pin == "" } {
+                puts "PDN_MACRO_CONNECTIONS missing power and ground pin names"
+                exit -1
+            }
+
+            set matched 0
+            foreach cell [[ord::get_db_block] getInsts] {
+                if { [regexp "\^$instance_name\$" [$cell getName]] } {
+                    set matched 1
+                    puts "$instance_name matched with [$cell getName]"
+                }
+            }
+            if { $matched != 1 } {
+                puts "\[ERROR\] No match found for regular expression '$instance_name' defined in PDN_MACRO_CONNECTIONS."
+                exit 1
+            }
+
+            add_global_connection \
+                -net $power_net \
+                -inst_pattern $instance_name \
+                -pin_pattern $power_pin \
+                -power
+
+            add_global_connection \
+                -net $ground_net \
+                -inst_pattern $instance_name \
+                -pin_pattern $ground_pin \
+                -ground
+        }
+    }
+
+    global_connect
+}

librelane/scripts/openroad/common/set_layer_adjustments.tcl

@@ -0,0 +1,31 @@
+# Copyright 2021-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.
+set_global_routing_layer_adjustment * $::env(GRT_ADJUSTMENT)
+
+set array [split $::env(GRT_LAYER_ADJUSTMENTS) " "]
+
+set layer_names [list]
+set layers [$::tech getLayers]
+foreach layer $layers {
+    if { [$layer getRoutingLevel] >= 1 } {
+        lappend layer_names [$layer getName]
+    }
+}
+
+set i 0
+foreach adjustment $array {
+    set layer_name [lindex $layer_names $i]
+    set_global_routing_layer_adjustment $layer_name $adjustment
+    incr i
+}

librelane/scripts/openroad/common/set_power_nets.tcl

@@ -0,0 +1,30 @@
+# Copyright 2021-2023 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.
+
+if { [info exists ::env(VDD_NETS)] || [info exists ::env(GND_NETS)] } {
+    # they both must exist and be equal in length
+    # current assumption: they cannot have a common ground
+    if { ! [info exists ::env(VDD_NETS)] || ! [info exists ::env(GND_NETS)] } {
+        puts stderr "\[ERROR\] VDD_NETS and GND_NETS must *both* either be defined or undefined"
+        exit -1
+    }
+    set ::env(VDD_NET) [lindex $::env(VDD_NETS) 0]
+    set ::env(GND_NET) [lindex $::env(GND_NETS) 0]
+
+} else {
+    set ::env(VDD_NET) $::env(VDD_PIN)
+    set ::env(GND_NET) $::env(GND_PIN)
+    set ::env(VDD_NETS) $::env(VDD_PIN)
+    set ::env(GND_NETS) $::env(GND_PIN)
+}

librelane/scripts/openroad/common/set_rc.tcl

@@ -0,0 +1,75 @@
+# Copyright 2021-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.
+
+# Resistance/Capacitance Overrides
+# Via resistance
+puts "\[INFO\] Setting RC values…"
+if { [info exist ::env(VIAS_RC)] } {
+    set vias_rc [split $::env(VIAS_RC) ","]
+    foreach via_rc $vias_rc {
+        set layer_name [lindex $via_rc 0]
+        set resistance [lindex $via_rc 1]
+        set_layer_rc -via $layer_name -resistance $resistance
+    }
+}
+
+# Metal resistance and capacitence
+if { [info exist ::env(LAYERS_RC)] } {
+    set layers_rc [split $::env(LAYERS_RC) ","]
+    foreach layer_rc $layers_rc {
+        set layer_name [lindex $layer_rc 0]
+        set capacitance [lindex $layer_rc 1]
+        set resistance [lindex $layer_rc 2]
+        set_layer_rc -layer $layer_name -capacitance $capacitance -resistance $resistance
+    }
+}
+
+set layer_names [list]
+set layers [$::tech getLayers]
+set adding 0
+foreach layer $layers {
+    if { [$layer getRoutingLevel] >= 1 } {
+        set name [$layer getName]
+        if {"$::env(RT_MIN_LAYER)" == "$name"} {
+            set adding 1
+        }
+        if { $adding } {
+            lappend layer_names $name
+        }
+
+        if {"$::env(RT_MAX_LAYER)" == "$name"} {
+            set adding 0
+        }
+    }
+}
+
+set signal_wire_rc_layers $layer_names
+set clock_wire_rc_layers $layer_names
+if { [info exist ::env(SIGNAL_WIRE_RC_LAYERS)] } {
+    set signal_wire_rc_layers $::env(SIGNAL_WIRE_RC_LAYERS)
+}
+if { [info exist ::env(CLOCK_WIRE_RC_LAYERS)] } {
+    set clock_wire_rc_layers $::env(CLOCK_WIRE_RC_LAYERS)
+}
+if { [llength $signal_wire_rc_layers] > 1 } {
+    set_wire_rc -signal -layers "$signal_wire_rc_layers"
+} else {
+    set_wire_rc -signal -layer "$signal_wire_rc_layers"
+}
+
+if { [llength $clock_wire_rc_layers] > 1 } {
+    set_wire_rc -clock -layers "$clock_wire_rc_layers"
+} else {
+    set_wire_rc -clock -layer "$clock_wire_rc_layers"
+}

librelane/scripts/openroad/common/set_routing_layers.tcl

@@ -0,0 +1,30 @@
+# Copyright 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.
+
+set signal_min_layer $::env(RT_MIN_LAYER)
+set signal_max_layer $::env(RT_MAX_LAYER)
+set clock_min_layer $::env(RT_MIN_LAYER)
+set clock_max_layer $::env(RT_MAX_LAYER)
+
+if { [info exists ::env(RT_CLOCK_MIN_LAYER)]} {
+    set clock_min_layer $::env(RT_CLOCK_MIN_LAYER)
+}
+if { [info exists ::env(RT_CLOCK_MAX_LAYER)]} {
+    set clock_max_layer $::env(RT_CLOCK_MAX_LAYER)
+}
+
+puts "\[INFO\] Setting signal min routing layer to: $signal_min_layer and clock min routing layer to $clock_min_layer. "
+puts "\[INFO\] Setting signal max routing layer to: $signal_max_layer and clock max routing layer to $clock_max_layer. "
+
+set_routing_layers -signal [subst $signal_min_layer]-[subst $signal_max_layer] -clock [subst $clock_min_layer]-[subst $clock_max_layer]

librelane/scripts/openroad/cts.tcl

@@ -0,0 +1,80 @@
+# 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/io.tcl
+source $::env(SCRIPTS_DIR)/openroad/common/resizer.tcl
+
+load_rsz_corners
+read_current_odb
+
+# set rc values
+source $::env(SCRIPTS_DIR)/openroad/common/set_rc.tcl
+estimate_parasitics -placement
+
+# Clone clock tree inverters next to register loads
+# so cts does not try to buffer the inverted clocks.
+repair_clock_inverters
+
+puts "\[INFO\] Configuring cts characterization…"
+set cts_characterization_args [list]
+if { [info exists ::env(CTS_MAX_CAP)] } {
+    lappend cts_characterization_args -max_cap [expr {$::env(CTS_MAX_CAP) * 1e-12}]; # pF -> F
+}
+if { [info exists ::env(CTS_MAX_SLEW)] } {
+    lappend cts_characterization_args -max_slew [expr {$::env(CTS_MAX_SLEW) * 1e-9}]; # ns -> S
+}
+configure_cts_characterization {*}$cts_characterization_args
+
+puts "\[INFO\] Performing clock tree synthesis…"
+puts "\[INFO\] Looking for the following net(s): $::env(CLOCK_NET)"
+puts "\[INFO\] Running Clock Tree Synthesis…"
+
+set arg_list [list]
+
+lappend arg_list -buf_list $::env(CTS_CLK_BUFFERS)
+lappend arg_list -root_buf $::env(CTS_ROOT_BUFFER)
+lappend arg_list -sink_clustering_size $::env(CTS_SINK_CLUSTERING_SIZE)
+lappend arg_list -sink_clustering_max_diameter $::env(CTS_SINK_CLUSTERING_MAX_DIAMETER)
+lappend arg_list -sink_clustering_enable
+
+if { $::env(CTS_DISTANCE_BETWEEN_BUFFERS) != 0 } {
+    lappend arg_list -distance_between_buffers $::env(CTS_DISTANCE_BETWEEN_BUFFERS)
+}
+
+if { $::env(CTS_DISABLE_POST_PROCESSING) } {
+    lappend arg_list -post_cts_disable
+}
+
+clock_tree_synthesis {*}$arg_list
+
+set_propagated_clock [all_clocks]
+
+estimate_parasitics -placement
+puts "\[INFO\] Repairing long wires on clock nets…"
+# CTS leaves a long wire from the pad to the clock tree root.
+repair_clock_nets -max_wire_length $::env(CTS_CLK_MAX_WIRE_LENGTH)
+
+estimate_parasitics -placement
+write_views
+
+puts "\[INFO\] Legalizing…"
+source $::env(SCRIPTS_DIR)/openroad/common/dpl.tcl
+
+estimate_parasitics -placement
+
+
+write_views
+
+puts "%OL_CREATE_REPORT cts.rpt"
+report_cts
+puts "%OL_END_REPORT"

librelane/scripts/openroad/cut_rows.tcl

@@ -0,0 +1,24 @@
+# Copyright 2023 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/io.tcl
+read_current_odb
+
+cut_rows\
+    -endcap_master $::env(ENDCAP_CELL)\
+    -halo_width_x $::env(FP_MACRO_HORIZONTAL_HALO)\
+    -halo_width_y $::env(FP_MACRO_VERTICAL_HALO)
+
+write_views
+
+report_design_area_metrics

librelane/scripts/openroad/dpl.tcl

@@ -0,0 +1,24 @@
+# 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/io.tcl
+read_current_odb
+
+source $::env(SCRIPTS_DIR)/openroad/common/dpl.tcl
+
+check_placement -verbose
+
+write_views
+
+report_design_area_metrics
+

librelane/scripts/openroad/drt.tcl

@@ -0,0 +1,37 @@
+# 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/io.tcl
+read_current_odb
+
+set_thread_count $::env(DRT_THREADS)
+
+set min_layer $::env(RT_MIN_LAYER)
+if { [info exists ::env(DRT_MIN_LAYER)] } {
+    set min_layer $::env(DRT_MIN_LAYER)
+}
+
+set max_layer $::env(RT_MAX_LAYER)
+if { [info exists ::env(DRT_MAX_LAYER)] } {
+    set max_layer $::env(DRT_MAX_LAYER)
+}
+
+detailed_route\
+    -bottom_routing_layer $min_layer\
+    -top_routing_layer $max_layer\
+    -output_drc $::env(STEP_DIR)/$::env(DESIGN_NAME).drc\
+    -droute_end_iter $::env(DRT_OPT_ITERS)\
+    -or_seed 42\
+    -verbose 1
+
+write_views

librelane/scripts/openroad/fill.tcl

@@ -0,0 +1,30 @@
+# 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/io.tcl
+read_current_odb
+
+set fill_list [list]
+foreach {pattern} $::env(DECAP_CELL) {
+    set stripped [string map {' {}} $pattern]
+    lappend fill_list $stripped
+}
+foreach {pattern} $::env(FILL_CELL) {
+    set stripped [string map {' {}} $pattern]
+    lappend fill_list $stripped
+}
+puts $fill_list
+filler_placement $fill_list
+
+write_views
+