lambdapdk 0.1.56__py3-none-any.whl → 0.2.0__py3-none-any.whl

lambdapdk/sky130/__init__.py

@@ -1,13 +1,9 @@
+from pathlib import Path
 
-import os
-import siliconcompiler
-from lambdapdk import register_data_source
+from lambdapdk import LambdaPDK
 
 
-####################################################
-# PDK Setup
-####################################################
-def setup():
+class Sky130PDK(LambdaPDK):
     '''
     The 'skywater130' Open Source PDK is a collaboration between Google and
     SkyWater Technology Foundry to provide a fully open source Process
@@ -36,88 +32,70 @@ def setup():
 
     * https://github.com/google/skywater-pdk
     '''
-
-    foundry = 'skywater'
-    process = 'skywater130'
-    rev = 'v0_0_2'
-    stackup = '5M1LI'
-
-    node = 130
-    # TODO: dummy numbers, only matter for cost estimation
-    wafersize = 300
-    hscribe = 0.1
-    vscribe = 0.1
-    edgemargin = 2
-
-    pdkdir = os.path.join('lambdapdk', 'sky130', 'base')
-
-    pdk = siliconcompiler.PDK(process, package='lambdapdk')
-    register_data_source(pdk)
-
-    # process name
-    pdk.set('pdk', process, 'foundry', foundry)
-    pdk.set('pdk', process, 'node', node)
-    pdk.set('pdk', process, 'version', rev)
-    pdk.set('pdk', process, 'stackup', stackup)
-    pdk.set('pdk', process, 'wafersize', wafersize)
-    pdk.set('pdk', process, 'edgemargin', edgemargin)
-    pdk.set('pdk', process, 'scribe', (hscribe, vscribe))
-
-    # APR Setup
-    # TODO: remove libtype
-    for tool in ('openroad', 'klayout', 'magic'):
-        for libtype in ('hd', 'hdll'):
-            pdk.set('pdk', process, 'aprtech', tool, stackup, libtype, 'lef',
-                    pdkdir + '/apr/sky130_fd_sc.tlef')
-
-    pdk.set('pdk', process, 'minlayer', stackup, 'met1')
-    pdk.set('pdk', process, 'maxlayer', stackup, 'met5')
-
-    # DRC Runsets
-    pdk.set('pdk', process, 'drc', 'runset', 'magic', stackup, 'basic',
-            pdkdir + '/setup/magic/sky130A.tech')
-
-    # LVS Runsets
-    pdk.set('pdk', process, 'lvs', 'runset', 'netgen', stackup, 'basic',
-            pdkdir + '/setup/netgen/lvs_setup.tcl')
-
-    # Layer map and display file
-    pdk.set('pdk', process, 'layermap', 'klayout', 'def', 'klayout', stackup,
-            pdkdir + '/setup/klayout/skywater130.lyt')
-    pdk.set('pdk', process, 'display', 'klayout', stackup, pdkdir + '/setup/klayout/sky130A.lyp')
-
-    # Openroad global routing grid derating
-    openroad_layer_adjustments = {
-        'li1': 1.0,
-        'met1': 0.40,
-        'met2': 0.40,
-        'met3': 0.30,
-        'met4': 0.30,
-        'met5': 0.30
-    }
-    for layer, adj in openroad_layer_adjustments.items():
-        pdk.set('pdk', process, 'var', 'openroad', f'{layer}_adjustment', stackup, str(adj))
-
-    pdk.set('pdk', process, 'var', 'openroad', 'rclayer_signal', stackup, 'met2')
-    pdk.set('pdk', process, 'var', 'openroad', 'rclayer_clock', stackup, 'met5')
-
-    pdk.set('pdk', process, 'var', 'openroad', 'pin_layer_vertical', stackup, 'met2')
-    pdk.set('pdk', process, 'var', 'openroad', 'pin_layer_horizontal', stackup, 'met3')
-
-    # Hide the 81/4 'areaid.standardc' layer by default; it puts opaque purple over most core areas.
-    pdk.set('pdk', process, 'var', 'klayout', 'hide_layers', stackup, ['areaid.standardc'])
-
-    # PEX
-    for corner in ["minimum", "typical", "maximum"]:
-        pdk.set('pdk', process, 'pexmodel', 'openroad', stackup, corner,
-                pdkdir + '/pex/openroad/' + corner + '.tcl')
-        pdk.set('pdk', process, 'pexmodel', 'openroad-openrcx', stackup, corner,
-                pdkdir + '/pex/openroad/' + corner + '.rules')
-
-    return pdk
-
-
-#########################
-if __name__ == "__main__":
-    pdk = setup()
-    pdk.write_manifest(f'{pdk.top()}.json')
+    def __init__(self):
+        super().__init__()
+        self.set_name("skywater130")
+
+        self.set_foundry("skywater")
+        self.package.set_version("v0_0_2")
+        self.set_stackup("5M1LI")
+        self.set_node(130)
+
+        pdk_path = Path("lambdapdk", "sky130", "base")
+
+        with self.active_dataroot("lambdapdk"):
+            # APR Setup
+            with self.active_fileset("views.lef"):
+                self.add_file(pdk_path / "apr" / "sky130_fd_sc.tlef", filetype="lef")
+                for tool in ('openroad', 'klayout', 'magic'):
+                    self.add_aprtechfileset(tool)
+
+            # DRC Runset
+            with self.active_fileset("magic.drc"):
+                self.add_file(pdk_path / "setup" / "magic" / "sky130A.tech", filetype="tech")
+                self.add_runsetfileset("drc", "magic", "basic")
+
+            # LVS Runset
+            with self.active_fileset("netgen.lvs"):
+                self.add_file(pdk_path / "setup" / "netgen" / "lvs_setup.tcl", filetype="tcl")
+                self.add_runsetfileset("lvs", "netgen", "basic")
+
+        self.set_aprroutinglayers(min="met1", max="met5")
+
+        # Klayout setup
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("klayout.techmap"):
+                self.add_file(pdk_path / "setup" / "klayout" / "skywater130.lyt",
+                              filetype="layermap")
+                self.add_file(pdk_path / "setup" / "klayout" / "sky130A.lyp", filetype="display")
+                self.add_layermapfileset("klayout", "def", "klayout")
+                self.add_displayfileset("klayout")
+        # Hide the 81/4 'areaid.standardc' layer by default; it puts opaque purple over most
+        # core areas.
+        self.add_klayout_hidelayers('areaid.standardc')
+
+        # OpenROAD setup
+        self.set_openroad_rclayers(signal="met3", clock="met5")
+
+        # OpenROAD global routing grid derating
+        for layer, derate in [
+                ('li1', 1.0),
+                ('met1', 0.40),
+                ('met2', 0.40),
+                ('met3', 0.30),
+                ('met4', 0.30),
+                ('met5', 0.30)]:
+            self.set_openroad_globalroutingderating(layer, derate)
+
+        self.add_openroad_pinlayers(vertical="met2", horizontal="met3")
+
+        # OpenROAD PEX
+        with self.active_dataroot("lambdapdk"):
+            for corner in ["minimum", "typical", "maximum"]:
+                with self.active_fileset(f"openroad.pex.{corner}"):
+                    self.add_file(pdk_path / "pex" / "openroad" / f"{corner}.tcl", filetype="tcl")
+                    self.add_file(pdk_path / "pex" / "openroad" / f"{corner}.rules",
+                                  filetype="openrcx")
+
+                    self.add_pexmodelfileset("openroad", corner)
+                    self.add_pexmodelfileset("openroad-openrcx", corner)

