Conventions on Naming and Displaying Objects in 

CadSoft EAGLE drawings

Doc. Version 2013­08­27­1

Author: Mario Blunk

Abstract: Guideline to give objects in libraries, schematic and layout unambiguous names and designators in order to standardize designing and manufacturing, simplify reading the drawings and service. Special focus is on future development of verification software.

Keywords: schematics, board, layout, PCB, module, merge, import, label, off­page connector, net, class, supply, library, symbol, package, device, attribute, part code, modularization, hierarchic, layer, color, usage, script

Blunk electronic at www.train­z.de  1

Contents 1 Prefixes, Symbols and Values of Components..................................................................4 2 Library Elements...............................................................................................................11

 2.1 Symbol Names..........................................................................................................13 2.1.1 Connectors and Jumpers...................................................................................15

 2.2 Package Names........................................................................................................16 2.2.1 Connectors and Jumpers...................................................................................17

 2.3 Devices......................................................................................................................18 2.3.1 Device Name......................................................................................................19

 2.3.1.1 Connectors and Jumpers............................................................................19 2.3.2 Prefix..................................................................................................................20 2.3.3 Suffix..................................................................................................................20 2.3.4 Technology.........................................................................................................21 2.3.5 Default Value.....................................................................................................22

 2.3.5.1 Connectors and Jumpers...........................................................................24 2.3.6 Package Variant Name......................................................................................25

 2.3.6.1 Connectors and Jumpers...........................................................................25 2.3.7 Attributes............................................................................................................26

 3 Net Classes......................................................................................................................27 4 Net Names.......................................................................................................................28 5 Schematic Drawing Frames.............................................................................................30 6 Layer Usage and Colors...................................................................................................31

 6.1 Schematics................................................................................................................31 6.2 Layout.......................................................................................................................32

 7 Fonts................................................................................................................................34 8 Notes................................................................................................................................34 9 References.......................................................................................................................35 10 Disclaimer.......................................................................................................................35

Blunk electronic at www.train­z.de  2

Preface

A common scheme to give objects an unambiguous name in electrical drawings and 

schematics is a must. This document outlines how to name objects inside CadSoft EAGLE 

projects. The benefits are not just better readability in terms of assembly, service and 

maintenance but also a preparation for merging schematics and layouts with each other.

The focus here is on objects of:

schematics (R, L, C, net names, net classes)

libraries (symbols, packages, devices, attributes)

administrating and naming connectors and jumpers

layer usage and color recommendations

 

Blunk electronic at www.train­z.de  3

 1  Prefixes, Symbols and Values of ComponentsPrefixes indicate the basic nature of a component. They are predefined in the device library (see section 2.3). Once properly defined in the library the schematic does not need any modifications here. In general components placed in a schematic are named, displayed and given a value as listed in Table 1 and Table 2.1  If special constraints on values apply, they are pointed out in column “Valid Values”. Otherwise this field is left empty to be filled with future constraints.

Miscellaneous or dummy components are listed in Table 3. They frequently appear only in a schematic (no package), have no index or may even lack a prefix.

The symbols listed in the following are ordered by their importance.

1 Only the basic symbols without derived symbols are shown here. 

Blunk electronic at www.train­z.de  4

Active Component

Prefix Schematic Symbol Valid Values

Diode regular D

Light Emitting Diode

LED ­ if visible radiation: red, green, blue, yellow, white, violet­ invisible radiation: wavelength i.e. 360nm

Transistor  T

Integrated Circuit

IC

Module MOD

Battery BAT

Blunk electronic at www.train­z.de  5

Active Component

Prefix Schematic Symbol Valid Values

Light Barrier LB

Table 1: prefixes of active components

Blunk electronic at www.train­z.de  6

Passive Component

Prefix European Symbol Valid Values

Resistor regular

R ­ basic unit Ohmsexamples: 10m, 0.1, 1, 10, 10k, 10M

