Referenz Handbuch

This document is Copyright © 2010-2018 by its contributors as listed below. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.

Alle Markenrechtsnamen in diesem Guide gehören den rechtmäßigen Eigentümern.

Mitwirkende

Jean-Pierre Charras, Fabrizio Tappero.

Übersetzung

André S. <ansc.de@gmail.com> 2015, Carsten Schoenert <c.schoenert@t-online.de> 2016

Feedback

Bitte senden Sie alle Fehlermeldungen, Vorschläge oder neue Versionen an:

Datum der Veröffentlichung und Softwareversion

Published on May 30, 2015.

1. Einleitung zu Eeschema

1.1. Beschreibung

Eeschema is a schematic capture software distributed as a part of KiCad and available under the following operating systems:

  • Linux

  • Apple macOS

  • Windows

Unabhängig vom Betriebssystem sind alle mit Eeschema erstellten Dateien 100% zwischen den Betriebssystemen kompatibel und austauschbar.

Eeschema ist eine integrierte Anwendung, alle Funktionen vom Zeichnen, Steuern, Layout, Bibliotheksmanagement und Zugriff auf die PCB-Design Software werden aus Eeschema heraus ausgeführt.

Eeschema is intended to cooperate with PcbNew, which is KiCad’s printed circuit design software. It can also export netlist files, which lists all the electrical connections, for other packages.

Eeschema includes a symbol library editor, which can create and edit symbols and manage libraries. It also integrates the following additional but essential functions needed for modern schematic capture software:

  • Prüfung der elektrischen Vorgaben durch einen Elektrischen Regel Check (ERC) für die automatische Prüfung auf falsche und fehlende Verbindungen.

  • Ausgabe von Plot-Dateien in vielen Formaten (Postscript, PDF, HPGL und SVG).

  • Bill of Materials generation (via Python or XSLT scripts, which allow many flexible formats).

1.2. Technischer Überblick

Eeschema is limited only by the available memory. There is thus no real limitation to the number of components, component pins, connections or sheets. In the case of multi-sheet diagrams, the representation is hierarchical.

Eeschema can use multi-sheet diagrams in a few ways:

  • Einfache Hierarchie (jede Schaltung wird nur einmal verwendet).

  • Komplexe Hierarchie (manche Schaltungen werden in mehreren Instanzen mehr als einmal verwendet).

  • Flache Hierarchie (Schaltpläne sind nicht explizit über den Hauptschaltplan verbunden).

2. Allgemeine Eeschema Befehle

Commands can be executed by:

  • Klicken auf die Menüleiste (oben am Bildschirm).

  • Klicken auf die Symbole oben im Fenster (allgemeine Befehle).

  • Klicken auf die Symbole auf der rechten Seite des Bildschirms (spezielle Befehle oder "Werkzeuge").

  • Klicken auf die Symbole auf der linken Seite am Bildschirm (Darstellungsoptionen).

  • Durch Betätigen von Maustasten (wichtige komplementäre Befehle). Ein Rechtsklick öffnet in der Regel ein Kontextmenü für das Element unter dem Cursor (Zoom, Raster und Bearbeitung des Elements).

  • Function keys (F1, F2, F3, F4, Insert and Space keys). Specifically: Escape key cancels the command in progress. Insert key allows the duplication of the last element created.

  • Pressing hot keys which typically perform a select tool command and begin tool action at the current cursor location. For a list of hot keys, see the "Help→List Hotkeys" menu entry or press ? key.

Commands overview

2.1. Mausbefehle

2.1.1. Basisbefehle

Linke Taste

  • Einfacher Klick: Zeigt die Eigenschaften der Komponente oder des Textes unter dem Cursor in der Statuszeile an.

  • Doppelklick: Bearbeiten (wenn das Element bearbeitbar ist) der Komponente oder des Textes.

Rechte Taste

  • Öffnet ein Pop-Up Menü.

2.1.2. Block operations

Sie können in allen Eeschema Menüs markierte Gruppierungen bewegen, ziehen, kopieren und löschen.

Areas are selected by drawing a box around items using the left mouse button.

Holding "Shift", "Ctrl", or "Shift + Ctrl" during selection respectively performs copying, dragging and deletion:

Linke Maustaste

Bewege Auswahl.

Umschalt + linke Maustaste

Kopiere Auswahl.

Strg + linke Maustaste

Ziehe Auswahl.

Strg + Umschalt + linke Maustaste

Lösche Auswahl.

Während des Ziehens oder Kopierens können Sie:

  • Noch einmal klicken um die Elemente zu platzieren.

  • Click the right button or press Escape key to cancel.

If a block move command has started, another command can be selected using the right-click pop-up menu.

Kontextmenü während dem Bewegen einer Gruppierung

2.2. Tastaturbefehle

  • Die "?" Taste zeigt die aktuelle Liste der Tastaturbefehle an.

  • Hotkeys might be redefined in Controls tab of Schematic Editor Options dialog (menu Preferences → General Options).

Here is the default hotkey list:

Help (this window)

?

Zoom In

F1

Zoom Out

F2

Zoom Redraw

F3

Zoom Center

F4

Fit on Screen

Home

Zoom to Selection

@

Reset Local Coordinates

Space

Edit Item

E

Delete Item

Del

Rotate Item

R

Drag Item

G

Undo

Ctrl+Z

Redo

Ctrl+Y

Mouse Left Click

Return

Mouse Left Double Click

End

Save Schematic

Ctrl+S

Load Schematic

Ctrl+L

Find Item

Ctrl+F

Find Next Item

F5

Find Next DRC Marker

Shift+F5

Find and Replace

Ctrl+Alt+F

Repeat Last Item

Ins

Move Block → Drag Block

Tab

Copy Block

Ctrl+C

Paste Block

Ctrl+V

Cut Block

Ctrl+X

Move Schematic Item

M

Duplicate Symbol or Label

C

Add Symbol

A

Add Power

P

Mirror X

X

Mirror Y

Y

Orient Normal Component

N

Edit Symbol Value

V

Edit Symbol Reference

U

Edit Symbol Footprint

F

Edit with Symbol Editor

Ctrl+E

Begin Wire

W

Begin Bus

B

End Line Wire Bus

K

Add Label

L

Add Hierarchical Label

H

Add Global Label

Ctrl+L

Add Junction

J

Add No Connect Flag

Q

Add Sheet

S

Add Wire Entry

Z

Add Bus Entry

/

Add Graphic PolyLine

I

Add Graphic Text

T

Update PCB from Schematic

F8

Autoplace Fields

O

Leave Sheet

Alt+BkSp

Delete Node

BkSp

Highlight Connection

Ctrl+X

All hotkeys can be redefined using the hotkey editor (menu Preferences→General Options→Controls).

It is possible to import/export hotkey settings using menu Preferences→Import and Export→Import/Export Hotkeys.

2.3. Grid

In Eeschema the cursor always moves over a grid. The grid can be customized:

  • Size might be changed using the pop-up menu or using the Preferences/Options menu.

  • Color might be changed in Colors tab of the Schematic Editor Options dialog (menu Preferences → General Options).

  • Visibility might be switched using the left-hand toolbar button.

Die Standard Rastergröße ist 50 mil (0.050'') oder 1,27 Millimeter.

This is the preferred grid to place components and wires in a schematic, and to place pins when designing a symbol in the Symbol Editor.

One can also work with a smaller grid from 25 mil to 10 mil. This is only intended for designing the symbol body or placing text and comments and not recommended for placing pins and wires.

2.4. Zoom Auswahl

Um die Zoom Größe zu verstellen:

  • Betätigen Sie die rechte Maustaste, um das Pop-Up Menü zu öffnen und den gewünschten Zoomlevel auszuwählen.

  • Oder benutzen Sie die Funktionstasten:

    • F1: Hineinzoomen

    • F2: Herauszoomen

    • F4 oder einfach mit der mittleren Maustaste klicken (ohne die Maus zu bewegen): Ansicht auf die Cursorposition zentrieren

  • Fensterzoom:

    • Mausrad: Hinein-/Herauszoomen

    • Umschalt+Mausrad: Fensterinhalt nach oben/unten verschieben

    • Strg+Mausrad: Fensterinhalt nach links/rechts verschieben

2.5. Anzeigen von Cursorkoordinaten

The display units are in inches or millimeters. However, Eeschema always uses 0.001 inch (mil/thou) as its internal unit.

Die folgende Information wird rechts unten im Fenster angezeigt:

  • Der Zoomfaktor

  • Die absolute Position des Cursors

  • Die relative Position des Cursors

The relative coordinates can be reset to zero by pressing Space. This is useful for measuring distance between two points or aligning objects.

Positionsangaben in der Statuszeile

2.6. Obere Menüleiste

The top menu bar allows the opening and saving of schematics, program configuration and viewing the documentation.

Menüleiste

2.7. Symbole in der oberen Werkzeugleiste

Diese Werkzeugleiste erlaubt den Zugriff auf die Hauptfunktionen von Eeschema.

Wenn Eeschema im Einzelstehenden Modus ausgeführt wird, zeigt die folgende Grafik die zur Verfügung stehende Werkzeugauswahl:

Werkzeugleiste Eeschema im Einzelstehenden Modus gestartet

Note that when KiCad runs in project mode, the first two icons are not available as they work with individual files.

New schematic icon

Create a new schematic (only in standalone mode).

Schaltplanprojekt öffnen

Öffnet einen Schaltplan (nur im Einzelstehenden Modus).

Save schematic icon

Save complete schematic project.

Seite einrichten

Blattgröße auswählen und Titelblock bearbeiten.

Print icon

Open print dialog.

icons/paste_png

Paste a copied/cut item or block to the current sheet.

icons/undo_png

Undo: Revert the last change.

icons/redo_png

Redo: Revert the last undo operation.

search icon

Show the dialog to search components and texts in the schematic.

search replace icon

Show the dialog to search and replace texts in the schematic.

Schaltplandarstellung neu zeichnen Schaltplan an Bildschirmgröße anpassen

Bildschirmanzeige neu zeichnen; Zoom auf Bildschirmgröße anpassen.

Hinein zoomen Heraus zoomen

Hinein und Heraus zoomen.

Navigation in der Schaltplanhierachie

Anzeige und Navigieren im Hierarchiebaum.

Schaltplan verlassen

Verlässt das aktuelle Blatt und geht in der Hierarchie eine Ebene nach oben.

icons/libedit_png

Call the symbol library editor to view and modify libraries and component symbols.

icons/library_browse_png

Browse symbol libraries.

icons_annotate_png

Annotate symbols.

ERC icon

Electrical Rules Checker (ERC), automatically validate electrical connections.

run cvpcb icon

Call CvPcb to assign footprints to symbols.

Netlist icon

Export a netlist (Pcbnew, SPICE and other formats).

Symbol fields editor icon

Edit symbol fields.

BOM icon

Generate the Bill of Materials (BOM).

Pcbnew starten

Ruft Pcbnew auf um ein Leiterplatten Layout durchzuführen.

Import Footprint Names icon

Back-import footprint assignment (selected using CvPcb or Pcbnew) into the "footprint" fields.

2.8. Symbole in der rechten Werkzeugleiste

Diese Werkzeugleiste enthält Werkzeuge für:

  • Place symbols, wires, buses, junctions, labels, text, etc.

  • Create hierarchical subsheets and connection symbols.

Cancel tool icon

Cancel the active command or tool.

Highlight net icon

Highlight a net by marking its wires and net labels with a different color. If KiCad runs in project mode then copper corresponding to the selected net will be highlighted in Pcbnew as well.

New Component icon

Display the symbol selector dialog to select a new symbol to be placed.

Add Power icon

Display the power symbol selector dialog to select a power symbol to be placed.

Elektrische Verbindung erstellen

Leitung zeichnen.

Bus verlegen

Zeichnet einen Bus.

Verbindung an Buseingang führen

Zeichnet eine Leitung zu einem Buseingangspunkt. Diese Elemente sind nur grafisch und erstellen keine Verbindung, daher sollten sie nicht verwendet werden um Leitungen miteinander zu verbinden.

Buseingang zu Buseingang führen

Zeichnet Bus zu Bus Verbindungen.

icons/noconn_png

Place a "No Connect" flag. These flags should be placed on symbol pins which are meant to be left unconnected. It is done to notify the Electrical Rules Checker that lack of connection for a particular pin is intentional and should not be reported.

icons/add_junction_png

Place a junction. This connects two crossing wires or a wire and a pin, when it can be ambiguous (i.e. if a wire end or a pin is not directly connected to another wire end).

icons/add_line_label_png

Place a local label. Local label connects items located in the same sheet. For connections between two different sheets, you have to use global or hierarchical labels.

Global label icon

Place a global label. All global labels with the same name are connected, even when located on different sheets.

icons/add_hierarchical_label_png

Place a hierarchical label. Hierarchical labels are used to create a connection between a subsheet and the parent sheet that contains it.

hierarchischen Schaltplan erstellen

Erstellt ein hierarchisches Unterblatt. Sie müssen einen Dateinamen für dieses Unterblatt angeben.

icons/import_hierarchical_label_png

Import a hierarchical pin from a subsheet. This command can be executed only on hierarchical subsheets. It will create hierarchical pins corresponding to hierarchical labels placed in the target subsheet.

icons/add_hierar_pin_png

Place a hierarchical pin in a subsheet. This command can be executed only on hierarchical subsheets. It will create arbitrary hierarchical pins, even if they do not exist in the target subsheet.

grafische Linie erstellen

Zeichnet eine Linie. Diese sind rein grafisch und stellen keine Verbindung her.

icons/text.png

Place a text comment.

Bitmap Grafik einfügen

Fügt eine Bitmap Grafik ein.

Element löschen

Löscht das ausgewählte Element.

2.9. Symbole der linken Werkzeugleiste

Diese Werkzeugleiste verwaltet die Anzeigeoptionen:

icons/grid

Toggle grid visibility.

icons/unit_inch

Switch units to inches.

icons/unit_mm

Switch units to millimeters.

icons/cursor_shape

Choose the cursor shape (full screen/small).

icons/hidden_pin

Toggle visibility of "invisible" pins.

icons/lines90

Toggle free angle/90 degrees wires and buses placement.

2.10. Pop-Up Menüs und Schnellbearbeitung

Ein Rechtsklick öffnet ein Kontextmenü für das ausgewählte Element. Dieses enthält:

  • Zoomfaktor.

  • Rasteranpassung.

  • Häufig bearbeitete Parameter des ausgewählten Elements.

Pop-Up Menü ohne ein ausgewähltes Element

Kontextmenü mit Rasterauswahl

Editing a label.

Bearbeiten eines Labels per Kontextmenü

Editing a symbol.

Bearbeiten eines Bauteils per Kontextmenü

3. Hauptmenü

3.1. Menüpunkt Datei

Menüpunkt Datei

New

Close current schematic and start a new one (only in standalone mode).

Open

Load a schematic project (only in standalone mode).

Open Recent

Open a schematic project from the list of recently opened files (only in standalone mode).

Append Schematic Sheet

Insert the contents of another sheet into the current one.

Import Non-Kicad Schematic File

Imports a schematic project saved in another file format.

Save

Save current sheet and all its subsheets.

Save Current Sheet

Save only the current sheet, but not others in the project.

Save Current Sheet As…

Save the current sheet under a new name.

Seite einrichten

Blattgröße und Titelblock einstellen.

Print

Print schematic project (See also chapter Plot and Print).

Plotten

Export in das PDF, PostScript, HPGL oder SVG Format (Siehe Kapitel Plotten und Drucken).

Close

Terminate the application.

3.2. Menüpunkt Einstellungen

Menüpunkt Einstellungen

Manage Symbol Library Tables

Add/remove symbol libraries.

Configure Paths

Set the default search paths.

General Options

Preferences (units, grid size, field names, etc.).

Set Language

Select interface language.

Icons Options

Icons visibility settings.

Import and Export

Transfer preferences to/from file.

3.2.1. Manage Symbol Library Tables

Symbol Library Tables

Eeschema uses two library tables to store the list of available symbol libraries, which differ by the scope:

  • Global Libraries

Libraries listed in the Global Libraries table are available to every project. They are saved in sym-lib-table in your home directory (exact path is dependent on the operating system; check the path above the table).

  • Project Specific Libraries

Libraries listed in Project Specific Libraries table are available to the currently opened project. They are saved in sym-lib-table file in the project directory (check the path above the table).

You can view either list by clicking on "Global Libraries" or "Project Specific Libraries" tab below the library table.

Add a new library

Add a library either by clicking Browse Libraries… button and selecting a file or clicking "Append Library" and typing a path to a library file. The selected library will be added to the currently opened library table (Global/Project Specific).

Remove a library

Remove a library by selecting one or more libraries and clicking Remove Library button.

Library properties

Each row in the table stores several fields describing a library:

Active

Enables/disables the library. It is useful to temporarily reduce the loaded library set.

Nickname

Nickname is a short, unique identifier used for assigning symbols to components. Symbols are represented by <Library Nickname>:<Symbol Name> strings.

Library Path

Path points to the library location.

Plugin Type

Determines the library file format.

Options

Stores library specific options, if used by plugin.

Description

Briefly characterizes the library contents.

3.2.2. General Options

Display
Display settings

Grid Size

Grid size selection.

It is recommended to work with normal grid (0.050 inches or 1,27 mm). Smaller grids are used for component building.

Bus thickness

Pen size used to draw buses.

Line thickness

Pen size used to draw objects that do not have a specified pen size.

Part ID notation

Style of suffix that is used to denote symbol units (U1A, U1.A, U1-1, etc.)

Icon scale

Adjust toolbar icons size.

Show Grid

Grid visibility setting.

Restrict buses and wires to H and V orientation

If checked, buses and wires are drawn only with vertical or horizontal lines. Otherwise buses and wires can be placed at any orientation.

Show hidden pins:

Display invisible (or hidden) pins, typically power pins.

Zeige Blattbegrenzung

Wenn aktiviert, werden die Blattränder auf dem Bildschirm angezeigt.

Footprint previews in symbol chooser

Displays a footprint preview frame and footprint selector when placing a new symbol.

Note: it may cause problems or delays, use at your own risk.

Editing
Editing settings

Measurement units

Select the display and the cursor coordinate units (inches or millimeters).

Horizontal pitch of repeated items

Increment on X axis during element duplication (default: 0) (after placing an item like a symbol, label or wire, a duplication is made by the Insert key)

Vertical pitch of repeated items

Increment on Y axis during element duplication (default: 0.100 inches or 2,54 mm).

Increment of repeated labels

Increment of label value during duplication of texts ending in a number, such as bus members (usual value 1 or -1).

Default text size

Text size used when creating new text items or labels.

Auto-save time interval

Time in minutes between saving backups.

Automatically place symbol fields

If checked, symbol fields (e.g. value and reference) in newly placed symbols might be moved to avoid collisions with other items.

Allow field autoplace to change justification

Extension of Automatically place symbol fields option. Enable text justification adjustment for symbol fields when placing a new part.

Always align autoplaced fields to the 50 mil grid

Extension of Automatically place symbol fields option. If checked, fields are autoplaced using 50 mils grid, otherwise they are placed freely.

Controls

Redefine hotkeys and set up the user interface behavior.

Controls settings

Select a new hotkey by double clicking an action or right click on an action to show a popup menu:

Edit

Define a new hotkey for the action (same as double click).

Undo Changes

Reverts the recent hotkey changes for the action.

Restore Default

Sets the action hotkey to its default value.

Undo All Changes

Reverts all recent hotkey changes for the action.

Restore All to Default

Sets all action hotkeys to their default values.

Options description:

Center and warp cursor on zoom

If checked, the pointed location is warped to the screen center when zooming in/out.

Use touchpad to pan

When enabled, view is panned using scroll wheels (or touchpad gestures) and to zoom one needs to hold Ctrl. Otherwise scroll wheels zoom in/out and Ctrl/Shift are the panning modifiers.

Pan while moving object

If checked, automatically pans the window if the cursor leaves the window during drawing or moving.

Colors

Color scheme for various graphic elements. Click on any of the color swatches to select a new color for a particular element.

Farbeinstellungen
Default Fields

Define additional custom fields and corresponding values that will appear in newly placed symbols.

Default Fields settings

3.3. Menüpunkt Hilfe

Access to on-line help (this document) for an extensive tutorial about KiCad.

Use „Copy Version Information“ when submitting bug reports to identify your build and system.

4. Obere Werkzeugleiste

4.1. Einrichten des Zeichenblattes

Das Symbol für die Einrichtung der Zeichenblattseite Seite einrichten ermöglicht es Ihnen die Blattgröße und auch den Inhalt des Titelblocks festzulegen.

Seite einrichten

Die Blattnummerierung wird automatisch aktualisiert. Sie können das heutige Datum setzen, indem Sie auf den Button mit den linksgerichteten Pfeilen bei "Datum festlegen" drücken, es wird aber später nicht automatisch geändert.

4.2. Optionen des Schaltplaneditors

4.3. Suchwerkzeug

Das Suche-Symbol Find icon kann verwendet werden, um das Suchwerkzeug aufzurufen.

Suchen Dialog

Sie können nach einer Referenz, einem Wert oder einer Zeichenfolge im aktuellen Blatt oder in der gesamten Hierarchie suchen. Wenn etwas gefunden wurde, wird der Cursor auf dem gefundenen Element im entsprechenden Unterblatt gesetzt.

4.4. Netzlisten Werkzeug

Über das Icon Netzliste erstellen öffnet das Werkzeug zur Netzlisten Erzeugung.

Die erzeugte Netzliste beschreibt alle Verbindungen in der gesamten Hierarchie.

In einer Multiblatt Hierarchie ist jedes lokale Label nur innerhalb des Blattes sichtbar zu dem es gehört. Daher ist ein Label TOTO auf Blatt 3 ein anderes als ein Label TOTO auf Blatt 5 (wenn nicht absichtlich eine Verbindung eingefügt wurde, um die beiden zu verbinden). Das kommt daher, da der Blattname intern mit dem lokalen Namen verbunden ist.

