EAGLE Help

ADD

Function: Add elements into a drawing.
Add symbols into a device.
Syntax: ADD 'name' package_name[@library_name] orientation *..
ADD 'name' ['gate'] device_name[@library_name] orientation *..
ADD 'name' symbol_name options *..
Mouse: Center button mirrors the part.
Right button rotates the part.

The ADD command fetches a circuit symbol (gate) or a package from the active library and places it into the drawing.

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.

If device_name contains wildcard characters ('*' or '?') and more than one device matches the pattern, the ADD dialog will be opened and the specific device can be selected from the list.

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.

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 library update will be started and you will be asked whether objects in the drawing shall be replaced with their new versions. Note: You should always run a Design Rule Check (DRC) and an Electrical Rule Check (ERC) after a library update has been performed!

Fetching a Package or Symbol into a Drawing

Wildcards

The ADD command can be used with wildcards ('*' or '?') 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.

To add directly from a specific library, the command syntax

ADD devicename@libraryname

can be used. devicename may contain wildcards and libraryname 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").

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 'IC1' DIL14 *

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.

Particular Gates

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:

Example:

ADD 'IC1' 'A' 7400 *

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 INVOKE command to invoke at least the MUST gates (otherwise the Electrical Rule Check will report them as missing).

Orientation

This parameter defines the orientation of the object in the drawing. Objects are normally rotated using the right mouse button. In Script files textual descriptions of this parameter are used:

[S][M]Rnnn

S sets the Spin flag, which disable keeping texts readable from the bottom or right side of the drawing (only available in a board context)

M sets the Mirror flag, which mirrors the object about the y-axis

Rnnn sets the Rotation to the given value, which may be in the range 0.0...359.9 in a board context, or one of 0, 90, 180 or 270 in a schematic context (angles may be given as negative values, which will be converted to the corresponding positive value)

The key letters S, M and R may be given in upper- or lowercase, and there must be at least R followed by a number.

If the Mirror 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 Spin flag.

Examples:

R0 no rotation

R90 rotated 90° counterclockwise

R-90 rotated 90° clockwise (will be converted to 270°)

MR0 mirrored about the y-axis

SR0 spin texts

SMR33.3 rotated 33.3° counterclockwise, mirrored and spin texts

Default: R0

ADD DIL16 R90 (0 0);

places a 16-pin DIL package, rotated 90 degrees counterclockwise, 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.

Request 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 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

`S`	sets the Spin flag, which disable keeping texts readable from the bottom or right side of the drawing (only available in a board context)
`M`	sets the Mirror flag, which mirrors the object about the y-axis
`Rnnn`	sets the Rotation to the given value, which may be in the range `0.0`...`359.9` in a board context, or one of `0`, `90`, `180` or `270` in a schematic context (angles may be given as negative values, which will be converted to the corresponding positive value)

R0	no rotation
R90	rotated 90° counterclockwise
R-90	rotated 90° clockwise (will be converted to 270°)
MR0	mirrored about the y-axis
SR0	spin texts
SMR33.3	rotated 33.3° counterclockwise, mirrored and spin texts

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).

`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.
`Request`	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 Gate, the processor symbol, might on the other hand be called IC1, since its separate voltage supply symbol is not counted as a gate.