Capacitor regular

C ­ basic unit Farad­ use “u” instead of “µ”examples: 100p, 0.1n, 100n, 0.1u , 10u

Capacitor polarized

C basic unit Farad­ use “u” instead of “µ”­ provide max. voltage in Voltsexamples: 100u/25V, 4700u/80V

Inductor L basic unit Henry­ use “u” instead of “µ”examples:10n, 10u, 10m, ...

Ferrite Bead FB basic unit Henry­ use “u” instead of “µ”examples:10n, 1u, ...

Jumper J

Solder Jumper J

Blunk electronic at www.train­z.de  7

Passive Component

Prefix European Symbol Valid Values

Connector male/female

X

Switch S

Quartz / Crystal

Q ­ basic unit Hertzexample:32k, 1M, ...

Fuse F ­ basic unit Ampereexample:100m, 1, 5k, ...

Test Pad / Test Point

TP

Relay K

Magnet MAG

Valve V

Buzzer BZ

Blunk electronic at www.train­z.de  8

Passive Component

Prefix European Symbol Valid Values

Loudspeaker LS

Table 2: prefixes of passive components

Blunk electronic at www.train­z.de  9

Device Prefix Schematic Symbol

Net Name Changer2 N

Power Supply

Ground regular GND

Ground Analog AGND

Net Junction

Net Crossing

Table 3: prefixes of miscellaneous components

2 Used to transition from one net to another with a quasi zero ohms bridge.

Blunk electronic at www.train­z.de  10

 2  Library ElementsIn order to maintain a clear separation between passive, active and miscellaneous components three directories should exist with the EAGLE library files ­ ending in *.lbr – residing therein. 

The full name of a library file stands for its origin and its contents as depicted in Figure 1. For example the library alr_diode.lbr has been created by company ALERE and contains all kinds of diodes. 

Blunk electronic at www.train­z.de  11

Figure 1: library tree

Inside a library, a distinction is made between symbols, packages and devices. Symbols and packages make a device. A device can be set up of symbols and packages of this very library file only. Finally a device is ready to use in a schematic and layout as well.

Blunk electronic at www.train­z.de  12

Figure 2: makeup of a device

 2.1  Symbol NamesSymbols represent an electrical component as it appears in the schematic later. Since there is no preview available inside the library, the symbol name should unambiguously stand for its meaning. 

A symbol is generic in most cases. Take care to use universal names with as less reference to manufacturers or any part/type codes as possible. 

Avoid type designators like “1N4148_FAIRCHILD”.

See Figure 3 through 5 for examples. Inside a library use the command 

edit *.sym 

to get a list of available symbols.

Blunk electronic at www.train­z.de  13

Figure 3: symbol names of R, C and L Figure 4: symbol names of diodes

Figure 5: symbol names of ICs

Later inside the schematic the symbol names matter when using the command invoke. The invoke­mode does not offer a preview, so the symbol name must clearly stand for its meaning (Figure 6).

NOTE: See section 6.1 for layer usage and colors of symbols !

Blunk electronic at www.train­z.de  14

Figure 6: invoke

 2.1.1  Connectors and JumpersUsually the symbol (inside the schematic) does not tell about mechanical dimensions like pitch or orientation (horizontal, vertical) of a connector. What matters is:

the pin count

if it is a jumper or connector

gender (male/female)

pin arrangement i.e. 2x5 or 3x60

So it is recommended to use symbol names as shown in Figure 7.

Blunk electronic at www.train­z.de  15

Figure 7: Connector/Jumper Symbol Names

 2.2 Package NamesThe package represents the physical appearance of an electrical component inside the board layout. Since there is no preview available inside the library, the symbol name should unambiguously stand for its meaning. 

It is recommended to use the prefixes “S_” and “T_” to distinguish at least between SMT and THT components. Further­on the name should contain information regarding the:

purpose i.e. “TEST_POINT”