Anmerkung 1:

Die Länge von Labels ist in Eeschema nicht begrenzt, aber ein Programm das die erzeugte Netzliste weiterverarbeitet könnte an dieser Stelle eingeschränkt sein.

Anmerkung 2:

Vermeiden Sie Leerzeichen in den Labels, denn diese werden als Trenner zwischen den Labels interpretiert. Das ist keine Einschränkung von Eeschema, aber von vielen Netzlisten Formaten die häufig annehmen, das Labels keine Leerzeichen enthalten.

Dialog Netzlistenerstellung

Optionen:

Default Format:

Aktivieren Sie dies, um Pcbnew als das Standardformat auszuwählen.

Andere Formate können ebenfalls erzeugt werden:

  • Orcad PCB2

  • CadStar

  • Spice, für Simulatoren

Externe Plugins können gestartet werden, um die Netzlisten Formate zu erweitern (ein PadsPcb Plugin aus dem Plugin Verzeichnis wurde hier hinzugefügt).

4.5. Das Annotation (Beschriftungs) Werkzeug

Das Symbol icons_annotate_png ruft das Beschriftungswerkzeug auf. Dieses Werkzeug führt eine automatische Benennung (Annotation) aller Bauteile im Schaltplan durch.

Für mehrteilige Bauteile (z.B. ein 4-fach-NAND Gatter der 7400 TTL Familie), wird ein Mehrteil-Suffix erzeugt (daher wird ein 7400 TTL mit dem Bezeichner U3 aufgeteilt in U3A, U3B, U3C und U3D).

Sie können bedingungslos alle Bauteile beschriften oder nur neue Bauteile, das heißt diese die bisher nicht beschriftet wurden.

Dialogbox Schaltplan Annotation

Anwendungsbereich

  1. Auf alle Schaltpläne anwenden. Alle Blätter werden neu beschriftet (übliche Einstellung).

  2. Nur auf den gegenwärtigen Schaltplan anwenden. Nur die aktuelle Schaltplanseite wird neu beschriftet (Diese Option sollte nur in speziellen Fällen verwendet werden, zum Beispiel um die Anzahl der Widerstände auf der aktuellen Seite zu bestimmen.).

  3. Bestehende Annotation beibehalten. Bedingte Beschriftung, nur die neuen Bauteile werden neu beschriftet (übliche Einstellung).

  4. Bestehende Annotationen ersetzen. Unbedingte Beschriftung, alle Bauteile werden neu beschriftet (diese Option sollte verwendet werden wenn es doppelte Referenzen gibt).

  5. Ersetzen, aber vorhandene Multi-Einheiten jedoch nicht tauschen. Das behält alle Gruppen von mehrteiligen Bauteilen (d.h. U2A, U2B, …) bei neuer Beschriftung bei.

Reihenfolge der Annotation

Wählt die Reihenfolge aus, in der die Bauteile beschriftet werden.

Annotationsauswahl

Setzt die Methode, mit der die Nummerierung ausgewählt wird.

4.6. ERC Werkzeug

Das Symbol ERC icon ruft das ERC (Electrical Rule Check → "Elektrische Regel Prüfung") Werkzeug auf.

Dieses Werkzeug führt eine Prüfung des Schaltplanentwurfs durch und ist besonders hilfreich, um vergessene Verbindungen und Inkonsistenzen herauszufinden.

Sobald Sie den ERC durchlaufen lassen haben, platziert Eeschema Markierungen im Schaltplan um die Probleme hervorzuheben. Die Diagnose kann dann mit einem Linksklick auf die Markierung gefolgt werden. Eine Fehlerdatei kann ebenfalls erzeugt werden.

4.6.1. ERC Bericht

ERC Dialog

Fehler werden in der Fehlerliste angezeigt:

  • Total: Komplette Zahl der Fehler und Warnungen.

  • Fehler: Anzahl der aufgetretenen Fehler

  • Warnungen: Anzahl der Warnungen

Optionen:

  • ERC Protokolldatei erstellen: Aktivieren Sie diese Option um eine ERC-Protokolldatei zu erstellen.

Befehle:

  • Markierungen entfernen: Entfernt alle ERC Fehler- und Warnungsmarkierungen

  • Starte: Den ERC starten.

  • Abbrechen: Die Dialogbox schließen.

Anmerkung:

  • Klicken auf eine Fehlermeldung springt zur zugehörigen Markierung im Schaltplan.

4.6.2. ERC Optionen Dialog

ERC Optionen Dialog

Dieser Tab erlaubt es Ihnen Verbindungsregeln zwischen den Pins festzulegen. Sie können zwischen drei Möglichkeiten für jeden dieser Fälle wählen:

  • Kein Fehler

  • Warnung

  • Fehler

Jedes Kästchen der Matrix kann durch anklicken verändert werden.

4.7. Stücklistenwerkzeug

Das Symbol BOM icon ruft den Stücklisten (BOM)-Generator auf. Dieses Menü erlaubt es eine Datei zu erzeugen, die alle Bauteile und/oder hierarchische Verbindungen auflistet.

Dialog Stücklisten Erstellung

Eeschemas Stücklistengenerator nutzt externe Plugins, üblicherweise in XSLT oder Python geschrieben. Manche werden mitgeliefert und werden im KiCad Programmverzeichnis installiert, welcher je nach Betriebssystem unterschiedlich ist.

Ein hilfreicher Satz von Bauteileigenschaften die in einer Stückliste (BOM) verwendet werden können:

  • Wert: eindeutiger Name für jedes verwendete Bauteil

  • Footprint - entweder manuell gesetzt oder "zurück-annotiert" (siehe unten).

  • Feld1 - Name des Herstellers

  • Feld2 - Teilenummer des Herstellers

  • Feld3 - Teilenummer des Distributors

Zum Beispiel:

Dialog Bauteileigenschaften

On MS Windows operating systems, BOM generator dialog has special option (pointed by red arrow) that controls visibility of external plugin window.
By default, command line runs with hidden console window and output is redirected to Plugin info field. Set this option to show the window of the running command. It may be necessary if plugin has GUI.

BOM dialog extra option on MS Windows

4.8. Import Werkzeug für Footprintzuweisung:

4.8.1. Zugriff:

Das Icon Rückimport Bauteil Footprintfelder ruft das Rückwärts-Annotations Werkzeug auf.

Dieses Werkzeug erlaubt es, Footprintänderungen die in Pcbnew gemacht wurden, zurück in die Footprintfelder in Eeschema zu importieren.

5. Erstellung und Bearbeitung eines Schaltplans

5.1. Einleitung

Ein Schaltplan kann auf einem einzelnen Blatt dargestellt werden, aber wenn er groß genug ist wird er mehrere Blätter benötigen.

Ein Schaltplan der auf mehreren Seiten erstellt wird, ist hierarchisch und alle seine Blätter (jedes Blatt ist eine eigene Datei) stellen ein Eeschema-Projekt dar. Die Bearbeitung von hierarchischen Schaltplänen wird im Kapitel Hierarchische Schaltpläne beschrieben.

5.2. Allgemeine Betrachtungen

Ein Schaltplan der mit Eeschema erstellt wird, ist mehr als eine einfache grafische Darstellung eines elektronischen Schaltkreises. Er ist normalerweise der Startpunkt einer Entwicklungskette, die es erlaubt:

  • Prüfungen unter zu Hilfenahme von Regelsätzen (Elektrischer-Regel-Prüfung (ERC)) können durchgeführt werden um Fehler und Auslassungen zu erkennen.

  • Automatisches Erstellen eine Stückliste (BOM).

  • Benutzung einer Software zur Simulation wie zum Beispiel SPICE, siehe Netzliste erzeugen.

  • Eine Netzliste erzeugen für die Übertragung zum Leiterplatten-Layout.

A schematic mainly consists of symbols, wires, labels, junctions, buses and power ports. For clarity in the schematic, you can place purely graphical elements like bus entries, comments, and polylines.

5.3. Die Entwicklungskette

Entwicklungsprozess

Symbols are added to the schematic from symbol libraries. After the schematic is made, a netlist is generated, which is later used to import the set of connections and footprints into PcbNew.

5.4. Symbol placement and editing

5.4.1. Find and place a symbol

To load a symbol into your schematic you can use the icon New Symbol icon . A dialog box allows you to type the name of the symbol to load.

Dialog der Bauteilauswahl

The Choose Symbols dialog will filter symbols by name, keywords, and description according to what you type into the search field. Advanced filters can be used just by typing them:

  • Wildcards: use the characters ? and * respectively to mean "any character" and "any number of characters".

  • Relational: if a library part’s description or keywords contain a tag of the format "Key:123", you can match relative to that by typing "Key>123" (greater than), "Key<123" (less than), etc. Numbers may include one of the following case-insensitive suffixes:

    |=== | p | n | u | m | k | meg | g | t | 10-12 | 10-9 | 10-6 | 10-3 | 103 | 106 | 109 | 1012 |===

    |=== | ki | mi | gi | ti | 210 | 220 | 230 | 240 |===

  • Regular expression: if you’re familiar with regular expressions, these can be used too. The regular expression flavor used is the wxWidgets Advanced Regular Expression style, which is similar to Perl regular expressions.

Before placing the symbol in the schematic, you can rotate it, mirror it, and edit its fields, by either using the hotkeys or the right-click context menu. This can be done the same way after placement.

Here is a symbol during placement:

Bauteil während Platzierung

5.4.2. Spannungsversorgungen

A power port symbol is a symbol (the symbols are grouped in the “power” library), so they can be placed using the symbol chooser. However, as power placements are frequent, the Add Power icon tool is available. This tool is similar, except that the search is done directly in the „power“ library.

5.4.3. Symbol Editing and Modification (already placed component)

There are two ways to edit a symbol:

  • Modification of the symbol itself: position, orientation, unit selection on a multi-unit symbol.

  • Modification of one of the fields of the symbol: reference, value, footprint, etc.

When a symbol has just been placed, you may have to modify its value (particularly for resistors, capacitors, etc.), but it is useless to assign to it a reference number right away, or to select the unit (except for components with locked units, which you have to assign manually). This can be done automatically by the annotation function.

Symbol modification

To modify some feature of a symbol, position the cursor on the symbol, and then either:

  • Double-click on the symbol to open the full editing dialog.

  • Mit einem Rechtsklick das Kontextmenü zu öffnen und einen der Befehle Bewegen, Ausrichtung, Bearbeiten, Löschen, usw. auswählen.

Textfelder eines Bauteils ändern

Sie können die Referenz, den Wert, die Position, die Ausrichtung, die Textgröße und Sichtbarkeit der Felder durch folgende Möglichkeiten ändern:

  • Doppelklick auf das Textfeld, um es zu ändern.

  • Rechtsklick um das Kontextmenü zu öffnen und einen der Befehle benutzen: Bewegen, Drehen, Bearbeiten, Löschen, usw.

For more options, or in order to create fields, double-click on the symbol to open the Symbol Properties dialog.

Dialog Bauteileigenschaften

Each field can be visible or hidden, and displayed horizontally or vertically. The displayed position is always indicated for a normally displayed symbol (no rotation or mirroring) and is relative to the anchor point of the symbol.

The option “Reset to Library Defaults” sets the symbol to the original orientation, and resets the options, size and position of each field. However, texts fields are not modified because this could break the schematic.

5.5. Leitungen, Busse, Label, Spannungsversorgungen

5.5.1. Einleitung

All diese Zeichnungselemente können ebenfalls mit den Werkzeugen der vertikalen rechten Werkzeugleiste platziert werden.

Diese Elemente sind:

  • Wires: most connections between symbols.

  • Busse: um Bus Labels grafisch zu verbinden

  • Polylinien: für grafische Darstellung.

  • Verbindungen: um Verbindungen zwischen gekreuzten Leitungen oder Bussen herzustellen.

  • Buseingänge: um Verbindungen zwischen Leitungen und Bussen darzustellen. Rein grafisch!

  • Label: um Leitungen zu benennen oder Verbindungen herzustellen.

  • Globale Label: für Verbindungen zwischen Blättern.

  • Texte: für Kommentare und Anmerkungen.

  • "Keine Verbindung" Kennzeichnung: um einen Anschluss abzuschließen, der keine Verbindung braucht.

  • Hierarchische Blätter, und ihre Verbindungsanschlüsse.

5.5.2. Verbindungen (Leitungen und Label)

Es gibt zwei Möglichkeiten eine Verbindung zu erstellen:

  • Pin zu Pin Verbindungen

  • Label

Das folgende Bild zeigt die beiden Methoden:

Leitungen und Label

Anmerkung 1:

Der "Anschluss"-Punkt eines Labels ist die untere linke Ecke des ersten Buchstaben des Labels. Dieser Punkt wird mit einem kleinen Quadrat dargestellt, wenn er nicht verbunden ist.

Dieser Punkt muss daher Kontakt zur Leitung haben oder am Ende eines Anschlusses überlagert werden, sodass das Label als verbunden angesehen wird.

Anmerkung 2:

Um eine Verbindung herzustellen, muss ein Teil der Leitung mit seinen Enden an ein anderes Segment oder einen Pin angeschlossen sein.

Wenn es eine Überlappung gibt (wenn eine Leitung über einen Anschluss läuft aber nicht zum Anschluss verbunden wird), gibt es keine Verbindung.

Anmerkung 3:

Leitungen die sich kreuzen sind nicht implizit verbunden. Es ist notwendig, sie mit einem Verbindungspunkt zu verbinden, wenn eine Verbindung gewünscht ist.

Das vorstehende Bild (Leitungen verbunden mit DB25FEMALE Pins 22, 21, 20, 19 ) zeigt so einen Fall einer Verbindung mit einem Verbindungspunkt.

Anmerkung 4:

Wenn zwei unterschiedliche Labels an der gleichen Leitung platziert werden, werden sie verbunden und werden äquivalent: alle anderen Elemente die mit einem der beiden Label verbunden sind, sind mit allen anderen verbunden.

5.5.3. Verbindungen (Busse)

Im folgenden Schaltplan sind viele Anschlüsse zu Bussen verbunden.

Beispiel Schaltplan mit Bussen
Mitglieder eines Buses

Aus Sicht des Schaltplans ist ein Bus eine Ansammlung von Signalen, die mit einem gemeinsamen Prefix starten und auf eine Nummer enden. Zum Beispiel PCA0, PCA1 und PCA2 sind Mitglieder des PCA Bus.

Der komplette Bus ist benannt PCA[N..m], wobei N und m die ersten und letzten Leitungs-Nummern dieses Busses sind. Wenn PCA also 20 Mitglieder von 0 bis 19 hat, wird der gesamte Bus mit PCA[0..19] bezeichnet. Eine Sammlung wie PCA0, PCA1, WRITE, READ kann nicht in einem Bus zusammengefasst werden.

Verbindungen zwischen Bus-Mitgliedern

Anschlüsse zwischen den gleichen Mitgliedern eines Busses müssen über Labels verbunden werden. Es ist nicht möglich einen Anschluss direkt an einen Bus zu verbinden; diese Art der Verbindung wird von Eeschema ignoriert.

Im Beispiel oben sind Verbindungen über Labels hergestellt, die an Leitungen platziert wurden, die an Pins angeschlossen sind. Buseingänge (Leitungssegmente mit 45 Grad) zu Bussen sind rein grafisch und nicht notwendig um logische Verbindungen herzustellen.

Wenn die Bauteilanschlüsse in aufsteigender Reihenfolge angeordnet sind können über den Wiederholungsbefehl (Einfg Taste) Verbindungen sehr schnell in folgender Weise hergestellt werden. Dies ist ein üblicher Fall in der Praxis bei Bauteilen wie Speichern, Mikroprozessoren.

  • Platzieren Sie das erste Label (zum Beispiel PCA0)

  • Nutzen Sie den Wiederholungsbefehl so oft wie nötig um die Mitglieder zu platzieren. Eeschema wird automatisch die nächsten Labels (PCA1, PCA2, …) senkrecht angeordnet an der theoretischen Position der anderen Anschlüsse erzeugen.

  • Zeichnen Sie die Leitung unter dem ersten Label. Dann nutzen Sie den Wiederholungsbefehl um die anderen Leitungen unter den Labels zu platzieren.

  • Wenn nötig platzieren sie die Buseingänge in der gleichen Weise (ersten Eingang platzieren, dann den Wiederholungsbefehl nutzen).

Anmerkung

Im Menü "Einstellungen → Einstellungen des Schaltplaneditors" können Sie die Parameter für die Wiederholungen einstellen:

  • Vertikaler Abstand wiederholter Elemente

  • Horizontaler Abstand wiederholter Elemente

  • Schrittweite der wiederholten Bezeichner (welche dadurch um 1, 2 oder 3 etc. erhöht oder auch vermindert wird)

Globale Verbindung zwischen Bussen

Es kann sein, dass Sie Verbindungen zwischen Bussen brauchen, um zwei Busse mit unterschiedlichen Namen, oder im Falle einer Hierarchie, um zwei unterschiedliche Blätter zu verbinden. Diese Verbindungen können Sie in folgender Weise erstellen.

Beispiel einer Busverbindung

Die Busse PCA[0..15], ADR[0..7] und BUS[5..10] sind miteinander verbunden. Beachten Sie den Verbindungspunkt hier, der die vertikale Busleitung mit der dem mittlerem und horizontalen Bussegment verbindet.

Um genau zu sein, folgende Mitglieder sind miteinander verbunden: PCA0, ADR0 sind verbunden (das Gleiche wie PCA1 und ADR1 … PCA1 und ADR7).

Weiterhin sind PCA5, BUS5 und ADR5 verbunden (genauso wie PCA6, BUS6 und ADR6 und analog wie PCA7, BUS7 und ADR7).

PCA8 und BUS8 sind ebenfalls verbunden (genau wie PCA9 und BUS9, PCA10 und BUS10).

5.5.4. Verbindungen von Spannungsversorgungen

When the power pins of the symbols are visible, they must be connected, as for any other signal.

Symbols such as gates and flip-flops may have invisible power pins. Care must be taken with these because:

  • Sie können keine Leitungen anschließen, weil sie nicht sichtbar sind.

  • Sie kennen die Namen der Anschlüsse nicht.

Zusätzlich wäre es eine schlechte Idee diese sichtbar zu machen und diese wie andere Pins anzuschließen, der Schaltplan würde schlechter lesbar und nicht mit den üblichen Konventionen überein stimmen.

Anmerkung
Wenn Sie die Anzeige der nicht sichtbaren Anschlüsse erzwingen wollen, müssen Sie die Option "Versteckte Pins einblenden" im Menü "Einstellungen" → "Einstellungen des Schaltplaneditors" Tab "Darstellung" einschalten oder über das Symbol Versteckte Pins einblinden in der linken (Anzeigeoptionen) Werkzeugleiste anklicken.

Eeschema verbindet automatisch ausgeblendete Spannungsanschlüsse mit gleichem Namen zu einem Spannungsnetz mit diesem Namen. Es mag nötig sein Spannungsnetze mit unterschiedlichen Namen zu verbinden (zum Beispiel "GND" in TTL Bauteilen und "VSS" in MOS Bauteilen); benutzen Sie Spannungsversorgungen dafür.

Es wird nicht empfohlen Label für die Verbindung von Spannungsnetzen zu benutzen. Diese haben nur einen lokalen Verbindungsfokus und würden ausgeblendete Spannungsanschlüsse nicht verbinden.

Das Bild unten zeigt ein Beispiel für Leistungsanschluss-Verbindungen.

Beispiel für Spannungsversorgungen

In diesem Beispiel ist Masse (GND) mit dem Spannungsanschluss VSS verbunden, und Spannungsanschluss VCC ist verbunden mit VDD.

Zwei PWR_FLAG Symbole sind hier zu sehen. Sie zeigen an, dass die zwei Spannungsanschlüsse VCC und GND tatsächlich mit einer Spannungsquelle verbunden sind. Ohne diese beiden Symbole würde das ERC-Werkzeug folgendes erkennen: Warning: power port not powered.

All these symbols can be found in the „power“ symbol library.

5.5.5. "Keine Verbindung" Markierung

Diese Markierungen sind sehr nützlich um unerwünschte ERC-Warnungen zu vermeiden. Die "Elektrische Regel Prüfung" stellt sicher, dass keine Verbindung ungewollt offen bleibt. Es gibt aber Konstellationen in denen Anschlüsse nicht benutzt werden sollen, zum Beispiel unbenutzte Eingänge von Schaltkreisen.

Wenn Anschlüsse wirklich unverbunden bleiben sollen ist es notwendig ein "Keine Verbindung" Markierung an diesen Anschlüssen zu platzieren (Werkzeug Symbol Keine Berbindung ). Diese Symbole haben keinen Einfluss auf die erzeugte Netzliste.

5.6. Zeichnungsergänzungen

5.6.1. Textkommentare

It can be useful (to aid in understanding the schematic) to place annotations such as text fields and frames. Text fields (tool images/icons/text.png ) and Polyline (tool images/icons/add_dashed_line.png ) are intended for this use, contrary to labels and wires, which are connection elements.

Hier finden sie ein Beispiel für einen Rahmen mit einem Textkommentar.

Rahmen mit Kommentar Beispiel

5.6.2. Seite einrichten -Titelblock

Der Titelblock wird über das Werkzeug Seite einrichten bearbeitet.

Seite einrichten Dialog
Titelblock

Die Schaltplannummer (Sheet: X/Y) wird automatisch aktualisiert.

5.7. Rescuing cached symbols

By default, Eeschema loads symbols from the project libraries according to the set paths and library order. This can cause a problem when loading a very old project: if the symbols in the library have changed or have been removed or the library no longer exists since they were used in the project, the ones in the project would be automatically replaced with the new versions. The new versions might not line up correctly or might be oriented differently leading to a broken schematic.

When a project is saved, a cache library with the contents of the current library symbols is saved along with the schematic. This allows the project to be distributed without the full libraries. If you load a project where symbols are present both in its cache and in the system libraries, Eeschema will scan the libraries for conflicts. Any conflicts found will be listed in the following dialog:

Dialog Bauteil Konflikt

You can see in this example that the project originally used a diode with the cathode facing up, but the library now contains one with the cathode facing down. This change would break the schematic! Pressing OK here will cause the symbol cache library to be saved into a special „rescue“ library and all the symbols are renamed to avoid naming conflicts.

If you press Cancel, no rescues will be made, so Eeschema will load all the new components by default. If you save the schematic at this point, your cache will be overwritten and the old symbols will not be recoverable. If you have saved the schematic, you can still go back and run the rescue function again by selecting "Rescue Cached Components" in the "Tools" menu to call up the rescue dialog again.

If you would prefer not to see this dialog, you can press "Never Show Again". The default will be to do nothing and allow the new components to be loaded. This option can be changed back in the Libraries preferences.

6. Hierarchische Schaltpläne

6.1. Einleitung

Eine hierarchische Darstellung ist im Allgemeinen eine gute Lösung für Projekte die größer als ein paar Arbeitsblätter sind. Wenn Sie solch eine Art von Projekt verwalten müssen dann ist es nötig:

  • Große Arbeitsblätter zu verwenden, was in Problemen beim Ausdrucken und Handhaben endet.

  • Mehrere Blätter zu verwenden, was Sie zu einer hierarchischen Struktur hinführt.

Der komplette Schaltplan besteht dann aus einem Hauptschaltplan, auch Hauptblatt genannt, und Unterblättern, die die Hierarchie darstellen. Zudem erhöht ein geschicktes Unterteilen des Entwurfs in separate Blätter oft die Lesbarkeit.

Vom Hauptblatt aus müssen Sie in der Lage sein alle Unterblätter zu erreichen. Hierarchische Schaltplanverwaltung ist in Eeschema dank des integrierten "Hierarchie-Navigators" sehr einfach, erreichbar über das Symbol Hierarchiebrowser in der oberen Werkzeugleiste.

There are two types of hierarchy that can exist simultaneously: the first one has just been evoked and is of general use. The second consists in creating symbols in the library that appear like traditional symbols in the schematic, but which actually correspond to a schematic which describes their internal structure.

Diese zweite Art wird verwendet um integrierte Schaltungen zu entwickeln, weil Sie in diesem Fall Funktionsbibliotheken in dem zu zeichnenden Schaltplan nutzen müssen.

Eeschema unterstützt derzeit diese zweite Möglichkeit nicht!

Eine Hierarchie kann folgende Art haben:

  • Einfach: Ein gegebenes Blatt wird nur einmal verwendet.

  • Komplex: Ein gegebenes Blatt wird mehr als einmal verwendet (mehrfache Instanzen).

  • Flach: Das ist eine einfache Hierarchie, aber es werden keine Verbindungen zwischen Blättern gezeichnet.

Eeschema kann mit all diesen Hierarchien umgehen.

Das Erstellen eines hierarchischen Schaltplans ist einfach, die komplette Hierarchie wird vom Hauptschaltplan aus gehandhabt, als hätten Sie nur einen Schaltplan.

Die zwei wichtigen zu verstehenden Punkte sind:

  • Wie erstellt man ein Unterblatt?

  • How to build electrical connections between sub-sheets.

Navigation among sub-sheets is acheived by using the navigator tool accessible via the button icons/hierarchy_nav_png on the top toolbar.

Schaltplan Hierarchiebrowser

Each sheet is reachable by clicking on its name. For quick access, right click on a sheet name, and choose to Enter Sheet or double click within the bounds of the sheet.

In order to exit the current sheet to the parent sheet, right click anywhere in the schematic where there is no object and select "Leave Sheet" in the context menu or press Alt+Backspace.

6.3. Lokale, hierarchische und globale Label

6.3.1. Eigenschaften

Lokale Label (Werkzeug Netznamen - lokales Label ) verbinden Signale nur innerhalb eines Blattes. Hierarchische Label (Werkzeug Globales Label hinzufügen ) verbinden Signale nur innerhalb eines Blattes und zu einem hierarchischen Anschluss im übergeordneten Blatt.

Globale Label (Werkzeug Globals Label hinzufügen ) verbinden Signale über alle Hierarchieebenen. Unsichtbare Spannungsversorgungsanschlüsse (Typ Spannungseingang und Spannungsausgang) sind wie globale Label, da diese über die gesamte Hierarchie als verbunden behandelt werden.

Anmerkung
Innerhalb einer Hierarchie (einfach oder komplex) können Sie sowohl hierarchische als auch globale Label verwenden.

6.4. Summary of hierarchy creation

Folgendes müssen Sie tun:

  • Platzieren sie im Hauptblatt ein Hierarchiesymbol "Blattsymbol".

  • Öffnen Sie den neuen Schaltplan (Unterblatt) mit dem Navigator und zeichnen Sie diesen wie jeden anderen Schaltplan.

  • Draw the electric connections between the two schematics by placing Global Labels (HLabels) in the new schematic (sub-sheet), and labels having the same name in the root sheet, known as SheetLabels. These SheetLabels will be connected to the sheet symbol of the root sheet to the other elements of the schematic like standard symbol pins.

6.5. Blattsymbol

Zeichnen Sie ein Rechteck, definiert über zwei diagonale Punkte, welches das Unterblatt symbolisiert.

Die Größe dieses Rechtecks muss es Ihnen erlauben später verschiedene Label (Hierarchieanschlüsse) zu platzieren, die mit den globalen Label (HLabels) des Unterblatts korrespondieren.

These labels are similar to usual symbol pins. Select the tool icons/add_hierarchical_subsheet_png .

Klicken Sie um die obere linke Ecke des Rechtecks zu platzieren. Klicken Sie noch einmal um die linke untere Ecke zu platzieren, achten Sie auf ein ausreichend großes Rechteck.

Sie werden dann aufgefordert einen Dateinamen einzugeben und einen Schaltplannamen für dieses Unterblatt. Dieser Name wird später im Hierarchienavigator verwendet um den Schaltplan aufrufen zu können.

Eigenschaften für Subschaltplan

Sie müssen einen Dateinamen eingeben. Wenn es keinen Schaltplannamen gibt dann wird der Dateiname als Blattname verwendet. Dies ist der übliche Weg.

6.6. Verbindungen - Hierarchische Verbinder

Hier erstellen Sie die Verbindungspunkte (hierarchische Bezeichner) für das Symbol, das gerade erstellt wurde.

These points of connection are similar to normal symbol pins, with however the possibility to connect a complete bus with only one point of connection.

Es gibt zwei Wege das zu tun:

  • Platzieren Sie die unterschiedlichen Anschlüsse bevor Sie das Unterblatt zeichnen (manuelle Platzierung).

  • Platzieren Sie die unterschiedlichen Anschlüsse nachdem Sie das Unterblatt und die globalen Label gezeichnet haben (halbautomatische Platzierung).

Die zweite Lösung sollte bevorzugt werden.

Manuelle Platzierung:

  • Wählen Sie das Werkzeug Hierarchische   Verbinder .

  • Klicken Sie auf das Hierarchiesymbol an dem Sie diesen Anschluss platzieren möchten.

Sie sehen unten ein Beispiel für die Erstellung eines hierarchischen Anschlusses mit dem Namen "Signaltakt".

Eingabe eines hierarchischen Bezeichners

Sie können den Namen, die grafischen Eigenschaften und den Verbindungstyp definieren, oder dies später nachholen indem Sie dieses Anschlussblatt bearbeiten (Rechtsklick und Bearbeiten im Pop-Up Menü).

Auf dem Blatt muss ein Hierarchisches Label vorhanden sein welches den gleichen Namen hat wieder der hierarchische Verbinder. Dabei muss manuell darauf geachtet werden das die zwei Namen sich nicht unterscheiden. Deswegen ist die zweite Lösung, wie nachfolgend beschrieben, die bevorzugte Variante.

Automatische Platzierung:

  • Wählen Sie das Werkzeug Hierarchisches Label   hinzufügen .

  • Klicken Sie auf das Hierarchiesymbol von wo Sie die Anschlüsse zum korrespondierenden globalen Label aus dem korrespondierenden Schaltplan importieren wollen. Ein hierarchischer Anschluss erscheint, wenn ein neues globales Label vorhanden ist, welches noch nicht mit einem schon vorhandenen Anschluss verbunden.

  • Klicken Sie dorthin wo Sie diesen Anschluss platzieren wollen.

Alle notwendigen Anschlüsse können so schnell und ohne logische Fehler platziert werden. Ihr Erscheinungsbild entspricht den entsprechenden globalen Labeln.

6.7. Verbindungen - Hierarchische Labels

Jede Verbindung, welche auf dem Blattsymbol erstellt worden ist, muss ein korrespondierendes hierarchisches Label im Unterblatt besitzen. Hierarchische Label sind gleich den normalen Labels, verbinden aber als Zusatz zu den normalen Labels das Unterblatt mit dem Hauptblatt und umgekehrt. Die grafische Darstellung der zwei ergänzenden Labels (Verbindung und HLabel) ist gleich. Hierarchische Label werden mit dem Werkzeug Hierarchischen Pin hinzufügen erstellt.

Siehe nachfolgendes Beispiel eines Hauptblattes:

Hierarchische Label auf dem Hauptblatt

Beachten Sie den Anschluss VCC_PIC, der mit dem Jumper JP1 verbunden ist.

Und dies sind die zugehörigen Verbindungen auf dem Unterblatt:

Hierarchisches Label auf dem Unterblatt

Sie sehen wieder die beiden korrespondierenden hierarchischen Label, die eine Verbindung zwischen den beiden hierarchischen Blättern herstellen.

Anmerkung
Sie können hierarchische Label und hierarchische Anschlüsse verwenden, um zwei Busse zu verbinden, entsprechend der Syntax (Bus[N..m]) wie schon beschrieben (siehe Abschnitt 5.5.3).

6.7.1. Labels, hierarchische Labels, globale Labels und unsichtbare Spannungsversorgungsanschlüsse

Einige Anmerkungen zu verschiedenen Arten eine Verbindung herzustellen, anders als über durch Leitungen.

Einfache Label

Einfache Label können nur lokale Punkte verbinden, d.h. begrenzt auf das Schaltplanblatt wo diese platziert sind. Das kommt daher da:

  • Jedes Blatt hat eine Blattnummer.

  • Die Blattnummer ist mit dem Label verbunden.

Also, wenn Sie ein Label "TOTO" auf Blatt 3 platzieren, dann ist das tatsächliche Label "TOTO_3". Wenn Sie ein Label "TOTO" ebenfalls auf Blatt 1 (dem Hauptblatt) platzieren, erstellen Sie eigentlich ein Label "TOTO_1" welches sich durch den angehängten Suffix von "TOTO_3" unterscheidet. Dieses Verhalten ist auch gegeben wenn es nur ein Blatt im Projekt gibt.

Hierarchische Label

Was für einfache Label gesagt wurde, gilt auch für hierarchische Label.

Thus in the same sheet, a hierarchical label "TOTO" is considered to be connected to a local label "TOTO", but not connected to a hierarchical label or label called "TOTO" in another sheet.

A hierarchical label is considered to be connected to the corresponding sheet pin symbol in the hierarchical symbol placed in the parent sheet.

Unsichtbare Spannungsanschlüsse

It was seen that invisible power pins were connected together if they have the same name. Thus all the power pins declared "Invisible Power Pins" and named VCC are connected all symbol invisible power pins named VCC only within the sheet they are placed.

Das bedeutet, wenn Sie ein Label "VCC" in einem Unterblatt platzieren, wird es nicht mit VCC Anschlüssen verbunden, weil dieses Label eigentlich VCC_n heißt, wobei n die Blattnummer ist.

If you want this label VCC to be really connected to the VCC for the entire schematic, it will have to be explicitly connected to an invisible power pin via a VCC power symbol.

6.7.2. Globale Label

Globale Label, die einen identischen Namen haben, sind über alle Schaltplanseiten miteinander verbunden.

Label für Spannungen wie VCC, … sind globale Label.

6.8. Komplexe Hierarchie

Here is an example. The same schematic is used twice (two instances). The two sheets share the same schematic because the file name is the same for the two sheets („other_sheet.sch“). The sheet names must be unique.

Beispiel komplexe Hierarchie

6.9. Flache Hierarchie

You can create a project using many sheets without creating connections between these sheets (flat hierarchy) if the following rules are observed:

  • Create a root sheet containing the other sheets which acts as a link between others sheets.

  • Es werden keine expliziten Verbindungen benötigt.

  • Use global labels instead of hierarchical labels in all sheets.

Hier ist ein Beispiel eines Hauptblattes.

Darstellung flache Hierarchie

Hier sind die zwei Blätter, verbunden über globale Label.

Dies ist ein Ausschnitt aus dem Schaltplan pic_programmer.sch.

Ausschnitt aus pic_programmer.sch

Und der zugehörige Ausschnitt aus pic_sockets.sch.

Ausschnitt globale Labels

Schauen Sie auf die globalen Labels.

Label flache Hierarchie

7. Symbol Annotation Tool

7.1. Einleitung

The annotation tool allows you to automatically assign a designator to symbols in your schematic. Annotation of symbols with multiple units will assign a unique suffix to minimize the number of these symbols. The annotation tool is accessible via the icon icons_annotate_png . Here you find its main window.

Dialogbox Schaltplan Annotation

Available annotation schemes:

  • Annotate all the symbols (reset existing annotation option)

  • Annotate all the symbols, but do not swap any previously annotated multi-unit parts.

  • Annotate only symbols that are currently not annotated. Symbols that are not annotated will have a designator which ends with a ? character.

  • Ganze Hierarchie annotieren (alle Schaltpläne).

  • Nur aktuelles Blatt annotieren (Nur den gegenwärtigen Schaltplan bearbeiten).

The „Reset, but do not swap any annotated multi-unit parts“ option keeps all existing associations between symbols with multilple units. For example, U2A and U2B may be reannotated to U1A and U1B respectively but they will never be reannotated to U1A and U2A, nor to U2B and U2A. This is useful if you want to ensure that pin groupings are maintained.

Die Auswahl der Annotationsreihenfolge legt die Methode fest, die verwendet wird um die Referenznummerierung innerhalb jeden Blattes der Hierarchie durchzuführen.

Außer in speziellen Fällen wird eine automatische Beschriftung für das gesamte Projekt (alle Arbeitsblätter) und für alle neuen Bauteile durchgeführt, wenn Sie keine bestehenden Beschriftungen ändern wollen.

The Annotation Choice gives the method used to calculate reference:

  • Use first free number in schematic: components are annotated from 1 (for each reference prefix). If a previous annotation exists, only unused numbers will be used.

  • Verwende erste freie Nummer bis Schaltplannummer x 100: Beschriftung startet von 101 für Blatt 1, und von 201 für Blatt 2, usw. Wenn es mehr als 99 Bauteile mit dem gleichen Referenzpräfix (U, R, …) auf Blatt 1 gibt, wird das Annotierungs-Werkzeug die Nummer 200 und folgende verwenden. Die Beschriftung auf Blatt 2 wird dann mit der nächsten freien Nummer fortgesetzt.

  • Verwende erste freie Nummer bis Schaltplannummer x 1000. Beschriftung startet mit 1001 auf Blatt 1, mit 2001 auf Blatt 2.

7.2. Einige Beispiele

7.2.1. Reihenfolge der Annotation

Dieses Beispiel zeigt 5 platzierte Bauteile, die aber noch nicht annotiert worden sind.

Nicht annotierte Bauteile

Nachdem das Annotationswerkzeug ausgeführt wurde, erhält man dieses Ergebnis.

Sortiert nach X-Position.

Annotierung nach Position in der X-Achse

Sortiert nach Y-Position.

Annotierung nach Position in der Y-Achse

Sie können sehen, dass vier 74LS00 Gatter im U1 Bauteil verteilt wurden und das fünfte 74LS00 Gatter wurde dem nächsten Bauteil U2 zugewiesen.

7.2.2. Annotationsauswahl

Hier ist eine Beschriftung in Blatt 2 wo die Option "Verwende erste Nummer im Schaltplan" gesetzt wurde.

Annotierung nach erster freier Nummer

Option "Verwende erste freie Nummer bis Schaltplannummer x 100" ergibt folgendes Ergebnis.

Annotierung nach erster freier Nummer mit Multiplikator 100

Option "Verwende erste freie Nummer bis Schaltplannummer x 1000" ergibt folgendes Ergebnis.

Annotierung nach erster freier Nummer mit Multiplikator 1000

8. Entwurfsprüfung mit ERC (Elektrische Regel Prüfung)

8.1. Einleitung

Das Werkzeug für die elektrische Regel Prüfung (ERC) führt eine automatische Prüfung Ihres Schaltplans durch. Der ERC prüft auf mögliche Fehler in ihrem Schaltplan, wie nicht verbundene Anschlüsse, nicht verbundene hierarchische Symbole, kurzgeschlossene Ausgänge, usw. Naturgemäß ist eine automatische Prüfung nicht unfehlbar und das Programm, das alle Entwurfsfehler erkennen kann ist noch nicht zu 100% fertig gestellt. Solch eine Prüfung ist sehr hilfreich da diese Ihnen hilft, viele versehentliche und kleine Fehler zu finden.

In fact all detected errors must be checked and then corrected before proceeding as normal. The quality of the ERC is directly related to the care taken in declaring electrical pin properties during symbol library creation. ERC output is reported as "errors" or "warnings".

ERC Dialog

8.2. ERC Benutzung

Der ERC kann über klicken auf das Symbol ERC ausführen gestartet werden.

Warnungen werden auf den Schaltplanelementen platziert, die einen ERC Fehler verursachen (z.B. Anschlüsse oder Label).

Anmerkung
  • Im Dialogfenster können Sie durch anklicken der Fehlermeldung auf die zugehörige Markierung im Schaltplan springen.

  • Und umgekehrt bewirkt ein Doppelklick mit der linken Maustaste auf einer Markierung im Schaltplan die Anzeige des zugehörigen Prüfergebnisses.

Sie können auch Fehlermarkierungen im Dialogfeld löschen.

8.3. Beispiel eines ERC mit Fehlern

ERC Markierungen

Hier sehen Sie vier Fehler:

  • Zwei Ausgänge wurden fehlerhaft miteinander verbunden (roter Pfeil am Pin 6).

  • Zwei Eingänge wurden offen gelassen (grüner Pfeil an den Pins 4 und 5).

  • Es gibt einen Fehler an einem ausgeblendeten Spannungsanschluss, die Markierung der Spannungsversorgung fehlt (grüner Pfeil am Gatter U1B).

8.4. Prüfergebnisse anzeigen

Mit doppelten Linksklick oder bei mehrfachen Auswahlmöglichkeiten unter dem Cursor nach Auswahl der Fehlermarkierung bei einem Rechtsklick zeigt Ihnen das Pop-Up Menü das Prüfergebnis zur Markierung.

Anwahl ERC Markierung

Wenn Sie auf den Marker zur Fehlerinformation klicken, erhalten Sie eine Beschreibung des Fehlers.

Fehlermeldung zur ERC Markierung

8.5. Spannungsversorgungsanschlüsse und Markierungen von Spannungsversorgungen

Es ist nicht unwahrscheinlich einen Fehler oder eine Warnung bei einem ERC für Spannungsversorgungsanschlüsse angezeigt zu bekommen, selbst wenn alles auf den ersten Blick normal aussieht. Sehen Sie sich nochmal das Beispiel oben an. Dies passiert weil in den meisten Entwürfen von Schaltplänen die Spannungsversorgung über Steckverbinder erfolgt, die an sich keine Spannungsquelle sind (anders wie z.B. der Ausgang eines Spannungsreglers, der als Spannungsausgang deklariert ist).

Der ERC wird daher keinen Spannungsausgang finden können der diese Leitung versorgt, und wird die Schaltung als nicht von einer Spannungsquelle versorgt detektieren.

Um diese Warnung zu vermeiden müssen Sie ein "PWR_FLAG" an so eine Spannungsversorgung platzieren. Sehen Sie sich das folgende Beispiel an:

Spannungsanschlüsse und Spannungsflags

Die Fehlermarkierung wird dann verschwinden.

Most of the time, a PWR_FLAG must be connected to GND, because regulators have outputs declared as power out, but ground pins are never power out (the normal attribute is power in), so grounds never appear connected to a power source without a power flag symbol.

8.6. Konfiguration

Im Tab Optionen des geöffneten ERC Dialogs können Sie die Verbindungsregeln einrichten, um die elektrischen Bedingungen für die Prüfungen auf Fehler und Warnungen festzulegen.

Einstelloptionen für den ERC

Die Regeln können durch Klicken auf das gewünschte Kästchen in der Matrix geändert werden, es wird bei jedem Klick durch die Auswahl mit diesen Optionen fortlaufend iteriert: Normal, Warnung, Fehler.

8.7. ERC Protokolldatei

Eine ERC Protokolldatei kann erstellt und abgespeichert werden indem die Option "ERC Protokolldatei erstellen" aktiviert wird. Die Dateiendung für eine ERC Protokolldatei ist .erc. Hier ist ein Beispiel einer ERC Protokolldatei:

ERC control (4/1/1997-14:16:4)

***** Sheet 1 (INTERFACE UNIVERSAL)
ERC: Warning Pin input Unconnected @ 8.450, 2.350
ERC: Warning passive Pin Unconnected @ 8.450, 1.950
ERC: Warning: BiDir Pin connected to power Pin (Net 6) @ 10.100, 3.300
ERC: Warning: Power Pin connected to BiDir Pin (Net 6) @ 4.950, 1.400

>> Errors ERC: 4

9. Eine Netzliste erzeugen

9.1. Überblick

A netlist is a file which describes electrical connections between symbols. These connections are referred to as nets. In the netlist file you can find:

  • The list of the symbols

  • The list of connections (nets) between symbols.

Many different netlist formats exist. Sometimes the symbols list and the list of nets are two separate files. This netlist is fundamental in the use of schematic capture software, because the netlist is the link with other electronic CAD software such as:

  • PCB layout software.

  • Schematic and electrical signal simulators.

  • Compiler für CPLD’s (und andere programmierbare Bausteine).

