EAGLE Help

ADD


Function
Copy elements into a drawing.
Copy a symbol into a device.

Syntax
ADD package_name 'name' orientation •..
ADD device_name 'name' orientation •..
ADD symbol_name 'name' options •..

Mouse
Right button rotates the elements.

See also USE

The ADD command fetches a circuit symbol (gate) or a package from the active library and places it into the drawing. The library must already have been loaded with the USE command.

During device definition the ADD command fetches a symbol into the device.

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.

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.

Fetching a Package or Symbol into a Drawing

Names

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.

Example:

ADD DIL14 'IC1' •
fetches the DIL14 package to the board and gives it the name IC1.

If no name is given in the schematic, the gate will receive the prefix that was specified in the device definition with PREFIX, expanded with a sequential number (e.g. IC1).

Example:

ADD 7400 • • • • •
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 INVOKE.

Orientation

This parameter gives the orientation of the library element in the drawing. The element is normally rotated using the right mouse button. In Script files textual descriptions of this parameter are used:

Permissible orientations are:

R0 no rotation
R90 rotated once (90 degrees anticlockwise)
R180 rotated twice (180 degrees anticlockwise)
R270 rotated three times
MR0 reflected about the y-axis
MR90 rotated once and reflected about the y-axis
MR180 rotated twice and reflected about the y-axis
MR270 rotated three times and reflected about the y-axis

Default: R0

Example:

ADD DIL16 R90 (0 0);
places a 16-pin DIL package, rotated 90 degrees to the left, at coordinates (0 0).

Error messages

An error message appears if a gate is to be fetched from a device which is not fully defined (see BOARD command). This can be prevented with the "SET 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.

Fetch Symbol into Device

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 CHANGE command. The value entered with the ADD command is also retained as a default value.

Swaplevel

The swaplevel is a number in the range 0..255, to which the following rules apply:

0: The symbol (gate) can not be swapped with any other in the schematic.
1..255 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).

Default: 0

Addlevel

The following possibilities are available for this parameter:

Next If a device has more than one gate, the symbols are fetched into the schematic with Addlevel Next.
Must 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.
Always Like Must, although a symbol with Addlevel Always can be deleted and brought back into the schematic with INVOKE.
Can 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.
RequestThis 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 Gate, the processor symbol, might on the other hand be called IC1, since its separate voltage supply symbol is not counted as a gate.

Example:

ADD PWR 0 REQUEST •
fetches the PWR symbol (e.g. a power pin symbol), and defines a Swaplevel of 0 (not swappable) and the Addlevel Request for it.
Index Copyright © 1999 CadSoft Computer GmbH