2017-04-25 14:41:48 +02:00
|
|
|
<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>
|
2024-01-09 22:37:00 +01:00
|
|
|
<TITLE>Magic-8.3 Command Reference</TITLE>
|
2017-04-25 14:41:48 +02:00
|
|
|
<BODY BACKGROUND=graphics/blpaper.gif>
|
2024-01-09 22:37:00 +01:00
|
|
|
<H1> <IMG SRC=graphics/magic_title8_3.png ALT="Magic VLSI Layout Tool Version 8.3">
|
2017-04-25 14:41:48 +02:00
|
|
|
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
|
|
|
|
|
|
|
|
|
|
<H2>port</H2>
|
|
|
|
|
<HR>
|
|
|
|
|
Declare a label to be a subcircuit port, or manipulate port parameters.
|
|
|
|
|
<HR>
|
|
|
|
|
|
|
|
|
|
<H3>Usage:</H3>
|
|
|
|
|
<BLOCKQUOTE>
|
2022-01-21 16:44:13 +01:00
|
|
|
<B>port</B> [<I>name</I>|<I>index</I>] <I>option</I> <BR><BR>
|
2017-04-25 14:41:48 +02:00
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
where <I>option</I> may be one of the following:
|
|
|
|
|
<DL>
|
|
|
|
|
<DT> </I>index</I> <I>directions</I>
|
|
|
|
|
<DD> Declare a label to be a port with order number
|
|
|
|
|
<I>index</I> and with allowed connection directions
|
|
|
|
|
specified by the list <I>directions</I>. This is
|
|
|
|
|
equivalent to the <B>make</B> option, except that
|
|
|
|
|
the index and direction must be specified.
|
|
|
|
|
<DT><B>class</B> [<I>type</I>]
|
|
|
|
|
<DD> Get [set] port class type (see Summary, below).
|
|
|
|
|
<DT> <B>use</B> [<I>type</I>]
|
|
|
|
|
<DD> Get [set] port use type (see Summary, below).
|
2022-01-21 16:44:13 +01:00
|
|
|
<DT> <B>shape</B> [<I>type</I>]
|
|
|
|
|
<DD> Get [set] port shape type (see Summary, below).
|
2017-04-25 14:41:48 +02:00
|
|
|
<DT> <B>index</B> [<I>number</I>]
|
|
|
|
|
<DD> Get [set] port number
|
2022-01-21 16:44:13 +01:00
|
|
|
<DT> <B>name</B> [<I>name</I>]
|
|
|
|
|
<DD> Get [set] port name. This is equivalent to <B>setlabel text</B>.
|
|
|
|
|
<DT> <B>first</B>
|
|
|
|
|
<DD> Return the first (lowest) port number used
|
|
|
|
|
<DT> <B>next</B> [<I>number</I>]
|
|
|
|
|
<DD> Return the next (higher) port number used after port <I>number</I>
|
|
|
|
|
if specified, or after the currently selected port if not specified.
|
|
|
|
|
If <I>number</I> or the currently selected port is the last port
|
|
|
|
|
number used, then this command returns the value -1.
|
|
|
|
|
<DT> <B>last</B>
|
|
|
|
|
<DD> Return the last (highest) port number used.
|
2017-04-25 14:41:48 +02:00
|
|
|
<DT> <B>equivalent</B> [<I>number</I>]
|
|
|
|
|
<DD> Make the port equivalent to the (other) port numbered
|
|
|
|
|
<I>number</I>.
|
|
|
|
|
<DT> <B>connections</B> [<I>directions</I>]
|
|
|
|
|
<DD> Get [set] port connection directions
|
|
|
|
|
<DT> <B>make</B> [</I>index</I>] [<I>directions</I>]
|
|
|
|
|
<DD> Declare a label to be a port with order number
|
|
|
|
|
<I>index</I> and with allowed connection directions
|
|
|
|
|
specified by the list <I>directions</I>. If not
|
|
|
|
|
specified, the index is set to the first unused
|
|
|
|
|
number, starting with 1, and the direction defaults
|
|
|
|
|
to the direction of the label text. That is, if the
|
|
|
|
|
label text is drawn to the right of the port, then
|
|
|
|
|
connections are allowed to the right side of the
|
|
|
|
|
port.
|
|
|
|
|
<DT> <B>remove</B>
|
|
|
|
|
<DD> Turn a port back into an ordinary label, removing
|
|
|
|
|
all of its port properties.
|
2022-01-21 16:44:13 +01:00
|
|
|
<DT> <B>renumber</B>
|
|
|
|
|
<DD> Renumber all of the (unique) ports in the edit cell by
|
|
|
|
|
alphabetical order of the port label text. This will
|
|
|
|
|
ensure that the order of ports in a SPICE netlist
|
|
|
|
|
generated by "extract" and "ext2spice" will always be
|
|
|
|
|
the same and not depend on artifacts of the way the
|
|
|
|
|
cell is extracted.
|
2017-04-25 14:41:48 +02:00
|
|
|
<DT> <B>help</B>
|
|
|
|
|
<DD> Print help information
|
|
|
|
|
</DL>
|
|
|
|
|
</BLOCKQUOTE>
|
|
|
|
|
</BLOCKQUOTE>
|
|
|
|
|
|
|
|
|
|
<H3>Summary:</H3>
|
|
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
The <B>port</B> command turns labels into ports and
|
|
|
|
|
manipulates the properties of those ports. The <B>port</B>
|
|
|
|
|
command gives <B>magic</B> some understanding of "standard
|
|
|
|
|
cells". A cell definition that contains declared ports is
|
|
|
|
|
treated specially by the <B>extract</B>, <B>ext2spice</B>,
|
|
|
|
|
<B>lef</B>, and <B>def</B> commands. All other commands
|
|
|
|
|
interpret ports as ordinary labels. <B>ext2spice</B> only
|
|
|
|
|
interprets ports specially if the option <B>ext2spice subcircuits
|
|
|
|
|
on</B> is enabled. Cells that contain port labels are assumed
|
|
|
|
|
in these cases to be <I>standard cells</I>, that is, cells
|
|
|
|
|
which are pre-characterized, and for which the layout is not
|
|
|
|
|
to be interpreted as a physical circuit. When writing SPICE
|
|
|
|
|
output, a cell containing port labels that is a descendent cell
|
|
|
|
|
of the top-level layout is written as a subcircuit call, that
|
|
|
|
|
is, an "X" record. If the top-level cell in the layout
|
|
|
|
|
contains ports, then the SPICE output is written as a subcircuit
|
|
|
|
|
definition, that is, wrapped in a ".subckt . . . .ends" pair.
|
|
|
|
|
For LEF files, a cell that contains ports is written as a
|
|
|
|
|
macro cell, and the ports are the declared PINs of the macro.
|
|
|
|
|
For DEF files, a cell that contains ports is written as a
|
|
|
|
|
COMPONENT. <P>
|
|
|
|
|
|
|
|
|
|
The "index" property of the port is used only when the
|
|
|
|
|
cell is written into a SPICE deck as a subcircuit entry,
|
|
|
|
|
when the <B>ext2spice subcircuit on</B> option is enabled
|
|
|
|
|
(which it is by default). In that case, the subcircuit
|
|
|
|
|
call parameters (nodes) are written in the order of the port
|
|
|
|
|
indices, which are then assumed to match the definition for
|
|
|
|
|
the subcircuit. Likewise, if the circuit is written as a
|
|
|
|
|
subcircuit to a SPICE file, the order of parameters in the
|
|
|
|
|
subcircuit definition will match the order of the port
|
|
|
|
|
indices. Note that the actual port numbers are ignored;
|
|
|
|
|
the port values will be written in ascending order starting
|
|
|
|
|
with the lowest numbered port and ending with the highest
|
|
|
|
|
numbered port. <P>
|
|
|
|
|
|
|
|
|
|
The "direction" property of the port has no particular
|
|
|
|
|
meaning to magic but may be used by other programs to control
|
2022-01-21 16:44:13 +01:00
|
|
|
the allowed direction of routes into a standard cell. The
|
|
|
|
|
"direction" value should be a string containing one or more
|
|
|
|
|
of the compass directions <B>n</B>, <B>s</B>, <B>e</B>,
|
|
|
|
|
and/or <B>w</B>. The default direction when not specified
|
|
|
|
|
is all four directions, <B>nsew</B>. <P>
|
2017-04-25 14:41:48 +02:00
|
|
|
|
2022-01-21 16:44:13 +01:00
|
|
|
The "class", "use", and "shape" properties of the port have
|
|
|
|
|
no internal meaning to magic but are used by the LEF and DEF
|
2017-04-25 14:41:48 +02:00
|
|
|
format read and write routines, and match the LEF/DEF
|
2022-01-21 16:44:13 +01:00
|
|
|
CLASS, USE, and SHAPE properties for macro cell pins. Valid
|
2017-04-25 14:41:48 +02:00
|
|
|
classes are: <B>default</B>, <B>input</B>, <B>output</B>,
|
|
|
|
|
<B>tristate</B>, <B>bidirectional</B>, <B>inout</B>,
|
|
|
|
|
<B>feedthrough</B>, and <B>feedthru</B>. Valid uses are:
|
|
|
|
|
<B>default</B>, <B>analog</B>, <B>signal</B>, <B>digital</B>,
|
2022-01-21 16:44:13 +01:00
|
|
|
<B>power</B>, <B>ground</B>, and <B>clock</B>. Valid shapes
|
|
|
|
|
are: <B>default</B>, <B>abutment</B>, <B>ring</B>, and
|
|
|
|
|
<B>feedthrough</B> or <B>feedthru</B>. <P>
|
|
|
|
|
|
|
|
|
|
Normally the <B>port</B> command operates on a selected label.
|
|
|
|
|
However, use of the optional <I>name</I> or <I>index</I> value
|
|
|
|
|
in front of the command option will cause the command to
|
|
|
|
|
operate on the given label as determined by the label text
|
|
|
|
|
(<I>name</I>) or port index (<I>index</I>). In the case of
|
|
|
|
|
an invalid <I>name</I> or <I>index</I>, the command returns
|
|
|
|
|
a null value (empty string) and prints an error message. If
|
|
|
|
|
the command ends with the "<B>-quiet</B>" option, then no
|
|
|
|
|
error message is printed.
|
2017-04-25 14:41:48 +02:00
|
|
|
</BLOCKQUOTE>
|
|
|
|
|
|
|
|
|
|
<H3>Implementation Notes:</H3>
|
|
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
<B>port</B> is implemented as a built-in command in <B>magic</B>.
|
|
|
|
|
</BLOCKQUOTE>
|
|
|
|
|
|
|
|
|
|
<H3>See Also:</H3>
|
|
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
<A HREF=label.html><B>label</B></A> <BR>
|
|
|
|
|
<A HREF=lef.html><B>lef</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>
|
2022-01-21 16:44:13 +01:00
|
|
|
<P><I>Last updated:</I> November 11, 2021 at 10:13am <P>
|
2017-04-25 14:41:48 +02:00
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