Eeschema unterstützt folgende Netzlistenformate:

  • Pcbnew Format (Leiterplatten).

  • ORCAD PCB2 Format (Leiterplatten).

  • CADSTAR Format (Leiterplatten).

  • Spice Format, für verschiedene Simulatoren (das Spice-Format wird ebenfalls von anderen Simulatoren verwendet).

9.2. Netzlistenformate

Select the tool Netlist icon to open the netlist creation dialog.

Reiter Pcbnew ausgewählt

Dialog Netzliste für Pcbnew Format

Reiter Spice ausgewählt

Dialog Netzliste für Spiceformat

Using the different tabs you can select the desired format. In Spice format you can generate netlists with either net names which makes the SPICE file more human readable or net numbers which are used by older Spice. By clicking the Netlist button, you will be asked for a netlist file name.

Anmerkung
The netlist generation can take up to several minutes for large schematics.

9.3. Beispiele für Netzlisten

Nachfolgend sehen Sie einen Schaltplanentwurf unter Nutzung der PSPICE Bibliothek:

Beispielschaltplan

Beispiel einer Pcbnew Netzlistendatei:

# Eeschema Netlist Version 1.0 generee le 21/1/1997-16:51:15
(
(32E35B76 $noname C2 1NF {Lib=C}
(1 0)
(2 VOUT_1)
)
(32CFC454 $noname V2 AC_0.1 {Lib=VSOURCE}
(1 N-000003)
(2 0)
)
(32CFC413 $noname C1 1UF {Lib=C}
(1 INPUT_1)
(2 N-000003)
)
(32CFC337 $noname V1 DC_12V {Lib=VSOURCE}
(1 +12V)
(2 0)
)
(32CFC293 $noname R2 10K {Lib=R}
(1 INPUT_1)
(2 0)
)
(32CFC288 $noname R6 22K {Lib=R}
(1 +12V)
(2 INPUT_1)
)
(32CFC27F $noname R5 22K {Lib=R}
(1 +12V)
(2 N-000008)
)
(32CFC277 $noname R1 10K {Lib=R}
(1 N-000008)
(2 0)
)
(32CFC25A $noname R7 470 {Lib=R}
(1 EMET_1)
(2 0)
)
(32CFC254 $noname R4 1K {Lib=R}
(1 +12V)
(2 VOUT_1)
)
(32CFC24C $noname R3 1K {Lib=R}
(1 +12V)
(2 N-000006)
)
(32CFC230 $noname Q2 Q2N2222 {Lib=NPN}
(1 VOUT_1)
(2 N-000008)
(3 EMET_1)
)
(32CFC227 $noname Q1 Q2N2222 {Lib=NPN}
(1 N-000006)
(2 INPUT_1)
(3 EMET_1)
)
)
# End

Im PSPICE-Format sieht die Netzliste wie folgt aus:

* Eeschema Netlist Version 1.1 (Spice format) creation date: 18/6/2008-08:38:03

.model Q2N2222 npn (bf=200)
.AC 10 1Meg \*1.2
.DC V1 10 12 0.5


R12   /VOUT N-000003 22K
R11   +12V N-000003 100
L1   N-000003 /VOUT 100mH
R10   N-000005 N-000004 220
C3   N-000005 0 10uF
C2   N-000009 0 1nF
R8   N-000004 0 2.2K
Q3   /VOUT N-000009 N-000004 N-000004 Q2N2222
V2   N-000008 0 AC 0.1
C1   /VIN N-000008 1UF
V1   +12V 0 DC 12V
R2   /VIN 0 10K
R6   +12V /VIN 22K
R5   +12V N-000012 22K
R1   N-000012 0 10K
R7   N-000007 0 470
R4   +12V N-000009 1K
R3   +12V N-000010 1K
Q2   N-000009 N-000012 N-000007 N-000007 Q2N2222
Q1   N-000010 /VIN N-000007 N-000007 Q2N2222

.print ac v(vout)
.plot ac v(nodes) (-1,5)

.end

9.4. Anmerkungen zu Netzlisten

9.4.1. Zu beachtende Punkte für die Benennung von Netzlisten

Many software tools that use netlists do not accept spaces in the component names, pins, nets or other informations. Avoid using spaces in labels, or names and value fields of components or their pins to ensure maximum compatibility.

In der gleichen Weise können spezielle Zeichen, die keine Buchstaben oder Zahlen sind, Probleme verursachen. Beachten Sie, dass diese Einschränkung nicht für Eeschema gilt, sondern für Netzlistenformate, die dann nicht übersetzbar sind für Software, die Netzlistendateien verwendet.

9.4.2. PSPICE Netzlisten

Für den Pspice Simulator müssen Sie einige Befehlszeilen in der Netzliste selbst einfügen (.PROBE, .AC, etc.).

Jede Textzeile, die im Schaltplan einfügt wird und mit den Schlüsselwörtern -pspice oder -gnucap beginnt, wird (ohne das Schlüsselwort) am Anfang der Netzliste eingefügt.

Jede Textzeile, die im Schaltplan einfügt wird und mit den Schlüsselwörtern +pspice oder +gnucap beginnt, wird (ohne das Schlüsselwort) am Ende der Netzliste eingefügt.

Hier ist ein Beispiel das viele einzeilige Texte und einen mehrzeiligen Text verwendet:

Eeschema Schaltplan mit grafischen Text für PSPICE Netzlisten

Zum Beispiel, wenn Sie folgenden Text eingeben (Verwenden Sie kein Label!):

-PSPICE .PROBE

wird eine Zeile .PROBE in die Netzliste eingefügt.

Im vorherigen Beispiel oben wurden mit dieser Technik drei Zeilen am Anfang der Netzliste eingefügt und zwei am Ende.

Wenn Sie mehrzeiligen Text verwenden werden die +pspice oder +gnucap Schlüsselwörter nur einmal benötigt:

+PSPICE .model NPN NPN
.model PNP PNP
.lib C:\Program Files\LTC\LTspiceIV\lib\cmp\standard.bjt
.backanno

erzeugt diese vier Zeilen:

.model NPN NPN
.model PNP PNP
.lib C:\Program Files\LTC\LTspiceIV\lib\cmp\standard.bjt
.backanno

Also note that the GND net must be named 0 (zero) for Pspice.

9.5. Andere Formate

Für andere Netzlistenformate können Sie Netzlistenkonverter in Form von Plugins hinzufügen. Diese Konverter werden automatisch von Eeschema gestartet. Kapitel 14 zeigt einige Erklärungen und Beispiele für Konverter.

Ein Konverter ist eine Textdatei (XSL-Format), aber Sie können auch andere Sprachen wie Python verwenden. Wenn Sie das XSL-Format verwenden, liest ein Werkzeug (xsltproc.exe unter Windows oder xsltproc unter Linux/MAC) das Zwischenformat und die Konverterdatei, welches von Eeschema erzeugt wird, um die Ausgabedatei zu erzeugen. In diesem Fall ist die Konverterdatei (ein Stylesheet) sehr klein und leicht zu schreiben.

9.5.1. Das Dialogfenster aufrufen

Sie können ein neues Netzlisten-Plugin über den Button „Plugin hinzufügen“ einzufügen.

Auswahlbutton zum Einfügen von Plugins

Hier ist das Setup-Fenster für das PadsPcb Plugin zu sehen:

Einstellungen des Plugins PadsPCB

Das Setup benötigt:

  • Einen Titel (zum Beispiel der Name für das Netzlistenformat).

  • Das zu startende Plugin.

Wenn die Netzliste erzeugt wurde:

  1. Eeschema erzeugt eine Zwischendatei *.tmp, zum Beispiel test.tmp.

  2. Eeschema startet das Plugin, welches test.tmp liest und test.net erzeugt.

9.5.2. Befehlszeilenformat

Hier ist ein Beispiel, das xsltproc.exe als Werkzeug (unter Windows) verwendet um .xsl Dateien umzuwandeln, und eine Datei netlist_form_pads-pcb.xsl als Konverter Stylesheet benutzt:

f:/kicad/bin/xsltproc.exe -o %O.net f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl %I

Folgende Erläuterungen dazu:

f:/kicad/bin/xsltproc.exe

Ein Werkzeug um XSL-Dateien zu lesen und umzuwandeln

-o %O.net

Ausgabedatei: %O legt die Ausgabedatei fest.

f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl

Dateiname des Konverters (ein Stylesheet im XSL-Format).

%I

Wird durch die von Eeschema erzeugte Zwischendatei ersetzt (*.tmp).

Für einen Schaltplan mit dem Namen test.sch, wäre die tatsächliche Befehlszeile:

f:/kicad/bin/xsltproc.exe -o test.net f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl test.tmp.

9.5.3. Konverter und Stylesheet (Plugin)

Dies ist ein sehr einfaches Stück Software, da sein einziger Zweck ist, eine Textdatei (die Zwischendatei) in eine andere Datei umzuwandeln. Zusätzlich können Sie aus der Zwischendatei auch eine Stückliste (BOM) erstellen.

Wenn Sie nur xsltproc als Konverter verwenden, wird nur das Stylesheet erzeugt.

9.5.4. Dateiformat der Zwischen-Netzliste

Bitte schauen Sie in Kapitel 14 für weitere Erklärungen zu xslproc, Beschreibungen zum Zwischendateiformat und einigen Beispielen für Stylesheets für Konverter.

10. Plotten und Drucken

10.1. Einleitung

Sie können auf die Druck- und Plotbefehle über das Menü "Datei" zugreifen.

Auswahl der Befehle für Drucken und Plotten

Die unterstützten Ausgabeformate sind Postscript, PDF, SVG, DXF und HPGL. Sie können natürlich ebenfalls auch direkt auf Ihren Drucker drucken.

10.2. Übliche Druckbefehle:

Aktuelle Seite drucken

Druckt eine Datei nur für das aktuelle Arbeitsblatt.

Alle Seiten drucken

Erlaubt es Ihnen die ganze Hierarchie auszudrucken (für jedes Arbeitsblatt wird eine Druckdatei erzeugt).

10.3. Ausgabe nach Postscript

Dieser Befehl erlaubt es Ihnen Postscriptdateien zu erzeugen.

Druckdialog für Postscriptausgabe

Der Dateiname ist der des Schaltplans mit der Erweiterung .ps. Sie können die Option "Schaltplanumrahmung und -betitelung drucken" abwählen. Das ist hilfreich, wenn Sie eine gekapselte Postscriptdatei erzeugen wollen (Dateiformat .eps), wie es häufig verwendet wird um Diagramme in einer Textverarbeitungssoftware einzufügen. Das Benachrichtigungsfenster zeigt den Dateinamen der erzeugten Datei.

10.4. Ausgabe nach PDF

Druckdialog für PDF Ausgabe

Erlaubt es Ihnen Druckdateien im PDF Format zu erstellen. Der Dateiname ist der Schaltplanname mit der Erweiterung .pdf.

10.5. Ausgabe nach SVG

Druckdialog für SVG Ausgabe

Erlaubt es Ihnen Druckdateien im vektorisierten SVG Format zu erstellen. Der Dateiname ist der Blattname mit der Erweiterung .svg.

10.6. Ausgabe nach DXF

Druckdialog für DXF Ausgabe

Erlaubt es Ihnen Druckdateien im DXF Format zu erstellen. Der Dateiname ist der Blattname mit der Erweiterung .dxf.

10.7. Ausgabe nach HPGL

Dieser Befehl erlaubt es Ihnen eine HPGL Datei zu erstellen. In diesem Format können Sie festlegen:

  • Blattgröße

  • (Koordinaten-)Ursprung

  • Stiftdicke in mm.

Das Dialogfenster der Plottereinstellungen sieht wie folgt aus:

Druckdialog für HPGL Ausgabe

Die Ausgabedatei wird den Schaltplannamen plus die Erweiterung .plt haben.

10.7.1. Auswahl der Seitengröße

Die Seitengröße ist normalerweise auf die Schaltplangröße gesetzt. In diesem Fall wird die im Titelblock festgelegte Blattgröße verwendet und der gewählte Maßstab wird 1:1 sein. Wenn eine andere Blattgröße ausgewählt wird (A4 bis A0 oder A bis E) wird der Maßstab automatisch angepasst, um die Seite zu füllen.

10.7.2. Offset Anpassungen

Für alle Standardabmessungen können Sie den Offset anpassen, um die Zeichnung so präzise wie möglich zu zentrieren. Weil Plotter ihren (Koordinaten-)Ursprung in der Mitte oder in der unteren linken Ecke des Blattes haben, ist es notwendig einen Ursprung festzulegen, um korrekt drucken zu können.

Allgemein ausgedrückt:

  • Für Plotter, die ihren Koordinatenursprung in der Mitte des Blattes haben, muss der Offset negativ sein und auf die Hälfte der Blattabmessungen gesetzt werden.

  • Für Plotter die ihren Koordinatenursprung an der unteren linken Ecke haben muss der Offset auf 0 gesetzt werden.

Um einen Offset einzustellen:

  • Wählen Sie die Blattgröße.

  • Setzen Sie den Offset X und Offset Y.

  • Klicken Sie auf Offset übernehmen.

Dieser Befehl, verfügbar durch das Icon icons/print_button_png , erlaubt es Ihnen, Entwurfsdateien für den Standarddrucker anzuzeigen und zu erzeugen.

Druckdialog für Druckerausgabe

Die Option "Drucke Schaltplanreferenz und Schaltplanbetitelung" schaltet Blattreferenzen und Titelblock ein oder aus.

Die Option "Drucke Schwarz-Weiß" setzt den einfarbigen Druckmodus. Diese Option wird allgemein benötigt wenn sie einen Schwarzweiß Laserdrucker verwenden, weil sonst Farben in Halbtönen ausgegeben werden und häufig nicht gut lesbar sind.

11. Bauteilbibliothekseditor

11.1. Allgemeine Informationen über Bauteilbibliotheken

Ein Bauteil ist ein Schaltplanelement welches die grafische Darstellung, die elektrischen Verbindungen und das Bauteil definierende Felder enthält. Bauteile die in einem Schaltplan verwendet werden, werden in Bauteilbibliotheken gespeichert. Eeschema stellt ein Werkzeug zur Bearbeitung der Bauteilbibliotheken zur Verfügung, das es Ihnen erlaubt Bibliotheken zu erstellen, Bauteile hinzuzufügen, zu löschen oder zwischen Bibliotheken zu verschieben, Bauteile in Dateien zu exportieren und Bauteile aus Dateien zu importieren. Das Werkzeug zur Bibliotheksbearbeitung stellt einen einfachen Weg zur Verfügung, um Bauteilbibliotheksdateien zu verwalten.

11.2. Überblick über Bauteilbibliotheken

Eine Bauteilbibliothek besteht aus einem oder mehreren Bauteilen. Allgemein sind die Bauteile logisch gruppiert nach Funktion, Typ und/oder Hersteller.

Ein Bauteil besteht aus:

  • Grafischen Elementen wie Linien, Kreise, Bögen, Text, usw., die die Symboldarstellung festlegen.

  • Anschlüssen (Pins) welche sowohl grafische Eigenschaften haben (Linien, Takt, Invertiert, Low-aktiv, usw.) als auch elektrische Eigenschaften (Eingang, Ausgang, Bidirektional, usw.), die vom ERC-Werkzeug genutzt werden.

  • Feldern für die Referenz, den Wert, zugehörige Footprintnamen für Leiterplattenentwurf, usw.

  • Aliase die verwendet werden um ein gemeinsames Bauteil wie ein 7400 mit all seinen Abwandlungen wie 74LS00, 74HC00 und 7437 zu verbinden. Alle diese Aliase teilen sich das gleiche Bibliotheksbauteil.

Ein korrekter Bauteilentwurf erfordert:

  • Die Festlegung ob das Bauteil aus einem oder mehreren Einheiten besteht.

  • Der Überlegung ob das Bauteil eine alternative Darstellung haben muss, auch bekannt als De Morgan Darstellung.

  • Dem Entwerfen seiner grafischen Darstellung mit Linien, Rechtecken, Kreisen, Polygonen und Text.

  • Das Hinzufügen von Anschlüssen (Pins) unter sorgfältiger Festlegung der grafischen Elemente jedes Anschlusses, des Namens, der Nummer und der elektrischen Eigenschaften (Eingang, Ausgang, Tri-State, Spannungsausgang, usw.).

  • Das Hinzufügen eines Alias wenn andere Bauteile das gleiche Symbol und Pinanordnung haben, oder das entfernen eines Alias wenn das Bauteil aus einem anderen Bauteil abgeleitet wurde.

  • Das Ergänzen von optionalen Feldern, wie der Name des Footprints, der für den Leiterplattenentwurf verwendet werden soll, und/oder die Festlegung ihrer Sichtbarkeit (im Schaltplan).

  • Das Dokumentieren des Bauteils durch hinzufügen einer Beschreibung und Links zu Datenblätter usw.

  • Das Abspeichern des Bauteils in der gewünschten Bibliothek.

11.3. Übersicht über den Bauteil Bibliothekseditors

Das Hauptfenster des Bauteilbibliothekseditors wird unten gezeigt. Es enthält drei Werkzeugleisten für den schnellen Zugriff auf häufige Funktionen und einen Ansichts-/-Bearbeitungsbereich für das Bauteil. Nicht alle Befehle sind über die Werkzeugleisten verfügbar, können aber über die Menüs aufgerufen werden.

Hauptfenster Bauteilbibliothekseditor

11.3.1. Hauptwerkzeugleiste

Die Hauptwerkzeugleiste (siehe unten) befindet sich typischerweise ganz oben im Hauptfenster und enthält die Werkzeuge zur Verwaltung der Bibliotheken, Befehle zum Rückgängig machen bzw. Wiederholen, Zoom-Befehle und Dialoge zum Anpassen der Bauteileigenschaften.

images/de/toolbar_libedit.png

Aktuelle Bibliothek abspeichern

Speichert die aktuell ausgewählte Bibliothek. Der Button ist deaktiviert wenn aktuell keine Bibliothek ausgewählt ist oder keine Änderungen an der aktuell ausgewählten Bibliothek gemacht wurden.

Arbeitsbibliothek auswählen

Wählt die zu bearbeitende Bibliothek aus.

Bauteil in der aktuellen Bibliothek entfernen

Löscht ein Bauteil aus der aktuell ausgewählten Bibliothek oder jeder anderen durch das Projekt festgelegten Bibliothek, wenn aktuell keine Bibliothek ausgewählt ist.

Bibliotheksbrowser

Öffnet den Bauteilbibliotheksbrowser, um die Bibliothek und das Bauteil zur Bearbeitung auszuwählen.

Neues Bauteil erstellen

Erstelle ein neues Bauteil.

Bauteil aus der Bibliothek laden

Lädt ein Bauteil aus der aktuell gewählten Bibliothek zur Bearbeitung.

Neues Bauteil aus dem aktuellen Bauteil erstellen

Erstellt ein neues Bauteil aus dem aktuell geladenen Bauteil.

Gegenwärtiges Bauteil in der Bibliothek aktualisieren

Speichert die Änderungen am aktuellen Bauteil im Arbeitsspeicher. Die Bibliotheksdatei wird nicht verändert.

Bauteil importieren

Importiert ein Bauteil aus einer Datei.

Bauteil exportieren

Exportiert das aktuelle Bauteil in eine Datei.

Gegenwärtiges Bauteil in einer neuen Bibliothek abspeichern

Erstellt eine neue Bibliothek mit dem aktuellen Bauteil. Anmerkung: Neue Bibliotheken werden nicht automatisch dem Projekt hinzugefügt.

Letzte Änderung rückgängig machen

Macht die letzte Bearbeitung rückgängig.

Wiederherstellen des Rückgängig machen

Stellt die letzte Bearbeitung wieder her.

Bauteileigenschaften editieren

Bearbeitet die Eigenschaften des aktuellen Bauteils.

icons/text.png

Edit the fields of current component.

Bauteil überprüfen

Prüft das aktuelle Bauteil auf Entwurfsfehler.

Hineinzoomen

Hineinzoomen.

Herauszoomen

Herauszoomen.

Schaltplan neu zeichnen

Anzeige neu zeichnen.

Schaltplan auf Bildschirm anpassen

Zoome Bildschirmausschnitt auf das Bauteil.

DeMorgan Normaldarstellung

Wählt die normale Bauteildarstellung. Der Button ist deaktiviert, wenn für das aktuelle Bauteil keine alternative Darstellung vorhanden ist.

Alternative DeMorgan Darstellung

Wählt die alternative Bauteildarstellung. Der Button ist deaktiviert, wenn für das aktuelle Bauteil keine alternative Darstellung vorhanden ist.

Anzeige der Dokumentation

Zeigt die zugehörige Dokumentation. Der Button ist deaktiviert, wenn für das aktuelle Bauteil keine Dokumentation hinterlegt ist.

Auswahl der Einheit

Wählt die anzuzeigende Einheit. Die Drop-Down Auswahl ist deaktiviert, wenn das aktuelle Bauteil nicht mehrere Einheiten hat.

Auswahl des Alias

Alias auswählen. Die Drop-Down Auswahl ist deaktiviert, wenn das aktuelle Bauteil keine Aliase hat.

Anschlüsse bearbeiten

Anschluss bearbeiten: unabhängiges Bearbeiten von Anschlussform und Position für Bauteile mit mehreren Gattern und alternativen Symbolen.

Anzeige Pintabelle

Zeigt die Anschlusstabelle.

11.3.2. Werkzeugleiste Elemente

Die senkrechte Werkzeugleiste befindet sich an der rechten Seite des Editorfensters. Diese Leiste enthält alle Elemente die für den Entwurf eines Bauteils benötigt werden. Die nachfolgende Tabelle unten beschreibt jeden Button der Werkzeugleiste.

Werkzeug abwählen

