189 lines
7.6 KiB
HTML
189 lines
7.6 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-8.3 Command Reference</TITLE>
|
|
<BODY BACKGROUND=graphics/blpaper.gif>
|
|
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
|
|
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
|
|
|
|
<H2>ext2sim, exttosim</H2>
|
|
<HR>
|
|
Convert extracted file(s) to a ".sim" format file.
|
|
<HR>
|
|
|
|
<H3>Usage:</H3>
|
|
<BLOCKQUOTE>
|
|
<B>ext2sim</B> [<I>option</I>] <BR><BR>
|
|
<BLOCKQUOTE>
|
|
where <I>option</I> is one of the following:
|
|
<DL>
|
|
<DT> [<B>run</B>] [<I>runtime_options</I>]
|
|
<DD> Run exttosim on current cell, with command-line options
|
|
(see Summary, below).
|
|
<DT> <B>alias on</B>|<B>off</B>
|
|
<DD> Enable/disable alias (.al) file. This file contains all of
|
|
the node aliases (different node names that correspond to the
|
|
same node). If "off", the statements are output directly to
|
|
the .sim file. If "on", the statements are moved to the ".al"
|
|
file.
|
|
<DT> <B>labels on</B>|<B>off</B>
|
|
<DD> Enable/disable labels (.nodes) file. The labels file is used
|
|
by the extresist command.
|
|
<DT> <B>default</B>
|
|
<DD> Reset to default values
|
|
<DT> <B>format MIT</B>|<B>SU</B>|<B>LBL</B>
|
|
<DD> Set output format
|
|
<DT> <B>rthresh</B> [<I>value</I>]
|
|
<DD> Set resistance threshold value. Lumped resistances
|
|
below this value will not be written to the output. The
|
|
value is in ohms, or may be the keyword <B>infinite</B>
|
|
to prohibit writing any lumped resistances to the output.
|
|
<DT> <B>cthresh</B> [<I>value</I>]
|
|
<DD> Set capacitance threshold value. The value is in femtofarads,
|
|
or may be the keyword <B>infinite</B> to prohibit writing
|
|
any parasitic capacitances to the output.
|
|
<DT> <B>merge</B> [<I>merge_option</I>]
|
|
<DD> Merge parallel devices/transistors. The valid merge options are:
|
|
<BLOCKQUOTE>
|
|
<DL>
|
|
<DT><B>conservative</B>
|
|
<DD> Merge transistors and capacitors having the same device
|
|
type and node connections and having the same width and
|
|
length. Widths are summed in the final output for
|
|
transistors. Capacitor values are summed in the final
|
|
output.
|
|
<DT><B>aggressive</B>
|
|
<DD> Merge transistors having the same node
|
|
connections and having the same length. Widths
|
|
are summed in the final output. Merge any capacitors
|
|
having the same device type and node connections.
|
|
Capacitance is summed in the final output.
|
|
<DT><B>none</B>
|
|
<DD> Do not merge any devices.
|
|
</DL>
|
|
</BLOCKQUOTE>
|
|
<DT> <B>extresist on</B>|<B>off</B>
|
|
<DD> Incorporate output from the command <B>extresist</B> into
|
|
the final <TT>.sim</TT> file.
|
|
<DT> <B>help</B>
|
|
<DD> Print help information
|
|
</DL>
|
|
|
|
</BLOCKQUOTE>
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>Summary:</H3>
|
|
<BLOCKQUOTE>
|
|
Without options, or with the option <B>run</B>,
|
|
the <B>ext2sim</B> command converts the hierarchical extracted
|
|
netlist information produced by the <B>extract</B> command in
|
|
a series of <TT>.ext</TT> files into a flattened representation
|
|
in the <TT>.sim</TT> format, used for switch-level simulation. <P>
|
|
|
|
<I>runtime_options</I> may be passed on the command line, and
|
|
represent the original command-line options passed to the
|
|
standalone version of ext2sim. A number of the original
|
|
command-line options have been deprecated in the Tcl-based
|
|
version, and some are duplicated by other <B>ext2sim</B> options.
|
|
Valid <I>runtime_options</I> are:
|
|
<BLOCKQUOTE>
|
|
<DL>
|
|
<DT> <B>-B</B>
|
|
<DD> Don't output transistor or node attributes in the .sim file.
|
|
This option will also disable the output of information such
|
|
as the area and perimeter of source and drain diffusion and
|
|
the FET substrate.
|
|
<DT> <B>-F</B>
|
|
<DD> Don't output nodes that aren't connected to devices (floating
|
|
nodes).
|
|
<DT> <B>-t</B><I>char</I>
|
|
<DD> Trim characters from node names when writing the output file.
|
|
<I>char</I> should be either "<B>#</B>" or "<B>!</B>". The
|
|
option may be used twice if both characters require trimming.
|
|
<DT> <B>-y</B> <I>num</I>
|
|
<DD> Select the precision for outputting capacitors. The default is
|
|
1 which means that the capacitors will be printed to a precision
|
|
of 0.1 fF.
|
|
<DT> <B>-J</B> <B>hier</B>|<B>flat</B>
|
|
<DD> Select the source/drain area and perimeter extraction algorithm.
|
|
If <B>hier</B> is selected then the areas and perimeters are
|
|
extracted only within each subcell. For each device in a
|
|
subcell the area and perimeter of its source and drain within
|
|
this subcell are output. If two or more devices share a
|
|
source/drain node then the total area and perimeter will be
|
|
output in only one of them and the other will have 0. If
|
|
<B>flat</B> is selected the same rules apply, only the scope
|
|
of search for area and perimeter is the whole netlist. In
|
|
general, <B>flat</B> (which is the default) will give accurate
|
|
results (it will take into account shared sources/drains).
|
|
<DT> <B>-p</B> <I>path</I>
|
|
<DD> Search the directory location <I>path</I> for .ext format
|
|
files. This option is typically used with the "<B>extract
|
|
path</B> <I>path</I>" command, because extraction and netlist
|
|
generation are two independent steps. If this option is not
|
|
specified, then by default the .ext file is expected to be in
|
|
the same location as the corresponding .mag file, and failing
|
|
that, the search path for .ext files is the same as the search
|
|
path for .mag files.
|
|
</DL>
|
|
</BLOCKQUOTE>
|
|
|
|
With options, the command sets various parameters affecting the
|
|
output format and content. <P>
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>Implementation Notes:</H3>
|
|
<BLOCKQUOTE>
|
|
<B>ext2sim</B> is implemented as a separate loadable Tcl package,
|
|
but one which depends on the presence of the standard "tclmagic"
|
|
package. <B>magic</B> is set up with a placeholder command for
|
|
<B>ext2sim</B>, and will automatically load the Tcl package when
|
|
this command is invoked. <P>
|
|
|
|
<B>exttosim</B> is an alias for <B>ext2sim</B>, to satisfy the
|
|
grammatically anal retentive.
|
|
|
|
<B>ext2sim</B> is also implemented as a script to be run from
|
|
the shell command line, where it executes magic in batch mode
|
|
(i.e., using the <B>-dnull</B> option) and runs the ext2sim
|
|
command automatically. With this usage, the syntax is:
|
|
<BLOCKQUOTE>
|
|
<B>ext2sim</B> [ <I>magic_options</I> <B>--</B> ]
|
|
<I>ext2sim_runtime_options ext_file</I>
|
|
</BLOCKQUOTE>
|
|
The double-dash separates command options passed to magic on
|
|
startup (such as "<B>-T</B> <I>technology</I>" to specify the
|
|
technology) from those runtime options (see above) passed to
|
|
the <B>ext2sim</B> command.
|
|
</BLOCKQUOTE>
|
|
|
|
<H3>See Also:</H3>
|
|
<BLOCKQUOTE>
|
|
<A HREF=extract.html><B>extract</B></A> <BR>
|
|
<A HREF=extresist.html><B>extresist</B></A> <BR>
|
|
<A HREF=ext2spice.html><B>ext2spice</B></A> <BR>
|
|
<A HREF=irsim.html><B>irsim</B></A> <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> September 13, 2021 at 12:31pm <P>
|
|
</BODY>
|
|
</HTML>
|