OpenRAM/technology/sky130/custom/sky130_dummy_array.py

#!/usr/bin/env python3
# See LICENSE for licensing information.
#
# Copyright (c) 2016-2023 Regents of the University of California
# All rights reserved.
#

from openram.base import geometry
from openram.sram_factory import factory
from openram.tech import layer
from openram import OPTS
from .sky130_bitcell_base_array import sky130_bitcell_base_array
from openram.modules import dummy_array
from openram.modules import pattern
from math import ceil

class sky130_dummy_array(dummy_array, sky130_bitcell_base_array):
    """
    Generate a dummy row/column for the replica array.
    """
    def __init__(self, rows, cols, column_offset=0, row_offset=0 ,mirror=0, location="", name=""):
        super().__init__(rows=rows, cols=cols, column_offset=column_offset, name=name)

    def add_modules(self):
        """ Add the modules used in this design """
        self.dummy_cell = factory.create(module_type=OPTS.dummy_bitcell, version="opt1")
        self.dummy_cella = factory.create(module_type=OPTS.dummy_bitcell, version="opt1a")
        
        self.strap = factory.create(module_type="internal", version="wlstrap")
        self.strap_p = factory.create(module_type="internal", version="wlstrap_p")
        self.strapa = factory.create(module_type="internal", version="wlstrapa")
        self.strapa_p = factory.create(module_type="internal", version="wlstrapa_p")
        self.cell = factory.create(module_type=OPTS.bitcell, version="opt1")

    def create_instances(self):
        """ Create the module instances used in this design """
        # this code needs to use connect_array_raw() to make dummy columns correctly, but single port shouldn't need these since there are dedicated cap cells
        self.all_inst={}
        self.cell_inst={}
        
        bit_row_opt1 = [geometry.instance("00_opt1", mod=self.dummy_cell, is_bitcell=True, mirror='MX')] \
                     + [geometry.instance("01_strap", mod=self.strap, is_bitcell=False, mirror='MX')]\
                     + [geometry.instance("02_opt1", mod=self.dummy_cell, is_bitcell=True, mirror='XY')] \
                     + [geometry.instance("03_strap_p", mod=self.strap_p, is_bitcell=False, mirror='MX')]
  
        bit_row_opt1a = [geometry.instance("10_opt1a", mod=self.dummy_cella, is_bitcell=True, mirror='')] \
                      + [geometry.instance("11_strapa", mod=self.strapa, is_bitcell=False, mirror='')] \
                      + [geometry.instance("12_opt1a", mod=self.dummy_cella, is_bitcell=True, mirror='MY')] \
                      + [geometry.instance("13_strapa_p", mod=self.strapa_p, is_bitcell=False, mirror='')]

       
        bit_block = []
        if(self.row_offset % 2 == 0):
            next_row = 1
        else:
            next_row = 0
        
        for i in range(self.row_size):
            if next_row == 0:
                pattern.append_row_to_block(bit_block, bit_row_opt1)
                next_row = 1
            else:
                pattern.append_row_to_block(bit_block, bit_row_opt1a)
                next_row = 0

        for row in bit_block:
            row = pattern.rotate_list(row, self.column_offset * 2)

        self.pattern = pattern(self, "bitcell_array", bit_block, num_rows=self.row_size, num_cols=self.column_size, num_cores_x=ceil(self.column_size/2), num_cores_y=ceil(self.row_size/2), name_template="dummy_bit_r{0}_c{1}")
        self.pattern.connect_array()