XSLS(1ICD)

NAME
xsls, xspice, xedifnet - extract an SLS, SPICE or EDIF network description out of the database

SYNOPSIS
xsls [-fhirv] cell
xspice [-afhivElmnpuxy -z name] cell
xedifnet [-efhiv] cell

OPTIONS

-f  send output to a file cell.sls (for SLS output) a file cell.spc (for SPICE output), a file cell.esp (for ESPICE output), or a file cell.edif (for EDIF output), instead of to stdout.

-h  also extract all local sub-cells.

-i  when option -h is used, also extract all imported sub-cells.

-v  enable verbose mode.

The following option is used for SLS circuit descriptions only.

-r  do not generate extern network definitions for sub-cells that are not retrieved.

The following options are used for SPICE circuit descriptions only.

-E  extract an ESPICE circuit description.

-a  use names for node and terminal references instead of only numbers.

-l  generate a name list that translates database names of nodes into corresponding numbers of nodes as used in the circuit description.

-m  include model definitions for devices in the output file.

-n  always add terminals for n-bulk connections.

-p  always add terminals for p-bulk connections.

-u  do not automatically add terminals for bulk connections.

-x  use node number = 0 for nodes whose name start with "gnd" or "GND".

-y  the same for node whose names start with "vss" or "VSS".

-z prefix
    the same for nodes whose name start with prefix.

The following option is used for EDIF circuit descriptions only.

-e  expand name arrays into single names.

DESCRIPTION
Xsls, xspice and xedifnet are programs to respectively extract an SLS circuit description, a SPICE circuit description or an EDIF netlist description out of the database. Default, only a circuit description of the cell itself is extracted and no sub-cells are extracted. When using the option -h the program will also extract all (local) sub-cells that are not a function (see "SLS: Switch-Level Simulator User's Manual") or a device.

Whether or not a cell is a device is determined by (1) a set of built-in device names: "res" for resistor, "cap" for capacitor, "nenh" for an n-enhancement transistor, "penh" for an p-enhancement transistor and "ndep" for a n-depletion transistor, (2) the use of the program putdevmod(1ICD) (see the manual page of this program), or (3) - optionally and for SPICE circuit descriptions only - by the contents of a file "spice_prim". The syntax of the file "spice_prim" is defined as follows: Each line contains (1) the name of the cell, and (2) a letter that specifies the first letter for instance names for that cell. E.g: "pnp q" specifies that cell pnp is a primitive cell for SPICE, and that each instance name that is generated for that cell should start with the letter 'q'. It is however recommanded to use to program putdevmod instead of the file "spice_prim" to specify whether or not a cell is a device.

When extracting SPICE circuit descriptions, the program xspice will automatically determine if n-bulk and/or p-bulk terminals should be added. This is determined from the bulk voltages that are required for the different devices that are part of the circuit and, under normal circumstances, comes down to the fact that for circuits containing n-enhancement and depletion transistors n-bulk connections are added, and that for circuits containing p-enhancement transistors (also) p-bulk connections are added.

When using the option -m xspice will automatically add model descriptions to the network for the devices that are part the network. These model descriptions are searched at the following places. First the process library directory is searched for a file spicemod(3ICD). If this file is present it will added at the end of the network description. Second, the program will search for model descriptions that have been added to the database with the use of the program putdevmod. For all devices that occur in the network and that have a model description stored in the database, this model description will added to the end of the network. Further, when using the -m option, the program will automatically generate an n-bulk and/or p-bulk voltage source if required (this is determined from the bulk terminals that are added).

EXAMPLES
$ xsls -h latch

$ xspice -fhmx invert

AUTHOR
A.J. van Genderen

FILES
cell.sls	(opt.) output file
cell.spc	(opt.) output file
cell.esp	(opt.) output file
cell.edif	(opt.) output file
spice_prim	(opt.) input file

SEE ALSO
sls_mkdb(1ICD),
putdevmod(1ICD).