Ubuntu Manpage: ext2sim - convert hierarchical ext(5) extracted-circuit files to flat sim(5) files

Provided by: magic_8.3.105+ds.1-1.1_amd64

NAME

       ext2sim - convert hierarchical ext(5) extracted-circuit files to flat sim(5) files

SYNOPSIS

       ext2sim  [ -a aliasfile ] [ -l labelsfile ] [ -o simfile ] [ -A ] [ -B ] [ -F ] [ -L ] [ -t ] [ extcheck-
       options ] [ -y num ] [ -f mit|lbl|su ] [ -J hier|flat ] [ -j device:sdRclass[/subRclass]/defaultSubstrate
       ] root

DESCRIPTION

Ext2sim will convert an extracted circuit from the hierarchical ext(5) representation produced by Magic
to the flat sim(5) representation required by many simulation tools. The root of the tree to be
extracted is the file root.ext; it and all the files it references are recursively flattened. The result
is a single, flat representation of the circuit that is written to the file root.sim, a list of node
aliases written to the file root.al, and a list of the locations of all nodenames in CIF format, suitable
for plotting, to the file root.nodes. The file root.sim is suitable for use with programs such as
crystal(1), esim(1), or sim2spice(1).

The following options are recognized:

-a aliasfile
Instead of leaving node aliases in the file root.al, leave it in aliasfile.

-l labelfile
Instead of leaving a CIF file with the locations of all node names in the file root.nodes,
leave it in labelfile.

-o outfile
Instead of leaving output in the file root.sim, leave it in outfile.

-A Don't produce the aliases file.

-B 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. For compatibitlity reasons the latest version of ext2sim outputs this information as
node attributes. This option is necessary when preparing input for programs that don't know
about attributes, such as sim2spice(1) (which is actually made obsolete by ext2spice(1),
anyway), or rsim(1).

-F Don't output nodes that aren't connected to fets (floating nodes).

-L Don't produce the label file.

-tchar Trim characters from node names when writing the output file. Char should be either "#" or
"!". The option may be used twice if both characters are desired.

-f MIT|LBL|SU
Select the output format. MIT is the traditional sim(5) format. LBL is a variant of it
understood by gemini(1) which includes the substrate connection as a fourth terminal before
length and width. SU is the internal Stanford format which is described also in sim(5) and
includes areas and perimeters of fet sources, drains and substrates.

-y num Select the precision for outputting capacitors. The default is 1 which means that the
capacitors will be printed to a precision of .1 fF.

-J hier|flat
Select the source/drain area and perimeter extraction algorithm. If hier is selected then the
areas and perimeters are extracted only within each subcell. For each fet in a subcell the area
and perimeter of its source and drain within this subcell are output. If two or more fets
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 flat is selected the same rules apply only that the scope of
search for area and perimeter is the whole netlist. In general flat (which is the default) will
give accurate results (it will take into account shared sources/drains) but hier is provided
for backwards compatibility with version 6.4.5. On top of this selection you can individually
control how a terminal of a specific fet will be extracted if you put a source/drain attribute.
ext:aph makes the extraction for that specific terminal hierarchical and ext:apf makes the
extraction flat (see the magic tutorial about attaching attribute labels). Additionally to
ease extraction of bipolar transistors the gate attribute ext:aps forces the output of the
substrate area and perimeter for a specific fet (in flat mode only).

-j device:sdRclass[/subRclass]/defaultSubstrate
Gives ext2sim information about the source/drain resistance class of the fet type device. Makes
device to have sdRclass source drain resistance class, subRclass substrate (well) resistance
class and the node named defaultSubstrate as its default substrate. The defaults are
nfet:0/Gnd and pfet:1/6/Vdd which correspond to the MOSIS technology file but things might vary
in your site. Ask your local cad administrator.

The way the extraction of node area and perimeter works in magic the total area and perimeter of the
source/drain junction is summed up on a single node. That is why all the junction areas and perimeters
are summed up on a single node (this should not affect simulation results however).

Special care must be taken when the substrate of a fet is tied to a node other than the default substrate
(eg in a bootstraping charge pump). To get the correct substrate info in these cases the fet(s) with
separate wells should be in their own separate subcell with ext:aph attributes attached to their
sensitive terminals (also all the transistors which share sensitive terminals with these should be in
another subcell with the same attributes).

In addition, all of the options of extcheck(1) are accepted.

SCALING AND UNITS

       If  all  of  the .ext files in the tree read by ext2sim have the same geometrical scale (specified in the
       scale line in each .ext file), this scale is reflected through to the output, resulting in  substantially
       smaller .sim files.  Otherwise, the geometrical unit in the output .sim file is a centimicron.

       Resistance and capacitance are always output in ohms and femptofarads, respectively.

AUTHOR

       Walter Scott additions/fixes by Stefanos Sidiropoulos.

BUGS