pin count and arrangement i.e. 2x10

grid i.e. 0.15mm (optional)

package orientation as suffix separated by dash i.e. “­straight”, “­boxed”,                 “­horizontal”, “­vertical” (useful with connector packages)

JEDEC package name (if available)

manufacturer specific package name (recommended for connectors i.e. S_SAMTEC_349PF­50x2)

If the package is a generic body (i.e. JEDEC packages), avoid references to manufacturer or part/type codes as far as possible ! See Figure 8 and 9 for examples. 

Inside a library use the command 

edit *.pac 

to get a list of available packages.

Blunk electronic at www.train­z.de  16

Figure 8: IC package names

 2.2.1  Connectors and JumpersAs said above, it has proven to be most practicable to use connector package names as shown in Figure 9.

Blunk electronic at www.train­z.de  17

Figure 9: names of connectors & jumper packages

 2.3 DevicesAs outlined in Figure 2 on page 12, a device is where symbols and packages join. Details of this procedure are to be found in [2]. 

At this point following properties of the device are to be defined as exactly as possible according to the manufacturer datasheet:

1. device name

2. device prefix i.e. R, L or C (see section 1 page 4)

3. device suffix i.e. IC1701A, IC1701B, …

4. device technology (optional) i.e. 74HC00, 74S00, ...

5. device default value (optional)

6. package variant name

7. attributes i.e. PART_CODE_JEN, PART_CODE_CAM, COMMISSIONED, UPDATED, FUNCTION, …

The following sections give recommendations and hints on naming these properties.

Blunk electronic at www.train­z.de  18

 2.3.1  Device NameThe device name identifies the actual device within a library file (*.lbr). 

It is THE link between schematic/board and library when using the “update” command. 

NOTE: Updating a symbol or package inside the schematic or board fails if the device name in the library differs from the one in the drawing. Once a device has been renamed in the library, the connection between drawing and library is lost !

External software is required to make sure that each device name in the drawing has a unique counterpart in the library file collection !

In addition, to avoid confusion, make sure a device name is unique among all library files.

 2.3.1.1  Connectors and Jumpers

Device names of connectors and jumpers should be chosen as simple as possible as shown in Figure 10. There are no references to manufacturers or part codes. Details like these are to be addressed in the device editor using so called variants. Read section 2.3.6.1 on page 25.

Blunk electronic at www.train­z.de  19

Figure 10: Device Names of Connectors and Jumpers

 2.3.2  PrefixGive all components a prefix as recommended in section 1.

 2.3.3  SuffixA device suffix like IC1701A or IC1701B is added automatically to the individual symbols a device contains. The name given to a symbol inside the device editor will be added as suffix later when the symbols are placed in the schematic. Following rules are recommended:

1. Individual but equal gates3 of logic ICs or operational amplifiers should get a letter like A, B, C, …

2. I/O banks should be named like _PORT_A, _PORT_B

3. Power symbols of ICs should be named like PWR, P, _PWR or _P

3 In the EAGLE terminology the word “gate” refers to all symbols built into a device like array­resistors, I/O banks or op­amps.

Blunk electronic at www.train­z.de  20

 2.3.4  TechnologyIf required, the technology of the component, can be part of the device value later in the schematic. Place an asterisk as placeholder if the technology is to be included in the device name. Usually the technology of a component refers to the manufacturing process implying certain electrical properties i.e. 74HC125, 74LVC125, … See datasheet !

Blunk electronic at www.train­z.de  21

Figure 11: technology placeholder

 2.3.5  Default ValueIf the value check is set to “off” in the device editor the device name will be taken as default value of the component. For example, if the device name is “BAT54S” the value displayed in the drawing later will be “BAT54S” too – without using the command value. If variants are defined, the variant name will be appended to the displayed value in the drawing automatically (see Figure 12).

Blunk electronic at www.train­z.de  22

