1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<html>
<head>
<title>EAGLE Help: ADD</title>
</head>
<body bgcolor=white>
<font face=Helvetica,Arial>
<hr>
<i>EAGLE Help</i>
<h1><center>ADD</center></h1>
<hr>
<dl>
<dt>
<b>Function</b>
<dd>
Add elements into a drawing.<br>
Add symbols into a device.
<p>
<dt>
<b>Syntax</b>
<dd>
<tt>ADD 'name' package_name[@library_name] orientation *..</tt><br>
<tt>ADD 'name' ['gate'] device_name[@library_name] orientation *..</tt><br>
<tt>ADD 'name' symbol_name options *..</tt>
<p>
<dt>
<b>Mouse</b>
<dd>
Center button mirrors the part.<br>
Right button rotates the part.
<p>
</dl>
<b>See also</b> <a href=95.htm>UPDATE</a>,
<a href=96.htm>USE</a>,
<a href=53.htm>INVOKE</a>
<p>
The ADD command fetches a circuit symbol (gate) or a package from the active library and places it into the drawing.
<p>
During device definition the ADD command fetches a symbol into the device.
<p>
Usually you click the ADD command and select the package or symbol from the menu which opens. If necessary, parameters can now be entered via the keyboard.
<p>
If <tt>device_name</tt> contains wildcard characters (<tt>'*'</tt> or <tt>'?'</tt>) and more
than one device matches the pattern, the ADD dialog will be opened and the specific device
can be selected from the list.
<p>
The package or symbol is placed with the left button and rotated with the right button. After it has been placed another copy is immediately hanging from the cursor.
<p>
If there is already a device or package with the same name (from the same library) in the drawing,
and the library has been modified after the original object was added, an automatic
<a href=95.htm>library update</a> will be started and you will be asked whether
objects in the drawing shall be replaced with their new versions.
<b>Note: You should always run a <a href=42.htm>Design Rule Check</a> (DRC) and an
<a href=44.htm>Electrical Rule Check</a> (ERC) after a library update has been performed!</b>
<p>
<b>Fetching a Package or Symbol into a Drawing</b>
<p>
<u>Wildcards</u>
<p>
The ADD command can be used with wildcards (<tt>'*'</tt> or <tt>'?'</tt>) to find
a specific device. The ADD dialog offers a tree view of the matching
devices, as well as a preview of the device and package variant.
<p>
To add directly from a specific library, the command syntax
<pre>
ADD devicename@libraryname
</pre>
can be used. <tt>devicename</tt> may contain wildcards and <tt>libraryname</tt> can
be either a plain library name (like "ttl" or "ttl.lbr") or a full
file name (like "/home/mydir/myproject/ttl.lbr" or "../lbr/ttl").
<p>
<u>Names</u>
<p>
The package_name, device_name or symbol_name parameter is the name under which the package, device or symbol is stored in the library. It is usually selected from a menu. The name parameter is the name which the element is to receive in the drawing. It must be enclosed in apostrophe characters. If a name is not explicitly given it will receive an automatically generated name.
<p>
Example:
<pre>
ADD 'IC1' DIL14 *
</pre>
fetches the DIL14 package to the board and gives it the name IC1.
<p>
If no name is given in the schematic, the gate will receive the prefix that was specified in the device definition with <a href=72.htm>PREFIX</a>, expanded with a sequential number (e.g. IC1).
<p>
Example:
<pre>
ADD 7400 * * * * *
</pre>
This will place a sequence of five gates from 7400 type components. Assuming that the prefix is defined as "IC" and that the individual gates within a 7400 have the names A..D, the gates in the schematic will be named IC1A, IC1B, IC1C, IC1D, IC2A. (If elements with the same prefix have already been placed the counting will proceed from the next sequential number.) See also <a href=53.htm>INVOKE</a>.
<p>
<u>Particular Gates</u>
<p>
To fetch a particular gate of a newly added device the name of that gate can be given in single quotes following the part name:
<p>
Example:
<pre>
ADD 'IC1' 'A' 7400 *
</pre>
This is mainly useful if a schematic is to be generated through a script. Note that if a particular
gate is added, no other gates with add level MUST or ALWAYS will be fetched automatically, and you will have to
use the <a href=53.htm>INVOKE</a> command to invoke at least the MUST gates (otherwise
the <a href=44.htm>Electrical Rule Check</a> will report them as missing).
<p>
<u>Orientation</u>
<p>
This parameter defines the orientation of the object in the drawing.
Objects are normally rotated using the right mouse button.
In <a href=85.htm>Script</a> files textual descriptions of this parameter are used:
<p>
<b><tt>[S][M]Rnnn</tt></b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><b><tt>S</tt></b> </font></td><td valign=top><font face=Helvetica,Arial>sets the <b>S</b>pin flag, which disable keeping texts readable from the bottom or right side of the drawing (only available in a board context)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><b><tt>M</tt></b> </font></td><td valign=top><font face=Helvetica,Arial>sets the <b>M</b>irror flag, which mirrors the object about the y-axis</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><b><tt>Rnnn</tt></b></font></td><td valign=top><font face=Helvetica,Arial>sets the <b>R</b>otation to the given value, which may be in the range <tt>0.0</tt>...<tt>359.9</tt> in a board context, or one of <tt>0</tt>, <tt>90</tt>, <tt>180</tt> or <tt>270</tt> in a schematic context (angles may be given as negative values, which will be converted to the corresponding positive value)</font></td></tr>
</table>
<p>
The key letters <b><tt>S</tt></b>, <b><tt>M</tt></b> and <b><tt>R</tt></b> may be given
in upper- or lowercase, and there must be at least <b><tt>R</tt></b> followed by a number.
<p>
If the <b>M</b>irror flag is set in an element as well as in a text within the
element's package, they cancel each other out.
The same applies to the <b>S</b>pin flag.
<p>
Examples:
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial>R0 </font></td><td valign=top><font face=Helvetica,Arial>no rotation</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>R90 </font></td><td valign=top><font face=Helvetica,Arial>rotated 90° counterclockwise</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>R-90 </font></td><td valign=top><font face=Helvetica,Arial>rotated 90° clockwise (will be converted to 270°)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>MR0 </font></td><td valign=top><font face=Helvetica,Arial>mirrored about the y-axis</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>SR0 </font></td><td valign=top><font face=Helvetica,Arial>spin texts</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>SMR33.3</font></td><td valign=top><font face=Helvetica,Arial>rotated 33.3° counterclockwise, mirrored and spin texts</font></td></tr>
</table>
<p>
Default: R0
<p>
<pre>
ADD DIL16 R90 (0 0);
</pre>
places a 16-pin DIL package, rotated 90 degrees counterclockwise, at coordinates (0 0).
<p>
<u>Error messages</u>
<p>
An error message appears if a gate is to be fetched from a device which is not fully defined (see <a href=30.htm>BOARD</a> command). This can be prevented with the "<a href=86.htm>SET</a> CHECK_CONNECTS OFF;" command. Take care: The BOARD command will perform this check in any case. Switching it off is only sensible if no pcb is to be made.
<p>
<b>Fetch Symbol into Device</b>
<p>
During device definition the ADD command fetches a previously defined symbol into the device. Two parameters (swaplevel and addlevel) are possible, and these can be entered in any sequence. Both can be preset and changed with the <a href=32.htm>CHANGE</a> command. The value entered with the ADD command is also retained as a default value.
<p>
<u>Swaplevel</u>
<p>
The swaplevel is a number in the range 0..255, to which the following rules apply:
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial>0: </font></td><td valign=top><font face=Helvetica,Arial>The symbol (gate) can not be swapped with any other in the schematic.</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial>1..255 </font></td><td valign=top><font face=Helvetica,Arial>The symbol (gate) can be swapped with any other symbol of the same type in the schematic that has the same swaplevel (including swapping between different devices).</font></td></tr>
</table>
<p>
Default: 0
<p>
<u>Addlevel</u>
<p>
The following possibilities are available for this parameter:
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>Next</tt> </font></td><td valign=top><font face=Helvetica,Arial>If a device has more than one gate, the symbols are fetched into the schematic with Addlevel Next.</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Must</tt> </font></td><td valign=top><font face=Helvetica,Arial>If any symbol from a device is fetched into the schematic, then a symbol defined with Addlevel Must must also appear. This happens automatically. It cannot be deleted until all the other symbols in the device have been deleted. If the only symbols remaining from a device are Must-symbols, the DELETE command will delete the entire device.</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Always</tt> </font></td><td valign=top><font face=Helvetica,Arial>Like Must, although a symbol with Addlevel Always can be deleted and brought back into the schematic with <a href=53.htm>INVOKE</a>.</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Can</tt> </font></td><td valign=top><font face=Helvetica,Arial>If a device contains Next-gates, then Can-gates are only fetched if explicitly called with INVOKE. A symbol with Addlevel Can is only then fetched into the schematic with ADD if the device only contains Can-gates and Request-gates.</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Request</tt></font></td><td valign=top><font face=Helvetica,Arial>This property is usefully applied to devices' power-symbols. Request-gates can only be explicitly fetched into the schematic (INVOKE) and are not internally counted. The effect of this is that in devices with only one gate and one voltage supply symbol, the gate name is not added to the component name. In the case of a 7400 with four gates (plus power supply) the individual gates in the schematic are called, for example, IC1A, IC1B, IC1C and IC1D. A 68000 with only one <i>Gate</i>, the processor symbol, might on the other hand be called IC1, since its separate voltage supply symbol is not counted as a gate. </font></td></tr>
</table>
<p>
Example:
<pre>
ADD PWR 0 REQUEST *
</pre>
fetches the PWR symbol (e.g. a power pin symbol), and defines a Swaplevel of 0 (not swappable) and the Addlevel <i>Request</i> for it.
<hr>
<table width=100% cellspacing=0 border=0><tr><td align=left><font face=Helvetica,Arial>
<a href=index.htm>Index</a>
</font></td><td align=right><font face=Helvetica,Arial size=-1>
<i>Copyright © 2005 CadSoft Computer GmbH</i>
</font></td></tr></table>
<hr>
</font>
</body>
</html>
|
