mirror of https://github.com/VLSIDA/OpenRAM.git
260 lines
12 KiB
Python
260 lines
12 KiB
Python
# See LICENSE for licensing information.
|
|
#
|
|
# Copyright (c) 2016-2019 Regents of the University of California and The Board
|
|
# of Regents for the Oklahoma Agricultural and Mechanical College
|
|
# (acting for and on behalf of Oklahoma State University)
|
|
# All rights reserved.
|
|
#
|
|
import hierarchy_design
|
|
import debug
|
|
from tech import *
|
|
from vector import vector
|
|
|
|
|
|
class contact(hierarchy_design.hierarchy_design):
|
|
"""
|
|
Object for a contact shape with its conductor enclosures. Creates
|
|
a contact array minimum active or poly enclosure and metal1
|
|
enclosure. This class has enclosure on two or four sides of the
|
|
contact. The direction specifies whether the first and second
|
|
layer have asymmetric extension in the H or V direction.
|
|
|
|
The well/implant_type is an option to add a select/implant layer
|
|
enclosing the contact. This is necessary to import layouts into
|
|
Magic which requires the select to be in the same GDS hierarchy as
|
|
the contact.
|
|
|
|
"""
|
|
|
|
def __init__(self, layer_stack, dimensions=(1, 1), directions=("V", "V"),
|
|
implant_type=None, well_type=None, name=""):
|
|
# This will ignore the name parameter since
|
|
# we can guarantee a unique name here
|
|
|
|
hierarchy_design.hierarchy_design.__init__(self, name)
|
|
debug.info(4, "create contact object {0}".format(name))
|
|
self.add_comment("layers: {0}".format(layer_stack))
|
|
self.add_comment("dimensions: {0}".format(dimensions))
|
|
if implant_type or well_type:
|
|
self.add_comment("implant type: {}\n".format(implant_type))
|
|
self.add_comment("well_type: {}\n".format(well_type))
|
|
|
|
self.layer_stack = layer_stack
|
|
self.dimensions = dimensions
|
|
self.directions = directions
|
|
self.offset = vector(0, 0)
|
|
self.implant_type = implant_type
|
|
self.well_type = well_type
|
|
# Module does not have pins, but has empty pin list.
|
|
self.pins = []
|
|
self.create_layout()
|
|
|
|
def create_layout(self):
|
|
|
|
self.setup_layers()
|
|
self.setup_layout_constants()
|
|
self.create_contact_array()
|
|
self.create_first_layer_enclosure()
|
|
self.create_second_layer_enclosure()
|
|
self.create_nitride_cut_enclosure()
|
|
|
|
self.height = max(obj.offset.y + obj.height for obj in self.objs)
|
|
self.width = max(obj.offset.x + obj.width for obj in self.objs)
|
|
|
|
# Do not include the select layer in the height/width
|
|
if self.implant_type and self.well_type:
|
|
self.create_implant_well_enclosures()
|
|
elif self.implant_type or self.well_type:
|
|
debug.error(-1, "Must define both implant and well type or none at all.")
|
|
|
|
def setup_layers(self):
|
|
""" Locally assign the layer names. """
|
|
|
|
(first_layer, via_layer, second_layer) = self.layer_stack
|
|
self.first_layer_name = first_layer
|
|
self.second_layer_name = second_layer
|
|
|
|
# Contacts will have unique per first layer
|
|
if via_layer in layer.keys():
|
|
self.via_layer_name = via_layer
|
|
elif via_layer == "contact":
|
|
if first_layer in ("active", "poly"):
|
|
self.via_layer_name = first_layer + "_" + via_layer
|
|
elif second_layer in ("active", "poly"):
|
|
self.via_layer_name = second_layer + "_" + via_layer
|
|
else:
|
|
debug.error("Invalid via layer {}".format(via_layer), -1)
|
|
else:
|
|
debug.error("Invalid via layer {}".format(via_layer), -1)
|
|
|
|
|
|
|
|
def setup_layout_constants(self):
|
|
""" Determine the design rules for the enclosure layers """
|
|
|
|
self.contact_width = drc("minwidth_{0}". format(self.via_layer_name))
|
|
contact_to_contact = drc("{0}_to_{0}".format(self.via_layer_name))
|
|
self.contact_pitch = self.contact_width + contact_to_contact
|
|
|
|
self.contact_array_width = self.contact_width + (self.dimensions[0] - 1) * self.contact_pitch
|
|
self.contact_array_height = self.contact_width + (self.dimensions[1] - 1) * self.contact_pitch
|
|
|
|
# DRC rules
|
|
# The extend rule applies to asymmetric enclosures in one direction.
|
|
# The enclosure rule applies to symmetric enclosure component.
|
|
|
|
first_layer_minwidth = drc("minwidth_{0}".format(self.first_layer_name))
|
|
first_layer_enclosure = drc("{0}_enclosure_{1}".format(self.first_layer_name, self.via_layer_name))
|
|
first_layer_extend = drc("{0}_extend_{1}".format(self.first_layer_name, self.via_layer_name))
|
|
|
|
second_layer_minwidth = drc("minwidth_{0}".format(self.second_layer_name))
|
|
second_layer_enclosure = drc("{0}_enclosure_{1}".format(self.second_layer_name, self.via_layer_name))
|
|
second_layer_extend = drc("{0}_extend_{1}".format(self.second_layer_name, self.via_layer_name))
|
|
|
|
# In some technologies, the minimum width may be larger
|
|
# than the overlap requirement around the via, so
|
|
# check this for each dimension.
|
|
if self.directions[0] == "V":
|
|
self.first_layer_horizontal_enclosure = max(first_layer_enclosure,
|
|
(first_layer_minwidth - self.contact_array_width) / 2)
|
|
self.first_layer_vertical_enclosure = max(first_layer_extend,
|
|
(first_layer_minwidth - self.contact_array_height) / 2)
|
|
elif self.directions[0] == "H":
|
|
self.first_layer_horizontal_enclosure = max(first_layer_extend,
|
|
(first_layer_minwidth - self.contact_array_width) / 2)
|
|
self.first_layer_vertical_enclosure = max(first_layer_enclosure,
|
|
(first_layer_minwidth - self.contact_array_height) / 2)
|
|
else:
|
|
debug.error("Invalid first layer direction.", -1)
|
|
|
|
# In some technologies, the minimum width may be larger than the overlap requirement around the via, so
|
|
# check this for each dimension.
|
|
if self.directions[1] == "V":
|
|
self.second_layer_horizontal_enclosure = max(second_layer_enclosure,
|
|
(second_layer_minwidth - self.contact_array_width) / 2)
|
|
self.second_layer_vertical_enclosure = max(second_layer_extend,
|
|
(second_layer_minwidth - self.contact_array_height) / 2)
|
|
elif self.directions[1] == "H":
|
|
self.second_layer_horizontal_enclosure = max(second_layer_extend,
|
|
(second_layer_minwidth - self.contact_array_height) / 2)
|
|
self.second_layer_vertical_enclosure = max(second_layer_enclosure,
|
|
(second_layer_minwidth - self.contact_array_width) / 2)
|
|
else:
|
|
debug.error("Invalid second layer direction.", -1)
|
|
|
|
def create_contact_array(self):
|
|
""" Create the contact array at the origin"""
|
|
# offset for the via array
|
|
self.via_layer_position = vector(
|
|
max(self.first_layer_horizontal_enclosure, self.second_layer_horizontal_enclosure),
|
|
max(self.first_layer_vertical_enclosure, self.second_layer_vertical_enclosure))
|
|
|
|
for i in range(self.dimensions[1]):
|
|
offset = self.via_layer_position + vector(0, self.contact_pitch * i)
|
|
for j in range(self.dimensions[0]):
|
|
self.add_rect(layer=self.via_layer_name,
|
|
offset=offset,
|
|
width=self.contact_width,
|
|
height=self.contact_width)
|
|
offset = offset + vector(self.contact_pitch, 0)
|
|
|
|
def create_nitride_cut_enclosure(self):
|
|
""" Special layer that encloses poly contacts in some processes """
|
|
# Check if there is a special poly nitride cut layer
|
|
if "npc" not in layer.keys():
|
|
return
|
|
|
|
# Only add for poly layers
|
|
if self.first_layer_name == "poly":
|
|
self.add_rect(layer="npc",
|
|
offset=self.first_layer_position,
|
|
width=self.first_layer_width,
|
|
height=self.first_layer_height)
|
|
elif self.second_layer_name == "poly":
|
|
self.add_rect(layer="npc",
|
|
offset=self.second_layer_position,
|
|
width=self.second_layer_width,
|
|
height=self.second_layer_height)
|
|
|
|
|
|
def create_first_layer_enclosure(self):
|
|
# this is if the first and second layers are different
|
|
self.first_layer_position = vector(
|
|
max(self.second_layer_horizontal_enclosure - self.first_layer_horizontal_enclosure, 0),
|
|
max(self.second_layer_vertical_enclosure - self.first_layer_vertical_enclosure, 0))
|
|
|
|
self.first_layer_width = self.contact_array_width + 2 * self.first_layer_horizontal_enclosure
|
|
self.first_layer_height = self.contact_array_height + 2 * self.first_layer_vertical_enclosure
|
|
self.add_rect(layer=self.first_layer_name,
|
|
offset=self.first_layer_position,
|
|
width=self.first_layer_width,
|
|
height=self.first_layer_height)
|
|
|
|
def create_second_layer_enclosure(self):
|
|
# this is if the first and second layers are different
|
|
self.second_layer_position = vector(
|
|
max(self.first_layer_horizontal_enclosure - self.second_layer_horizontal_enclosure, 0),
|
|
max(self.first_layer_vertical_enclosure - self.second_layer_vertical_enclosure, 0))
|
|
|
|
self.second_layer_width = self.contact_array_width + 2 * self.second_layer_horizontal_enclosure
|
|
self.second_layer_height = self.contact_array_height + 2 * self.second_layer_vertical_enclosure
|
|
self.add_rect(layer=self.second_layer_name,
|
|
offset=self.second_layer_position,
|
|
width=self.second_layer_width,
|
|
height=self.second_layer_height)
|
|
|
|
def create_implant_well_enclosures(self):
|
|
implant_position = self.first_layer_position - [drc("implant_enclosure_active")] * 2
|
|
implant_width = self.first_layer_width + 2 * drc("implant_enclosure_active")
|
|
implant_height = self.first_layer_height + 2 * drc("implant_enclosure_active")
|
|
self.add_rect(layer="{}implant".format(self.implant_type),
|
|
offset=implant_position,
|
|
width=implant_width,
|
|
height=implant_height)
|
|
well_position = self.first_layer_position - [drc("well_enclosure_active")] * 2
|
|
well_width = self.first_layer_width + 2 * drc("well_enclosure_active")
|
|
well_height = self.first_layer_height + 2 * drc("well_enclosure_active")
|
|
self.add_rect(layer="{}well".format(self.well_type),
|
|
offset=well_position,
|
|
width=well_width,
|
|
height=well_height)
|
|
|
|
def analytical_power(self, corner, load):
|
|
""" Get total power of a module """
|
|
return self.return_power()
|
|
|
|
|
|
from sram_factory import factory
|
|
|
|
# This is not instantiated and used for calculations only.
|
|
# These are static 1x1 contacts to reuse in all the design modules.
|
|
well = factory.create(module_type="contact",
|
|
layer_stack=active_stack,
|
|
directions=("H", "V"))
|
|
active = factory.create(module_type="contact",
|
|
layer_stack=active_stack,
|
|
directions=("H", "V"))
|
|
poly = factory.create(module_type="contact",
|
|
layer_stack=poly_stack,
|
|
directions=("V", "H"))
|
|
if "li" in layer.keys():
|
|
lim1 = factory.create(module_type="contact",
|
|
layer_stack=li_stack,
|
|
directions=("V", "H"))
|
|
else:
|
|
lim1 = None
|
|
|
|
m1m2 = factory.create(module_type="contact",
|
|
layer_stack=m1_stack,
|
|
directions=("H", "V"))
|
|
m2m3 = factory.create(module_type="contact",
|
|
layer_stack=m2_stack,
|
|
directions=("V", "H"))
|
|
if "metal4" in layer.keys():
|
|
m3m4 = factory.create(module_type="contact",
|
|
layer_stack=m3_stack,
|
|
directions=("H", "V"))
|
|
else:
|
|
m3m4 = None
|
|
|