Figure 12: Default Value Setting for a Diode

Otherwise, if the value check is set “on” in the device editor, an empty device value is assumed to be assigned later in the drawing with the command value. In this case, the variant names are of secondary importance since they are not displayed in the drawing (Figure 13).

Blunk electronic at www.train­z.de  23

Figure 13: Default Value with Resistors

 2.3.5.1 Connectors and Jumpers

It is recommended to use a default value by leaving the value check set to “off”. The value displayed in the drawing consists of the actual device name and – if defined ­ the variant name. 

Do not use the value as placeholder for the later function of the device ! Use the “FUNCTION” attribute. See section 2.3.7 page 26.

Blunk electronic at www.train­z.de  24

Figure 14: Value Check with Connector and Jumpers

 2.3.6  Package Variant NameThe variant name identifies a subset of a device, that is is most cases the package (or housing) the manufacturer provides.

For ICs, the package variant name should clearly indicate the package variant of an IC as given by the manufacturer datasheet. The manufacturer usually appends the variant name like TSC695F (for the MQFP­F package) or TSC695X (for package X).

For devices with the value check set “on”, the package variant is of secondary importance, because it will not be displayed in the drawing later. For example most resistors and capacitors have hundreds of package variants with the value check set to “off”. See section 2.3.5 Figure 13 page 23.

 2.3.6.1 Connectors and Jumpers

Use variant names which clearly distinguish between, THT/SMD and the orientation as shown in Figure 15.

Blunk electronic at www.train­z.de  25

Figure 15: Connector Variants

 2.3.7  AttributesDevices must have attributes to provide additional information. Each device must have these and only these attributes:

BOM, constant, [YES/NO], to indicate this component should be listed in the Bill Of Material. For example, a solder jumper is just a pair of pads where no device is soldered on. Hence, a solder jumper must have BOM set to NO.

COMMISSIONED, constant, example “2013­07­02”

PART_CODE_yxz, variable, example “D­BAT54_SOT23_1”. The part code itself should indicate what component it is about. This approach avoids multiple assignments of a part code to a large extent. 

The part code shall be left empty for components of which the value is to be defined exclusively in the drawing, i.e. capacitors or resistors. The part code of a resistor there could be something like R­S0805_100R.

However, external software is required to make sure a part code has been assigned only once to a component type !

UPDATED, variable, example “2014­01­20”

FUNCTION, variable, void value field

NOTE: The function is to be specified in the drawing, not in the library device editor !

To simplify entering these attributes, a shot­cut “CTRL­A”, can be used. This short­cut of course becomes available if this EAGLE start script is used: 

http://www.train­z.de/eagle/misc/eagle.scr

Blunk electronic at www.train­z.de  26

Figure 16: attributes

 3  Net ClassesNet classes allow grouping of nets according to their electrical properties like maximum voltage, current, impedance, … These properties basically result in three parameters: min. track size, min. distance to other tracks, min. via drill size. 

The routing process and the DRC take the net class into account. 

If schematics and layouts are to be merged, the net class names of the individual modules must match. 

The class name is case sensitive.

Here some recommendations:

1. Nets meant to carry any supply currents should be in class “pwr”.

2. Differential nets, i.e. USB data or LVDS, should be in class “diff”.

3. Nets carrying the mains voltage, i.e. 230V AC, should be in class “mains”.

4. Remaining nets stay in the class “default”.

Blunk electronic at www.train­z.de  27

Figure 17: class settings

 4  Net NamesAll nets should be given a name. Unless a name is given explicitly to a net, the automatic naming like N$1, N$2, … takes place as safety measure. The latter is safe but is not recommended. See [1] for details. 

In order to prepare schematic and layout for modularization and fast and flexible routing (using the drawing importer, the autorouter, the ripup command) the net names should comply to following rules:

1. Use hierarchic names in a “top­down” or “big­small” manner. For example all nets connected to the motor module 1 start with “M1_”. All nets connected to connector X3 start with “X3_”. Secondary and even less relevant information like “_CD_ENABLE” and so on follow.

2. Use underscore (“_”) as separator.

3. It is highly recommended to use the prefix “DIFF_” for all kinds of differential signals (like USB data signals).

4. Use letters A..Z, numbers 0..9, characters “.” and “­” only ! 

5. Net names are case insensitive.

Blunk electronic at www.train­z.de  28

Figure 18: hierarchic net naming

6. L­active signals start with an exclamation mark like “!TRST”. Figure 19 and 20.

Blunk electronic at www.train­z.de  29

Figure 20: L­active net in schematicFigure 19: L­active net name assignment

 5  Schematic Drawing FramesUse schematic sheets dedicated for pages containing sections of:

the final product (red color)

development mock­ups (turquoise color) 

net name changers (blue color). 

Place symbols and nets according to their future usage on these sheets.

See library preview screenshot in Figure 21.

CAUTION: 

1. Objects placed on development and net changer pages will be optimized away when merging schematics.

2. Use external software to ensure, that net changer pages contain net changers and nets only.

NOTE: See section 6.1 for layer usage and colors !

Blunk electronic at www.train­z.de  30

Figure 21: library frame preview

 6  Layer Usage and Colors

 6.1  SchematicsIn the current state of the schematics required, a few rules apply in addition to the default settings:

1. Use color magenta for the layer “info” as shown in Figure 22 and 23. This setting should be done on start­up of EAGLE by means of the eagle.scr script [3].

2. Layer 100 and 101 are no default layers. They get “imported” on placing a development/net_changer drawing frame from the library alr_frame.lbr. The colors turquoise/blue of layer 100 and 101 should not be changed. This setting should be done on start­up of EAGLE by means of the eagle.scr script [3].

NOTE: Layer 100 and 101 are reserved for drawing frames and must not be used by other library symbols !

Use external software for verification !

Blunk electronic at www.train­z.de  31

Figure 22: additional reserved layer and colors in schematics

Figure 23: example of objects in layer "info"

 6.2 Layout

1. Use color magenta for the layer 120 “placement_notes” as shown in in Figure 24 and Figure 25. This setting should be done on start­up of EAGLE by means of the eagle.scr script [3].

2. Layer 120 is no default layer. It gets “imported” on placing a board template from the library alr_board_templates.lbr. The color of layer 120 should not be changed.

NOTE: Layer 120 is reserved for placement notes in the board layout and must not be used by other library symbols !

Use external software for verification !

Blunk electronic at www.train­z.de  32

Figure 24: additional reserved layer and colors in boards

Blunk electronic at www.train­z.de  33

Figure 25: example of placement notes in layer 120

 7  FontsUse for:

schematics and library symbols font “fixed”

board layouts and library packages font “vector”

Never use font “Proportional”.

External software is required to verify proper usage of fonts !

 8  Notes

Blunk electronic at www.train­z.de  34

 9  References

1. Mario Blunk, “Design Checklist” 

at http://www.train­z.de/pdf/Design_Checklist_en.pdf

2. Mario Blunk, “EAGLE Library Tutorial” at http://www.train­z.de/pdf/library_tutorial.pdf

3. Mario Blunk, “EAGLE Scripting Tutorial” at http://www.train­z.de/pdf/Scripting_en.pdf

4. CadSoft EAGLE Version 6.x English users manual

 10  DisclaimerThis paper is believed to be accurate and reliable. I do not assume responsibility for any errors which may appear in this document. 

Mario Blunk, August 27th 2013

Blunk electronic / owner : Dipl. Ing. Mario Blunk / Buchfinkenweg 5 / 99097 Erfurt / Germany +49 176 2904 5855 / http://www.train­z.de 

© 2013 Mario Blunk Printed in Germany 

Blunk electronic at www.train­z.de  35