start => gnetlist_ug

« Netlist backends | gEDA gnetlist User Guide | Hierarchy »

## Basic netlisting

For basic netlisting (such as for relatively simple PCB designs or simulations), there are some simple requirements for the schematics and symbols that you use. These requirements are imposed by the gnetlist frontend, and apply no matter which netlist backend you use. Some backends might have additional requirements not listed on this page.

Many of these requirements are related to the correct use of attributes. For a full list of standard attributes and their meanings, see the Master Attributes List.

### Schematics

Schematics must contain only nets, buses, components and graphical elements. A component in a schematic is an instance of a symbol from a symbol library.

Every component that you want to appear in a netlist must have a “`refdes=`” attribute attached to it. This should be an alphanumeric string beginning with a letter. The “refdes” is used to identify the component in parts lists, on PCB layouts, and in simulator output.

If two components in the same circuit have the same “refdes”, then gnetlist will merge them (i.e. it will treat them as being the same component). This behaviour enables slotting. It also allows you to split complicated components with very many pins across several pages, by using different symbols for different sections of the component.

Nets can be named by attaching a “`netname=`” attribute to a net segment. All net segments attached to the segment with the attribute will then share the same name. If two nets in the same circuit have the same “netname”, then gnetlist will treat them as being connected. If two connected nets have different “netname” attributes, then gnetlist will merge all the nets with either of those names together. If a net doesn't have a “netname”, gnetlist will automatically generate one.

gnetlist currently ignores buses and bus pins. You can still use them in your schematic diagrams, but they will not be used for netlist generation.

### Symbols

Following the Symbol Creation Guide will help you make symbols that work well with gnetlist.

Symbols must contain only pins, attributes and graphical elements. Symbols should include an unattached “`device=`” attribute.

All pins must have “`pinnumber=`” and “`pinlabel=`” attributes attached. You should normally attach “`pintype=`” and “`pinseq=`” attributes as well.

Sometimes, you may want gnetlist to ignore a symbol entirely. For example, some people use symbols for non-electrical purposes such as title blocks, or for comment or note markers. To do this, you may use the “`graphical=1`” attribute.

There are additional requirements if you want to make use of gnetlist's hierarchy or slotting support.

### Attribute promotion

gnetlist supports attribute promotion. When looking for a particular attribute from a component, it will check attributes attached to the symbol first, and then check unattached attributes in the component's underlying symbol. This lets you provide default values for commonly-used attributes when designing a symbol, while still being able to override them while preparing the design.