Auswahlwerkzeug. Rechtsklick mit dem Auswahlwerkzeug öffnet das Kontextmenü für das Objekt unter dem Cursor. Linksklick mit dem Auswahlwerkzeug zeigt die Eigenschaften des Objektes unter dem Cursor im Nachrichtenbereich am untereren Rand des Hauptfensters an. Doppelklick mit dem Auswahlwerkzeug öffnet den Eigenschaftendialog für das Objekt unter dem Cursor.

Pins hinzufügen

Anschlusswerkzeug. Linksklick fügt einen neuen Anschluss hinzu.

icons/text.png

Graphical text tool. Left-click to add a new graphical text item.

Rechteck hinzufügen

Rechteckwerkzeug. Linksklick startet das Zeichnen der ersten Ecke eines grafischen Rechtecks. Nochmaliger Linksklick platziert die (diagonal) gegenüber liegende Ecke des Rechtecks.

Kreis hinzufügen

Kreiswerkzeug. Linksklick um einen grafischen Kreis am Mittelpunkt zu beginnen. Nochmaliger Linksklick setzt den Radius des Kreises fest.

Kreisbogen hinzufügen

Kreisbogenwerkzeug. Linksklick um einen neuen Kreisbogen am Mittelpunkt zu beginnen. Nochmaliger Linksklick um den ersten Endpunkt des Kreisbogens festzulegen. Nochmaliger Linksklick um den zweiten Endpunkt des Kreisbogens festzulegen.

Polygon zeichnen

Polygonwerkzeug. Linksklick um ein neues grafisches Polygonelement im aktuellen Bauteil zu beginnen. Linksklick für jede neue Polygonlinie. Doppelklick um das Polygon fertigzustellen.

Bauteilanker verschieben

Ankerwerkzeug. Linksklick um die Ankerposition des Bauteils festzulegen.

Existierende Bauteilzeichnung importieren

Import eines Bauteils aus einer Datei.

Bauteil exportieren

Exportiert das aktuelle Bauteil in eine Datei.

Element entfernen

Löschwerkzeug. Linksklick um ein Objekt aus dem aktuellen Bauteil zu löschen.

11.3.3. Werkzeugleiste für Einstellungen

Die linke Werkzeugleiste erlaubt es Ihnen einige Zeichnungseinstellungen für den Editor zu ändern. Die Tabelle unten erklärt jeden Button der Werkzeugleiste.

Raster einblenden oder ausblenden

Sichtbarkeit des Rasters ein- und ausschalten.

Maßeinheit in Zoll

Schaltet die Maßeinheit auf Zoll um.

Maßeinheit in mm

Schaltet die Maßeinheit auf Millimeter um.

Cursorform ändern

Vollbild-Cursor an- und ausschalten.

11.4. Bibliotheksauswahl und Bibliothekswartung

Die Auswahl der aktuellen Bibliothek wird über das Symbol Arbeitsbibliothek auswählen gestartet, welches Ihnen alle verfügbaren Bibliotheken anzeigt und eine auswählen lässt. Wenn ein Bauteil geladen oder gespeichert wird dann wird es in dieser Bibliothek abgelegt. Der Bibliotheksname des Bauteils ist der Inhalt seines Wertefeldes.

Anmerkung
  • Sie müssen eine Bibliothek in Eeschema laden, um auf ihren Inhalt zugreifen zu können.

  • Der Inhalt der aktuellen Bibliothek kann nach der Bearbeitung gesichert werden, indem Sie auf das Symbol Aktuelle Bibliothek abspeichern in der Hauptwerkzeugleiste klicken.

  • Ein Bauteil kann aus der Bibliothek entfernt werden, indem Sie auf das Symbol Element entfernen klicken.

11.4.1. Auswählen und Speichern eines Bauteils

Wenn Sie ein Bauteil bearbeiten, bearbeiten Sie nicht wirklich das Bauteil in dessen Bibliothek sondern eine Kopie davon im Arbeitsspeicher des Computers. Jede Bearbeitung kann leicht rückgängig gemacht werden. Ein Bauteil kann von einer lokalen Bibliothek oder von einem bestehenden Bauteil geladen werden.

Bauteilauswahl

Ein Klick auf Bauteil aus der Bibliothek laden in der Hauptwerkzeugleiste zeigt eine Liste aller verfügbaren Bauteile an, die Sie auswählen und aus der aktuell ausgewählten Bibliothek laden können.

Anmerkung
Wählen Sie ein Bauteil über sein Alias aus wird der Name des geladenen Bauteils in der Fenstertitelleiste angezeigt anstelle des ausgewählten Alias. Die Liste der Bauteil-Aliase wird immer mit jedem Bauteil geladen und kann bearbeitet werden. Sie können ein neues Bauteil erstellen, indem Sie ein Alias des aktuellen Bauteils hier Auswahl des Alias auswählen. Das erste Element in der Alias-Liste ist der Hauptname des Bauteils.
Anmerkung
Alternativ erlaubt Ihnen ein Klick auf Existierende Bauteilzeichnung importieren ein Bauteil zu laden, welches vorher über Bauteil exportieren gespeichert wurde.
Ein Bauteil abspeichern

Nach dem Bearbeiten kann ein Bauteil in der aktuellen Bibliothek oder in einer neuen Bibliothek gespeichert werden oder in eine Sicherungsdatei exportiert werden.

Um das geänderte Bauteil in der aktuellen Bibliothek zu speichern, klicken Sie auf Gegenwärtiges Bauteil in der Bibliothek aktualisieren . Bitte beachten Sie das der Befehl zur Aktualisierung das Bauteil nur im Arbeitsspeicher ändert. So können Sie sich Ihre Meinung bilden, bevor Sie die Bibliothek abspeichern.

Um Bauteiländerungen dauerhaft in der Bibliotheksdatei zu speichern, klicken Sie auf Aktuelle Bibliothek abspeichern , was die bestehende Bibliotheksdatei mit den Bauteiländerungen überschreibt.

Wenn Sie eine neue Bibliothek erzeugen wollen, die das aktuelle Bauteil enthält, klicken Sie auf Gegenwärtiges Bauteil in einer neuen Bibliothek abspeichern . Sie werden aufgefordert den neuen Bibliotheksnamen einzugeben.

Anmerkung

Neue Bibliotheken werden nicht automatisch dem aktuellen Projekt hinzugefügt.

You must add any new library you wish to use in a schematic to the list of project libraries in Eeschema using the Symbol Library Table dialog.

Klicken Sie auf Bauteil exportieren um eine Datei zu erzeugen, die nur das aktuelle Bauteil enthält. Diese Datei wird eine Standardbibliotheksdatei, die nur dieses eine Bauteil enthält. Diese Datei kann dazu verwendet werden, um das Bauteil in eine andere Bibliothek zu importieren. Tatsächlich sind die Befehle "Neue Bibliothek erstellen" und "Bauteil exportieren" grundsätzlich identisch.

Bauteile zu einer anderen Bibliothek übertragen

Sie können sehr leicht ein Bauteil von einer Quellbibliothek in eine Zielbibliothek über folgende Befehle kopieren:

  • Wählen Sie die Quellbibliothek mit einem Klick auf Aktuelle Bibliothek abspeichern .

  • Laden Sie das zu übertragende Bauteil mit einem Klick auf Bauteil aus der Bibliothek   laden . Das Bauteil wird im Bearbeitungsbereich angezeigt.

  • Wählen Sie die Zielbibliothek mit Klick auf Aktuelle Bibliothek abspeichern .

  • Speichern Sie das aktuelle Bauteil in die neue Bibliothek im Arbeitsspeicher mit Klick auf Gegenwärtiges Bauteil   in der Bibliothek aktualisieren .

  • Speichern Sie das Bauteil in die aktuelle lokale Bibliotheksdatei mit Klick auf Aktuelle Bibliothek abspeichern .

Änderungen am Bauteil verwerfen

Wenn Sie ein Bauteil bearbeiten, dann ist das bearbeitete Bauteil nur eine Arbeitskopie des tatsächlichen Bauteils aus der Bibliothek. Das bedeutet, solange Sie es nicht abgespeichert haben, können Sie es einfach neu einlesen und alle gemachten Änderungen verwerfen. Wenn Sie es bereits in den Arbeitsspeicher aktualisiert haben aber noch nicht in die Bibliotheksdatei abgespeichert, können Sie den Editor einfach beenden und neu starten. Eeschema wird alle Änderungen verwerfen.

11.5. Bibliotheksbauteile erstellen

11.5.1. Ein neues Bauteil erstellen

Ein neues Bauteil kann mit einem Klick auf Bauteil hinzufügen erstellt werden. Sie werden nach dem Bauteilnamen gefragt (der Name wird als Standardwert für das Feld Wert im Schaltplaneditor benutzt), den Referenzbezeichner (U, IC, R…), die Anzahl der Einheiten pro Baustein (zum Beispiel ein 7400 hat 4 Gatter pro Baustein) und ob eine alternative Darstellung (manchmal als DeMorgan bezeichnet) gewünscht ist. Wenn das Feld für den Referenzbezeichner leer bleibt, wird dieses standardmäßig auf "U" gesetzt. Diese Eigenschaften können später geändert werden, aber es ist effizienter diese schon bei der Erstellung des Bauteils korrekt zu setzen.

Vorgabe Bauteileigenschaften

Ein neues Bauteil wird unter Nutzung der obigen Eigenschaften erstellt und wird im Editor wie unten zu sehen dargestellt:

Neues Bauteil im Bibliothekseditor

11.5.2. Ein Bauteil aus einem anderen Bauteil erstellen

Häufig ist das Bauteil, das Sie erstellen wollen, einem ähnlich welches schon in der Bibliothek vorhanden ist. In diesem Fall ist es meistens einfacher ein bestehendes Bauteil zu laden und zu bearbeiten.

  • Laden Sie das Bauteil, das als Ursprung verwendet werden soll.

  • Klicken Sie auf Neues Bauteil aus dem   aktuellen Bauteil erstellen oder ändern Sie seinen Namen mit Rechtsklick auf das Wert-Feld und bearbeiten Sie den Text. Wenn Sie das aktuelle Bauteil duplizieren wollen, werden Sie nach einem neuen Bauteilnamen gefragt.

  • Wenn das Ausgangsbauteil Aliase hat, werden Sie aufgefordert die Aliase vom neuen Bauteil zu entfernen die mit der aktuellen Bibliothek kollidieren. Wenn Sie mit Nein antworten wird die Erstellung des neuen Bauteils abgebrochen. Bauteilbibliotheken können keine doppelten Namen oder Aliase enthalten.

  • Bearbeiten Sie das neue Bauteil wie benötigt.

  • Aktualisieren Sie das neue Bauteil in der aktuellen Bibliothek mit einem Klick auf Gegenwärtiges Bauteil in   der Bibliothek aktualisieren oder speichern Sie es in eine neue Bibliothek mit einem Klick auf Gegenwärtiges Bauteil   in einer neuen Bibliothek abspeichern oder wenn Sie das neue Bauteil in einer anderen bestehenden Bibliothek speichern wollen, wählen Sie die andere Bibliothek durch Klick auf Aktuelle   Bibliothek abspeichern und speichern Sie das neue Bauteil.

  • Speichern Sie die aktuelle Bibliotheksdatei auf die Festplatte mit Klick auf Aktuelle Bibliothek abspeichern .

11.5.3. Bauteileigenschaften

Bauteileigenschaften sollten sorgfältig während der Bauteilerstellung gesetzt werden oder alternativ werden sie vom kopierten Bauteil übernommen. Um Bauteileinschaften zu ändern, klicken Sie auf the Bauteileigenschaften editieren um den unten angezeigten Dialog zu öffnen.

Bauteileigenschaften neues Bauteil

Es ist sehr wichtig die Anzahl der Einheiten pro Bauteil korrekt zu setzen und ob das Bauteil eine alternative Darstellung hat, denn wenn Anschlüsse bearbeitet oder erstellt werden, werden die entsprechenden Pins für jede Einheit erstellt. Wenn Sie die Anzahl der Einheiten pro Bauteil nach der Erstellung und Bearbeitung der Anschlüsse ändern, wird zusätzliche Arbeit notwendig um die neuen Anschlüsse und Symbole der Einheiten zu erstellen. Nichtsdestotrotz ist es möglich diese Eigenschaften zu jeder Zeit zu ändern.

Die grafischen Optionen "Pinnummern anzeigen" und "Pinnamen anzeigen" legen die Sichtbarkeit des Textes von Anschlussnummer und Anschlussnamen fest. Dieser Text wird sichtbar, wenn die zugehörige Option aktiviert ist. Die Option "Pinnamen innenseitig platzieren" legt die Position der Anschlussnamen relativ zum Anschlusskörper fest. Dieser Text wird innerhalb des Bauteilrahmens angezeigt, wenn diese Option aktiviert ist. In diesem Fall definiert die Eigenschaft "Offset für die Position des Pinnamens" den Versatz des Textes vom Ende des Anschlusses. Ein Wert von 30 bis 40 (in 1/1000 Zoll) ist sinnvoll.

Das Beispiel unten zeigt ein Bauteil mit deaktivierter Option "Pinnamen innenseitig platzieren". Beachten sie die Position der Namen und Anschlussnummern.

Bauteil mit Pinnamen nicht innenseitig platziert

11.5.4. Bauteile mit alternativen Symbolen

Wenn das Bauteil mehr als eine symbolische Darstellung hat, müssen Sie die verschiedenen Symbole des Bauteils auswählen, um sie zu bearbeiten. Um das normale Symbol zu bearbeiten, klicken Sie auf icons/morgan1_png .

Um das alternative Symbol zu bearbeiten, klicken Sie auf Alternative DeMorgan Darstellung . Benutzen Sie Auswahl des Alias wie unten gezeigt um die zu bearbeitende Einheit auszuwählen.

Auswahl Einheit für alternatives Symbol

11.6. Grafische Elemente

Grafische Elemente erstellen die symbolische Darstellung eines Bauteils und enthalten keine Informationen über die elektrische Verbindung. Der Erstellung ist über die folgenden Werkzeuge möglich:

  • Linien und Polygone, die durch Anfangs- und Endpunkte definiert sind.

  • Rechtecke, die durch zwei diagonale Ecken definiert sind.

  • Kreise, die durch Zentrum und Radius definiert sind.

  • Kreisbögen, die durch den Anfangs- und Endpunkt des Bogens und sein Zentrum definiert sind. Ein Kreisbogen geht von 0° bis 180°.

Die senkrechte Werkzeugleiste auf der rechten Seite des Hauptfensters erlaubt es Ihnen alle grafischen Elemente auszuwählen und zu platzieren, die benötigt werden, um die symbolische Darstellung des Bauteils zu erstellen.

11.6.1. Zugehörigkeit grafischer Elemente

Jedes grafische Element (Linie, Kreis Kreisbogen, usw.) kann als zugehörig zu allen Einheiten und/oder Bauform oder speziell für eine Einheit und/oder Bauform definiert werden. Elementeigenschaften können einfach und schnell über das Kontextmenü durch einen Rechtsklick auf das ausgewählte Element ausgewählt werden. Unten sehen Sie das Kontextmenü für ein Linienelement.

Kontextmenü zu Bearbeiten der Linieneigenschaften

Sie können ebenfalls auf ein Element doppelklicken, um seine Eigenschaften zu bearbeiten. Unten ist der Eigenschaftendialog für die Eigenschaften eines Linienzuges zu sehen

Dialog Linienzug Eigenschaften

Die Eigenschaften eines grafischen Elementes sind:

  • Breite, definiert die Strichbreite des Elements in der aktuellen Maßeinheit.

  • Die Einstellung "Von allen Einheiten eines Bauteils gemeinsam genutzt" definiert, ob das grafische Element für jede Einheit in Bauteilen mit mehr als einer Einheit gezeichnet wird oder ob das grafische Element nur für die aktuelle Einheit gezeichnet wird.

  • Die Einstellung "Von allen Darstellungsformen (DeMorgan) für Bauteile gemeinsam genutzt" definiert ob das grafische Element für jede symbolische Darstellungsform in Bauteilen mit alternativer Darstellungsform gezeichnet wird oder nur für die aktuelle Darstellungsform.

  • Die Einstellung der Füllart legt fest ob das Symbol, das mit diesem grafischen Element dargestellt wird, ungefüllt, mit gefülltem Hintergrund oder gefülltem Vordergrund gezeichnet wird.

11.6.2. Grafische Textelemente

The icons/text.png allows for the creation of graphical text. Graphical text is always readable, even when the component is mirrored. Please note that graphical text items are not fields.

11.7. Mehrere Einheiten pro Bauteil und alternative Darstellungsformen

Bauteile können zwei symbolische Darstellungsformen haben (ein Standardsymbol und ein alternatives Symbol, oft als "DeMorgan" bezeichnet) und/oder mehr als eine Einheit pro Bauteil (Logikgatter zum Beispiel). Manche Bauteile können mehr als eine Einheit pro Bauteil haben, jedes mit einem anderem Symbol und anderer Anschlusskonfiguration.

Betrachten Sie zum Beispiel ein Relais mit zwei Schaltern, welches als ein Bauteil mit drei unterschiedlichen Einheiten entworfen werden kann: eine Spule, Wechsler 1 und Wechsler 2. Der Entwurf eines Bauteils mit mehreren Einheiten pro Bauteil und alternativen Darstellungsformen ist sehr flexibel. Ein Anschluss oder Bauteilsymbol kann für alle Einheiten gemeinsam oder speziell für eine einzelne Einheit oder sie können gemeinsam für beide Darstellungsformen oder speziell für eine einzelne Darstellungsform sein.

Standardmäßig sind Anschlüsse spezifisch für jede Darstellungsform in jeder Einheit, weil die Anschlussnummer speziell für dieser Einheiten gilt und die Form von der Darstellungsform abhängt. Wenn ein Anschluss für alle Einheiten und Darstellungsformen gemeinsam gilt, müssen Sie es nur einmal für alle Einheiten und Darstellungsformen erstellen (das ist üblicherweise der Fall für Spannungsanschlüsse). Das trifft ebenfalls auf die grafischen Elemente der Darstellungsform zu, welche gemeinsam für alle Einheiten gültig sein können (aber typischerweise speziell für jede einzelne Darstellungsform sind).

11.7.1. Beispiel eines Bauteils mit mehreren Einheiten und unterschiedlichen Symbolen:

Das ist ein Beispiel eines Relais das mit drei Einheiten pro Bauteil definiert wurde, Wechsler 1, Wechsler 2 und Spule:

Option: Anschlüsse sind nicht verbunden. Sie können Anschlüsse für jede Einheit hinzufügen oder bearbeiten ohne Verknüpfung zu Anschlüssen der anderen Einheiten.

Optionsauswahl Verbindungen der Anschlüsse

"Untereinander nicht austauschbare Einheiten" muss aktiviert sein.

Aktivieren der Option Untereinander nicht austauschbare Einheiten

Einheit 1

Relais Einheit 1

Einheit 2

Relais Einheit 2

Einheit 3

Relais Einheit 3

Diese Einheit hat nicht das gleiche Symbol und Anschlusslayout und ist daher nicht austauschbar mit den Einheiten 1 und 2.

Grafische Symbolelemente

Nachfolgend sind die Eigenschaften für ein grafisches Symbolelement aufgeführt. Für das Beispiel mit dem Relais oben haben die drei Einheiten verschiedene symbolische Darstellungen. Daher wurde jede Einheit getrennt erstellt und für die grafischen Symbolelemente musste "Von allen Einheiten eines Bauteils gemeinsam genutzt" deaktiviert werden.

Option Von allen Einheiten eines Bauteils gemeinsam benutzt deaktivieren

11.8. Anschlusserstellung und Anschlussbearbeitung

Sie können auf Pins hinzufügen klicken um einen Anschluss zu erstellen und einzufügen. Das Bearbeiten aller Anschlusseigenschaften wird aufgerufen durch einen Doppelklick auf den Anschluss oder Rechtsklick auf den Anschluss um das Kontextmenü zu öffnen. Anschlüsse müssen sorgfältig erstellt werden, jeder Fehler einen Einfluss auf den Leiterplattenentwurf hat. Schon vorhandene Anschlüsse können bearbeitet, gelöscht und/oder bewegt werden.

11.8.1. Anschlussübersicht

Ein Anschluss ist über seine grafische Darstellung, seinen Namen und seine "Nummer" definiert. Die "Nummer" des Anschlusses ist über 4 Zeichen (Buchstaben und/oder Nummern) festgelegt. Damit das ERC-Werkzeug nutzbringend ist, muss der Elektrische Typ des Anschlusses (Eingang, Ausgang, Tri-State, …) korrekt festgelegt sein. Wenn der Typ nicht korrekt gesetzt ist, können die Prüfergebnisse des ERC falsch sein.

Wichtige Hinweise:

  • Verwenden Sie keine Leerzeichen in den Anschlussnamen und Anschlussnummern.

  • Um einen Anschlussnamen mit einem invertierten Signal zu definieren (Überstrich) benutzen Sie das ~ (Tilde) Zeichen. Das nächste ~ Zeichen wird den Überstrich beenden. Zum Beispiel ~FO~O wird dargestellt als FO O.

  • Ist der Anschlussname auf ein einziges Zeichen reduziert wird der Anschluss als nicht benannt betrachtet.

  • Anschlussnamen die mit # beginnen, sind für Symbole vom Typ Spannungsanschluss reserviert.

  • Eine Anschluss-"Nummer" besteht aus 1 bis 4 Buchstaben und/oder Nummern. 1,2,..9999 sind gültige Nummern. A1, B3, Anod, Gnd, Wire, usw. sind ebenfalls gültig.

  • Doppelte Anschluss-"Nummern" können in einem Bauteil nicht vergeben werden.

11.8.2. Anschlusseigenschaften

Pineigenschaften verändern und anpassen

Der Dialog der Anschlusseigenschaften erlaubt es Ihnen alle Eigenschaften eines Anschlusses, auch Pin genannt, zu bearbeiten. Dieser Dialog wird automatisch geöffnet, wenn Sie einen Anschluss erstellen oder auf einen vorhandenen Anschluss doppelklicken. Dieser Dialog erlaubt Ihnen diese Änderungen:

  • Name und Textgröße des Namens.

  • Nummer und Textgröße der Nummer.

  • Länge.

  • Elektrischer und grafischer Typ.

  • Zugehörigkeit zu Einheit und alternativer Darstellung.

  • Sichtbarkeit.