lambdapdk/sky130/libs/sky130io.py

@@ -1,53 +1,264 @@
-import os
-import siliconcompiler
-from lambdapdk import register_data_source
+from pathlib import Path
 
+from siliconcompiler import ASIC
+from lambdalib import LambalibTechLibrary
+from lambdapdk import LambdaLibrary, _LambdaPath
+from lambdapdk.sky130 import Sky130PDK
 
-def setup():
+
+class Sky130_IOLibrary(LambdaLibrary):
     '''
     Skywater130 I/O library.
     '''
-    process = 'skywater130'
-    libname = 'sky130io'
-    stackup = '5M1LI'
+    def __init__(self):
+        super().__init__()
+        self.set_name("sky130io")
+
+        self.add_asic_pdk(Sky130PDK())
+
+        path_base = Path('lambdapdk', 'sky130', 'libs', "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("models.timing.nldm"):
+                self.add_file(path_base / "nldm" / "sky130_dummy_io.lib")
+                self.add_asic_libcornerfileset("generic", "nldm")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("models.physical"):
+                self.add_file(path_base / "lef" / "sky130_ef_io.lef")
+                self.add_file(path_base / "gds" / "sky130_ef_io.gds")
+                self.add_file(path_base / "gds" / "sky130_fd_io.gds")
+                self.add_file(path_base / "gds" / "sky130_ef_io__gpiov2_pad_wrapped.gds")
+                self.add_asic_aprfileset()
+
+            with self.active_fileset("rtl"):
+                self.add_file(path_base / "verilog" / "sky130_ef_io.v")
+                self.add_file(path_base / "verilog" / "sky130_fd_io.v")
+                self.add_file(path_base / "verilog" / "sky130_ef_io__gpiov2_pad_wrapped.v")
+                self.add_file(path_base / "verilog" / "sky130_ef_io__analog_pad.v")
+
+                # TODO defines?
+
+        self.add_asic_celllist('filler', ['sky130_ef_io__com_bus_slice_1um',
+                                          'sky130_ef_io__com_bus_slice_5um',
+                                          'sky130_ef_io__com_bus_slice_10um',
+                                          'sky130_ef_io__com_bus_slice_20um'])
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("models.blackbox"):
+                self.add_file(path_base / "blackbox" / "sky130_ef_io.v")
+                self.add_file(path_base / "blackbox" / "sky130_fd_io.v")
+            self.add_yosys_blackbox_fileset("models.blackbox")
+
+
+class Sky130Lambdalib_la_ioanalog(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_ioanalog", [Sky130_IOLibrary])
+        self.set_name("sky130_la_ioanalog")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_ioanalog.v")
+
+
+class Sky130Lambdalib_la_iobidir(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iobidir", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iobidir")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iobidir.v")
+
+
+class Sky130Lambdalib_la_ioclamp(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_ioclamp", [Sky130_IOLibrary])
+        self.set_name("sky130_la_ioclamp")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_ioclamp.v")
+
+
+class Sky130Lambdalib_la_iocorner(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iocorner", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iocorner")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iocorner.v")
+
+
+class Sky130Lambdalib_la_ioinput(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_ioinput", [Sky130_IOLibrary])
+        self.set_name("sky130_la_ioinput")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_ioinput.v")
+
+
+class Sky130Lambdalib_la_iorxdiff(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iorxdiff", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iorxdiff")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iorxdiff.v")
+
+
+class Sky130Lambdalib_la_iotxdiff(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iotxdiff", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iotxdiff")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iotxdiff.v")
+
+
+class Sky130Lambdalib_la_iovdd(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovdd", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovdd")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovdd.v")
+
+
+class Sky130Lambdalib_la_iovdda(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovdda", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovdda")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovdda.v")
+
+
+class Sky130Lambdalib_la_iovddio(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovddio", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovddio")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovddio.v")
+
+
+class Sky130Lambdalib_la_iovss(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovss", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovss")
+
+        # version
+        self.package.set_version("v1")
+
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
+
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovss.v")
+
 
-    lib = siliconcompiler.Library(libname, package='lambdapdk')
-    register_data_source(lib)
+class Sky130Lambdalib_la_iovssa(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovssa", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovssa")
 
-    libdir = os.path.join('lambdapdk', 'sky130', 'libs', libname)
+        # version
+        self.package.set_version("v1")
 
-    # pdk
-    lib.set('option', 'pdk', process)
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
 
-    for corner in ['slow', 'typical', 'fast']:
-        # Only one corner provided
-        lib.set('output', corner, 'nldm', os.path.join(libdir, 'nldm', 'sky130_dummy_io.lib'))
-    lib.set('output', stackup, 'lef', os.path.join(libdir, 'lef', 'sky130_ef_io.lef'))
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovssa.v")
 
-    # Need both GDS files: ef relies on fd one
-    lib.add('output', stackup, 'gds', os.path.join(libdir, 'gds', 'sky130_ef_io.gds'))
-    lib.add('output', stackup, 'gds', os.path.join(libdir, 'gds', 'sky130_fd_io.gds'))
-    lib.add('output', stackup, 'gds', os.path.join(libdir, 'gds',
-                                                   'sky130_ef_io__gpiov2_pad_wrapped.gds'))
 
-    lib.set('asic', 'cells', 'filler', ['sky130_ef_io__com_bus_slice_1um',
-                                        'sky130_ef_io__com_bus_slice_5um',
-                                        'sky130_ef_io__com_bus_slice_10um',
-                                        'sky130_ef_io__com_bus_slice_20um'])
+class Sky130Lambdalib_la_iovssio(LambalibTechLibrary, _LambdaPath):
+    def __init__(self):
+        super().__init__("la_iovssio", [Sky130_IOLibrary])
+        self.set_name("sky130_la_iovssio")
 
-    lib.set('output', 'blackbox', 'verilog', os.path.join(libdir, 'blackbox', 'sky130_ef_io.v'))
-    lib.add('output', 'blackbox', 'verilog', os.path.join(libdir, 'blackbox', 'sky130_fd_io.v'))
+        # version
+        self.package.set_version("v1")
 
-    lambda_lib = siliconcompiler.Library(f'lambdalib_{libname}', package='lambdapdk')
-    register_data_source(lambda_lib)
-    lambda_lib.add('option', 'ydir', 'lambdapdk/sky130/libs/sky130io/lambda')
-    lambda_lib.use(lib)
-    lambda_lib.set('asic', 'macrolib', lib.design)
+        lib_path = Path("lambdapdk", "sky130", "libs", "sky130io")
 
-    return [lib, lambda_lib]
+        with self.active_dataroot("lambdapdk"):
+            with self.active_fileset("rtl"):
+                self.add_file(lib_path / "lambda" / "la_iovssio.v")
 
 
-#########################
-if __name__ == "__main__":
-    for lib in setup(siliconcompiler.Chip('<lib>')):
-        lib.write_manifest(f'{lib.top()}.json')
+class Sky130LambdaLib_IO(LambalibTechLibrary):
+    @classmethod
+    def alias(cls, project: ASIC):
+        Sky130Lambdalib_la_ioanalog.alias(project)
+        Sky130Lambdalib_la_iobidir.alias(project)
+        Sky130Lambdalib_la_ioclamp.alias(project)
+        Sky130Lambdalib_la_iocorner.alias(project)
+        Sky130Lambdalib_la_ioinput.alias(project)
+        Sky130Lambdalib_la_iorxdiff.alias(project)
+        Sky130Lambdalib_la_iotxdiff.alias(project)
+        Sky130Lambdalib_la_iovdd.alias(project)
+        Sky130Lambdalib_la_iovdda.alias(project)
+        Sky130Lambdalib_la_iovddio.alias(project)
+        Sky130Lambdalib_la_iovss.alias(project)
+        Sky130Lambdalib_la_iovssa.alias(project)
+        Sky130Lambdalib_la_iovssio.alias(project)