mirror of
https://github.com/RTimothyEdwards/magic.git
synced 2026-08-29 17:39:28 +02:00
Tim Edwards
a8c3117020
"cif *hier write disable" and "cif *array write disable" commands for a specific cell def and its descendents. The revision ensures that all descendents apply the override. The "cif write" command uses a stack instead of recursion, which makes it difficult to apply the same method. Currently the method only works for the "gds write" command, and implementing the feature for "cif write" is deemed not worth the effort.
261 lines
12 KiB
HTML
261 lines
12 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<STYLE type="text/css">
|
|
H1 {color: black }
|
|
H2 {color: maroon }
|
|
H3 {color: #007090 }
|
|
A.head:link {color: #0060a0 }
|
|
A.head:visited {color: #3040c0 }
|
|
A.head:active {color: white }
|
|
A.head:hover {color: yellow }
|
|
A.red:link {color: red }
|
|
A.red:visited {color: maroon }
|
|
A.red:active {color: yellow }
|
|
</STYLE>
|
|
</HEAD>
|
|
<TITLE>Magic-7.3 Command Reference</TITLE>
|
|
<BODY BACKGROUND=graphics/blpaper.gif>
|
|
<H1> <IMG SRC=graphics/magic_title8_2.png ALT="Magic VLSI Layout Tool Version 8.2">
|
|
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
|
|
|
|
<H2>cif</H2>
|
|
<HR>
|
|
Read CIF input or generate CIF output.
|
|
<HR>
|
|
|
|
<H3>Usage:</H3>
|
|
<BLOCKQUOTE>
|
|
<B>cif</B> [<I>option</I>] <BR><BR>
|
|
<BLOCKQUOTE>
|
|
where <I>option</I> is one of the following:
|
|
<DL>
|
|
<DT> <B>help</B>
|
|
<DD> Print usage information
|
|
<DT> <B>arealabels</B> [<B>yes</B>|<B>no</B>]
|
|
<DD> Enable/disable use of the CIF area label extension. The
|
|
default is "yes". Normally there is no reason not to
|
|
do this.
|
|
<DT> [<B>list</B>] <B>coverage</B> <I>layer</I> [<B>box</B>]
|
|
<DD> Report the coverage of the indicated CIF layer within the
|
|
bounds of the current edit cell. This is useful for
|
|
fabrication processes that require a minimum amount of
|
|
coverage for specific layers (usually the metal routing
|
|
layers). With option <B>list</B> in front, return only
|
|
the coverage value, as a decimal. Otherwise, the value
|
|
is returned as a percentage, with additional diagnostic
|
|
information about the area analyzed. <P>
|
|
With option "<B>box</B>", report the density inside the
|
|
cursor box area only.
|
|
<DT> <B>idcell</B> [<B>yes</B>|<B>no</B>]
|
|
<DD> Enable/disable use of the CIF cell ID extension. The
|
|
default is "yes". Normally there is no reason not to
|
|
do this.
|
|
<DT> <B>scale</B> <B>in</B>|<B>out</B>
|
|
<DD> Report the number of microns per internal unit for
|
|
the current style. If "<B>in</B>" is specified,
|
|
the value is reported for the current CIF/GDS input
|
|
style. If "<B>out</B>" is specified, the value is
|
|
reported for the current CIF/GDS output style. <P>
|
|
<I>Warning:</I> For a long time (prior to magic 8.0.180),
|
|
this function was
|
|
"<B>cif lambda in</B>|<B>out</B>" and claimed to
|
|
return the number of microns per lambda. For
|
|
backwards compatibility, this syntax is retained,
|
|
but its use is discouraged.
|
|
<DT> <B>limit</B> [<I>value</I>]
|
|
<DD> Limit the amount of internal grid subdivision to the
|
|
indicated value (which is dimensionless, the ratio
|
|
of the maximum subdivision to the current lambda
|
|
value). If no <I>value</I> is given, the current
|
|
limit is reported. By default, the value is set to
|
|
100, as grid subdivision smaller than this amount
|
|
can result in integer overflow on subsequent CIF or
|
|
GDS output.
|
|
<DT> <B>rescale</B> [<B>yes</B>|<B>no</B>]
|
|
<DD> Allow or disallow internal grid subdivision while reading
|
|
CIF input. Default is "yes". Normally, one wants to allow
|
|
rescaling to ensure that the CIF is displayed exactly as it
|
|
is in the input file. Occasionally, however, the CIF input
|
|
is on a very fine scale, such as nanometers, and it is
|
|
preferable to snap the input to lambda boundaries rather
|
|
than to subsplit the internal grid to such a fine value.
|
|
The <B>limit</B> option may also be used to limit grid
|
|
subdivision to a minimum value (see above).
|
|
<DT> <B>drccheck</B> [<B>yes</B>|<B>no</B>]
|
|
<DD> (Introduced in Magic version 8.0.176) Set to "yes" by
|
|
default, causing all cells in the input file to be
|
|
marked as not checked by DRC as they are input. Set this
|
|
to "no" to force magic to treat the CIF cells as "known
|
|
DRC clean".
|
|
<DT> <B>warning</B> [<I>option</I>]
|
|
<DD> Set warning information level. "<I>option</I>" may be one
|
|
of the following:
|
|
<DL>
|
|
<DT><B>default</B>
|
|
<DD> The default setting is equivalent to all the other
|
|
options (<B>align</B>, <B>limit</B>, <B>redirect</B>,
|
|
and <B>none</B>) being disabled.
|
|
<DT><B>align</B>
|
|
<DD> Generate warnings during a "<B>cif see</B>" command
|
|
if the alignment of geometry is on fractional lambda.
|
|
Normally, magic allows contacts to be drawn at
|
|
half-lambda positions. If this violates DRC requirements
|
|
for the minimum output grid, this warning setting can be
|
|
used to detect such violations.
|
|
<DT><B>limit</B>
|
|
<DD> Limit warnings to the first 100 warnings or errors only.
|
|
<DT><B>redirect</B> [<I>file</I>]
|
|
<DD> Redirect all warnings to an output file named <I>file</I>.
|
|
If <I>file</I> is not given, then redirection is disabled.
|
|
<DT><B>none</B>
|
|
<DD> Do not produce any warning messages on CIF input.
|
|
</DL>
|
|
<DT> <B>polygon subcells</B> [<B>yes</B>|<B>no</B>]
|
|
<DD> Put non-Manhattan polygons into subcells. Default is "no".
|
|
Normally this option is not needed. However, input layout
|
|
that defines a number of angled wires, particularly those
|
|
that are closely spaced, can cause <B>magic</B> to generate
|
|
literally millions of internal tiles. This tends to be
|
|
true in particular for corner cells in padframes for deep
|
|
submicron feature sizes, where the angled corners are
|
|
required to meet the DRC specification. When set to "yes",
|
|
each polygon encountered in the CIF input is placed in its
|
|
own uniquely-named subcell. This prevents interations with
|
|
other polygons on the same plane and so reduces tile splitting.
|
|
<DT> <B>paint</B> <I>cif_layers</I> <I>magic_layer</I> [<I>cellname</I>]
|
|
<DD> Generate the CIF layer(s) specified by <I>cif_layers</I>,
|
|
then import them into the Magic database as layer
|
|
<I>magic_layer</I>. If <I>cellname</I> is specified, then
|
|
the paint is generated in that cell (which will be created,
|
|
if it does not already exist). Otherwise, paint is generated
|
|
directly in the edit cell. This is a very useful function,
|
|
as it allows the automatic generation of layout from boolean
|
|
operations. Principal uses are to auto-generate fill
|
|
patterns, auto-generate obstruction geometry in a standard
|
|
cell, to automatically place substrate and well contacts
|
|
into a standard-cell array, and so forth.
|
|
<DT> <B>see</B> <I>layers</I>
|
|
<DD> View the CIF/GDS output layers in the comma-separated list
|
|
<I>layers</I> as feedback entries on the layout. This is
|
|
useful for determining what the actual foundry layer types
|
|
are doing as a result of the boolean operations in the
|
|
CIF/GDS output style. Most useful for debugging technology
|
|
file CIF/GDS output style sections, or tracing DRC error
|
|
reports from sources other than <B>magic</B>. CIF output
|
|
is computed and feedback is shown only inside the cursor
|
|
box area.
|
|
<CENTER>
|
|
<IMG SRC=graphics/cif_see.gif> <BR>
|
|
<I>Figure 1. Command <B>cif see CSP</B> shows the P+
|
|
implant layer surrounding the P diffusion regions within
|
|
the cursor box area.</I>
|
|
</CENTER>
|
|
<DT> <B>statistics</B>
|
|
<DD> Print statistics from the CIF generator, including tile
|
|
operations, rectangles output, and interactions between
|
|
cells. Not especially useful to the typical end-user.
|
|
<DT> <B>prefix</B> [<I>path</I>]
|
|
<DD> Prepend the path name <I>path</I> to cell names in the
|
|
CIF output. If no <I>path</I> is specified, reports the
|
|
existing path name.
|
|
<DT> [<B>list|listall</B>] <B>istyle</B> [<I>style</I>]
|
|
<DD> Set the current input style to <I>style</I>. If no
|
|
<I>style</I> is specified, returns the current input
|
|
style. To get a list of all available input styles
|
|
in the current technology, use the <B>listall
|
|
istyle</B> option. The <B>list istyle</B> option
|
|
returns the current style name as a Tcl result.
|
|
<DT> [<B>list|listall</B>] <B>ostyle</B> [<I>style</I>]
|
|
<DD> Set the current output style to <I>style</I>. If no
|
|
<I>style</I> is specified, returns the current output
|
|
style. To get a list of all available output styles
|
|
in the current technology, use the <B>listall
|
|
ostyle</B> option. The <B>list ostyle</B> option
|
|
returns the current style name as a Tcl result.
|
|
<DT> <B>flat</B> <I>file</I>
|
|
<DD> Output CIF format to "<I>file</I>" for the window's root
|
|
cell, flattening the hierarchy prior to output.
|
|
<DT> <B>read</B> <I>file</I>
|
|
<DD> Read CIF format from file <I>file</I> into the edit cell.
|
|
If <I>file</I> does not have a file extension, then <B>magic</B>
|
|
searches for a file named <I>file</I> or <I>file</I>.cif.
|
|
<DT> <B>write</B> <I>file</I>
|
|
<DD> Output CIF format to "<I>file</I>" for the window's root cell.
|
|
</DL>
|
|
</BLOCKQUOTE>
|
|
<BLOCKQUOTE>
|
|
<BR>
|
|
"Wizard" options: Where <I>option</I> is one of the following:
|
|
<BR>
|
|
<DL>
|
|
<DT> <B>*hier</B> <I>layer</I>
|
|
<DD> This option is like "<B>cif see</B>" but shows the layers
|
|
that are generated as the result of hierarchical interactions
|
|
between subcells (not including interactions between components
|
|
of a subcell array; see below).
|
|
<DT> <B>*array</B> <I>layer</I>
|
|
<DD> This option is like "<B>cif see</B>" but shows the layers
|
|
that are generated as the result of hierarchical interactions
|
|
between components of subcell arrays.
|
|
<DT> <B>*hier write</B> [ <B>enable</B> | <B>disable</B> ]
|
|
<DD> This sets a global option that enables (default) or disables
|
|
the generation of output CIF or GDS layers due to interaction
|
|
between subcells (not including inter-array interactions;
|
|
see below). For large standard cell layouts where the
|
|
standard cells are known to abut properly without causing
|
|
spacing or overlap errors, disabling hierarchical generation
|
|
can greatly reduce the amount of time needed to generate
|
|
output. Defining the property <B>CIFhier</B> inside a cell
|
|
will override the use of <B>*hier write disable</B> and
|
|
force hierarchical output for that cell and its descendents.
|
|
<DT> <B>*array write</B> [ <B>enable</B> | <B>disable</B> ]
|
|
<DD> This sets a global option that enables (default) or disables
|
|
the generation of output CIF or GDS layers due to interaction
|
|
between components of subcell arrays. If cells are known to
|
|
abut properly without generating spacing errors between them,
|
|
disabling hierarchical generation can greatly reduce the
|
|
amount of time needed to generate output.
|
|
Defining the property <B>CIFhier</B> inside a cell
|
|
will override the use of <B>*array write disable</B> and
|
|
force hierarchical output for that cell and its descendents.
|
|
</DL>
|
|
</BLOCKQUOTE>
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>Summary:</H3>
|
|
<BLOCKQUOTE>
|
|
The <B>cif</B> command reads CIF input or produces CIF input/output
|
|
("Caltech Intermediate Format", as described in Mead & Conway),
|
|
or sets various parameters affecting the CIF (and GDS) input and
|
|
output. Certain <B>cif</B> command options also affect GDS input
|
|
and output. <P>
|
|
|
|
If no option is given, a CIF file is produced for the root cell,
|
|
with the default name of the root cell definition and the
|
|
filename extension ".cif". <P>
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>Implementation Notes:</H3>
|
|
<BLOCKQUOTE>
|
|
<B>cif</B> is implemented as a built-in function in <B>magic</B>.
|
|
Options <B>list</B> and <B>listall</B> cause output to be
|
|
returned as a Tcl result, rather than printed to stdout (the
|
|
console).
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>See Also:</H3>
|
|
<BLOCKQUOTE>
|
|
<A HREF=gds.html><B>gds</B> (<B>calma</B>)</A> <BR>
|
|
<A HREF=property.html><B>property</B></A> (property "CIFhier")<BR>
|
|
</BLOCKQUOTE>
|
|
|
|
<P><IMG SRC=graphics/line1.gif><P>
|
|
<TABLE BORDER=0>
|
|
<TR>
|
|
<TD> <A HREF=commands.html>Return to command index</A>
|
|
</TR>
|
|
</TABLE>
|
|
<P><I>Last updated:</I> February 8, 2021 at 11:12am <P>
|
|
</BODY>
|
|
</HTML>
|