11.8.3. Grafischer Stil von Anschlüssen

Im Bild unten sind die verschiedenen grafischen Stile für Anschlüsse dargestellt. Die Wahl der Graphischen Darstellung hat keinen Einfluss auf den elektrischen Typ des Anschlusses.

Auswahloptionen grafische Anschlussdarstellung

11.8.4. Typen von Elektrischen Anschlüssen

Den korrekten elektrischen Typ eines Anschlusses auszuwählen ist wichtig für das ERC-Werkzeug. Die elektrischen Typen sind definiert als:

  • Bidirektional: Gibt an, dass bidirektionale Anschlüsse zwischen Eingang und Ausgang umschaltbar sind (der Datenbus eines Mikroprozessors zum Beispiel).

  • Tri-State: Dies ist der übliche Tri-State Ausgang (mögliche Zustände: 0, 1 und hochohmig).

  • Passiv: Wird für passive Bauteilanschlüsse, Widerstände, Steckverbinder, usw. verwendet.

  • Nicht spezifiziert: Kann benutzt werden, wenn das Ergebnis des ERC egal ist.

  • Spannungseingang: Wird für die Spannungsanschlüsse des Bauteils benutzt. Spannungsanschlüsse werden automatisch mit anderen Spannungseingängen gleichen Namens verbunden.

  • Spannungsausgang: Wird benutzt für Ausgänge von Spannungsreglern.

  • Offener Emitter und Offener Kollektor: Dieser Typ kann für Logik-Ausgänge verwendet werden, die solcherart gekennzeichnet sind.

  • Nicht angeschlossen: Wird verwendet, wenn ein Bauteilanschluss keine interne Verbindung hat.

11.8.5. Globale Anschlusseigenschaften

Sie können die Länge oder die Textgröße des Namens und/oder der Nummer aller Anschlüsse über den "Global" Befehl im Kontextmenü eines Anschlusses ändern. Klicken Sie auf die Einstellung die Sie ändern möchten und geben Sie den neuen Wert ein. Dieser wird dann auf alle Anschlüsse des aktuellen Bauteils angewendet.

globales Verändern von Anschlusseigenschaften

11.8.6. Anschlüsse für mehrere Einheiten und alternative Darstellung definieren

Bauteile mit mehreren Einheiten und/oder grafischen Darstellungen sind speziell dann problematisch, wenn Anschlüsse erstellt oder bearbeitet werden. Der Großteil von Anschlüssen ist spezifisch für jede Einheit (die Anschlussnummer ist spezifisch für jede Einheit) und zu jeder Darstellung (die Form und Position ist spezifisch für jede Darstellung). Der Bauteilbibliothekseditor erlaubt die gleichzeitige Erstellung von Anschlüssen. Standardmäßig werden Änderungen an einem Anschluss an allen Einheiten in einem Mehreinheiten-Bauteil und für beide Darstellungen bei Bauteilen mit alternativen Darstellungen durchgeführt.

Die einzige Ausnahme davon sind der Symboltyp und der Name des Anschlusses. Diese Abhängigkeit wurde eingeführt, um das Erstellen und Bearbeiten von Anschlüssen für die meisten Anwendungsfälle zu vereinfachen. Diese Abhängigkeit kann über Anschlüsse bearbeiten in der Hauptwerkzeugleiste umgeschaltet werden. Das ermöglicht es Ihnen, Anschlüsse für jede Einheit und deren Darstellung komplett unabhängig zu erstellen.

Ein Bauteil kann zwei Darstellungsformen haben, zweite Darstellungsform bekannt als "DeMorgan", und kann aus mehr als einer Einheit aufgebaut sein wie im Falle von Logikbausteinen. Bei einigen Bauteile möchten Sie eventuell mehrere unterschiedliche Grafikelemente und Anschlüsse benutzen. Wie im Beispiel des Relais in Abschnitt 11.7.1 gezeigt kann ein Relais als drei unterschiedliche Einheiten dargestellt werden: Spule, Wechsler 1 und Wechsler 2.

Die Verwaltung von Bauteilen mit mehreren Einheiten und Bauteilen mit alternativen Darstellungsformen ist flexibel. Ein Anschluss kann für alle oder spezifisch für einzelne Einheiten gültig sein. Ein Anschluss kann auch für beide oder spezifisch nur für eine Darstellungsform gültig sein.

Standardmäßig sind Anschlüsse spezifisch für jede Darstellungsform einer Einheit, da sich ihre Anschlussnummern für jede Einheit unterscheiden und ihr Symbol für jede Darstellungsform unterschiedlich ist. Wenn ein Pin für alle Einheiten gültig ist, muss er nur einmal gezeichnet werden, wie im Fall von Spannungsanschlüssen.

Ein Beispiel ist der Ausgangsanschluss eines 7400 NAND Gatter mit 4 zweifach Eingängen. Da es vier Einheiten und je zwei Darstellungsformen gibt, ergeben sich acht einzeln definierte Ausgangsanschlüsse in der Bauteildefinition. Wenn Sie ein neues 7400 Bauteil erstellen, wird die normale Darstellungsform von Einheit A im Bibliothekseditor angezeigt. Um den Symboltyp des Anschlusses der alternativen Darstellungsform zu bearbeiten, muss diese erst über einen Klick auf Alternative DeMorgan Darstellung in der Werkzeugleiste ausgewählt werden. Um die Anschlussnummer für jedes Gatter zu bearbeiten, wählen Sie das jeweilige Gatter über die Auswahl des Alias Drop-Down Auswahl.

11.9. Bauteilfelder

Alle Bibliotheksbauteile sind mit vier Standardfeldern angelegt. Die Felder für Referenz, Wert, Footprint und Datenblatt werden immer erzeugt wenn ein Bauteil neu erzeugt oder kopiert wird. Nur die zwei Felder für die Bauteilreferenz und -wert werden zwingend benötigt. Zum Ändern bestehender Felder können Sie das Kontextmenü nach einem Rechtsklick auf den Anschluss benutzen. Bauteile die in Bibliotheken angelegt sind, besitzen üblicherweise diese vier Standardfeldern. Zusätzliche Felder wie Hersteller, Teilenummer, Bauteilkosten, usw. können zu Bibliotheksbauteilen hinzugefügt werden, aber im allgemeinen wird das im Schaltplaneditor gemacht, damit die zusätzlichen Felder für alle Bauteile im Schaltplan angelegt werden können.

11.9.1. Bearbeiten der Bauteilfelder

Um ein bestehendes Bauteilfeld zu bearbeiten, benutzen Sie das Kontextmenü nach einen Rechtsklick auf den Feldtext.

Kontextmenü Feldeigenschaften

To edit undefined fields, add new fields, or delete optional fields icons/text.png on the main tool bar to open the field properties dialog shown below.

Dialog Feldeigenschaften

Felder sind Textbereiche die dem Bauteil zugeordnet sind. Verwechseln Sie diese nicht mit dem Text der zur grafischen Darstellung dieses Bauteils gehört.

Wichtige Hinweise:

  • Das Bearbeiten des Wertefeldes erstellt faktisch ein neues Bauteil unter Benutzung des aktuellen Bauteils als Startpunkt für das neue Bauteil. Dieses neue Bauteil bekommt den Namen der im Wertefeld steht, wenn Sie es in die aktuell ausgewählte Bibliothek abspeichern.

  • Der Dialog für die Feldeigenschaften wie oben zu sehen muss verwendet werden, um ein Feld zu bearbeiten das leer ist oder bei dem das "sichtbar" Attribut nicht gesetzt ist.

  • Der Footprint ist als absoluter Footprint im LIBNAME:FPNAME Format festgelegt, wobei LIBNAME der Name der Footprint Bibliothek ist, wie in der Footprintbibliothekstabelle hinterlegt (siehe Abschnitt "Footprint Bibliothek Tabellen" im Pcbnew "Referenz Handbuch") und FPNAME ist der Name des Footprints in der Bibliothek LIBNAME.

11.10. Spannungsversorgungssymbole

Spannungsversorgungssymbole werden in der gleichen Weise wie normale Bauteile erstellt. Es kann hilfreich sein diese in einer speziell dafür vorgesehenen Bibliothek zu sammeln, so wie power.lib dies macht. Spannungsversorgungssymbole bestehen aus einem grafischen Symbol und einem Anschluss vom Typ "Spannungsversorgung unsichtbar". Spannungsversorgungssymbole werden wie jedes andere Bauteil vom Schaltplaneditor gehandhabt. Einige Vorkehrungen sind dazu erforderlich. Unten ist ein Beispiel eines Spannungsversorgungssymbols +5V.

Symbol Spannungsversorgung +5V

Um ein Spannungsversorgungssymbol zu erstellen führen Sie folgende Schritte aus:

  • Fügen Sie einen Anschluss des Typs "Spannungseingang" mit dem Namen +5V (wichtig, denn dieser Name wird die Verbindung zum Netz +5V herstellen), der Anschlussnummer 1 (die Nummer hat keine Bedeutung), einer Länge von 0 und dem "Symbol Typ" "Linie" hinzu.

  • Zeichnen Sie die Linien an den Anschluss wie gezeigt.

  • Der Anker des Symbols liegt auf dem Anschluss.

  • Der Wert des Bauteils ist +5V.

  • Die Referenz des Bauteils ist #+5V. Der Referenztext ist nicht wichtig, außer dass das erste Zeichen ein # sein muss um anzuzeigen, dass das Bauteil ein Spannungsversorgungssymbol ist. Per Konvention wird jedes Bauteil, dessen Referenz mit einem # beginnt, nicht in der Stückliste oder in der Netzliste aufgeführt und die Referenz wird als "Nicht sichtbar" eingestellt.

Eine einfachere Methode ein Spannungsversorgungssymbol zu erstellen, ist es ein anderes Symbol als Vorlage zu verwenden:

  • Laden Sie ein bestehendes Spannungsversorgungssymbol.

  • Setzen Sie den Anschlussnamen auf den Namen des neuen Spannungsversorgungssymbols.

  • Setzen Sie das Feld Wert auf den gleichen Namen wie den Anschlussnamen, wenn Sie den Spannungsversorgungswert anzeigen wollen.

  • Speichern Sie das neue Bauteil.

12. Bauteileditor - Bauteile

12.1. Überblick

Ein Bauteil besteht aus den folgenden Elementen:

  • Einer grafischen Repräsentation (geometrische Formen, Texte).

  • Anschlüssen (Pins).

  • Feldern oder zugehörigem Text, der von Post-Prozessoren genutzt wird: Netzliste, Bauteilliste.

Zwei Felder müssen initialisiert werden: Referenz und Wert. Der Name des Entwurfs der mit dem Bauteil verbunden ist, und der Name des zugehörigen Footprints. Die anderen Felder sind freie Felder, sie können im Allgemeinen leer bleiben und können während der Schaltplaneingabe gefüllt werden.

Jedoch erleichtert die Verwaltung der Dokumentation jedes Bauteils die Suche, Benutzung und Pflege der Bibliotheken. Die zugehörige Dokumentation besteht aus:

  • Einer Kommentarzeile.

  • Einer Zeile mit Schlüsselwörtern wie TTL CMOS NAND2, getrennt mit Leerzeichen.

  • Einem angehängten Dateinamen (zum Beispiel einem Anwendungshinweis oder eine PDF Datei).

    Das Standardverzeichnis für angehängte Dateien:

    kicad/share/library/doc

    Wenn dieses nicht gefunden wird:

    kicad/library/doc

    Unter Linux:

    /usr/local/kicad/share/library/doc

    /usr/share/kicad/library/doc

    /usr/local/share/kicad/library/doc

Schlüsselwörter erlauben es Ihnen selektiv nach Bauteilen gemäß verschiedener Auswahlkriterien zu suchen. Kommentare und Schlüsselwörter werden in verschiedenen Menüs angezeigt und besonders wenn Sie ein Bauteil aus der Bibliothek aussuchen.

Das Bauteil hat ebenfalls einen Ankerpunkt. Eine Drehung oder Spiegelung wird relativ zu diesem Ankerpunkt durchgeführt und während der Platzierung wird dieser Punkt als Referenzposition verwendet. Daher ist es nützlich, diesen Anker akkurat zu setzen.

Ein Bauteil kann Aliase haben, d.h. gleichbedeutende Namen. Dies erlaubt Ihnen, die Anzahl der zu erstellenden Bauteile drastisch zu reduzieren (zum Beispiel, ein 74LS00 kann Aliase wie 7400, 74HC00, 74HCT00… haben).

Schlussendlich werden die Bauteile in Bibliotheken ausgeliefert (klassifiziert nach Thema oder Hersteller), um ihre Verwaltung zu ermöglichen.

12.2. Einen Bauteilanker positionieren

Der Anker befindet sich an den Koordinaten (0,0) und wird durch die blauen Achsen auf Ihrem Bildschirm dargestellt.

Ankerpunkt eines Bauteils

Der Anker kann neu gesetzt werden, indem Sie das Symbol Bauteilanker verschieben auswählen und auf die neue gewünschte Ankerposition klicken. Die Zeichnung wird automatisch auf den neuen Ankerpunkt zentriert.

12.3. Bauteil Aliase

Ein Alias ist ein anderer Name, der auf das gleiche Bauteil in der Bibliothek verweist. Bauteile mit gleicher Pinbelegung und Darstellung können dann durch ein Bauteil dargestellt werden, das verschiedene Aliase hat (z.B. 7400 mit Alias 74LS00, 74HC00, 74LS37).

Die Benutzung von Aliasen erlaubt es Ihnen vollständige Bibliotheken schnell zu erstellen. Und zusätzlich dazu, dass diese Bibliotheken deutlich kompakter sind, werden diese schneller von KiCad geladen.

Um die Liste der Aliase zu bearbeiten, müssen Sie das Hauptbearbeitungsfenster über das Symbol Bauteileigenschaften editieren auswählen und den Ordner der Aliase auswählen.

Bearbeiten von Bauteil Aliases

Jetzt können Sie den gewünschten Alias ergänzen oder entfernen. Der aktuelle Alias kann selbstverständlich nicht entfernt werden da er gerade bearbeitet wird.

Um alle Aliase zu entfernen müssen Sie zuerst das ursprüngliche Bauteil auswählen. Das ist das erste Bauteil in der Aliasliste im Auswahlfenster der Hauptwerkzeugleiste.

12.4. Bauteilfelder

The field editor is called via the icon icons/text.png .

Es gibt 4 Spezialfelder (Texte die an das Bauteil angehängt werden) und konfigurierbare Nutzerfelder:

Bauteilfelder

Spezialfelder:

  • Referenz.

  • Wert. Das ist der Bauteilname in der Bibliothek und der Standardwert im Schaltplan.

  • Footprint. Das ist der Name des Footprints der für die Leiterplatte verwendet wird. Nicht sonderlich hilfreich wenn CvPcb genutzt wird, um die Footprint Liste zu erzeugen, aber zwingend erforderlich wenn CvPcb nicht benutzt wird.

  • Datenblatt. Das ist ein reserviertes Feld, derzeit nicht genutzt.

12.5. Bauteil Eigenschaften

Um die Informationen der Eigenschaften zu bearbeiten, ist es notwendig das Fenster der Eigenschaften des Bauteils über das Symbol Bauteileigenschaften editieren aufzurufen und den Tab Beschreibung auszuwählen.

Beschreibung und Dokumente für Bauteils

Stellen Sie sicher, dass der richtigen Alias oder das Hauptbauteil ausgewählt ist, denn diese Dokumentation ist die einzige Eigenschaft, durch die sich die Aliase unterscheiden. Der Button "Dokumentation von Elternelement kopieren" erlaubt es Ihnen die Dokumentationsinformation vom Hauptbauteil zum aktuell bearbeiteten Alias zu kopieren.

12.5.1. Schlüsselwörter für Bauteile

Schlüsselwörter erlauben es Ihnen in einer selektiven Art nach Bauteilen zu suchen, entsprechend spezifischer Auswahlkriterien (Funktion, technologischer Familie, usw.).

Das Eeschema Suchwerkzeug unterscheidet nicht nach Groß-/Kleinschreibung. Die aktuell in den Bibliotheken verwendeten Schlüsselwörter sind:

  • CMOS TTL für Logik-Familien

  • AND2 NOR3 XOR2 INV… für die Gatter (AND2 = UND Gatter mit 2 Eingängen, NOR3 = NOR Gatter mit 3 Eingängen).

  • JKFF DFF… für JK- oder D- Flip-Flop.

  • ADC, DAC, MUX… für Analog-Digital Wandler, Digital-Analog Wandler, Multiplexer

  • OpenCol für die Gatter mit Open-Collector Ausgang. Wenn Sie dann im Schaltplaneditor mit den Schlüsselwörtern NAND2 OpenCol nach dem Bauteil suchen, wird Eeschema die Liste der Bauteile anzeigen, die diese beiden Schlüsselwörter haben.

12.5.2. Bauteil Dokumentation

Die Beschreibung und Schlüsselwörter werden in verschiedenen Menüs angezeigt, besonders wenn Sie ein Bauteil in der dargestellten Bauteilliste einer Bibliothek auswählen und im Bibliotheksbrowser.

Wenn die Datei vorhanden ist kann auf diese im Schaltplaneditor zugegriffen werden, z.B. über das Pop-Up Menü, Eintrag Typenbeschreibung das bei Rechtsklick auf das Bauteil angezeigt wird.

12.5.3. Zugehörige Dokumentationsdatei

Zeigt an, dass eine angehängte Datei (Dokumentation, Anwendungsschaltplan) verfügbar ist (PDF-Datei, Schaltplan Diagramm, usw.).

12.5.4. Footprintfilter für CvPcb

Sie können eine Liste der erlaubten Footprints für das Bauteil eingeben. Die Liste agiert als Filter, der von CvPcb verwendet wird, um nur die erlaubten Footprints anzuzeigen. Eine leere Liste filtert nichts (alles wird angezeigt).

Bearbeiten der Footprint Filter

Platzhalter Zeichen sind zulässig.

SO14* erlaubt CvPcb alle Footprints anzuzeigen, deren Name mit SO14 anfängt.

Für einen Widerstand zeigt R? alle Footprints mit insgesamt zwei Zeichen im Namen an, wobei aber nur Namen gezeigt werden die mit R beginnen.

Hier sind Beispiele mit und ohne Filterung.

Mit Filterung:

Anzeige in CvPcb ohne Filterung

Ohne Filterung:

Anzeige in CvPvb mit Filterung

12.6. Symbolbibliothek

Sie können leicht eine Bibliothek mit häufig genutzten grafischen Symbolen zusammenstellen. Diese kann später dann benutzt werden, um einfach Bauteile erstellen zu können. Zum Beispiel häufig benutzte Dreiecksformen, die Formen für UND, ODER, XOR Gatter, usw.

Diese Dateien werden standardmäßig im Bibliotheksverzeichnis gespeichert und haben eine .sym Erweiterung. Die Symbole werden nicht in Bibliotheken gesammelt wie die Bauteile, es sind im Allgemeinen nicht so viele.

12.6.1. Ein Symbol erstellen oder exportieren

Ein Bauteil kann als Symbol mit dem Button Bauteil exportieren exportiert werden. Sie können allgemein nur eine Grafik erstellen, außerdem ist es eine gute Idee die Anschlüsse zu löschen, wenn sie vorhanden sind.

12.6.2. Ein Symbol importieren

Importieren erlaubt es Ihnen Grafiken zu einem bearbeiteten Bauteil hinzuzufügen. Ein Symbol wird importiert über den Button Bauteil importieren . Importierte Grafiken werden so hinzugefügt wie sie in der bestehenden Grafik erstellt wurden.

13. Symbol Library Browser

13.1. Einleitung

The Symbol Library Browser allows you to quickly examine the content of symbol libraries. The Symbol Library Viewer can be accessed by the main toolbar button icons/library_browse_png or by the "Library Browser" entry in the "Tool" menu.

Bauteilfilter im Bauteilbrowser

13.2. Bibliotheksbrowser - Hauptfenster

Bauteilbibliotheksbrowser ohne spezielle Auswahl

To examine the contents of a library, select a library from the list on the left hand pane. All symbols in the selected library will appear in the second pane. Select a symbol name to view the symbol.

Bauteileditor mit ausgewähltem Bauteil

13.3. Symbol Library Browser Top Toolbar

The top tool bar in Symbol Library Brower is shown below.

images/de/toolbar_viewlib.png

Die möglichen Befehle sind:

Aktuelle Bibliothek abspeichern

Auswahl der gewünschten Bibliothek, die auch in der angezeigten Liste ausgewählt werden kann.

icons/add_component_png

Selection of the symbol which can be also selected in the displayed list.

icons/lib_previous_png

Display previous symbol.

icons/lib_next_png

Display next symbol.

Hinein zoomen Heraus zoomen Anzeige neu zeichnen Anzeige in Bildschirmgröße einpassen

Zoomwerkzeuge.

images/icons/morgan1.png Alternative DeMorgan Darstellung

Auswahl der Darstellungsform (normal oder umgewandelt) wenn vorhanden.

images/toolbar_viewlib_part.png

Selection of the unit for symbols that contain multiple units.

icons/datasheet_png

If it exist, display the associated documents. Exists only when called by the place symbol dialog frame from Eeschema.

icons/export_png

Close the browser and place the selected symbol in Eeschema. This icon is only displayed when browser has been called from Eeschema (double click on a symbol in the component chooser).

14. Erstellen angepasster Dateien für Netzlisten und Stücklisten

14.1. Zwischenzeitliche Netzlistendatei

Stücklistendateien (BOM-Dateien) und Netzlistendateien können aus einer zwischenzeitlichen Netzlistendatei, die von Eeschema erzeugt wird, erstellt werden.

Diese Datei benutzt XML Syntax und wird "zwischenzeitliche Netzliste" genannt. Die Zwischennetzliste enthält eine große Menge von Daten über Ihre Leiterplatte und aufgrund dessen kann sie dafür genutzt werden, eine Stückliste und andere Berichte zu erstellen.

Abhängig von der Ausgabe (Stückliste oder Netzliste) werden unterschiedliche Untermengen der kompletten Zwischennetzlistendatei für die Nachbearbeitung verwendet.

14.1.1. Schaltplanbeispiel

width=

14.1.2. Dateibeispiel der Zwischennetzliste

Die korrespondierende Zwischennetzliste (als XML-Datei) des Schaltkreises ist unten zu sehen.

<?xml version="1.0" encoding="utf-8"?>
<export version="D">
  <design>
    <source>F:\kicad_aux\netlist_test\netlist_test.sch</source>
    <date>29/08/2010 20:35:21</date>
    <tool>eeschema (2010-08-28 BZR 2458)-unstable</tool>
  </design>
  <components>
    <comp ref="P1">
      <value>CONN_4</value>
      <libsource lib="conn" part="CONN_4"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E2141</tstamp>
    </comp>
    <comp ref="U2">
      <value>74LS74</value>
      <libsource lib="74xx" part="74LS74"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E20BA</tstamp>
    </comp>
    <comp ref="U1">
      <value>74LS04</value>
      <libsource lib="74xx" part="74LS04"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E20A6</tstamp>
    </comp>
    <comp ref="C1">
      <value>CP</value>
      <libsource lib="device" part="CP"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E2094</tstamp>
    </comp>
    <comp ref="R1">
      <value>R</value>
      <libsource lib="device" part="R"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E208A</tstamp>
    </comp>
  </components>
  <libparts>
    <libpart lib="device" part="C">
      <description>Condensateur non polarise</description>
      <footprints>
        <fp>SM*</fp>
        <fp>C?</fp>
        <fp>C1-1</fp>
      </footprints>
      <fields>
        <field name="Reference">C</field>
        <field name="Value">C</field>
      </fields>
      <pins>
        <pin num="1" name="~" type="passive"/>
        <pin num="2" name="~" type="passive"/>
      </pins>
    </libpart>
    <libpart lib="device" part="R">
      <description>Resistance</description>
      <footprints>
        <fp>R?</fp>
        <fp>SM0603</fp>
        <fp>SM0805</fp>
        <fp>R?-*</fp>
        <fp>SM1206</fp>
      </footprints>
      <fields>
        <field name="Reference">R</field>
        <field name="Value">R</field>
      </fields>
      <pins>
        <pin num="1" name="~" type="passive"/>
        <pin num="2" name="~" type="passive"/>
      </pins>
    </libpart>
    <libpart lib="conn" part="CONN_4">
      <description>Symbole general de connecteur</description>
      <fields>
        <field name="Reference">P</field>
        <field name="Value">CONN_4</field>
      </fields>
      <pins>
        <pin num="1" name="P1" type="passive"/>
        <pin num="2" name="P2" type="passive"/>
        <pin num="3" name="P3" type="passive"/>
        <pin num="4" name="P4" type="passive"/>
      </pins>
    </libpart>
    <libpart lib="74xx" part="74LS04">
      <description>Hex Inverseur</description>
      <fields>
        <field name="Reference">U</field>
        <field name="Value">74LS04</field>
      </fields>
      <pins>
        <pin num="1" name="~" type="input"/>
        <pin num="2" name="~" type="output"/>
        <pin num="3" name="~" type="input"/>
        <pin num="4" name="~" type="output"/>
        <pin num="5" name="~" type="input"/>
        <pin num="6" name="~" type="output"/>
        <pin num="7" name="GND" type="power_in"/>
        <pin num="8" name="~" type="output"/>
        <pin num="9" name="~" type="input"/>
        <pin num="10" name="~" type="output"/>
        <pin num="11" name="~" type="input"/>
        <pin num="12" name="~" type="output"/>
        <pin num="13" name="~" type="input"/>
        <pin num="14" name="VCC" type="power_in"/>
      </pins>
    </libpart>
    <libpart lib="74xx" part="74LS74">
      <description>Dual D FlipFlop, Set &amp; Reset</description>
      <docs>74xx/74hc_hct74.pdf</docs>
      <fields>
        <field name="Reference">U</field>
        <field name="Value">74LS74</field>
      </fields>
      <pins>
        <pin num="1" name="Cd" type="input"/>
        <pin num="2" name="D" type="input"/>
        <pin num="3" name="Cp" type="input"/>
        <pin num="4" name="Sd" type="input"/>
        <pin num="5" name="Q" type="output"/>
        <pin num="6" name="~Q" type="output"/>
        <pin num="7" name="GND" type="power_in"/>
        <pin num="8" name="~Q" type="output"/>
        <pin num="9" name="Q" type="output"/>
        <pin num="10" name="Sd" type="input"/>
        <pin num="11" name="Cp" type="input"/>
        <pin num="12" name="D" type="input"/>
        <pin num="13" name="Cd" type="input"/>
        <pin num="14" name="VCC" type="power_in"/>
      </pins>
    </libpart>
  </libparts>
  <libraries>
    <library logical="device">
      <uri>F:\kicad\share\library\device.lib</uri>
    </library>
    <library logical="conn">
      <uri>F:\kicad\share\library\conn.lib</uri>
    </library>
    <library logical="74xx">
      <uri>F:\kicad\share\library\74xx.lib</uri>
    </library>
  </libraries>
  <nets>
    <net code="1" name="GND">
      <node ref="U1" pin="7"/>
      <node ref="C1" pin="2"/>
      <node ref="U2" pin="7"/>
      <node ref="P1" pin="4"/>
    </net>
    <net code="2" name="VCC">
      <node ref="R1" pin="1"/>
      <node ref="U1" pin="14"/>
      <node ref="U2" pin="4"/>
      <node ref="U2" pin="1"/>
      <node ref="U2" pin="14"/>
      <node ref="P1" pin="1"/>
    </net>
    <net code="3" name="">
      <node ref="U2" pin="6"/>
    </net>
    <net code="4" name="">
      <node ref="U1" pin="2"/>
      <node ref="U2" pin="3"/>
    </net>
    <net code="5" name="/SIG_OUT">
      <node ref="P1" pin="2"/>
      <node ref="U2" pin="5"/>
      <node ref="U2" pin="2"/>
    </net>
    <net code="6" name="/CLOCK_IN">
      <node ref="R1" pin="2"/>
      <node ref="C1" pin="1"/>
      <node ref="U1" pin="1"/>
      <node ref="P1" pin="3"/>
    </net>
  </nets>
</export>

14.2. Umwandlung in ein neues Netzlistenformat

Unter Anwendung eines Nachtbearbeitungsfilters auf die Zwischennetzlistendatei können Sie fremde Netzlistenformate und auch Stücklisten erzeugen. Weil diese Umwandlung eine Text zu Text Umwandlung ist, kann dieser Nachtbearbeitungsfilter in Python, XSLT oder jedem anderen Werkzeug geschrieben werden, das XML als Eingabe verarbeiten kann.

XSLT selbst ist eine XML-Sprache die sehr gut für XML Umwandlungen geeignet ist. Es gibt ein freies Programm mit dem Namen xsltproc, das Sie selbst herunterladen und installieren können. Das Programm xsltproc kann verwendet werden um die Zwischennetzliste zu lesen, eine Stylesheet Umwandlung durchzuführen und das Ergebnis in einer Ausgabedatei zu speichern. Die Benutzung von xsltproc erfordert eine Stylesheetdatei die den XSLT-Konventionen folgt. Der komplette Umwandlungsprozess wird von Eeschema durchgeführt, wenn es einmal eingerichtet wurde xsltproc in einer bestimmten Weise aufzurufen.

14.3. XSLT-Vorgehensweise

Das Dokument, das die XSL-Umwandlung (XSLT) beschreibt, gibt es unter:

http://www.w3.org/TR/xslt

14.3.1. Erstellen einer PadsPcb Netzlistendatei

Das PadsPcb Format besteht aus zwei Teilen.

  • Die Footprintliste.

  • Die Netzeliste: Gruppiert Referenzen der Pads nach Netzen.

Direkt unten ist ein Stylesheet welches die Zwischennetzlistendatei in ein PadsPcb Netzlistenformat umwandelt:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--XSL style sheet to Eeschema Generic Netlist Format to PADS netlist format
    Copyright (C) 2010, SoftPLC Corporation.
    GPL v2.

    How to use:
        https://lists.launchpad.net/kicad-developers/msg05157.html
-->

<!DOCTYPE xsl:stylesheet [
  <!ENTITY nl  "&#xd;&#xa;"> <!--new line CR, LF -->
]>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="text" omit-xml-declaration="yes" indent="no"/>

<xsl:template match="/export">
    <xsl:text>*PADS-PCB*&nl;*PART*&nl;</xsl:text>
    <xsl:apply-templates select="components/comp"/>
    <xsl:text>&nl;*NET*&nl;</xsl:text>
    <xsl:apply-templates select="nets/net"/>
    <xsl:text>*END*&nl;</xsl:text>
</xsl:template>

<!-- for each component -->
<xsl:template match="comp">
    <xsl:text> </xsl:text>
    <xsl:value-of select="@ref"/>
    <xsl:text> </xsl:text>
    <xsl:choose>
        <xsl:when test = "footprint != '' ">
            <xsl:apply-templates select="footprint"/>
        </xsl:when>
        <xsl:otherwise>
            <xsl:text>unknown</xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:text>&nl;</xsl:text>
</xsl:template>

<!-- for each net -->
<xsl:template match="net">
    <!-- nets are output only if there is more than one pin in net -->
    <xsl:if test="count(node)>1">
        <xsl:text>*SIGNAL* </xsl:text>
        <xsl:choose>
            <xsl:when test = "@name != '' ">
                <xsl:value-of select="@name"/>
            </xsl:when>
            <xsl:otherwise>
                <xsl:text>N-</xsl:text>
                <xsl:value-of select="@code"/>
            </xsl:otherwise>
        </xsl:choose>
        <xsl:text>&nl;</xsl:text>
        <xsl:apply-templates select="node"/>
    </xsl:if>
</xsl:template>

<!-- for each node -->
<xsl:template match="node">
    <xsl:text> </xsl:text>
    <xsl:value-of select="@ref"/>
    <xsl:text>.</xsl:text>
    <xsl:value-of select="@pin"/>
    <xsl:text>&nl;</xsl:text>
</xsl:template>

</xsl:stylesheet>

Und dies ist die PadsPcb Ausgabe nach dem Durchlauf von xsltproc:

*PADS-PCB*
*PART*
P1 unknown
U2 unknown
U1 unknown
C1 unknown
R1 unknown
*NET*
*SIGNAL* GND
U1.7
C1.2
U2.7
P1.4
*SIGNAL* VCC
R1.1
U1.14
U2.4
U2.1
U2.14
P1.1
*SIGNAL* N-4
U1.2
U2.3
*SIGNAL* /SIG_OUT
P1.2
U2.5
U2.2
*SIGNAL* /CLOCK_IN
R1.2
C1.1
U1.1
P1.3

*END*

Die Befehlszeile um diese Umwandlung durchzuführen lautet:

kicad\\bin\\xsltproc.exe -o test.net kicad\\bin\\plugins\\netlist_form_pads-pcb.xsl test.tmp

14.3.2. Eine Cadstar Netzlistendatei erstellen

Das Cadstarformat besteht aus zwei Teilen.

  • Die Footprintliste.

  • Die Netzeliste: Gruppiert Referenzen der Pads nach Netzen.

Hier ist die Stylesheet-Datei um diese spezielle Umwandlung durchzuführen.

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--XSL style sheet to Eeschema Generic Netlist Format to CADSTAR netlist format
    Copyright (C) 2010, Jean-Pierre Charras.
    Copyright (C) 2010, SoftPLC Corporation.
    GPL v2.

<!DOCTYPE xsl:stylesheet [
  <!ENTITY nl  "&#xd;&#xa;"> <!--new line CR, LF -->
]>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="text" omit-xml-declaration="yes" indent="no"/>

<!-- Netlist header -->
<xsl:template match="/export">
    <xsl:text>.HEA&nl;</xsl:text>
    <xsl:apply-templates select="design/date"/>  <!-- Generate line .TIM <time> -->
    <xsl:apply-templates select="design/tool"/>  <!-- Generate line .APP <eeschema version> -->
    <xsl:apply-templates select="components/comp"/>  <!-- Generate list of components -->
    <xsl:text>&nl;&nl;</xsl:text>
    <xsl:apply-templates select="nets/net"/>          <!-- Generate list of nets and connections -->
    <xsl:text>&nl;.END&nl;</xsl:text>
</xsl:template>

 <!-- Generate line .TIM 20/08/2010 10:45:33 -->
<xsl:template match="tool">
    <xsl:text>.APP "</xsl:text>
    <xsl:apply-templates/>
    <xsl:text>"&nl;</xsl:text>
</xsl:template>

 <!-- Generate line .APP "eeschema (2010-08-17 BZR 2450)-unstable" -->
<xsl:template match="date">
    <xsl:text>.TIM </xsl:text>
    <xsl:apply-templates/>
    <xsl:text>&nl;</xsl:text>
</xsl:template>

<!-- for each component -->
<xsl:template match="comp">
    <xsl:text>.ADD_COM </xsl:text>
    <xsl:value-of select="@ref"/>
    <xsl:text> </xsl:text>
    <xsl:choose>
        <xsl:when test = "value != '' ">
            <xsl:text>"</xsl:text> <xsl:apply-templates select="value"/> <xsl:text>"</xsl:text>
        </xsl:when>
        <xsl:otherwise>
            <xsl:text>""</xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:text>&nl;</xsl:text>
</xsl:template>

<!-- for each net -->
<xsl:template match="net">
    <!-- nets are output only if there is more than one pin in net -->
    <xsl:if test="count(node)>1">
    <xsl:variable name="netname">
        <xsl:text>"</xsl:text>
        <xsl:choose>
            <xsl:when test = "@name != '' ">
                <xsl:value-of select="@name"/>
            </xsl:when>
            <xsl:otherwise>
                <xsl:text>N-</xsl:text>
                <xsl:value-of select="@code"/>
        </xsl:otherwise>
        </xsl:choose>
        <xsl:text>"&nl;</xsl:text>
        </xsl:variable>
        <xsl:apply-templates select="node" mode="first"/>
        <xsl:value-of select="$netname"/>
        <xsl:apply-templates select="node" mode="others"/>
    </xsl:if>
</xsl:template>

<!-- for each node -->
<xsl:template match="node" mode="first">
    <xsl:if test="position()=1">
       <xsl:text>.ADD_TER </xsl:text>
    <xsl:value-of select="@ref"/>
    <xsl:text>.</xsl:text>
    <xsl:value-of select="@pin"/>
    <xsl:text> </xsl:text>
    </xsl:if>
</xsl:template>

<xsl:template match="node" mode="others">
    <xsl:choose>
        <xsl:when test='position()=1'>
        </xsl:when>
        <xsl:when test='position()=2'>
           <xsl:text>.TER     </xsl:text>
        </xsl:when>
        <xsl:otherwise>
           <xsl:text>         </xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:if test="position()>1">
        <xsl:value-of select="@ref"/>
        <xsl:text>.</xsl:text>
        <xsl:value-of select="@pin"/>
        <xsl:text>&nl;</xsl:text>
    </xsl:if>
</xsl:template>

</xsl:stylesheet>

Hier ist die Cadstar Ausgabedatei.

.HEA
.TIM 21/08/2010 08:12:08
.APP "eeschema (2010-08-09 BZR 2439)-unstable"
.ADD_COM P1 "CONN_4"
.ADD_COM U2 "74LS74"
.ADD_COM U1 "74LS04"
.ADD_COM C1 "CP"
.ADD_COM R1 "R"


.ADD_TER U1.7 "GND"
.TER     C1.2
         U2.7
         P1.4
.ADD_TER R1.1 "VCC"
.TER     U1.14
         U2.4
         U2.1
         U2.14
         P1.1
.ADD_TER U1.2 "N-4"
.TER     U2.3
.ADD_TER P1.2 "/SIG_OUT"
.TER     U2.5
         U2.2
.ADD_TER R1.2 "/CLOCK_IN"
.TER     C1.1
         U1.1
         P1.3

.END

14.3.3. Eine OrcadPCB2 Netzlistendatei erstellen

Dieses Format hat nur einen Teil, die Footprintliste. Jeder Footprint enthält selbst seine Liste von Pads mit einer Referenz zu einem Netz.

Hier ist das Stylesheet für diese spezielle Umwandlung:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--XSL style sheet to Eeschema Generic Netlist Format to CADSTAR netlist format
    Copyright (C) 2010, SoftPLC Corporation.
    GPL v2.

    How to use:
        https://lists.launchpad.net/kicad-developers/msg05157.html
-->

<!DOCTYPE xsl:stylesheet [
  <!ENTITY nl  "&#xd;&#xa;"> <!--new line CR, LF -->
]>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="text" omit-xml-declaration="yes" indent="no"/>

<!--
    Netlist header
    Creates the entire netlist
    (can be seen as equivalent to main function in C
-->
<xsl:template match="/export">
    <xsl:text>( { Eeschema Netlist Version 1.1  </xsl:text>
    <!-- Generate line .TIM <time> -->
<xsl:apply-templates select="design/date"/>
<!-- Generate line eeschema version ... -->
<xsl:apply-templates select="design/tool"/>
<xsl:text>}&nl;</xsl:text>

<!-- Generate the list of components -->
<xsl:apply-templates select="components/comp"/>  <!-- Generate list of components -->

<!-- end of file -->
<xsl:text>)&nl;*&nl;</xsl:text>
</xsl:template>

<!--
    Generate id in header like "eeschema (2010-08-17 BZR 2450)-unstable"
-->
<xsl:template match="tool">
    <xsl:apply-templates/>
</xsl:template>

<!--
    Generate date in header like "20/08/2010 10:45:33"
-->
<xsl:template match="date">
    <xsl:apply-templates/>
    <xsl:text>&nl;</xsl:text>
</xsl:template>

<!--
    This template read each component
    (path = /export/components/comp)
    creates lines:
     ( 3EBF7DBD $noname U1 74LS125
      ... pin list ...
      )
    and calls "create_pin_list" template to build the pin list
-->
<xsl:template match="comp">
    <xsl:text> ( </xsl:text>
    <xsl:choose>
        <xsl:when test = "tstamp != '' ">
            <xsl:apply-templates select="tstamp"/>
        </xsl:when>
        <xsl:otherwise>
            <xsl:text>00000000</xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:text> </xsl:text>
    <xsl:choose>
        <xsl:when test = "footprint != '' ">
            <xsl:apply-templates select="footprint"/>
        </xsl:when>
        <xsl:otherwise>
            <xsl:text>$noname</xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:text> </xsl:text>
    <xsl:value-of select="@ref"/>
    <xsl:text> </xsl:text>
    <xsl:choose>
        <xsl:when test = "value != '' ">
            <xsl:apply-templates select="value"/>
        </xsl:when>
        <xsl:otherwise>
            <xsl:text>"~"</xsl:text>
        </xsl:otherwise>
    </xsl:choose>
    <xsl:text>&nl;</xsl:text>
    <xsl:call-template name="Search_pin_list" >
        <xsl:with-param name="cmplib_id" select="libsource/@part"/>
        <xsl:with-param name="cmp_ref" select="@ref"/>
    </xsl:call-template>
    <xsl:text> )&nl;</xsl:text>
</xsl:template>

<!--
    This template search for a given lib component description in list
    lib component descriptions are in /export/libparts,
    and each description start at ./libpart
    We search here for the list of pins of the given component
    This template has 2 parameters:
        "cmplib_id" (reference in libparts)
        "cmp_ref"   (schematic reference of the given component)
-->
<xsl:template name="Search_pin_list" >
    <xsl:param name="cmplib_id" select="0" />
    <xsl:param name="cmp_ref" select="0" />
        <xsl:for-each select="/export/libparts/libpart">
            <xsl:if test = "@part = $cmplib_id ">
                <xsl:apply-templates name="build_pin_list" select="pins/pin">
                    <xsl:with-param name="cmp_ref" select="$cmp_ref"/>
                </xsl:apply-templates>
            </xsl:if>
        </xsl:for-each>
</xsl:template>


<!--
    This template writes the pin list of a component
    from the pin list of the library description
    The pin list from library description is something like
          <pins>
            <pin num="1" type="passive"/>
            <pin num="2" type="passive"/>
          </pins>
    Output pin list is ( <pin num> <net name> )
    something like
            ( 1 VCC )
            ( 2 GND )
-->
<xsl:template name="build_pin_list" match="pin">
    <xsl:param name="cmp_ref" select="0" />

    <!-- write pin numner and separator -->
    <xsl:text>  ( </xsl:text>
    <xsl:value-of select="@num"/>
    <xsl:text> </xsl:text>

    <!-- search net name in nets section and write it: -->
    <xsl:variable name="pinNum" select="@num" />
    <xsl:for-each select="/export/nets/net">
        <!-- net name is output only if there is more than one pin in net
             else use "?" as net name, so count items in this net
        -->
        <xsl:variable name="pinCnt" select="count(node)" />
        <xsl:apply-templates name="Search_pin_netname" select="node">
            <xsl:with-param name="cmp_ref" select="$cmp_ref"/>
            <xsl:with-param name="pin_cnt_in_net" select="$pinCnt"/>
            <xsl:with-param name="pin_num"> <xsl:value-of select="$pinNum"/>
            </xsl:with-param>
        </xsl:apply-templates>
    </xsl:for-each>

    <!-- close line -->
    <xsl:text> )&nl;</xsl:text>
</xsl:template>

<!--
    This template writes the pin netname of a given pin of a given component
    from the nets list
    The nets list description is something like
      <nets>
        <net code="1" name="GND">
          <node ref="J1" pin="20"/>
              <node ref="C2" pin="2"/>
        </net>
        <net code="2" name="">
          <node ref="U2" pin="11"/>
        </net>
    </nets>
    This template has 2 parameters:
        "cmp_ref"   (schematic reference of the given component)
        "pin_num"   (pin number)
-->

<xsl:template name="Search_pin_netname" match="node">
    <xsl:param name="cmp_ref" select="0" />
    <xsl:param name="pin_num" select="0" />
    <xsl:param name="pin_cnt_in_net" select="0" />

    <xsl:if test = "@ref = $cmp_ref ">
        <xsl:if test = "@pin = $pin_num">
        <!-- net name is output only if there is more than one pin in net
             else use "?" as net name
        -->
            <xsl:if test = "$pin_cnt_in_net>1">
                <xsl:choose>
                    <!-- if a net has a name, use it,
                        else build a name from its net code
                    -->
                    <xsl:when test = "../@name != '' ">
                        <xsl:value-of select="../@name"/>
                    </xsl:when>
                    <xsl:otherwise>
                        <xsl:text>$N-0</xsl:text><xsl:value-of select="../@code"/>
                    </xsl:otherwise>
                </xsl:choose>
            </xsl:if>
            <xsl:if test = "$pin_cnt_in_net &lt;2">
                <xsl:text>?</xsl:text>
            </xsl:if>
        </xsl:if>
    </xsl:if>

</xsl:template>

</xsl:stylesheet>

Hier ist die OrcadPCB2 Ausgabedatei.

( { Eeschema Netlist Version 1.1  29/08/2010 21:07:51
eeschema (2010-08-28 BZR 2458)-unstable}
 ( 4C6E2141 $noname P1 CONN_4
  (  1 VCC )
  (  2 /SIG_OUT )
  (  3 /CLOCK_IN )
  (  4 GND )
 )
 ( 4C6E20BA $noname U2 74LS74
  (  1 VCC )
  (  2 /SIG_OUT )
  (  3 N-04 )
  (  4 VCC )
  (  5 /SIG_OUT )
  (  6 ? )
  (  7 GND )
  (  14 VCC )
 )
 ( 4C6E20A6 $noname U1 74LS04
  (  1 /CLOCK_IN )
  (  2 N-04 )
  (  7 GND )
  (  14 VCC )
 )
 ( 4C6E2094 $noname C1 CP
  (  1 /CLOCK_IN )
  (  2 GND )
 )
 ( 4C6E208A $noname R1 R
  (  1 VCC )
  (  2 /CLOCK_IN )
 )
)
*

14.3.4. Eeschema Plugin-Schnittstelle

Zwischenzeitliche Netzlistenkonverter können automatisch aus Eeschema gestartet werden.

Das Dialogfenster aufrufen

Sie können ein neues Netzlisten-Plugin hinzufügen mit einem Klick auf "Plugin hinzufügen".

Auswahlbutton zum Einfügen von Plugins

So sehen die Konfigurationsdaten für das PadsPcb Plugin aus:

Einstellungen des Plugins PadsPCB
Konfiguration der Plugin-Parameter

Folgende Informationen werden in der Eeschema Plug-In Konfiguration benötigt:

  • Titel: Zum Beispiel der Name des Netzlistenformats.

  • Netzliste Befehl: Der Audruf um den Konverter zu starten.

Sobald Sie auf den Button Erstellen drücken, wird folgendes passieren:

  1. Eeschema erzeugt eine zwischenzeitliche Netzlistendatei im XML-Format, zum Beispiel test.xml.

  2. Eeschema startet das Plugin und liest test.xml ein und erzeugt test.net.

Netzlistendateien über die Befehlszeile erzeugen

Angenommen wir benutzen das Programm xsltproc.exe um ein Stylesheet auf die zwischenzeitliche Netzlistendatei anzuwenden, dann wird xsltproc.exe mit folgendem Befehl ausgeführt:

xsltproc.exe -o <output filename> < style-sheet filename> <input XML file to convert>

In KiCad unter Windows ist die Befehlszeile wie folgt:

f:/kicad/bin/xsltproc.exe -o "%O" f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl "%I"

Unter Linux sieht der Befehl (abhängig vom Installationsort) wie folgt aus:

xsltproc -o "%O" /usr/local/kicad/bin/plugins/netlist_form_pads-pcb.xsl "%I"

Wobei netliste_form_pads-pcb.xsl das Stylesheet ist, das Sie anwenden. Vergessen Sie nicht die Anführungsstriche um die Dateinamen, dies erlaubt es Leerzeichen zu verwenden nach der Ersetzung durch Eeschema.

Das Befehlszeilenformat akzeptiert Parameter für Dateinamen:

Die unterstützten Formatierungsparameter sind:

  • %B ⇒ Basisdateiname und Pfad der ausgewählten Ausgabedatei ohne Pfad und Erweiterung.

  • %I ⇒ Kompletter Dateiname und Pfad der temporären Eingangsdatei (die Zwischennetzliste).

  • %O ⇒ Kompletter Dateiname und Pfad der vom Benutzer gewählten Ausgabedatei.

%I wird vom tatsächlichen Zwischendateiname ersetzt.

%O wird vom tatsächlichen Ausgabedateiname ersetzt.

Befehlszeilenformat: Beispiel für xsltproc

Das Befehlszeilenformat für xsltproc sieht wie folgt aus:

<Pfad zu xsltproc>xsltproc <xsltproc Parameter>

Unter Windows:

f:/kicad/bin/xsltproc.exe -o "%O" f:/kicad/bin/plugins/netlist_form_pads-pcb.xsl "%I"

Unter Linux (wieder abhängig vom Installationsort):

xsltproc -o "%O" /usr/local/kicad/bin/plugins/netlist_form_pads-pcb.xsl "%I"

Die obigen Beispiele gehen davon aus, dass xsltproc auf Ihren PC unter Windows installiert ist und sich alle Dateien in kicad/bin befinden.

14.3.5. Stücklistenerzeugung

Weil die zwischenzeitliche Netzlistendatei alle Informationen über verwendete Bauteile enthält, kann eine Stückliste aus ihr abgeleitet werden. Hier ist das Einstellungsfenster des Plugin (in Linux) um eine angepasste Stücklistendatei zu erzeugen:

Einstellungen BOM in der Netzliste

Der Pfad zum Stylesheet bom2csv.xsl ist abhängig vom verwendeten Betriebssystem. Das derzeit beste XSLT Stylesheet zur Stücklistenerzeugung heißt bom2csv.xsl. Sie können es nach Ihren Anforderungen anpassen und wenn Sie etwas allgemein Nutzbares erzeugen, fragen Sie ob es Teil des KiCad Projekts werden kann.

14.4. Kommandozeilenformat: Beispiel für Pythonskripte

Das Befehlszeilenformat für Python sieht so aus:

python <script file name> <input filename> <output filename>

Unter Windows:

python *.exe f:/kicad/python/my_python_script.py "%I" "%O"

Unter Linux (wieder abhängig vom Installationsort):

python /usr/local/kicad/python/my_python_script.py "%I" "%O"

Dabei wird angenommen, dass Python auf Ihrem PC installiert ist.

14.5. Struktur der Zwischennetzliste

Dieses Beispiel gibt Ihnen eine Idee für das Netzlistendateiformat:

<?xml version="1.0" encoding="utf-8"?>
<export version="D">
  <design>
    <source>F:\kicad_aux\netlist_test\netlist_test.sch</source>
    <date>29/08/2010 21:07:51</date>
    <tool>eeschema (2010-08-28 BZR 2458)-unstable</tool>
  </design>
  <components>
    <comp ref="P1">
      <value>CONN_4</value>
      <libsource lib="conn" part="CONN_4"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E2141</tstamp>
    </comp>
    <comp ref="U2">
      <value>74LS74</value>
      <libsource lib="74xx" part="74LS74"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E20BA</tstamp>
    </comp>
    <comp ref="U1">
      <value>74LS04</value>
      <libsource lib="74xx" part="74LS04"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E20A6</tstamp>
    </comp>
    <comp ref="C1">
      <value>CP</value>
      <libsource lib="device" part="CP"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E2094</tstamp>
    <comp ref="R1">
      <value>R</value>
      <libsource lib="device" part="R"/>
      <sheetpath names="/" tstamps="/"/>
      <tstamp>4C6E208A</tstamp>
    </comp>
  </components>
  <libparts/>
  <libraries/>
  <nets>
    <net code="1" name="GND">
      <node ref="U1" pin="7"/>
      <node ref="C1" pin="2"/>
      <node ref="U2" pin="7"/>
      <node ref="P1" pin="4"/>
    </net>
    <net code="2" name="VCC">
      <node ref="R1" pin="1"/>
      <node ref="U1" pin="14"/>
      <node ref="U2" pin="4"/>
      <node ref="U2" pin="1"/>
      <node ref="U2" pin="14"/>
      <node ref="P1" pin="1"/>
    </net>
    <net code="3" name="">
      <node ref="U2" pin="6"/>
    </net>
    <net code="4" name="">
      <node ref="U1" pin="2"/>
      <node ref="U2" pin="3"/>
    </net>
    <net code="5" name="/SIG_OUT">
      <node ref="P1" pin="2"/>
      <node ref="U2" pin="5"/>
      <node ref="U2" pin="2"/>
    </net>
    <net code="6" name="/CLOCK_IN">
      <node ref="R1" pin="2"/>
      <node ref="C1" pin="1"/>
      <node ref="U1" pin="1"/>
      <node ref="P1" pin="3"/>
    </net>
  </nets>
</export>

14.5.1. Allgemeine Struktur der Netzlistendatei

Die Zwischennetzliste hat fünf Abschnitte.

  • Einen Header Abschnitt.

  • Einen Abschnitt der Bauteile.

  • Einen Abschnitt der Bibliotheksteile.

  • Einen Abschnitt der Bibliotheken.

  • Einen Abschnitt der Netze.

Der Dateiinhalt hat das Trennzeichen <export>.

<export version="D">
...
</export>

14.5.2. Der Header

Der Header hat das Trennzeichen <design>.

<design>
<source>F:\kicad_aux\netlist_test\netlist_test.sch</source>
<date>21/08/2010 08:12:08</date>
<tool>eeschema (2010-08-09 BZR 2439)-unstable</tool>
</design>

Dieser Abschnitt kann als ein Kommentarabschnitt betrachtet werden.

14.5.3. Der Abschnitt der Bauteile

Der Abschnitt der Bauteile hat das Trennzeichen <components>.

<components>
<comp ref="P1">
<value>CONN_4</value>
<libsource lib="conn" part="CONN_4"/>
<sheetpath names="/" tstamps="/"/>
<tstamp>4C6E2141</tstamp>
</comp>
</components>

Dieser Abschnitt enthält die Liste der Bauteile ihres Schaltplans. Jedes Bauteil ist wie folgt beschrieben:

<comp ref="P1">
<value>CONN_4</value>
<libsource lib="conn" part="CONN_4"/>
<sheetpath names="/" tstamps="/"/>
<tstamp>4C6E2141</tstamp>
</comp>

libsource

Name der Bibliothek, in der das Bauteil gefunden wurde.

part

Bauteilname in dieser Bibliothek.

sheetpath

Pfad des Blattes in der Hierarchie: Kennzeichnet das Blatt innerhalb der kompletten Schaltplanhierarchie.

tstamps (time stamps)

Zeitstempel der Schaltplandatei.

tstamp (time stamp)

Zeitstempel des Bauteils.

Anmerkung zu Zeitstempeln für Bauteile

Um ein Bauteil in einer Netzliste und damit auf der Leiterplatte zu identifizieren, wird die Zeitstempel-Referenz als einzigartig für jedes Bauteil verwendet. Jedoch stellt KiCad einen zusätzlichen Hilfsweg zur Verfügung um ein Bauteil zu identifizieren, und zwar über den zugehörigen Footprint auf der Leiterplatte. Das erlaubt die Neunummerierung von Bauteilen in einem Schaltplanprojekt ohne den Verlust der Verbindung zwischen Bauteil und seinem Footprint.

Ein Zeitstempel ist eine einzigartige Identifizierung für jedes Bauteil oder Blatt in einem Schaltplanprojekt. Jedoch wird in einer komplexen Hierarchie das selbe Blatt mehr als einmal verwendet, daher enthält dieses Blatt Bauteile mit dem gleichen Zeitstempel.

Ein gegebenes Blatt hat eine einzigartige Identifizierung innerhalb einer komplexen Hierarchie: seinen Blattpfad. Ein gegebenes Bauteil (in einer komplexen Hierarchie) hat ebenfalls eine einzigartige Identifizierung: den Blattpfad + seinen Zeitstempel.

14.5.4. Der Abschnitt der Bibliotheksteile

Der Abschnitt der Bibliotheksteile hat das Trennzeichen <libparts> und der Inhalt dieses Abschnitts ist in den Schaltplanbibliotheken festgelegt. Der Abschnitt der Bibliotheksteile enthält:

  • Die erlaubten Footprintnamen (Namen verwenden Platzhalter), Trennzeichen <fp>.

  • Die in der Bibliothek definierten Felder, Trennzeichen <fields>.

  • Die Liste der Anschlüsse, Trennzeichen <pins>.

<libparts>
<libpart lib="device" part="CP">
  <description>Condensateur polarise</description>
  <footprints>
    <fp>CP*</fp>
    <fp>SM*</fp>
  </footprints>
  <fields>
    <field name="Reference">C</field>
    <field name="Valeur">CP</field>
  </fields>
  <pins>
    <pin num="1" name="1" type="passive"/>
    <pin num="2" name="2" type="passive"/>
  </pins>
</libpart>
</libparts>

Zeilen wie <pin num="1" type="passive"/> geben ebenfalls den elektrischen Typ des Anschlusses an. Die möglichen elektrischen Typen sind:

Input

Normaler Eingang

Output

Normaler Ausgang

Bidirectional

Eingang oder Ausgang

Tri-state

Bus Ein-/Ausgang

Passive

Üblicherweise die Enden von passiven Bauteilen

Unspecified

Unbekannter elektrischer Typ

Power input

Spannungseingang des Bauteils

Power output

Spannungsausgang wie z.B. Ausgang eines Spannungsreglers

Open collector

Offener Kollektorausgang wie häufig in Analog Komparatoren zu finden

Open emitter

Ausgang der manchmal bei Logikbausteinen zu finden ist

Not connected

Darf im Schaltplan nicht verbunden werden

14.5.5. Der Abschnitt der Bibliotheken

Der Abschnitt der Bibliotheken hat das Trennzeichen <libraries>. Dieser Abschnitt enthält die Liste der im Projekt verwendeten Schaltplanbibliotheken.

<libraries>
  <library logical="device">
    <uri>F:\kicad\share\library\device.lib</uri>
  </library>
  <library logical="conn">
    <uri>F:\kicad\share\library\conn.lib</uri>
  </library>
</libraries>

14.5.6. Der Abschnitt der Netze

Der Abschnitt der Netze hat das Trennzeichen <nets>. Dieser Abschnitt enthält die "Verbindungen" des Schaltplans.

<nets>
  <net code="1" name="GND">
    <node ref="U1" pin="7"/>
    <node ref="C1" pin="2"/>
    <node ref="U2" pin="7"/>
    <node ref="P1" pin="4"/>
  </net>
  <net code="2" name="VCC">
    <node ref="R1" pin="1"/>
    <node ref="U1" pin="14"/>
    <node ref="U2" pin="4"/>
    <node ref="U2" pin="1"/>
    <node ref="U2" pin="14"/>
    <node ref="P1" pin="1"/>
  </net>
</nets>

Dieser Abschnitt listet alle Netze des Schaltplans auf.

Ein mögliches Netz enthält das folgende:

<net code="1" name="GND">
  <node ref="U1" pin="7"/>
  <node ref="C1" pin="2"/>
  <node ref="U2" pin="7"/>
  <node ref="P1" pin="4"/>
</net>

net code

ist ein interner Identifikator für dieses Netz

name

ist der Name für dieses Netz

node

gibt eine Anschlussreferenz an der mit diesem Netz verbunden ist

14.6. Mehr über xsltproc

Finden Sie auf der Seite: http://xmlsoft.org/XSLT/xsltproc.html

14.6.1. Einleitung

xsltproc ist ein Befehlszeilenwerkzeug, um XSLT Stylesheets auf XML Dokumente anzuwenden. Obwohl es als Teil des GNOME-Projekts entwickelt wurde, kann es unabhängig vom GNOME-Desktop verwendet werden.

xsltproc wird von auf Befehlszeile mit dem Namen des zu verwendenden Stylesheets, gefolgt vom Namen der Datei oder Dateien auf welche das Stylesheet angewendet werden soll aufgerufen. Es wird die Standard Eingabe verwenden, wenn ein Dateiname mit - angegeben wird.

Wenn ein Stylesheet in einem XML-Dokument mit Stylesheet Verarbeitungshinweisen enthalten ist, muss kein Stylesheet auf der Befehlszeile angegeben werden. xsltproc wird das enthaltene Stylesheet automatisch erkennen und benutzen. Standardmäßig erfolgt die Ausgabe nach stdout. Sie können eine Ausgabedatei mit der -o Option angeben.

14.6.2. Übersicht

xsltproc [[-V] | [-v] | [-o *file* ] | [--timing] | [--repeat] |
[--debug] | [--novalid] | [--noout] | [--maxdepth *val* ] | [--html] |
[--param *name* *value* ] | [--stringparam *name* *value* ] | [--nonet] |
[--path *paths* ] | [--load-trace] | [--catalogs] | [--xinclude] |
[--profile] | [--dumpextensions] | [--nowrite] | [--nomkdir] |
[--writesubtree] | [--nodtdattr]] [ *stylesheet* ] [ *file1* ] [ *file2* ]
[ *....* ]

14.6.3. Befehlszeilen-Optionen

-V or --version

Zeigt die verwendete Version von libxml und libxslt an.

-v or --verbose

Gebe jeden Schritt aus, den xsltproc bei der Verarbeitung des Stylesheets und des Dokuments durchführt

-o or --output file

Leite die Ausgabe auf den Dateinamen file um. Für mehrere Ausgaben, auch als „chunking“ benannt, leitet -o Verzeichnis/ die Ausgabendateien in ein spezielles Verzeichnis um. Das Verzeichnis muss schon angelegt sein.

--timing

Zeigt die Zeit an, die für das Lesen des Stylesheets, des Dokuments, Anwenden des Stylesheets und speichern des Ergebnisses benötigt wurde. Die Zeiten werden in Millisekunden angegeben.

--repeat

Führe die Umwandlung 20 mal durch. Wird für Zeit bestimmende Tests verwendet.

--debug

Gibt den XML-Baum des umgewandelten Dokuments aus; für Debug Zwecke.

--novalid

Überspringe das Laden der DTD des Dokuments.

--noout

Das Ergebnis nicht ausgeben.

--maxdepth value

Stellt die maximale Tiefe des Vorlagenstapels ein, bevor libxslt feststellt, dass es in einer unendlichen Schleife festhängt. Der Standard ist 500.

--html

Das Eingabedokument ist eine HTML-Datei.

--param name value

Übergibt einen Parameter mit dem Namen name und des Wertes value an das Stylesheet. Sie können mehrere Namen/Wert Paare bis zu einem Maximum von 32 angeben. Wenn der übergebene Wert eine Zeichenkette und kein Knoten Identifikator ist, benutzen Sie stattdessen --stringparam.

--stringparam name value

Übergibt einen Parameter mit dem Namen name und Wert value wobei value eine Zeichenkette und kein Knoten Identifikator ist. (Anmerkung: die Zeichenkette muss UTF-8 sein.)

--nonet

Nicht das Internet benutzen um DTD’s, Entities oder Dokumente zu laden.

--path paths

Benutze die Liste (getrennt mit Leerzeichen oder Doppelpunkt) von Dateisystempfaden, angegeben über paths, um DTD’s, Entities oder Dokumente zu laden.

--load-trace

Gibt alle während der Verarbeitung geladene Dokumente auf stderr aus.

--catalogs

Benutze den in SGML_CATALOG_FILES spezifizierten SGML-Katalog um den Ort von externen Entities aufzulösen. Standardmäßig sucht xsltproc nach dem Katalog, der in XML_CATALOG_FILES spezifiziert ist. Wenn das nicht spezifiziert ist, benutzt es /etc/xml/catalog.

--xinclude

Verarbeitet das Eingabe-Dokument unter Benutzung der Xinclude-Spezifikation. Mehr Details dazu können in der Xinclude-Spezifikation gefunden werden: http://www.w3.org/TR/xinclude/

--profile --norman

Gibt detaillierte Information über die in jedem Teil des Stylesheets benötigte Zeit aus. Das ist hilfreich um die Performance des Stylesheets zu optimieren.

--dumpextensions

Gibt die Liste aller registrierten Erweiterungen auf stdout aus.

--nowrite

Untersagt jegliches Schreiben in eine Datei oder Ressource.

--nomkdir

Untersagt das Erstellen von Verzeichnissen.

--writesubtree path

Erlaubt das Schreiben von Dateien nur unterhalb des Pfades path.

--nodtdattr

Keine Standardattribute aus dem DTD des Dokuments anwenden.

14.6.4. Xsltproc Rückgabewerte

xsltproc gibt eine Status Nummer zurück, die sehr hilfreich sein kann, wenn es aus einem Skript aufgerufen wird.

0: Normal

1: Kein Argument

2: zu viele Parameter

3: unbekannte Option

4: konnte Stylesheet nicht abarbeiten

5: Fehler im Stylesheet

6: Fehler in einem der Dokumente

7: nicht unterstützte xsl:Ausgabe Methode

8: Zeichenketten-Parameter enthält sowohl einfache als auch doppelte Anführungszeichen

9: interner Verarbeitungsfehler

10: Verarbeitung wurde durch eine Abbruch Nachricht gestoppt

11: konnte das Ergebnis in die Ausgabedatei schreiben

14.6.5. Mehr Information über xsltproc

libxml Webseite: http://www.xmlsoft.org/

W3C XSLT Webseite: http://www.w3.org/TR/xslt