Manuel de référence

Ce document est la propriété des contributeurs ci-dessous, copyright © 2010-2015. Vous pouvez le distribuer et/ou le modifier selon les termes de la GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 ou ultérieure ou bien selon la licence Creative Commons Attribution (http://creativecommons.org/licenses/by/3.0/), version 3.0 ou ultérieure.

Toutes les marques apparaissant dans ce document appartiennent à leurs propriétaires respectifs.

Contributeurs

Jean-Pierre Charras, Fabrizio Tappero, Marc Berlioux.

Traduction

Marc Berlioux <[email protected]>, 2015-2016

Retours

Merci de signaler vos corrections de bugs, suggestions ou nouvelles versions ici :

Date de publication et version du logiciel

Publié le 30 mai 2015.

Introduction à Eeschema

Description

Eeschema est un puissant logiciel de saisie de schémas électroniques faisant partie de KiCad et disponible pour les systèmes d’exploitations suivants :

  • Linux

  • Apple OS X

  • Windows

Les fichiers de Eeschema sont compatibles d’un système d’exploitation à un autre.

Eeschema est une application intégrée à partir de laquelle toutes les fonctions de dessin, de contrôle, de mise en page, de gestion des librairies et d’accès au logiciel de conception de circuit imprimé sont accessibles.

Eeschema est conçu pour fonctionner avec PcbNew, le logiciel d’édition de circuit imprimés de KiCad. Il permet aussi d’exporter des fichiers Netlistes listant toutes les connexions électriques, pour d’autres logiciels.

Eeschema inclue un éditeur de symboles schématiques de composants, qui permet de créer, modifier des composants et de gérer les librairies. Il intègre aussi plusieurs autres fonctions essentielles à la création de schémas électroniques modernes :

  • La vérification des règles électriques ou ERC (Electrical Rules Check), pour le contrôle des connexions manquantes ou incorrectes.

  • L’exportation de fichiers de tracé en plusieurs formats (Postscript, PDF, HPGL, SVG)

  • La génération de listes de composants ou BOM (Bill of Materials) à travers des scripts Python, ce qui permet plusieurs formats configurables.

Aperçu technique

Eeschema n’est limité que par la mémoire vive disponible. Il n’y a ainsi aucune limitation sur le nombre de composants, de pins, de connexions ou de feuilles schématiques. Dans le cas de schémas à feuilles multiples, leur représentation est hiérarchique.

Eeschema gère les schémas multi-feuilles de types suivants :

  • Schémas à hiérarchie simple (chaque schéma n’est utilisé qu’une fois).

  • Schémas à hiérarchie complexe (certains schémas sont utilisés plus d’une fois, en plusieurs instances).

  • Schémas à hiérarchie plate (les schémas ne font pas explicitement partie d’un schéma maître).

Commandes de bases de Eeschema

Accès aux commandes de Eeschema

Vous pouvez accéder au différentes commandes :

  • En cliquant sur les menus, en haut de la fenêtre.

  • En cliquant sur les boutons de la barre d’outil principale, au sommet de la fenêtre, sous les menus.

  • En cliquant sur les boutons de la barre d’outils à droite de la fenêtre (outils de placement d’éléments).

  • En cliquant sur les boutons de la barre d’outils à gauche de la fenêtre (options d’affichage).

  • En utilisant la souris (commandes complémentaires importantes), notamment au moyen du clic droit sur un élément du schéma, qui affiche un menu contextuel (options de zoom, de dimension de grille et d’édition des éléments).

  • En utilisant les touches de fonctions (touches F1, F2, F3, F4, [Insert], et [Espace]). Généralement, l’appui sur la touche [Escape] annule l’opération en cours, et la touche [Insert] permet la duplication d’un élément venant d’être inséré.

Voici un apercu de l’interface et de l’emplacement des différentes commandes :

commands overview

Commandes à la souris

Commandes de base

Bouton gauche

  • Simple clic : affiche les caractéristiques du composant ou du texte sous le curseur, dans la barre d’état, au bas de la fenêtre.

  • Double clic : modifie l’élément (s’il est éditable..), composant ou texte.

Bouton droit

  • Ouvre un menu contextuel, en fonction de l’élément sous le curseur.

Opérations sur les blocs

Vous pouvez déplacer, traîner ou détruire des zones sélectionnées dans tous les modes de Eeschema. La différence entre 'déplacer' (Move) et 'traîner' (Drag) est que les liaisons électriques entre éléments sont conservées lors d’un Drag.

On sélectionne une zone en cliquant du bouton gauche et en maintenant ce bouton appuyé tout en déplaçant la souris.

L’appui sur [Shift], [Ctrl], ou [Shift + Ctrl] pendant la sélection effectue respectivement une copie, un "drag", ou une suppression :

Bouton gauche de la souris

Déplacer la sélection (Move).

Shift + bouton gauche de la souris

Copier la sélection.

Ctrl + bouton gauche de la souris

Traîner la sélection (Drag).

Ctrl + Shift + bouton gauche de la souris

Supprimer la sélection.

Lors d’un "drag" ou d’une copie, vous pouvez :

  • Cliquer à nouveau du bouton gauche pour poser les éléments.

  • Cliquer du bouton droit et choisir 'Annuler Bloc' pour annuler l’opération.

En cliquant du bouton droit on peut choisir d’autres actions dans le menu contextuel :

main window popup

Raccourcis clavier

  • L’appui sur la touche [?] affiche la liste des raccourcis clavier.

  • Les raccourcis clavier peuvent être modifiés par le menu 'Préférences', 'Raccourcis', 'Editer les raccourcis'.

Aperçu de la liste des raccourcis clavier par défaut :

Default hotkey list

Tous les raccourcis clavier peuvent être redéfinis avec l’Éditeur de raccourcis :

Hotkeys editor window

Sélection de la taille de grille

Dans Eeschema, le curseur se déplace au dessus d’une grille, qui peut être visible ou non. La grille est toujours visible dans le gestionnaire de librairie.

Vous pouvez changer la taille de la grille par le menu contextuel ou par le menu 'Préférences','Options de l’éditeur de schématique'.

La taille par défaut de la grille est de 50 mils (0.050") soit 1.27 mm.

C’est la dimension préférée pour le placement des composants et des fils dans le schéma, mais aussi pour le placement des pins pendant le dessin d’un symbole de composant dans l’éditeur de composants.

On peut aussi travailler avec une dimension de grille plus petite comme 25 mils ou 10 mils. C’est uniquement lors du dessin des boîtiers de composants ou pour placer des textes et des commentaires, et non pour placer des pins ou des fils.

Sélection du Zoom

Pour changer le niveau du zoom :

  • Cliquez du bouton droit pour ouvrir le menu contextuel et choisissez la valeur de zoom désirée.

  • Ou utilisez les touches de fonctions :

    • F1: Zoom in

    • F2: Zoom out

    • F4 or simply click on the middle mouse button (without moving the mouse): Center the view around the cursor pointer position

  • Zoom fenêtre :

    • Mouse wheel: Zoom in/out

    • Shift+Mouse wheel: Pan up/down

    • Ctrl+Mouse wheel: Pan left/right

Affichage des coordonnées du curseur

L’unité d’affichage est en inches ou en millimètres. Toutefois, Eeschema travaille toujours en interne en unités de 0.001 inch (mil/thou).

Les informations suivantes sont affichées en bas et à droite de la fenêtre :

  • Le facteur de Zoom

  • La position absolue du curseur (X Y)

  • La position relative du curseur (dx dy)

Les coordonnées relatives sont remises à zéro par un appui sur la barre d’espace du clavier. C’est très utile pour faire des mesures entre deux points.

Barre d’état

Barre de menu

La barre de menus permet l’ouverture et la sauvegarde de schémas, la configuration du programme et l’affichage de la documentation.

menubar

Barre d’outils supérieure

Cette barre d’outils donne accès aux principales fonctions de Eeschema.

Si Eeschema est lancé tout seul (mode standalone), et non par le gestionnaire de projets, voici les boutons disponibles :

images/toolbar_schedit_standalone.png

Si Eeschema est lancé par le gestionnaire de projets (KiCad), voici les boutons disponibles :

images/toolbar_schedit.png

Les outils pour créer un projet ne sont pas présents, car ils sont dans le Gestionnaire de Projets.

new schematic icon

Create a new schematic (only in standalone mode).

Open schematic icon

Open a schematic (only in standalone mode).

icons/save_png

Save complete (hierarchical) schematic.

Page Settings icon

Select the sheet size and edit the title block.

icons/print_button_png

Open print dialog.

icons/cut_button_png

Remove the selected elements during a block move.

icons/copyblock_png

Copy selected elements to the clipboard during a block move.

icons/paste_png

Copy last selected element or block in the current sheet.

icons/undo_png

Undo: Cancel the last change (up to 10 levels).

icons/redo_png

Redo (up to 10 levels).

search icon

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

search replace icon

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

icons/zoom_in icons/zoom_out

Zoom in and out.

icons/zoom_redraw icons/zoom_fit_in_page_png

Refresh screen; zoom to fit.

hierarchy navigator icon

View and navigate the hierarchy tree.

icons/leave_sheet

Leave the current sheet and go up in the hierarchy.

icons/libedit_png

Call component editor Libedit to view and modify libraries and component symbols.

icons/library_browse_png

Display libraries (Viewlib).

icons_annotate_png

Annotate components.

ERC icon

Electrical rules check (ERC), automatically validate electrical connections.

Netlist icon

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

BOM icon

Generate the BOM (Bill of Materials).

edit_module icon

Edit footprint.

run cvpcb icon

Call CvPcb to assign footprints to components.

icons/pcbnew_png

Call Pcbnew to perform a PCB layout.

Import Footprint Names icon

Back-import component footprints (selected using CvPcb) into the "footprint" fields.

Barre d’outils latérale droite

Cette barre d’outils contient les outils pour :

  • Placer des composants, des fils, des bus, des jonctions, des étiquettes (labels), des textes, etc…​

  • Créer des sous-feuilles hiérarchiques et des symboles de connexion.

images/toolbar_schedit_rightside.png

icons/cursor_png

Cancel the active command or tool.

icons/hierarchy_cursor_png

Hierarchy navigation: this tool makes it possible to open the subsheet of the displayed schematic (click in the symbol of this subsheet), or to go back up in the hierarchy (click in a free area of the schematic).

New Component icon

Display the component selector.

Add Power icon

Display the power symbol selector.

icons/add_line_png

Draw a wire.

icons/add_bus_png

Draw a bus.

icons/add_line2bus_png

Draw wire-to-bus entry points. These elements are only graphical and do not create a connection, thus they should not be used to connect wires together.

icons/add_bus2bus_png

Draw bus-to-bus entry points.

icons/noconn_png

Place a "No Connect" flag. These are placed on component pins which are not to be connected. This is useful in the ERC function to check if pins are intentionally left not connected or are missed.

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 an end of the wire or pin is not connected to one of the ends of the other wire).

icons/add_line_label_png

Local label placement. Two wires may be connected with identical labels 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 between different sheets.

icons/add_hierarchical_label_png

Place a hierarchical label. This makes it possible to place a connection between a sheet and the parent sheet that contains it.

icons/add_hierarchical_subsheet_png

Place a hierarchical subsheet. You must specify the file name for this subsheet.

icons/import_hierarchical_label_png

Import hierarchical labels from a subsheet. These hierarchical labels must already be placed in the subsheet. These are equivalent to pins on a component, and must be connected using wires.

icons/add_hierar_pin_png

Place hierarchical label in a subsheet symbol. This is placed by name and does not require the label to already exist in the subsheet itself.

icons/add_dashed_line_png

Draw a line. These are only graphical and do not connect anything.

icons/add_text_png

Place textual comments. These are only graphical.

icons/image_png

Place a bitmap image.

icons/cancel_png

Delete selected element. If several superimposed elements are selected, the priority is given to the smallest (in the decreasing priorities: junction, "No Connect", wire, bus, text, component). This also applies to hierarchical sheets. Note: the "Undelete" function of the general toolbar allows you to cancel last deletions.

Barre d’outils latérale gauche

Cette barre d’outils permet de gérer les options d’affichage :

icons/grid

Show/Hide the grid.

icons/unit_inch

Switch to inches.

icons/unit_mm

Switch to millimeters.

icons/cursor_shape

Choose the cursor shape.

icons/hidden_pin

Visibility of "invisible" pins.

icons/lines90

Allowed orientation of wires and buses.

Menus contextuels et édition rapide

Un clic droit ouvre un menu contextuel pour l’élément sélectionné ou survolé : ce menu permet d’ajuster :

  • Le facteur de Zoom.

  • La taille de grille.

  • Les paramètres couramment édités de l’élément sélectionné.

Menu contextuel en dehors d’un élément.

eeschema_popup_without_element_png

Édition d’un label

eeschema_popup_edit_label_png

Édition d’un composant

eeschema_popup_edit_component_png

Barre de menus

Menu Fichiers

Menu Fichiers
New Schematic Project Clear current schematic and initialize a new one

Open Schematic Project

Load a schematic hierarchy

Open Recent

Open a list of recently opened files

Append Schematic Sheet

Insert the contents of another sheet into the current one

Save Schematic Project

Save current sheet and all its hierarchy.

Save Current Sheet Only

Save current sheet, but not others in a hierarchy.

Save Current Sheet As…​

Save current sheet with a new name.

Page Settings

Configure page dimensions and title block.

Print

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

Plot

Export to PDF, PostScript, HPGL or SVG format (See chapter Plot and Print).

Close

Quit without saving.

Menu Préférences

Préférences

Menu Préférences

Librairies de Composants

Sélection des librairies et des chemins de recherche de librairies.

Sélection Couleurs des Éléments

Réglages des couleurs de l’affichage, de tracé et d’impression.

Options de l’Éditeur de schématique

Options générales (unités, tailles de grille, noms de champs, etc…​).

Langue

Sélection de la langue de l’interface.

Raccourcis

Sous-menu des raccourcis (liste, édition, export, import).

Sauver Préférences

Enregistrer les préférences dans un fichier de projet .pro.

Charger Préférences

Charger les préférences du projet depuis un fichier .pro.

Préférences / Librairies de Composants

Configuration des Librairies

Cette boite de dialogue est utilisée pour configurer les librairies de composants et les chemins de recherche des librairies. Ces réglages sont enregistrés dans un fichier .pro. Vous pouvez avoir différents fichiers de configuration dans différents dossiers.

Eeschema recherche, dans l’ordre :

  1. Le fichier de configuration (nom_du_projet.pro) dans le dossier courant.

  2. Le fichier kicad.pro dans le répertoire de KiCad. Ce fichier sera donc le fichier de configuration par défaut.

  3. En l’absence de ces fichiers, il chargera des valeurs par défaut. À charge pour vous d’ajouter vos librairies à la liste, et d’enregistrer la configuration dans un fichier .pro.

La case 'Vérifier les conflits entre cache et librairie au chargement du schéma' détermine le comportement du restaurateur de cache de librairies. Voir Réparer le Cache de Composants pour plus d’informations.

Préférences / Sélection Couleurs des Éléments

Couleurs dans Eeschema

Palette des couleurs utilisées pour les différents éléments graphiques, ainsi que pour la couleur de fond de la zone d’édition (noir ou blanc).

Préférences / Options de l’Éditeur de Schématique

Options de l’éditeur de schématique

Measurement units:

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

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.

Default bus width:

Pen size used to draw buses.

Default line width:

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

Default text size:

Text size used when creating new text items or labels

Repeat draw item horizontal displacement

increment on X axis during element duplication (usual value 0)

(after placing an item like a component, label or wire, a duplication is made by the Insert key)

Repeat draw item vertical displacement

increment on Y axis during element duplication (usual value is 0.100 inches or 2,54 mm)

Repeat label increment:

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

Auto save time interval:

Time in minutes between saving backups.

Part id notation:

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

Show Grid:

If checked: display grid.

Show hidden pins:

Display invisible (or hidden) pins, typically power pins. If checked, allows the display of power pins.

Do not center and warp cursor on zoom:

When zooming, keep the position and cursor where they are.

Use middle mouse button to pan

When enabled, the sheet can be dragged around using the middle mouse button.

Limit panning to scroll size

When enabled, the middle mouse button cannot move the sheet area outside the displayed area.

Pan while moving object

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

Allow buses and wires to be placed in H or V orientation only

If checked, buses and wires can only be vertical or horizontal.

Otherwise, buses and wires can be placed at any orientation.

Show page limits

If checked, shows the page boundaries on screen.

Préférences / Langue

Utilisez la langue par défaut du système. Les autres choix de langue sont là principalement pour le développement.

Menu Aide

Accédez à l’aide en ligne (ce document) pour un manuel détaillé de KiCad. Utilisez les informations présentes dans ``Copier infos de version'' quand vous soumettez un rapport de bug, pour identifier votre version et votre système.

Barre d’outils principale

Gestion des feuilles schématiques

L’icône 'Ajustage des options de la page' Sheet Settings icon, vous permet de régler la taille de la feuille et les textes contenus dans le cartouche.

Réglage de la page

Le nombre de feuilles, numéro de feuille, sont mis à jour automatiquement. La date ne sera pas changée automatiquement, mais vous pouvez la fixer à aujourd’hui en cliquant sur le bouton "←".

Options de l’éditeur de schématique

Options générales

Options de l’éditeur de schématique

Noms des Champs Modèles

Vous pouvez définir des champs personnalisés qui existeront par défaut pour chaque composant (même s’ils sont laissés vides).

Définition des Noms de Champs Modèles

Outil de recherche

L’icône Find icon, vous affichera la fenêtre de l’outil de recherche.

Chercher

Vous pouvez rechercher une référence, une valeur, ou du texte, dans la feuille courante ou dans l’ensemble de la hiérarchie. Une fois trouvé, le curseur sera positionné sur l’élément recherché dans la sous-feuille concernée.

Outil de Netliste

L’icône Netlist icon ouvre l’outil de génération de netlistes.

Les fichiers netlistes générés décrivent toutes les connexions entre éléments dans l’entière hiérarchie.

Dans une hiérarchie multi-feuilles, chaque label local n’est visible que dans la feuille à laquelle il appartient. Ainsi, le label TOTO de la feuille 3 est différent du label TOTO de la feuille 5 (si aucune connexion n’a été introduite volontairement pour les relier). Ceci est du au fait que le numéro de la feuille est associé en interne aux labels locaux.

Note 1 :

La longueur des labels n’a aucune limitation dans Eeschema, mais les logiciels exploitant les netlistes générées peuvent, eux, avoir certaines limitations à ce sujet.

Note 2 :

Évitez les espaces dans les noms de labels, car ils apparaîtront comme des mots séparés. Ce n’est pas une limitation de Eeschema, mais il peut y en avoir dans certains formats de netlistes qui considèrent que les noms de labels sont dépourvus d’espaces.

La fenêtre de l’outil de Netlistes

Options :

Format par défaut :

Cochez la case pour choisir Pcbnew comme le format par défaut.

D’autres formats de netlistes peuvent être générés :

  • Orcad PCB2

  • CadStar

  • Spice, pour les simulateurs

Des plugins externes peuvent également être ajoutés pour de nouveaux formats.

Outil d’annotation

L’icône icons_annotate_png donne accès à l’outil d’annotation. Cet outil effectue le nommage automatique des références des composants du schéma.

Pour des composants multi-unités (comme par exemple le 7400 qui contient 4 portes), un suffixe d’unité sera attribué (ainsi notre 7400 désigné par la référence U3 sera divisé en quatre unités référencées U3A, U3B, U3C et U3D).

Vous pouvez choisir d’annoter tous les composants, ou seulement les nouveaux, comme ceux qui ne sont pas encore annotés.

annotate-dialog_img

Portée

  1. Utiliser la schématique entière. Toutes les feuilles seront ré-annotées (c’est option habituelle).

  2. Utiliser la feuille active uniquement. Seule la feuille courante sera ré-annotée (cette option sera utilisée dans des cas particuliers, par exemple pour évaluer le nombre de résistances de la feuille courante).

  3. Garder l’annotation existante. Annotation conditionnelle, seuls les nouveaux composants seront annotés (option habituelle).

  4. Supprimer l’annotation existante. Annotation inconditionnelle, tous les composants seront ré-annotés (cette option sera utilisée quand il y a un risque de doublons dans les références).

  5. Reset, mais ne pas échanger les unités déjà numérotées des boitiers multi-unités. Cette option conserve les groupes de multi-unités (ex. : U2A, U2B) lors de la ré-annotation.

Ordre d’annotation

Choisit dans quelle direction seront numérotés les composants.

Choix de l’annotation

Sélectionne la méthode de numérotation pour les schémas multi-feuilles.

Outil de vérification des règles électriques

L’icône ERC icon donne accès à l’outil de vérification des règles électriques (ERC).

Cet outil effectue la vérification du schéma, et est particulièrement utile pour détecter des connexions oubliées ou des incohérences.

Une fois que vous avez exécuté l’ERC, Eeschema place des marqueurs pour mettre en évidence les problèmes. Le diagnostic peut alors être donné par un clic gauche sur le marqueur. Un fichier de rapport d’erreurs peut également être généré.

Fenêtre principale de l’ERC

La fenêtre de l’ERC.

Les erreurs sont affichées dans la fenêtre du vérificateur des règles électriques :

  • Total : nombre total d’erreurs et avertissements.

  • Erreurs : nombre d’erreurs.

  • Warnings : nombre d’avertissements.

Options :

  • Créer fichier rapport ERC : cochez la case pour la création d’un fichier de rapport d’erreurs.

Commandes :

  • Effacer marqueurs : enlève tous les marqueurs d’erreurs et avertissements du schéma.

  • Exécuter : lance la vérification.

  • Fermer : ferme la fenêtre de l’ERC.

Note :

  • En cliquant sur une erreur, vous êtes emmenés au marqueur correspondant sur le schéma.

Options de l’ERC

Onglet 'Options'

Cet onglet vous permet de fixer les règles de connexion entre pins. Vous pouvez choisir parmi trois options pour chaque cas :

  • Pas d’erreur (Vert)

  • Avertissement (W jaune)

  • Erreur (E rouge)

Chaque carré de la matrice peut être modifié en cliquant une ou plusieurs fois dessus.

Outil de Liste de Matériel

L’icône BOM icon donne accès à l’outil de création de la liste de matériel, ou BOM (Bill Of Material). Cet outil génère un fichier contenant la liste des composants et/ou les connexions hiérarchiques (labels globaux).

Fenêtre du générateur de BOM

Le générateur de BOM utilise des plugins externes, en général sous la forme de feuilles de styles XSLT ou de scripts Python. Certains sont fournis, et sont disponibles dans le répertoire d’installation de KiCad. (Linux : /usr/lib/kicad/plugins).

Quelques champs de composants utiles à utiliser pour le BOM :

  • Valeur : nom unique pour chaque composant utilisé.

  • Empreinte : entrée soit manuellement, soit par rétro-annotation (voir ci-dessous).

  • Champ 1 : nom du fabricant.

  • Champ 2 : référence fabricant.

  • Champ 3 : référence distributeur.

Exemple :

Fenêtre des propriétés du composant

Outil de rétro-annotation des empreintes associées

Accès :

L’icône Import Footprint Names icon donne accès à l’outil de rétro-annotation.

Cet outil permet de rétro-importer les noms des empreintes choisies dans Pcbnew dans les champs empreintes de Eeschema.

Création et édition de schémas

Introduction

Un schéma peut être représenté sur une seule feuille, mais, s’il est assez grand, il lui faudra plusieurs feuilles.

Un schéma représenté sur plusieurs feuilles est un schéma hiérarchique, et toutes ses feuilles (chacune représentée par son propre fichier) constituent un projet Eeschema. La manipulation des schémas hiérarchiques sera décrite au chapitre Schématiques hiérarchiques .

Généralités

Un schéma conçu avec Eeschema est plus que la simple représentation graphique d’un dispositif électronique. Il est normalement le point d’entrée d’une chaîne de développement qui permet de :

Un schéma se compose principalement de composants, de fils, d’étiquettes (labels), de jonctions, de bus et de sources d’alimentation. Pour plus de clarté dans le schéma, vous pouvez placer des éléments purement graphiques comme des entrées de bus, des commentaires ou des polygones graphiques.

Chaîne de développement

dev-chain_png

Les composants sont ajoutés à la schématique à partir de bibliothèques (librairies) de composants. Quand le schéma est fait, une liste d’interconnexions (netliste) est générée, qui est ensuite utilisée pour importer la définition des connexions et des empreintes dans PcbNew.

Placement et édition de composants

Rechercher et placer un composant

Pour placer un composant dans votre schéma, vous pouvez utiliser l’icône New Component icon. Une boîte de dialogue vous permet de taper le nom du composant à charger.

Fenêtre de sélection de composant

La boîte de dialogue Sélection Composant va filtrer les composants par nom, mots-clés, ou description selon ce que vous tapez dans le champ de recherche du filtre.

Avant de placer le composant dans le schéma, vous pouvez le faire pivoter, le renverser (miroir haut-bas ou droite-gauche), ou modifier ses champs, soit en utilisant les raccourcis clavier soit par le menu contextuel (clic-droit). Cela pourra également être fait après le placement, de la même manière.

Voici un composant lors de son placement :

composant en cours de placement

Alimentations

Un symbole d’alimentation est un composant (les symboles d’alimentation sont regroupés dans la librairie "power"), afin qu’ils puissent être placés en utilisant le sélecteur de composants. Cependant, comme les placements d’alimentations sont fréquents, on utilisera l’outil Add Power icon. Cet outil est le même que pour le placement de composants, sauf que la recherche se fait directement dans la librairie ``power''.

Édition et modification de composants (déjà placés)

Il y a deux façons d’éditer un composant :

  • Modifier le composant lui-même : position, orientation, sélection d’unité pour un composant multi-unités.

  • Modifier un de ses champs : référence, valeur, empreinte, etc…​

Lorsqu’un composant vient d’être placé, vous pouvez avoir à modifier sa valeur (en particulier pour les résistances, condensateurs, etc…​), mais il est inutile de lui assigner un numéro de référence tout de suite, ni de sélectionner l’unité (sauf pour les composants avec des unités verrouillées, que vous aurez à attribuer manuellement). Ceci peut être fait automatiquement par l’outil d’annotation.

Modification de composant

Pour modifier une caractéristique d’un composant, placez le curseur sur le composant, puis, au choix :

  • Double-cliquez sur le composant pour ouvrir la fenêtre d’édition complète.

  • Faites un clic droit pour ouvrir le menu contextuel et choisissez l’une des commandes : Déplacer, Orienter, Éditer, Supprimer, etc…​

Édition des champs du composant

Vous pouvez modifier la référence, la valeur, la position, l’orientation, la taille du texte et la visibilité des champs :

  • Double-cliquez sur le champ à modifier.

  • Faites un clic droit pour ouvrir le menu contextuel et choisissez l’une des commandes : Déplacer, Orienter, Éditer, Supprimer, etc…​

Pour plus d’options, ou pour créer de nouveaux champs, double-cliquez sur le composant pour ouvrir la fenêtre d’édition complète des propriétés du composant.

Fenêtre des propriétés du composant

Chaque champ peut être visible ou caché, et affiché soit horizontalement, soit verticalement. La position affichée est toujours indiquée pour le composant normalement affiché (pas de rotation ou de mise en miroir), et est relative au point d’ancrage du composant.

Le bouton "Remettre aux valeurs en Librairie" ramène le composant à son orientation originale, et réinitialise les options, la taille et la position de chaque champ. Les champs textes ne sont cependant pas modifiés, car cela pourrait casser la schématique.

Fils, Bus, Labels, Alimentations

Introduction

Tous ces éléments peuvent être placés à partir des outils de la barre latérale droite

Ces éléments peuvent être des :

  • Fils : connexions entre composants

  • Bus : pour relier graphiquement des labels de bus

  • Polygones : pour la présentation graphique.

  • Jonctions : pour créer des connexions au croisement de fils ou de bus.

  • Entrées de Bus : pour montrer les connexions entre fils et bus. Seulement pour l’aspect graphique !

  • Labels: pour étiqueter ou établir des connexions.

  • Labels globaux: pour établir des connexions entre feuilles.

  • Textes: pour ajouter des commentaires ou des notes.

  • Symboles de Non-Connexion: pour signaler une pin de composant qui ne sera pas utilisée.

  • Feuilles Hiérarchiques, et leurs pins de connexions.

Connexions (Fils et Labels)

Il y a deux moyens d’établir des connexions :

  • Fils de pin à pin.

  • Labels.

La figure ci-dessous montre les deux méthodes :

Labels de fils

Note 1 :

Le point de "contact" d’un label est le coin inférieur gauche de la première lettre de l’étiquette. Ce point est affiché avec un petit carré lorsqu’il n’est pas connecté.

Ce point doit donc être en contact avec le fil, ou être superposé à l’extrémité d’une pin pour que le label soit considéré comme connecté.

Note 2 :

Pour établir une connexion, un segment de fil doit être connecté par ses extrémités à un autre segment ou à une pin de composant.

Si il y a chevauchement (si un fil survole une pin sans être connecté à son extrémité), il n’y a pas de connexion.

Note 3 :

Les fils qui se croisent ne sont pas implicitement connectés. Il est nécessaire de les joindre avec un point de jonction si une connexion est souhaitée.

La figure précédente montre un cas de connexions utilisant des symboles de jonction (fils reliés entre eux, DB25FEMALE pins 19, 20, 21, 22).

Note 4 :

Si deux labels différents sont placés sur le même fil, ils sont reliés entre eux et deviennent équivalents. Et tous les éléments reliés à l’un ou l’autre de ces labels seront connectés entre eux.

Connexions (Bus)

Dans le schéma ci-dessous, de nombreuses pins sont connectées à des bus.

Exemple de schéma avec des bus :
Membres d’un bus

Du point de vue schématique, un bus est une collection de signaux, commençant par un préfixe commun, et se terminant par un numéro. Par exemple, PCA0, PCA1, PCA2 et sont des membres du bus PCA.

Le bus complet est nommé PCA[N..m], où N et m sont le premier et le dernier numéro des fils de ce bus. Ainsi, si le bus PCA compte 20 membres, de 0 à 19, le bus complet sera noté PCA[0..19]. Une collection de signaux comme PCA0, PCA1, PCA2, WRITE, READ ne peut être contenue dans un bus.

Connexions entre membres de bus

Les pins connectées entre les membres d’un même bus doivent être reliées par des labels. Il est impossible de connecter une pin directement à un bus ; ce type de connexion sera ignoré par Eeschema.

Dans l’exemple ci-dessus, les connexions sont faites par des labels placés sur les fils connectés aux pins. Les entrées de bus (segments de fil à 45 degrés) sont purement décoratifs, et ne sont pas nécessaires pour établir des connexions logiques.

En pratique, en utilisant la commande de répétition (touche Insert), les connexions peuvent être très vite faites de la façon suivante, si les pins de composants sont alignées dans l’ordre croissant (un cas fréquent sur des composants tels que des mémoires, microprocesseurs, etc…​) :

  • Placez le premier label (par exemple PCA0).

  • Utilisez la commande de répétition autant de fois que nécessaire pour placer les autres membres. Eeschema créera automatiquement les labels suivants (PCA1, PCA2 …​) alignés verticalement, théoriquement sur la position des autres pins.

  • Dessinez le fil sous le premier label. Ensuite, utilisez la commande de répétition pour placer les autres fils sous les autres labels.

  • Au besoin, placez les entrées de bus de la même façon (placez la première entrée, puis utilisez la commande de répétition).

Dans le menu Préférences / Options de l’éditeur de schématique, vous pouvez définir les paramètres de répétition :

  • Pas vertical.

  • Pas horizontal.

  • Incrémentation des labels (qui peuvent ainsi être incrémentés de 2, 3, ou décrémentés).

Connexions globales entre les bus

Vous pouvez avoir besoin de mettre des connexions entre des bus, pour, par exemple, relier deux bus ayant des noms différents, ou dans le cas d’une hiérarchie, pour créer des liens entre les différentes feuilles. Dans ce cas, effectuez ces connexions de la manière suivante :

Exemple de jonction de bus

Les bus PCA [0..15], ADR [0..7] et BUS [5..10] sont reliés entre eux (remarquez la jonction placée ici pour que le fil de bus vertical rejoigne le milieu du segment du bus horizontal).

Plus précisément, les éléments correspondants sont reliés entre eux: PCA0, ADR0 sont connectés, (de même que PCA1 et ADR1, …​, PCA7 et ADR7).

De la même manière, PCA5, BUS5 et ADR5 sont connectés (tout comme PCA6, BUS6 et ADR6 et PCA7, BUS7 et ADR7).

PCA8 et BUS8 sont aussi connectés (tout comme PCA9 et BUS9, PCA10 et BUS10)

Connexion des sources d’alimentation

Lorsque les pins d’alimentation des composants sont visibles, elles doivent être connectées, comme pour tout autre signal.

Les composants tels que les portes logiques et les bascules peuvent avoir des pins d’alimentation invisibles. Des précautions doivent être prises avec ceux-ci parce que :

  • Vous ne pouvez pas connecter de fils, en raison de leur invisibilité.

  • Vous ne connaissez pas leurs noms.

Et de plus, ce serait une mauvaise idée de les rendre visibles et de les relier comme les autres pins, parce que le schéma deviendrait illisible et non conforme aux conventions habituelles.

Si vous voulez forcer l’affichage de ces pins d’alimentation invisibles, vous devez cocher l’option «Afficher les pins invisibles» dans la boîte de dialogue du menu Préférences / Options de l’éditeur de schématique, ou cliquer sur l’icône hidden pin de la barre d’outils de gauche.

Eeschema connecte automatiquement les pins d’alimentation invisibles de même nom, à la source d’alimentation portant ce nom. Il peut être nécessaire de relier des points d’alimentation de noms différents (par exemple, "GND" dans les composants TTL et "VSS" dans les composants MOS) ; utilisez les symboles d’alimentation pour cela.

Il est déconseillé d’utiliser des labels pour le raccordement aux alimentations. Ceux-ci ne disposent que d’une portée de connexion "locale", et ne relieraient pas les pins d’alimentation invisibles.

La figure ci-dessous montre un exemple de connexion de sources d’alimentation.

Exemples de sources d’alimentations

Dans cet exemple, la masse (GND) est connectée à la source d’alimentation VSS, et la source d’alimentation VCC est connectée à VDD.

Deux symboles PWR_FLAG y sont visibles. Ils indiquent que les deux sources d’alimentation VCC et GND sont vraiment reliées à une source d’alimentation. Sans ces deux drapeaux, l’outil ERC diagnostiquerait : Warning Avertissement : port d’alimentation non connecté.

Tous ces symboles de composants font partie de la librairie ``power''.

Symboles de "Non-Connexion"

Ces symboles sont très utiles pour éviter d’avoir des avertissements indésirables dans l’ERC. La vérification des règles électriques s’assurant qu’aucune connexion n’a été oubliée.

Si des pins doivent vraiment rester en l’air, il est nécessaire de placer un drapeau, symbole de "Non Connexion" (outil : No connection icon) sur ces broches. Ces symboles n’ont aucune incidence sur la génération des netlistes.

Compléments Graphiques

Textes et Commentaires

Il peut être utile, pour la compréhension le schéma, de placer des éléments tels que des textes, des notes, ou des cadres. Les outils Texte : add text et Polygones : add dashed line) sont destinés à cet usage, contrairement aux labels et aux fils, qui sont des éléments de connexion.

Ici, un exemple de cadre avec un texte de commentaire :

Cadre et exemple de texte de commentaire.

Cartouche

On peut modifier le cartouche et son contenu en cliquant sur l’outil Ajustage Opt Page.

Fenêtre des Options de la page
Bloc Titre

Le nombre et le numéro de feuille sont automatiquement mis à jour.

Restauration du cache des composants

Par défaut, EESchema va chercher les symboles de composants des librairies disponibles dans les chemins et emplacements configurés. Cela peut causer un problème lors du chargement d’un projet très ancien : si les symboles de la librairie ont changé depuis qu’ils ont été utilisés dans le projet, ils seraient remplacés automatiquement avec leurs nouvelles versions. Les nouvelles versions peuvent ne pas s’insérer correctement, ou être orientées différemment, ce qui conduit à un schéma cassé.

Cependant, quand un projet est enregistré, une librairie de sauvegarde (ou cache) est enregistrée avec lui. Cela permet au projet d’être distribué sans les librairies complètes. Si vous chargez un projet où les symboles sont présents à la fois dans ce fichier cache et dans les librairies du système, Eeschema va scanner les bibliothèques pour trouver d’éventuels conflits. Les conflits trouvés seront affichés dans la fenêtre suivante :

Fenêtre de résolution des conflits

Vous pouvez voir dans cet exemple que le projet utilisait initialement une diode avec la cathode vers le haut, mais la librairie en contient maintenant une avec la cathode vers le bas. Ce changement pourrait ruiner le projet ! Un appui sur OK, provoquera la sauvegarde de l’ancien symbole dans une librairie spéciale ``rescue'', et tous les composants utilisant ce symbole seront renommés pour éviter les conflits de noms.

Si vous appuyez sur Annuler, aucune sauvegarde ne sera effectuée, et donc Eeschema va, par défaut, charger tous les nouveaux composants. Tant qu’aucun changement n’a été effectué, vous pouvez toujours revenir en arrière et relancer la restauration du cache : choisissez "Sauver anciens composants" du menu Outils pour faire apparaître la fenêtre à nouveau.

Si vous préférez ne plus voir cette boîte de dialogue, vous pouvez appuyer sur "Ne plus afficher". La valeur par défaut est de ne rien faire et de permettre aux nouveaux composants d’être chargés. Cette option peut être modifiée dans les Préférences / Librairies de composants.

Schématiques hiérarchiques

Introduction

Une représentation hiérarchique est généralement une bonne solution pour des projets dépassant quelques feuilles. Si vous voulez gérer ce type de projet, il vous faudra :

  • Utiliser de grande feuilles, ce qui pourrait conduire à des problèmes d’impression ou de manipulation.

  • Utiliser plusieurs feuilles, ce qui vous amène à une structure hiérarchique.

La schématique complète consiste alors en une feuille principale, appelée feuille racine, et des sous-feuilles constituant la hiérarchie. En outre, une habile subdivision du schéma en plusieurs feuilles augmentera souvent sa lisibilité.

À partir de la feuille racine, vous pouvez accéder à toutes les sous-feuilles. La gestion d’une schématique hiérarchique est très facile avec Eeschema, grâce à son "Navigateur de Hiérarchie" accessible par l’icône icons/hierarchy_nav_png de la barre d’outils supérieure.

Deux sortes de hiérarchies peuvent cohabiter : la première est celle qui vient d’être évoquée, et qui est d’usage courant. La seconde consiste en la création de composants en librairie qui ressemblent à des composants ordinaires, mais qui correspondent en fait à un schéma décrivant leur structure interne.

Le second type est utilisé pour concevoir des circuits intégrés, car dans ce cas vous devez utiliser des librairies de fonctions dans le schéma que vous êtes en train de dessiner.

Eeschema ne gère pas pour l’instant ce deuxième type.

Une hiérarchie peut être :

  • simple : une feuille donnée n’est utilisée qu’une seule fois.

  • complexe : une feuille donnée sera utilisée plusieurs fois (instances multiples).

  • à plat : c’est un hiérarchie simple, mais les liaisons entre feuilles ne sont pas dessinées.

Eeschema est capable de gérer ces différentes hiérarchies.

La création d’une schématique hiérarchique est facile, la hiérarchie étant manipulée à partir de la feuille racine, comme si vous n’aviez qu’un seul schéma.

Les deux étapes importantes à comprendre sont :

  • Comment créer une sous-feuille.

  • Comment établir des connexions électriques entre les sous-feuilles.

La navigation parmi les sous-feuilles est très facile, grâce à l’outil de navigation accessible par le bouton icons/hierarchy_nav_png de la barre d’outils supérieure.

hierarchy_navigator_dialog_png

On peut atteindre chaque feuille en double-cliquant sur son nom. Vous pouvez aussi entrer rapidement dans une feuille, depuis sa feuille parente, en faisant un clic droit dessus, puis 'Entrer dans feuille'.

Vous pouvez accéder rapidement à la feuille racine, ou à une des sous-feuilles grâce à l’outil icons/hierarchy_cursor_png de la barre latérale droite. Après que cet outil ait été sélectionné :

  • Cliquez sur un nom de feuille pour la sélectionner.

  • Cliquez ailleurs sur la feuille pour afficher la feuille racine, ou pour remonter dans la hiérarchie.

Labels locaux, hiérarchiques et globaux

Propriétés

Les labels locaux, outil icons/add_line_label_png, relient des signaux uniquement à l’intérieur de la même feuille. Les labels hiérarchiques, outil icons/add_hierarchical_label_png, relient des signaux uniquement à l’intérieur d’une feuille ou à une pin hiérarchique de sa feuille parente.

Les labels globaux, outil Global label icon, relient des signaux à travers toute la hiérarchie. Les pins d’alimentation (de type power in et power out) invisibles sont similaires aux labels globaux car elles sont reliées à travers toute la hiérarchie.

À l’intérieur d’une hiérarchie, on peut utiliser à la fois des labels globaux ou hiérarchiques.

Étapes de la création hiérarchique

Vous devez :

  • Placer dans la feuille racine un symbole appelé "Feuille hiérarchique".

  • Accéder à cette nouvelle feuille schématique (sous-feuille) par le navigateur, et la dessiner, comme n’importe quel schéma.

  • Établir les connexions électriques entre les deux feuilles de schéma en plaçant des Labels Globaux (HLabels) dans la nouvelle sous-feuille et des labels portant le même nom dans la feuille racine, appelées 'Labels de Feuille' (SheetLabels). Ces SheetLabels seront connectées au symbole de feuille, de la feuille racine aux autres éléments du schéma comme des pins ordinaires de composants.

Symbole de feuille hiérarchique

Tracez un rectangle symbolisant la sous-feuille, en plaçant deux points sur une diagonale.

La taille de ce rectangle vous permettra d’ajouter plus tard des labels particuliers, des pins de hiérarchie, correspondant aux labels globaux (Hlabels) de la sous-feuille.

Ces labels sont vues comme des pins ordinaires de composants. Utilisez l’outil icons/add_hierarchical_subsheet_png.

Cliquez pour placer le coin supérieur gauche du rectangle. Cliquez à nouveau pour positionner le coin inférieur droit, afin d’avoir un rectangle suffisamment grand.

On vous demandera alors de donner un nom de fichier et un nom de feuille pour cette sous-feuille, pour vous permettre de l’atteindre par le navigateur de hiérarchie.

hsheet_properties_1_png

Vous devez au moins spécifier un nom de fichier. En l’absence de nom de feuille, c’est le nom de fichier qui sera utilisé comme nom de feuille (c’est la méthode habituelle).

Connexions - Pins hiérarchiques

Vous allez maintenant créer des points de connexion (pins hiérarchiques) pour le symbole de feuille qui vient d’être créé.

Ces pins hiérarchiques sont similaires à des pins ordinaires de composants, avec toutefois la possibilité de raccorder un bus entier sur un seul point de connexion.

Il y a deux méthodes possibles :

  • Placer les différentes pins avant le dessin de la sous-feuille (placement manuel).

  • Placer les différentes pins après le dessin de la sous-feuille et des labels globaux (placement semi-automatique).

Cette deuxième méthode largement préférable.

Placement manuel

  • Choisissez l’outil icons/add_hierar_pin_png.

  • Cliquez sur le symbole de feuille hiérarchique où vous voulez placer cette pin.

Ci-dessous, un exemple de création de pin hiérarchique appelée "CONNECTION".

eeschema_hierarchical_label_png

Vous pouvez dès maintenant définir ses attributs graphiques, sa dimension, ou ultérieurement, en l’éditant (clic droit et choisir Éditer dans le menu contextuel).

Différentes formes de pins s’offrent à vous :

  • Entrée

  • Sortie

  • Bidirectionnel

  • Trois-états

  • Passive

Ces formes de symboles de pins ne sont que des améliorations graphiques et elles n’ont pas d’autre rôle.

Placement automatique :

  • Sélectionnez l’outil icons/import_hierarchical_label_png.

  • Cliquez sur le symbole de feuille hiérarchique dans lequel vous voulez importer des pins hiérarchiques correspondant aux labels hiérarchiques placés dans la feuille correspondante. Une pin hiérarchique apparaît si un label hiérarchique existe et qu’il ne correspond pas à une pin déjà placée.

  • Cliquez où vous souhaiter placer la pin.

Les pins nécessaires peuvent ainsi être placées rapidement et sans erreur. Leur aspect correspond à celui de leur label hiérarchique.

Connexions - Labels hiérarchiques

À chaque pin de la feuille symbolique venant d’être créée doit correspondre un label appelé label hiérarchique dans la sous-feuille. Les labels hiérarchiques sont similaires aux labels ordinaires, mais ils permettent des connexions entre les sous-feuilles et la feuille de racine. La représentation graphique de ces deux éléments complémentaires (pin et label hiérarchiques) est identique. La création de labels hiérarchiques se fait à l’aide de l’outil : icons/add_hierarchical_label_png.

Ci-dessous un exemple de feuille racine :

hierarchical_label_root_png

Remarquez la pin hiérarchique VCC-PIC, reliée au connecteur JP1.

Voici les connexions correspondantes dans la sous-feuille :

hierarchical_label_sub_png

Nous retrouvons les deux labels hiérarchiques correspondants, qui établissent la connexion entre les deux feuilles hiérarchiques.

Vous pouvez utiliser des pins et des labels hiérarchiques pour relier deux bus, en utilisant la syntaxe décrite précédemment (Bus [N..m]).

Labels, labels hiérarchiques, labels globaux et pins d’alimentation invisibles

Quelques remarques sur les différentes façons d’établir des connexions autrement qu’avec des fils.

Labels simples

Les labels simples n’ont qu’une portée locale de connexion, limitée à la feuille de schéma dans laquelle ils sont placés. Ceci est du au fait que :

  • Chaque feuille a un numéro de feuille.

  • Ce numéro de feuille est associé à l’étiquette.

Ainsi, quand vous placez un label "TOTO" dans la feuille n°3, le vrai nom de ce label est "TOTO_3". Si vous avez aussi un label "TOTO" dans la feuille n°1 (feuille racine), c’est en fait un label "TOTO_1" différent de "TOTO_3". Ceci est toujours vrai, même si vous n’avez qu’une seule feuille.

Labels hiérarchiques

Ce que nous avons dit pour les labels simple est vrai aussi pour les labels hiérarchiques.

Ainsi, dans la même feuille, un label hiérarchique "TOTO" est considéré comme connecté à un autre label "TOTO", mais n’est pas connecté à un label "TOTO" dans une autre feuille.

Toutefois, un label hiérarchique sera connecté au symbole de pin hiérarchique correspondant dans la feuille racine.

Pins d’alimentations invisibles

Nous avons vu que les pins d’alimentation invisibles sont connectées ensemble si elles portent le même nom. Ainsi toutes les pins déclarées "pins d’alimentation invisibles" et nommées VCC sont reliées et forment l’équipotentiel VCC, quelle que soit la feuille dans laquelle elles sont placées.

En revanche, si vous placez un label VCC dans une sous-feuille, il ne sera pas relié aux pins VCC, parce que ce label est en fait VCC_n, où n est le numéro de la feuille.

Si vous voulez que ce label VCC soit réellement connecté à l’équipotentiel VCC, il devra avoir été explicitement connecté à une pin invisible grâce à un port d’alimentation VCC.

Labels globaux

Les labels globaux qui portent le même nom sont connectés à travers toute la hiérarchie.

(les labels d’alimentation comme vcc …​ sont des labels globaux)

Hiérarchie complexe

Voici un exemple. La même schématique est utilisée deux fois (deux instances). Les deux feuilles partagent le même schéma parce que le nom de fichier est le même pour les deux feuilles (``other_sheet.sch''). Mais leurs noms de feuilles doivent être différents.

eeschema_complex_hierarchy_png

Hiérarchie à plat

Vous pouvez créer un projet utilisant plusieurs feuilles, sans créer aucune connexion entre ces feuilles (hiérarchie à plat) si les règles suivantes son respectées :

  • Vous devez créer une feuille racine, contenant les autres feuilles, qui sera le lien entre les feuilles.

  • Aucune connexion explicite n’est nécessaire.

  • Les connexions entre feuilles utiliseront des label globaux au lieu de label hiérarchiques.

Voici un exemple de feuille racine :

eeschema_flat_hierarchy_png

Voici les deux feuilles, connectées par des labels globaux.

Voici la feuille pic_programmer.sch.

eeschema_flat_hierarchy_1_png

Voici la feuille pic_sockets.sch.

eeschema_flat_hierarchy_2_png

Regardez les labels globaux.

eeschema_flat_hierarchy_3_png

Annotation automatique des composants

Introduction

L’outil d’annotation automatique permet d’affecter automatiquement une référence aux composants du schéma. Pour les boitiers multi-unités, il affecte un suffixe de multi-unité pour réduire le nombre de ces boitiers. L’outil d’annotation automatique est accessible par l’icone icons_annotate_png. qui se trouve sur la fenêtre principale.

annotate-dialog_img

Plusieurs choix s’offrent à vous :

  • Réaffecter toutes les références, même celles existantes (Supprimer l’annotation existante).

  • Réaffecter toutes les références, sauf pour les boitiers multi-unités déjà annotés (Reset, mais ne pas échanger les unités déjà numérotées des boitiers multi-unités).

  • Annoter seulement les nouveaux composants (ceux dont la référence finit par ? comme IC? (Garder l’annotation existante).

  • Annoter toute la hiérarchie (Utiliser la schématique entière).

  • Annoter seulement le schéma en cours (Utiliser la feuille active uniquement).

L’option ``Reset, mais ne pas échanger les unités déjà numérotées des boitiers multi-unités'' conserve toutes les associations existantes entre les boitiers multi-unités. En pratique, si vous avez U2A et U2B, ils pourront être réannotés respectivement U1A et U1B, mais ne seront jamais réannotés U1A et U2A, ni U2B et U2A. Utile si on veut s’assurer que les regroupements de pins soient conservés, dans le cas où vous avez déjà décidé à quel endroit sera le mieux placée telle unité.

Le choix de l’ordre de l’annotation fixe la méthode utilisée pour affecter les numéros de référence sur chaque feuille de la hiérarchie.

Sauf exception, l’annotation automatique s’applique au projet entier (toutes les feuilles) et aux nouveaux composants, si on ne veut pas modifier les annotations précédentes.

Le choix de l’annotation fixe la méthode utilisée pour calculer le numéro de la référence :

  • Utiliser le premier nombre libre de la schématique : les composants seront annotés à partir de 1 (pour chaque préfixe de référence). S’il existe une précédente annotation, les nombres non encore utilisés seront pris.

  • Démarrer à numéro de feuille *100 et utiliser le premier nombre libre : l’annotation commence par 101 sur la feuille numéro 1, par 201 sur la feuille numéro 2, etc…​ S’il y a plus de 99 éléments avec le même préfixe de référence (U, R) sur la feuille 1, l’outil d’annotation utilisera le numéro 200 et suivants, et l’annotation de la feuille 2 commencera au prochain numéro libre.

  • Démarrer à numéro de feuille *1000 et utiliser le premier nombre libre : l’annotation commence par 1001 sur la feuille numéro 1, par 2001 sur la feuille numéro 2, etc…​

Quelques exemples

Ordre d’annotation

Cet exemple montre 5 composants, non encore annotés.

eeschema_annotation_order_none_png

Après l’exécution de l’annotation automatique, on obtient le résultat suivant.

Composants triés par position X.

eeschema_annotation_order_x_png

Composants triés par position Y.

eeschema_annotation_order_y_png

Vous pouvez voir que quatre portes 74LS00 ont été réparties dans le boitier U1, et que la cinquième porte 74LS00 a été assignée au suivant, U2.

Choix de l’annotation

Voici une annotation de la feuille 2 avec l’option 'Utiliser le premier nombre libre de la schématique'.

eeschema_annotation_choice_free_png

L’option 'Démarrer à numéro de feuille *100 et utiliser le premier nombre libre' donne le résultat suivant.

eeschema_annotation_choice_x100_png

L’option 'Démarrer à numéro de feuille *1000 et utiliser le premier nombre libre' donne le résultat suivant.

eeschema_annotation_choice_x1000_png

Vérification des règles électriques (ERC)

Introduction

L’outil de vérification des règles électriques, ou ERC (Electrical Rules Check), vérifie automatiquement votre schéma. Il détecte les erreurs dans la feuille, comme les pins ou les symboles hiérarchiques non connectés, les sorties en court-circuit, etc…​ Bien entendu une vérification automatique n’est pas infaillible, et le logiciel qui la réalise n’est pas encore terminé à 100%. Malgré tout, cette vérification est très utile, car elle détecte beaucoup d’omissions et de petites erreurs.

Dans un processus normal, toutes les erreurs détectées devront être vérifiées et corrigées avant de continuer. La qualité de l’ERC est directement liée au soin pris dans la déclaration des propriétés des pins électriques, lors de la création des composants de la librairie. L’ERC produit en sortie des "erreurs" ou des "avertissements".

La fenêtre de l’ERC.

Utilisation de l’ERC

L’ERC est lancé par l’icône Icône ERC.

Des avertissements, sous forme de petites flèches de marquage, seront placés sur les éléments schématiques générant une erreur ERC (pins ou labels).

  • Dans cette boite de dialogue, en cliquant sur un message d’erreur, vous allez au marqueur d’erreur correspondant dans le schéma.

  • Dans le schéma, faites un clic droit sur un marqueur pour accéder au message de diagnostic correspondant.

Vous pouvez également supprimer des marqueurs d’erreur dans la boîte de dialogue.

Exemple d’ERC

Marqueurs d’ERC

Ici, vous pouvez voir quatre erreurs :

  • Deux sorties logiques ont été reliées ensemble (flèche rouge).

  • Deux entrées ne sont pas connectées (flèches vertes du bas).

  • Une erreur sur une source d’alimentation invisible, dont il manque le symbole d’alimentation (flèche verte du haut).

Affichage du diagnostic

Un clic droit sur un marqueur vous affiche le menu contextuel permettant d’accéder à la fenêtre d’informations de diagnostic de l’ERC.

Infos des marqueurs de L’ERC

et en cliquant sur un marqueur, vous obtenez une description de l’erreur.

erc_pointers_message_png

Pins d’alimentation et symboles d’alimentation (Power Flag)

Il est fréquent d’avoir une erreur ou un avertissement sur les pins d’alimentation, même si tout semble normal. Voir l’exemple ci-dessus. Cela arrive parce que, dans la plupart des dessins, l’alimentation est fournie par des connecteurs qui ne sont pas identifiés comme des sources d’énergie (au contraire d’une sortie de régulateur qui, elle, est déclarée en tant que sortie d’alimentation).

Ainsi l’ERC ne détectera pas une pin de sortie d’alimentation pour ce fil et le déclarera non-connecté à une source d’alimentation.

Pour éviter ceci, il faut placer un symbole d’alimentation, "PWR_FLAG", sur ce connecteur d’alim. Comme dans l’exemple suivant :

eeschema_power_pins_and_flags_png

Et ainsi le marqueur disparaît.

La plupart du temps, un PWR_FLAG devra aussi être relié à la masse, car si la sortie des régulateurs de tensions est déclarée comme source d’alimentation, les pins de masse ne le sont pas (leur attribut normal est entrée d’alimentation). Et donc, les masses ne seront pas considérées comme connectées à une source d’alimentation en l’absence d’un PWR_FLAG.

Configuration

Le panneau des Options vous permet de configurer les règles de connexion définissant les conditions électriques de la vérification des erreurs et des avertissements.

eeschema_erc_options_png

Les règles sont modifiées en cliquant plusieurs fois sur le bouton carré dans le tableau pour faire défiler les différents choix : normal [vert], avertissement [W jaune], erreur [E rouge].

Fichier de rapport d’ERC

Un rapport d’ERC peut être produit et sauvegardé en cochant la case "Créer fichier rapport ERC". L’extension pour ces fichiers est .erc. Voici un exemple de rapport d’ERC :

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

Création d’une Netliste

Généralités

Une Netliste est un fichier qui décrit les connexions électriques entre les composants. Dans un fichier Netlist vous trouverez :

  • La liste des composants.

  • La liste des connexions entre composants, appelées aussi équipotentielles.

Différents formats de netlistes existent. Parfois, la liste des composants et des équipotentielles sont deux fichiers séparés. Cette netliste est fondamentale dans l’utilisation des logiciels de saisie de schémas, car cette liste est le lien avec les autres logiciels de CAO électronique, comme :

  • Les logiciels de dessin de circuit imprimés.

  • Les simulateurs de schémas et de circuits imprimés.

  • les compilateurs de CPLD (et autres circuits intégrés programmables).

Eeschema gère plusieurs formats de netlistes.

  • Le format PCBNEW (circuits imprimés).

  • Le format ORCAD PCB2 (circuits imprimés).

  • Le format CADSTAR (circuits imprimés).

  • Le format SPICE, utilisé par différents simulateurs.

Formats de Netliste

Cliquez sur l’outil Netlist icon pour ouvrir la boite de dialogue de création de Netliste.

Onglet Pcbnew :

eeschema_netlist_dialog_pcbnew_png

Onglet Spice :

eeschema_netlist_dialog_spice_png

Au moyen des différents onglets, vous pouvez choisir le format désiré. Dans le format Pspice, vous pouvez générer des netlistes avec soit des noms d’équipotentielles (c’est plus lisible), soit des numéros de net (les anciennes versions de Spice n’acceptent que les chiffres). En cliquant sur le bouton "Générer", vous serez invité à donner un nom de fichier à votre netliste.

Dans les gros projets, la génération de la netliste peut prendre quelques minutes.

Exemples de netlistes

Vous pouvez voir ci-dessous un schéma

eeschema_netlist_schematic_png

Exemple d’une netliste pour PcbNew :

# 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

La même netliste, en format PSPICE :

* 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

Notes sur les netlistes

Précautions pour les noms de netlistes

Beaucoup de logiciels qui utilisent des netlistes n’acceptent pas les espaces dans les noms de composants, de pins, d’équipotentielles ou autres. Évitez donc systématiquement les espaces dans les labels, les noms, les champs de composants et leurs pins.

De la même manière, les caractères spéciaux autres que les lettres et les chiffres peuvent poser problème. Notez que cette limitation n’est pas propre à Eeschema, mais aux formats de netlistes qui pourraient s’avérer intraduisibles pour les logiciels qui les utilisent.

Netlistes PSPICE

Pour le simulateur PSPICE, vous devez inclure certaines commandes dans la netliste elle-même (.PROBE, .AC, etc..).

Chaque ligne de texte incluse dans le schéma et débutant par les mots-clefs -pspice ou -gnucap sera insérée (sans le mot-clef) au début de la netliste.

Chaque ligne de texte incluse dans le schéma et débutant par les mots-clefs +pspice ou +gnucap sera insérée (sans le mot-clef) à la fin de la netliste.

Voici un exemple utilisant plusieurs lignes de texte et un autre utilisant un texte multi-lignes :

eeschema_pspice_netlist_png

Par exemple, si vous tapez le texte suivant (n’utilisez pas un label !) :

-PSPICE .PROBE

une ligne .PROBE sera insérée en début de netliste.

Dans l’exemple précédent, avec cette méthode, trois lignes étaient insérées au début de la netliste et deux à la fin.

Si vous utilisez un texte multi-lignes, les mots-clefs +pspice ou +gnucap ne sont nécessaires qu’une seule fois :

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

crée les quatre lignes :

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

Notez aussi que l’équipotentielle GND doit être nommée 0 (zéro) pour Pspice.

Autres formats

Pour d’autres formats de netlistes, vous pouvez ajouter des convertisseurs de netlistes sous forme de plugins. Ces convertisseurs seront lancés automatiquement par Eeshema. Le chapitre 14 donne des explications et quelques exemples de convertisseurs.

Un convertisseur est un fichier texte (format XSL), mais on peut utiliser d’autres langages, comme Python. Lorsque vous utilisez le format XSL, un outil (xsltproc.exe ou xsltproc) lit le fichier intermédiaire créé par Eeschema et le fichier de conversion pour créer le fichier de sortie. Dans ce cas, le fichier de conversion (une feuille de style) est très petit et très facile à écrire.

Ajout dans la boite de dialogue

Vous pouvez ajouter un nouveau plugin par le bouton "Ajouter Plugin".

eeschema_netlist_dialog_add_plugin_png

Voici la fenêtre de configuration pour un plugin PadsPcb :

eeschema_netlist_dialog_padspcb_png

La configuration demande :

  • Un titre pour l’onglet (comme le nom du format de Netliste).

  • La ligne de commande du plugin à lancer.

Quand la liste est créée :

  1. Eeschema crée un fichier temporaire intermédiaire .tmp, par exemple test.tmp.

  2. Eeschema lance le plugin, qui lit ce test.tmp et crée la netliste test.net.

Format de la ligne de commande

Voici un exemple de ligne de commande utilisant xsltproc.exe comme outil de conversion de fichiers .xsl et un fichier netlist_form_pads-pcb.xsl qui sert de feuille de style :

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

avec :

f:/kicad/bin/xsltproc.exe A tool to read and convert xsl file

-o %O.net

Output file: %O will define the output file.

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

File name converter (a sheet style, xsl format).

%I

Will be replaced by the intermediate file created by Eeschema (*.tmp).

Pour un schéma nommé test.sch, la ligne de commande réelle qui en résulterait :

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

Convertisseur et feuille de style

C’est un logiciel très simple, parce que son rôle est seulement de convertir un fichier texte d’entrée (le fichier intermédiaire) en un autre fichier texte. À partir du fichier intermédiaire, vous pouvez, en outre, créer une liste des composants (BOM).

Lors de l’utilisation de xsltproc comme convertisseur, seul le contenu décrit dans la feuille de style sera généré.

Format du fichier intermédiaire de Netliste

Voir le chapitre 14 pour plus d’explications au sujet de xsltproc, du fichier intermédiaire, et des exemples de feuilles de style pour le convertisseur.

Tracer / Imprimer

Introduction

Les commandes 'Imprimer' et 'Tracer' sont accessibles par le menu 'Fichiers'.

eeschema_file_menu_plot_png

Les formats de sortie peuvent être : Postscript, PDF, SVG, DXF ou HPGL. Vous pouvez aussi imprimer directement sur votre imprimante.

Commandes de tracé communes

Tracer Page Courante

génère un fichier pour la feuille courante seulement.

Tracer Toutes les Pages

vous permet de tracer toute la hiérarchie (un fichier est généré pour chaque feuille).

Tracer en Postscript

Cette commande vous permet de générer des fichiers au format PostScript.

eeschema_plot_postscript_png

Le nom du fichier généré est le nom de la feuille avec l’extension .ps. Vous pouvez désactiver l’option "Tracer cartouche et encadrement". Ceci est utile quand vous voulez créer un fichier PostScript pour l’encapsulation (format .eps), utilisé pour insérer une figure dans un logiciel de traitement de texte. La fenêtre de message affiche le chemin et le nom des fichiers créés.

Tracer en PDF

eeschema_plot_pdf.png

Vous permet de générer un tracé au format PDF. Le nom du fichier généré est le nom de la feuille avec l’extension .pdf.

Tracer en SVG

eeschema_plot_svg_png

Vous permet de générer un tracé au format vectoriel SVG. Le nom du fichier généré est le nom de la feuille avec l’extension .svg.

Tracer en DXF

eeschema_plot_dxf_png

Vous permet de générer un tracé au format DXF. Le nom du fichier généré est le nom de la feuille avec l’extension .dxf.

Tracer en HPGL

Vous permet de générer un tracé au format HPGL. Pour ce format, vous pouvez définir :

  • La taille de page.

  • L’origine.

  • La taille du pinceau (en mm).

La fenêtre de configuration du tracé ressemble à ceci :

eeschema_plot_hpgl_png

Le nom du fichier généré sera le nom de la feuille avec l’extension .plt.

Sélection de la taille de la feuille schématique

La case 'Taille Shématique' est normalement cochée. Dans ce cas, la taille de la feuille définie dans les options de la page sera utilisée, et l’échelle choisie sera de 1. Si une autre taille de feuille est sélectionnée (de A4 à A0, de A à E, etc..), l’échelle sera automatiquement ajustée pour remplir la page.

Ajustement des décalages

Pour toutes les dimensions standards, vous pouvez ajuster les décalages pour centrer le dessin aussi précisément que possible. Certains traceurs ayant un point d’origine au centre, et d’autres au coin inférieur droit, il est nécessaire de pouvoir introduire un décalage pour tracer correctement.

Généralement :

  • Pour des traceurs ayant leur point d’origine au centre de la feuille, le décalage doit être négatif et fixé à la moitié de la dimension de la feuille.

  • Pour des traceurs ayant leur point d’origine dans le coin inférieur gauche de la feuille, le décalage doit être réglé à 0.

Pour fixer un décalage :

  • Sélectionnez la taille de la feuille.

  • Fixez les décalages X et Y.

  • Cliquez sur accepter les décalages.

Cette commande, accessible par l’icône icons/print_button_png, vous permet de visualiser et de générer les fichiers pour une imprimante standard.

print_dialog_png

L’option "Imprimer cartouche" active ou désactive l’impression du cartouche.

L’option "Imprimer en noir et blanc seulement" force l’impression en monochrome. Cette option est généralement nécessaire si vous avez une imprimante laser noir et blanc, parce que les couleurs, imprimées en demi-tons, ne sont souvent pas très lisibles.

L’Éditeur de Composants

Informations générales à propos des librairies

Un symbole de composant est un élément qui contient une représentation graphique, des connexions électriques, et des champs définissant le composant lui-même. Les composants utilisés dans un schéma sont stockés dans des bibliothèques (ou librairies) de composants. Eeschema contient un éditeur qui vous permet de créer des librairies, d’ajouter, supprimer ou transférer des composants entre les librairies, d’exporter des composants vers des fichiers ou d’importer des composants depuis des fichiers. Bref, cet éditeur vous fournit un moyen simple de gérer vos fichiers de librairies de composants.

Vue d’ensemble des librairies de composants

Une librairie de composants contient un ou plusieurs composants. En général, les composants y sont regroupés par fonction, type, ou fabricant.

Un composant contient :

  • Des éléments graphiques (lignes, cercles, arcs, textes, etc…​), qui fournissent la définition du symbole.

  • Des broches (pins), qui ont à la fois des propriétés graphiques (ligne, horloge, inversée, active à l’état bas, etc..), et des propriétés électriques (entrée, sortie, bidirectionnelle, etc..), qui sont utilisées par l’outil de vérification des règles électriques (ERC).

  • Des champs : référence, valeur, empreintes correspondantes pour le dessin du circuit imprimé, etc…​

  • Des alias, utilisés pour associer un composant générique à ses variantes, comme 74LS00, 74HC00, 7437 pour le 7400. Ces alias partagent tous le même symbole en librairie.

Le dessin d’un composant nécessite :

  • De définir s’il est composé d’une ou de plusieurs unités.

  • De définir si le composant a une autre représentation graphique, aussi appelée représentation De Morgan.

  • De dessiner sa représentation symbolique, au moyen de lignes, rectangles, cercles, polygones, et de texte.

  • D’ajouter des pins, en définissant leurs éléments graphiques, leurs noms, leurs numéros et leurs propriétés électriques (entrées, sorties, trois-états, alimentations, etc..).

  • D’ajouter des alias, au cas où d’autres composants utiliseraient le même symbole, ou le même brochage. Ou d’en enlever, si le composant a été créé à partir d’un autre composant.

  • D’ajouter des champs supplémentaires, comme le nom de l’empreinte utilisée par le logiciel de dessin du circuit imprimé, et de définir leur visibilité.

  • De documenter le composant, en ajoutant une description, des liens éventuels vers des datasheets, etc…​

  • De le sauvegarder dans la librairie désirée.

Interface de l’éditeur de librairies

Ci-dessous, la fenêtre principale de l’éditeur de composants. Elle comporte 3 barres d’outils, pour accéder aux fonctions principales, et la zone d’affichage et d’édition du composant. Les quelques commandes qui ne sont pas disponibles dans les barres d’outils sont accessibles par les menus.

libedit_main_window_png

Barre d’outils principale

Ci-dessous, la barre d’outils principale, située en haut de la fenêtre. Elle contient les outils de gestion des librairies, les boutons 'Défaire' 'Refaire', les commandes de Zoom, et les outils d’édition des propriétés du composant.

images/toolbar_libedit.png

icons/save_library_png

Save the currently selected library. The button will be disabled if no library is currently selected or no changes to the currently selected library have been made.

icons/library_png

Select the library to edit.

icons/delete_png

Delete a component from the currently selected library or any library defined by the project if no library is currently selected.

icons/library_browse_png

Open the component library browser to select the library and component to edit.

icons/new_component_png

Create a new component.

icons/import_cmp_from_lib_png

Load component from currently selected library for editing.

icons/copycomponent_png

Create a new component from the currently loaded component.

icons/save_part_in_mem_png

Save the current component changes in memory. The library file is not changed.

icons/import_png

Import one component from a file.

icons/export_png

Export the current component to a file.

icons/new_library_png

Create a new library file containing the current component. Note: new libraries are not automatically added to the project.

icons/undo_png

Undo last edit.

icons/redo_png

Redo last undo.

icons/part_properties_png

Edit the current component properties.

icons/add_text_png

Edit the fields of current component.

icons/erc_png

Test the current component for design errors.

zoom in

Zoom in.

zoom out

Zoom out.

zoom redraw

Refresh display.

zoom fit in page

Zoom to fit component in display.

icons/morgan1_png

Select the normal body style. The button is disabled if the current component does not have an alternate body style.

icons/morgan2_png

Select the alternate body style. The button is disabled if the current component does not have an alternate body style.

icons/datasheet_png

Show the associated documentation. The button will be disabled if no documentation is defined for the current component.

images/toolbar_libedit_part.png

Select the unit to display. The drop down control will be disabled if the current component is not derived from multiple units.

images/toolbar_libedit_part.png

Select the alias. The drop down control will be disabled if the current component does not have any aliases.

icons/pin2pin_png

Pin editing: independent editing for pin shape and position for components with multiple units and alternate symbols.

icons/pin_table_png

Show pin table.

Barre d’outils des éléments

La barre d’outils verticale située à droite de la fenêtre vous permet d’ajouter les éléments nécessaires au dessin d’un composant. La table ci-dessous décrit les fonctions des différents boutons :

icons/cursor_png

Select tool. Right-clicking with the select tool opens the context menu for the object under the cursor. Left-clicking with the select tool displays the attributes of the object under the cursor in the message panel at the bottom of the main window. Double-left-clicking with the select tool will open the properties dialog for the object under the cursor.

icons/pin_png

Pin tool. Left-click to add a new pin.

icons/add_text_png

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

icons/add_rectangle_png

Rectangle tool. Left-click to begin drawing the first corner of a graphical rectangle. Left-click again to place the opposite corner of the rectangle.

icons/add_circle_png

Circle tool. Left-click to begin drawing a new graphical circle from the center. Left-click again to define the radius of the cicle.

icons/add_arc_png

Arc tool. Left-click to begin drawing a new graphical arc item from the center. Left-click again to define the first arc end point. Left-click again to define the second arc end point.

icons/add_polygon_png

Polygon tool. Left-click to begin drawing a new graphical polygon item in the current component. Left-click for each addition polygon line. Double-left-click to complete the polygon.

icons/anchor_png

Anchor tool. Left-click to set the anchor position of the component.

icons/import_png

Import a component from a file.

icons/export_png

Export the current component to a file.

icons/delete_png

Delete tool. Left-click to delete an object from the current component.

Barre d’outils des options

La barre d’outil verticale située à gauche de la fenêtre vous permet de régler quelques options de dessin. La table ci-dessous décrit les fonctions des différents boutons :

icons/grid_png

Toggle grid visibility on and off.

icons/unit_inch_png

Set units to inches.

icons/unit_mm_png

Set units to millimeters.

icons/cursor_shape_png

Toggle full screen cursor on and off.

Sélection et gestion des librairies

On accède à la boite de dialogue de sélection de la librairie courante au moyen du bouton icons/library_png qui montre les librairies disponibles et permet leur sélection. Une fois sélectionnée, le nom de la librairie courante s’affiche dans la barre de titre de la fenêtre de l’éditeur. Quand un composant sera chargé ou enregistré, il le sera depuis ou vers cette librairie. Le nom du composant en librairie est le contenu de son champ 'valeur'.

  • Vous devez charger une librairie dans Eeshema pour accéder à son contenu.

  • Le contenu de la librairie courante peut être sauvegardé après modification en cliquant sur le bouton icons/save_library_png de la barre d’outils principale.

  • Un composant peut être enlevé de n’importe quelle librairie en cliquant sur le bouton icons/delete_png.

Sélectionner et Sauvegarder un Composant

Quand vous éditez un composant, vous ne le modifiez pas directement en librairie, mais dans une copie dans la mémoire de l’ordinateur. Chaque modification peut être annulée facilement. Un composant peut être chargé d’une librairie locale ou depuis un composant existant.

Sélectionner un composant

En cliquant sur l’icône icons/import_cmp_from_lib_png de la barre principale, vous faites apparaître la liste des composants disponibles de la librairie courante sélectionnée que vous pouvez choisir de charger dans l’éditeur.

Si un composant est sélectionné par un de ses alias, ce sera le nom du composant d’origine(ou nom racine) qui sera affiché dans la fenêtre et non celui de l’alias. La liste des alias est toujours chargée en même temps que le composant et peut être modifiée. Vous pouvez créer un nouveau composant en sélectionnant un alias dans le nenu déroulant images/toolbar_libedit_alias.png. Le premier élément de la liste est le nom racine du composant.
Par ailleurs, un clic sur le bouton icons/import_png vous permet de charger un composant précédemment sauvegardé au moyen de l’icône icons/export_png.
Sauvegarder un composant

Après modification, un composant peut être sauvegardé en librairie courante, dans une nouvelle librairie, ou encore exporté vers un fichier de sauvegarde.

Pour enregistrer le composant modifié dans la librairie courante, cliquez sur le bouton icons/save_part_in_mem_png. Notez toutefois que cette mise à jour ne s’effectue que dans la mémoire de l’ordinateur. Vous pouvez ainsi prendre le temps de réfléchir avant de sauvegarder vraiment la librairie.

Pour sauvegarder les modifications du composant de façon permanente dans la librairie, cliquez icons/save_library_png.

Si vous voulez créer une nouvelle librairie contenant le composant courant, cliquez sur icons/new_library_png, et saisissez un nom pour la nouvelle librairie.

Les nouvelles librairies ne sont pas automatiquement ajoutées au projet en cours.

Vous devez ajouter les nouvelles librairies à utiliser dans votre schéma à la liste des librairies du projet, par le menu 'Librairies de Composants' dans 'Préférences'.

Fichiers Librairies de Composants

Cliquez sur le bouton icons/export_png pour créer un fichier contenant seulement le composant courant. Ce fichier est un fichier de librairie standard, mais ne contenant qu’un seul composant. Ce fichier peut être ensuite utilisé pour importer le composant dans une nouvelle librairie. En fait, la commande créer une nouvelle librairie et la commande exporter sont identiques.

Transférer un composant vers une autre librairie

Il est très facile de copier un composant d’une librairie vers une autre en utilisant la méthode suivante :

  • Choisissez la librairie d’origine par le bouton icons/library_png.

  • Chargez le composant à transférer en cliquant sur icons/import_cmp_from_lib_png. Le composant sera affiché dans la zone d’édition.

  • Choisissez la librairie de destination en cliquant à nouveau sur icons/library_png.

  • Enregistrez le composant courant en mémoire en cliquant sur icons/save_part_in_mem_png.

  • Enfin, sauvegardez la librairie courante en cliquant sur icons/save_library_png.

Annuler les modifications d’un composant

Quand vous travaillez sur un composant, le composant en cours d’édition est seulement une copie de travail du composant présent en librairie. Du coup, tant que vous ne l’aurez pas sauvegardé, vous n’avez qu’à recharger ce composant pour annuler les changements. Si vous avez mis à jour ce composant en mémoire et que vous ne l’avez pas sauvegardé dans le fichier de librairie, vous n’avez qu’à quitter l’éditeur et le relancer. Eeshema aura annulé les modifications.

Création de Composants

Créer un nouveau composant

Un nouveau composant peut être créé en cliquant sur icons/new_component_png. Vous serez invité à donner un nom de composant (ce nom sera utilisé comme valeur par défaut pour le champ 'valeur' dans l’éditeur schématique), un préfixe de référence (U, IC, R …​), le nombre d’unités par boitier (par exemple pour un 7400, composé de 4 unités par boitier), et si une représentation alternative (parfois dénommée De Morgan) est souhaitée. Si le champ 'référence' est laissé vide, il sera fixé par défaut à «U». Ces propriétés peuvent être modifiées ultérieurement, mais il est préférable de les définir correctement dès la création du composant.

eeschema_component_properties_png

Un nouveau composant sera créé avec les propriétés ci-dessus et apparaîtra dans l’éditeur comme ceci :

eeschema_libedit_new_png

Créer un composant depuis un autre composant

Souvent, le composant que vous voulez créer est très proche d’un composant existant. Dans ce cas, il est facile de charger et de modifier un composant existant.

  • Chargez le composant qui vous servira de modèle.

  • Cliquez sur icons/copycomponent_png, ou modifiez son nom par clic-droit sur le champ 'valeur' et éditez le texte. Si vous avez choisi de dupliquer le composant courant, vous serez invité à donner un nouveau nom à ce composant.

  • Si le composant modèle a des alias, vous serez invité à supprimer les alias du nouveau composant qui sont en conflit avec la librairie actuelle. Si la réponse est non, la création du nouveau composant sera annulée. Les librairies de composants ne peuvent avoir des noms ou des alias en double.

  • Modifiez le nouveau composant comme vous le souhaitez.

  • Mettez à jour le nouveau composant dans la librairie courante en cliquant sur icons/save_part_in_mem_png, ou enregistrez le dans une nouvelle librairie en cliquant sur icons/new_library_png, ou encore, si vous voulez enregistrer ce nouveau composant dans un autre librairie existante, sélectionnez l’autre librairie en cliquant sur icons/library_png et enregistrez-y le nouveau composant.

  • Sauvez la librairie courante sur le disque en cliquant sur icons/save_library_png.

Propriétés du composant

Les propriétés des composants doivent être soigneusement renseignées lors de leur création, ou alors elles sont héritées du composant copié. Pour modifier les propriétés du composant, cliquez sur icons/part_properties_png pour afficher la boîte de dialogue ci-dessous.

eeschema_properties_for_component_png

Il est très important de fixer correctement le nombre d’unités par boîtier et si le composant a une représentation symbolique alternative, parce que lorsque des pins seront modifiées ou créées, les pins correspondantes pour chaque unité seront créées. Si vous changez le nombre d’unités par boitier après la création et l’édition des pins, il y aura du travail supplémentaire pour ajouter les nouvelles pins et les nouveaux symboles de l’unité. Quoi qu’il en soit, il est possible de modifier ces propriétés à tout moment.

Les options graphiques "Montrer le n° de pin" et "Montrer nom de pin" définissent la visibilité du numéro et du nom de pin. Le texte sera visible si les options correspondantes sont cochées. L’option "Noms des pins à l’intérieur" définit la position du nom de la pin par rapport au corps de la pin. Ce texte sera affiché à l’intérieur du contour du composant si l’option est cochée. Dans ce cas, l’attribut "Offset de Position du Texte de la pin" ajuste le décalage du texte par rapport à l’extrémité côté boîtier de la pin. Une valeur de 30 à 40 (en 1/1000 de pouce) est raisonnable.

L’exemple ci-dessous montre un composant avec l’option "Noms des pins à l’intérieur" décochée. Remarquez la position des noms et des numéros de pin.

eeschema_uncheck_pin_name_inside_png

Composants avec des représentations alternatives

Si votre composant a plus d’une représentation symbolique, vous devrez sélectionner les différents symboles du composant afin de les modifier. Pour éditer le symbole normal, cliquez sur icons/morgan1_png.

Pour éditer le symbole alternatif, cliquez sur icons/morgan2_png. Utilisez le menu déroulant images/toolbar_libedit_part.png montré ci-dessous pour choisir l’unité à modifier.

eeschema_libedit_select_unit_png

Éléments graphiques

Les éléments graphiques forment la représentation symbolique du composant et ne contiennent aucune information de connexion électrique. Leur dessin est possible en utilisant les outils suivants :

  • Lignes et polygones définis par des points d’origine et des points de fin.

  • Rectangles définis par leurs deux coins opposés sur la diagonale.

  • Cercles définis par leur centre et leur rayon.

  • Arcs de cercles définis par leur centre et leurs points de départ et de fin. Un arc peut aller de 0 à 180°.

La barre d’outils latérale droite de la fenêtre principale vous permet de placer tous les éléments graphiques nécessaires à la représentation symbolique d’un composant.

Appartenance des éléments graphiques

Chaque élément graphique, (ligne, arc, cercle, etc…​), peut être défini comme commun à toutes les unités et/ou représentations, ou spécifique à une unité donnée et/ou une représentation. Les options des éléments sont accessibles rapidement par le menu contextuel : clic droit sur l’élément à modifier. Ci-dessous, le menu contextuel pour un élément de type ligne.

eeschema_libedit_context_menu_png

Vous pouvez aussi double-cliquer sur un élément et modifier ses propriétés. Ci-dessous, la fenêtre des propriétés pour un élément de type polygone.

eeschema_libedit_polyline_properties_png

Les propriétés d’un élément graphique sont :

  • La largeur de ligne de l’élément dans l’unité courante.

  • L’option "Commun à toutes les unités du composant" définit si l’élément graphique sera visible dans chaque unité de composant, pour les composants multi-unités, ou si l’élément graphique sera visible uniquement dans l’unité actuelle.

  • L’option "Commun à tous les styles de corps (De Morgan)" définit si l’élément graphique sera visible dans chaque représentation symbolique, pour les composants ayant une représentation alternative, ou si l’élément graphique sera visible uniquement pour la représentation actuelle.

  • Les options de "Style de remplissage" déterminent si le symbole défini par l’élément graphique doit être vide, rempli avec la couleur de premier plan, ou rempli avec la couleur de fond.

Éléments Graphiques Textes

L’outil icons/add_text_png vous permet d’ajouter des éléments graphiques de textes. Le texte est toujours lisible, même quand le composant est renversé (miroir H ou V). Veuillez noter que ces éléments graphiques de textes ne sont pas des champs.

Composants Multi-unités et Représentations Alternatives

Les composants peuvent avoir deux représentations symboliques (un symbole standard et un symbole alternatif souvent dénommé "De Morgan") et/ou avoir plus d’une unité par boîtier (portes logiques par exemple). Certains composants peuvent avoir plusieurs unités par boîtier, et différents symboles et configurations de pins pour chaque unité.

Considérons par exemple un relais avec deux switches qui peuvent être dessinés comme un composant avec trois unités différentes : la bobine, le switch 1 et le switch 2. Concevoir un composant avec plusieurs unités par boitier et/ou une autre représentation est très flexible. Une pin ou un élément graphique peuvent être communs à toutes les unités, ou spécifiques à une unité donnée, et ils peuvent être communs aux deux représentations symboliques ou être spécifiques à une représentation symbolique donnée.

Par défaut, les pins sont spécifiques à chaque représentation symbolique de chaque unité, parce que le numéro de pin est spécifique à une unité, et sa forme dépend de la représentation symbolique. Quand une pin est commune à chaque unité ou chaque représentation symbolique, vous n’avez besoin de la créer qu’une seule fois pour toutes les unités et toutes les représentations symboliques (ce qui est généralement le cas pour les pins d’alimentation). C’est également le cas pour la forme de l’unité et le texte, qui peuvent être communs à chaque unité (mais généralement sont spécifiques à chaque représentation symbolique).

Exemple de composant multi-unités avec différentes représentations symboliques :

Voici l’exemple d’un relais contenant 3 unités, la bobine, le switch 1 et le switch 2 :

Le bouton "Éditer pins unité par unité ou forme par forme" permet d’ajouter ou d’éditer des pins pour chaque unité sans aucun lien avec les pins des autres unités.

eeschema_libedit_pins_per_part_png

l’option "Toutes les unités ne sont pas interchangeables", des propriétés du composant, doit être cochée.

eeschema_libedit_not_interchangeable_png

Unité 1

eeschema_libedit_unit1_png

Unité 2

eeschema_libedit_unit2_png

Unité 3

eeschema_libedit_unit3_png

L’unité 3 n’a pas le même symbole, ni les mêmes pins, et du fait, n’est pas interchangeable avec les unités 1 et 2.

Éléments graphiques symboliques

Ci-dessous, les propriétés d’un élément graphique de symbole. Dans l’exemple du relais ci-dessus, les trois unités ont différentes représentations symboliques. Par conséquent, chaque unité a été créée séparément et les éléments graphiques de chaque unité doivent avoir l’option "Commun à toutes les unités du composant" désactivée.

eeschema_libedit_disable_common_png

Création et édition de pins

Cliquez sur icons/pin_png pour créer et insérer une pin. L’édition de ses propriétés se fait par un double-clic sur la pin ou par un clic droit pour ouvrir son menu contextuel. Les pins doivent être créées avec soin, car toute erreur aura des conséquences sur le dessin du PCB. Toute pin déjà placée peut être modifiée, supprimée, et / ou déplacée.

Généralités sur les pins

Une pin est définie par sa représentation graphique, son nom et son "numéro". Le "numéro" de pin est défini par un ensemble de 4 lettres et / ou chiffres. Pour que l’outil de vérification des règles électriques (ERC) soit utile, le type "électrique" de la pin (entrée, sortie, trois-états, …​) doit être défini avec le plus grand soin. Si ce type n’est pas défini correctement, le résultat de la vérification du schéma peut être invalide.

Notes importantes :

  • N’utilisez pas d’espaces dans les noms et les numéros de pins.

  • Pour définir un nom de pin avec un signal inversé (barre au-dessus), utilisez le caractère “~” (tilde). Le caractère “~” suivant terminera la barre. Par exemple : ~FO~O` affichera FO O.

  • Si le nom d’une pin est réduit à un seul caractère symbolique, la pin est considérée comme non-nommée.

  • Les noms de pins commençant par “#”, sont réservés aux symboles d’alimentations.

  • Un "numéro" de pin contient de 1 à 4 lettres et/ou chiffres. 1,2,..9999 sont valides. A1, B3, Anod, Gnd, Wire, etc…​ sont valides également.

  • Il ne peut y avoir deux "numéros" de pins identiques dans un même composant.

Propriétés des pins

eeschema_libedit_pin_properties_png

La fenêtre des propriétés des pins vous permet de modifier toutes les caractéristiques d’une pin. Cette fenêtre apparaît automatiquement à la création de la pin ou quand vous double-cliquez sur une pin existante. Vous pouvez modifier :

  • Son nom et la dimension de son nom.

  • Son numéro et la dimension de son numéro.

  • Son orientation et sa longueur.

  • Son type électrique et son style graphique.

  • Son appartenance aux unités et aux représentations alternatives.

  • Sa visibilité.

Styles graphiques des pins

Ci-dessous, les différents styles de pins. Le choix du style n’a aucune influence sur le type électrique de la pin.

eeschema_libedit_pin_properties_style_png

Types électriques des pins

Choisir le type électrique correct est important pour l’outil de vérification (ERC). Les types électriques sont :

  • Bidirectionel : pin pouvant être alternativement une entrée ou une sortie (bus de données de microprocesseur, par exemple).

  • Trois-états : type classique d’une sortie trois-états.

  • Passive : utilisé pour les composants passifs, résistances, condensateurs, connecteurs, etc…​

  • Non-Spécifié : sera utilisé quand sa vérification par l’ERC n’est pas importante.

  • Power input : utilisé pour les pins d’alimentations des composants. Les pins d’alimentations sont automatiquement raccordées aux autres pins d’entrées d’alimentations portant le même nom.

  • Power output : utilisé pour les sorties de régulateurs de tension.

  • Collecteur ouvert et Émetteur ouvert : pour les sorties logiques définies comme telles.

  • Non-connecté : pour les pins de composants qui ne sont pas reliées intérieurement.

Propriétés globales des pins

Il est possible de modifier la longueur, les tailles de nom ou de numéro, de toutes les pins d’un seul coup, par les commandes 'Global' du menu contextuel d’une pin. Éditez la nouvelle valeur du paramètre sur une pin, puis utilisez les commandes globales de son menu contextuel pour appliquer le changement aux autres pins.

eeschema_libedit_pin_context_menu_png

Définitions de pins pour unités multiples et représentations alternatives

La création et l’édition de pins peuvent être problématiques pour les composants avec de multiples unités par boîtier ou une représentation symbolique alternative. La plupart des pins sont spécifiques à une unité (parce que leur numéro de pin est spécifique à une unité), ou à une représentation symbolique (parce que leur forme et leur position est spécifique à une représentation symbolique). L’éditeur de librairie de composants permet la création simultanée de pins. Par défaut, les modifications apportées à une pin sont faites pour toutes les unités des composants à unités multiples, et pour les deux représentations des composants ayant une représentation alternative.

La seule exception à ceci concerne son type graphique et son nom. Cette limitation a été faite pour faciliter la création et l’édition de pins dans la plupart des cas. Cette limitation peut être désactivée en basculant l’option icons/pin2pin_png sur la barre d’outils principale. Ceci vous permettra de créer des pins pour chaque unité et chaque représentation de façon complètement indépendante.

Un composant peut avoir une deuxième représentation symbolique (aussi appelée "De Morgan") et peut être composé de plusieurs unités, comme dans le cas des portes logiques. Pour certains composants, vous voudrez peut-être disposer de plusieurs éléments graphiques ou de pins différents. Comme dans l’exemple vu à la section 11.7.1, un relais peut être représenté par trois unités distinctes : une bobine, le switch 1, et le switch 2.

La gestion des composants avec de multiples unités et des composants avec des représentations symboliques alternatives est flexible. Une pin peut être commune à différentes unités ou spécifique à l’une d’elles. Une pin peut également être commune aux deux représentations symboliques ou spécifique à l’une d’elles.

Par défaut, les pins sont spécifiques à chaque représentation de chaque unité, car leur numéro diffère pour chaque unité, et leur dessin est différent pour chaque représentation symbolique. Quand une pin est commune à toutes les unités, comme par exemple dans le cas des pins d’alimentation, elle ne doit être dessinée qu’une fois.

Un exemple est le cas des sorties du 7400 (quadruple porte NON-ET à deux entrées). Comme il comporte quatre unités et deux représentations symboliques, il y a huit pins de sorties distinctes dans la définition du composant. Lors de la création d’un nouveau composant 7400, l’unité A de la représentation symbolique normale sera affichée dans l’éditeur de librairie. Pour modifier le style d’une pin dans la représentation symbolique alternative, il faut d’abord l’activer en cliquant sur le bouton icons/morgan2_png de la barre d’outils. Pour modifier les numéros de pins de chaque unité, sélectionnez l’unité appropriée par le menu déroulant images/toolbar_libedit_alias.png.

Champs du composant

Tous les composants de la librairie possèdent quatre champs par défaut : préfixe de référence, valeur, empreintes associées, lien vers un fichier de documentation, qui sont créés chaque fois qu’un composant est créé ou copié. Seuls le préfixe de référence et la valeur sont indispensables. Pour modifier les champs existants, vous pouvez, par un clic droit, utiliser les commandes du menu contextuel. Les composants présents dans les librairies sont généralement définis avec ces quatre champs par défaut. Des champs supplémentaires, tels que : revendeur, référence revendeur, coût unitaire, etc. peuvent être ajoutés aux composants de la librairie, mais en général cela se fait plutôt dans l’éditeur de schémas de sorte que les champs supplémentaires peuvent être appliqués à tous les composants du schéma.

Édition des champs du composant

Pour éditer un champ existant, un clic droit sur le texte du champ affichera le menu contextuel ci-dessous :

eeschema_libedit_field_context_menu_png

Pour ajouter des champs, éditer des champs non définis, ou supprimer des champs optionnels, cliquez sur l’outil icons/add_text_png de la barre principale pour ouvrir la fenêtre d’édition des propriétés des champs ci-dessous :

eeschema_libedit_field_properties_png

Les champs sont des bouts de texte associés au composant. Ne les confondez pas avec les textes appartenant à la représentation graphique de ce composant.

Notes importantes :

  • La modification du champ valeur crée un nouveau composant utilisant le composant actuel comme point de départ. Ce nouveau composant aura comme nom celui contenu dans le champ valeur lorsque vous l’enregistrerez dans la librairie courante sélectionnée.

  • La boîte de dialogue de saisie de champ, ci-dessus, sera utilisée pour éditer un champ vide, ou qui a l’attribut invisible activé.

  • L’empreinte associée est définie de façon absolue en utilisant le format LIBNAME:FPNAME, où LIBNAME est le nom de la librairie de l’empreinte défini dans la table des librairies d’empreintes (voir la section "Table des librairies d’empreintes" du "Manuel de référence" de Pcbnew), et FPNAME le nom de l’empreinte dans la bibliothèque LIBNAME.

Symboles d’alimentation

Les symboles d’alimentation sont créés de la même manière que les composants normaux. Il peut être utile de les regrouper dans une librairie dédiée, telle la librairie power.lib. Les symboles d’alimentation sont constitués d’un symbole graphique et d’une pin de type "Power invisible". Les symboles d’alimentation sont manipulés comme les autres composants par le logiciel de saisie de schéma. Quelques précautions sont essentielles. Ci-dessous, l’exemple d’un symbole d’alim +5V.

eeschema_libedit_power_symbol_png

Pour créer un symbole d’alimentation, utilisez les étapes suivantes :

  • Ajouter une pin de type "Power Input", avec pour nom +5V (important parce que ce nom va établir la connexion au net +5V), un numéro de pin à 1 (ce numéro n’a aucune importance), une longueur de 0, et comme Style graphique : "ligne".

  • Placez un petit cercle et un segment graphique, de la pin au cercle, comme indiqué.

  • Le point d’ancrage du symbole est sur la pin.

  • La valeur du composant est +5V.

  • La référence du composant est +5V. Le texte de référence n’est pas important, sauf le premier caractère qui doit être , pour indiquer que ce composant est un symbole d’alimentation. Par convention, chaque composant dont la référence commence par # n’apparaîtra pas dans la liste des composants, ni dans la netliste. La référence sera déclarée comme invisible.

Une méthode plus facile pour créer un nouveau symbole d’alimentation est d’utiliser un autre symbole comme modèle :

  • Chargez un symbole d’alimentation.

  • Éditez le nom de la pin du nouveau symbole.

  • Donnez au champ valeur le même nom que la pin, si vous voulez afficher la valeur de l’alimentation.

  • Sauvegardez le nouveau composant.

LibEdit - Compléments

Généralités

Un composant est constitué des éléments suivants :

  • Une représentation graphique (formes géométriques, textes).

  • Des pins.

  • Des champs ou des textes associés utilisés par les post-processeurs : netliste, liste de composants.

Deux champs doivent être initialisés : référence et valeur. Le nom de dessin associé au composant, le nom de l’empreinte associée, et les autres champs sont des champs libres. Ils peuvent généralement rester vides, ou être remplis lors de la saisie du schéma.

Cependant, la gestion de la documentation associée aux composants facilite la recherche, l’utilisation et l’entretien des librairies. La documentation associée se compose de :

  • Une ligne de commentaire.

  • Une ligne de mots-clefs, séparés par des espaces, comme TTL CMOS NAND2.

  • Un nom de fichier attaché (par exemple une note d’application ou un fichier PDF).

    Le répertoire par défaut des fichiers attachés :

    kicad/share/library/doc

    S’il n’existe pas :

    kicad/library/doc

    Sous Linux :

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

    /usr/share/kicad/library/doc

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

Les mots clés permettent de rechercher un composant de manière sélective selon différents critères de sélection. Les commentaires et les mots clés sont affichés dans différents menus, et plus particulièrement lorsque vous sélectionnez un élément de la librairie.

Le composant a également un point d’ancrage. La rotation et le miroir sont faits relativement à ce point d’ancrage, et, pendant un placement, ce point est utilisé comme la position de référence. Il est donc utile de placer cette ancre précisément.

Un élément peut avoir des alias, à savoir des noms équivalents. Cela permet de réduire considérablement le nombre de composants qui doivent être créés (par exemple, un 74LS00 peut avoir des alias tels que 7400, 74HC00, 74HCT00 …​).

Enfin, les composants sont distribués dans des librairies (classés par thèmes, ou par fabricant) afin de faciliter leur gestion.

Placement du point d’ancrage d’un composant

Le point d’ancrage est aux coordonnées (0,0) et est représenté par les axes bleus affichés à l’écran.

eeschema_libedit_anchor_png

Le point d’ancrage peut être repositionné en sélectionnant l’icône icons/anchor_png et en cliquant à la nouvelle position souhaitée du point d’ancrage. Le dessin sera automatiquement recentré sur ce nouveau point d’ancrage.

Alias de composants

Un alias est un autre nom correspondant au même composant dans la librairie. Les composants avec le même brochage et la même représentation peuvent alors être représentés par un seul composant ayant plusieurs alias (par exemple le 7400 avec comme alias 74LS00, 74HC00, 74LS37).

L’utilisation d’alias vous permet de fabriquer rapidement des librairies entières. De plus, ces librairies, étant beaucoup plus compactes, seront plus facilement chargées par KiCad.

Pour modifier la liste des alias, vous devez sélectionner la fenêtre d’édition principale des propriétés par l’icône icons/part_properties.png et sélectionnez l’onglet alias.

eeschema_libedit_alias_png

Vous pouvez ainsi ajouter ou supprimer l’alias désiré. L’alias actuel ne peut évidemment pas être supprimé puisqu’il est en cours d’édition.

Pour supprimer tous les alias, vous devez d’abord sélectionner le composant racine. Le premier composant de la liste des alias, dans la zone de sélection de la barre d’outils principale.

Champs de composants

L’éditeur de champs s’ouvre par l’icône icons/add_text_png de la barre d’outils du haut.

Il y a quatre champs spéciaux (des textes attachés au composant), et des champs utilisateur configurables.

eeschema_library_component_field_png

Champs spéciaux

  • Référence.

  • Valeur. C’est le nom du composant dans la librairie, et le texte par défaut du champ valeur dans le schéma.

  • Empreinte. Le nom d’empreinte qui sera utilisée sur le circuit. Pas très utile si on utilise CvPcb pour associer les empreintes, mais obligatoire si on ne l’utilise pas.

  • Datasheet. C’est un champ réservé, pas actuellement utilisé.

Documentation du composant

Pour modifier les informations de documentation, il est nécessaire d’ouvrir la fenêtre d’édition des propriétés du composant par l’icône icons/part_properties_png, onglet description, et de sélectionner le document.

eeschema_libedit_description_png

Assurez-vous de choisir le bon alias, ou le composant racine, parce que cette documentation peut différer suivant les alias. Le bouton "Copier Doc" vous permet de copier les informations de documentation, du composant racine vers l’alias en cours d’édition.

Mots-clefs du composant

Les mots-clés vous permettent de rechercher un composant de manière sélective, en fonction de critères spécifiques de sélection (fonction, famille technologique, etc…​).

L’outil de recherche de Eeschema est insensible à la casse. Les mots-clés les plus couramment utilisés dans les librairies sont :

  • CMOS TTL pour les familles de composants logiques.

  • AND2 NOR3 XOR2 INV…​ pour les portes (AND2 = porte ET 2 entrées, NOR3 = porte NON-OU 3 entrées).

  • JKFF DFF…​ pour les bascules JK ou D.

  • ADC, DAC, MUX…​

  • OpenCol pour les portes avec sortie à collecteur ouvert. Ainsi, si dans le logiciel de schéma, vous recherchez un composant : par les mots-clefs NAND2 OpenCol, Eeschema affichera la liste des composants possédant ces 2 mots-clés.

Documentation des composants (Doc)

La ligne de commentaires (et les mots-clefs) sont affichés dans divers menus, et spécialement lors de la sélection d’un composant dans la liste des composants d’une librairie, ou dans le visualisateur de librairie.

Si ce fichier Doc. existe, il est aussi accessible depuis le logiciel de saisie, dans le menu contextuel du composant.

Fichier de documentation associé (DocFileName)

Indique la disponibilité d’un fichier attaché (documentation, schéma applicatif), PDF, schéma, etc…​

Filtrage d’empreintes pour CvPcb

Vous pouvez entrer une liste d’empreintes possibles pour le composant. Cette liste agit comme un filtre utilisé par CvPcb pour afficher uniquement les empreintes autorisées. Une liste vide ne filtrera rien.

eeschema_libedit_footprint_png

Les caractères de remplacement sont autorisés.

S014* fera afficher par CvPcb toutes les empreintes avec un nom commençant par SO14.

Pour une résistance, R? montrera les empreintes avec 2 lettres et dont le nom commence par R.

Voici quelques exemples, avec ou sans filtrage :

Avec filtrage

eeschema_cvpcb_with_filtering_png

Sans filtrage

eeschema_cvpcb_without_filtering_png

Librairie de symboles

Vous pouvez facilement compiler un fichier librairie de symboles graphiques, contenant les symboles fréquemment utilisés (triangles, forme des portes ET, OU, OU exclusif, etc…​). Celui-ci sera utilisé pour la création de composants, et enregistré en vue d’une réutilisation ultérieure.

Ces fichiers sont stockés par défaut dans le répertoire de la librairie et ont une extension '.sym'. Les symboles ne sont pas rassemblés en librairies comme les composants, car ils sont généralement pas très nombreux.

Exporter ou créer un symbole

Un composant peut être exporté comme un symbole à l’aide du bouton icons/import_png. Vous ne pouvez généralement créer qu’un seul graphique, aussi ce sera une bonne idée de supprimer toutes les pins, si elles existent.

Importer un symbole

L’importation de symboles vous permet d’ajouter des éléments graphiques à un composant que vous éditez. Un symbole sera importé par le bouton Import graphic icon. Ces éléments importés sont ajoutés tels qu’ils ont été été créés.

Visualisateur de librairies

Introduction

Le visualisateur de librairies (Viewlib) vous permet d’examiner rapidement le contenu des librairies. Viewlib est appelé par l’icône icons/library_browse_png de la barre d’outils du haut, ou par l’outil "Placer un composant" de la barre d’outils de droite.

eeschema_viewlib_choose_png

Viewlib - fenêtre principale

eeschema_viewlib_select_library_png

Pour examiner le contenu d’une librairie, vous devez sélectionner cette librairie dans la liste de gauche. Les composants disponibles apparaîtront alors dans la deuxième liste, qui vous permet de sélectionner un composant pour l’afficher.

eeschema_viewlib_select_component_png

Barre d’outils de ViewLib

Ci-dessous, la barre d’outils de Viewlib :

images/toolbar_viewlib.png

Les boutons disponibles sont :

icons/library_png

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

icons/add_component_png

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

icons/lib_previous_png

Display previous component.

icons/lib_next_png

Display next component.

zoom in zoom out zoom redraw zoom fit in page

Zoom tools.

morgan1 morgan2

Selection of the representation (normal or converted) if exist.

images/toolbar_viewlib_part.png

Selection of the part, only for multi-part components.

icons/datasheet_png

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

icons/export_png

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

Création de Netlistes et BOM personnalisés

Fichier intermédiaire de Netliste

Les fichiers de BOM et de Netlistes sont convertis à partir d’un fichier intermédiaire créé par Eeschema.

Ce fichier utilise une syntaxe XML, et est appelé "netliste intermédiaire". Cette netliste intermédiaire inclue une grande quantité de données relatives au circuit, et, pour cette raison, il peut être utilisé par un post-traitement pour créer une liste de composants ou d’autres rapports.

Suivant le fichier de sortie (BOM ou netliste), différentes portions de la netliste intermédiaire seront utilisées dans le post-traitement.

Exemple de schéma

Exemple de schéma

Exemple de fichier netliste intermédiaire

Le fichier netliste intermédiaire (utilisant une syntaxe XML) correspondant au schéma ci-dessus :

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

Conversion dans un nouveau format de netliste

En appliquant un filtre de post-traitement au fichier netliste Intermédiaire, vous pouvez générer des formats inconnus de netliste, ou de BOM. Parce que cette conversion est une transformation de texte en texte, ce filtre de post-traitement pourra être écrit en Python, XSLT, ou tout autre outil capable de prendre du XML en entrée.

XSLT est aussi un langage XML, très approprié pour les transformations XML. Il y a un programme libre appelé xsltproc que vous pouvez télécharger et installer. Le programme xsltproc va lire en entrée le fichier netliste intermédiaire en XML, lui appliquer une feuille de style pour transformer l’entrée, et sauvegarder les résultats dans un fichier de sortie. L’utilisation de xsltproc nécessite un fichier de feuille de style utilisant les conventions XSLT. Le processus de conversion complet est géré par Eeschema, une fois configuré pour exécuter xsltproc d’une manière spécifique.

L’approche XSLT

Vous trouverez la documentation qui décrit les transformations XSL (XSLT) ici :

Créer un fichier Netliste Pads-Pcb

Le format pads-pcb contient deux sections.

  • La liste des empreintes.

  • La Netliste : qui regroupe les références des broches par équipotentielles.

Ci-dessous, une feuille de style qui convertit le fichier netliste intermédiaire au format de netliste pads-pcb

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

Voici le fichier de sortie pads-pcb après traitement par 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*

La ligne de commande utilisée pour effectuer cette conversion :

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

Créer un fichier de netliste Cadstar

Le format Cadstar contient deux sections.

  • La liste des empreintes.

  • La Netliste : qui regroupe les références des broches par équipotentielles.

Ci-dessous, la feuille de style pour effectuer cette conversion spécifique :

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

Le fichier de sortie au format Cadstar :

.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

Créer un fichier de netliste OrcadPCB2

Ce format a une seule section, qui est la liste des empreintes. Chaque empreinte inclue sa liste de broches avec leurs références d’équipotentielles.

Ci-dessous, la feuille de style pour cette conversion spécifique :

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

Le fichier de sortie au format OrcadPCB2 :

( { 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 )
 )
)
*

Interface des plugins de Eeschema

Les convertisseurs de netliste intermédiaire peuvent être lancés automatiquement par Eeschema.

Ouvrez la fenêtre de configuration

Vous pouvez ajouter un nouveau plugin par le bouton "Ajouter Plugin".

eeschema_plugin_add_plugin_png

Voici l’onglet de configuration du plugin pour Pads-Pcb :

eeschema_plugin_padspcb_png
Configuration des paramètres du plugin

La configuration d’un plugin dans Eeschema requiert les informations suivantes :

  • Un titre : pour l’onglet, comme le nom du format de Netliste.

  • La ligne de commande pour lancer la conversion.

Quand vous cliquez sur le bouton netliste :

  1. Eeschema crée un fichier netliste intermédiaire .xml, par exemple test.xml.

  2. Eeschema lance le plugin, qui lit ce test.xml et crée la netliste test.net.

Génération de fichiers netlistes en ligne de commande

Partant du fait que nous utilisons le programme xsltproc.exe pour appliquer la feuille de style au fichier intermédiaire, xsltproc.exe sera exécuté avec la commande suivante :

xsltproc.exe -o <fichier de sortie> <fichier feuille de style> <fichier XML d’entrée à convertir>

Sous Windows, la ligne de commande sera la suivante :

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

Sous Linux, la ligne de commande sera la suivante :

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

netlist_form_pads-pcb.xsl est le nom de la feuille de style que vous voulez utiliser. N’oubliez pas les guillemets autour des noms de fichiers, ceci permet d’utiliser des espaces dans les noms des fichiers d’entrée et de sortie.

Le format de la ligne de commande accepte des paramètres de substitution pour les noms de fichiers :

Les paramètres autorisés sont.

  • %B ⇒ nom et chemin du fichier de sortie, sans le point et l’extension.

  • %I ⇒ nom et chemin complets du fichier d’entrée (le fichier intermédiaire de netliste).

  • %O ⇒ nom et chemin complets du fichier de sortie.

%I sera remplacé par le nom de fichier intermédiaire de netliste.

%O sera remplacé par le nom de fichier de sortie.

Format de ligne de commande : exemple pour xsltproc

Le format de ligne de commande de xsltproc est le suivant :

<chemin vers xsltproc> xsltproc <paramètres de xsltproc >

Sous Windows

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

Sous Linux

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

Les exemples ci-dessus supposent que xsltproc est installé sur votre PC sous Windows et que tous les fichiers sont situés dans F:\kicad\bin.

Génération de listes de composants (BOM)

Puisque le fichier netliste intermédiaire contient toutes les informations sur les composants utilisés, une liste de composants peut en être extraite. Voici la fenêtre de configuration du plugin (sous Linux) permettant de créer un fichier de BOM (Bill Of Materials) personnalisé :

bom-netlist-tab_png

Le chemin vers la feuille de style bom2csv.xsl dépend de votre système. Actuellement, la meilleure feuille de style XSLT pour la génération du BOM est nommée bom2csv.xsl. Vous êtes libre de la modifier en fonction de vos besoins, et si vous développez un autre modèle utile à tous, vous pouvez demander qu’il fasse partie du projet KiCad.

Exemples de lignes de commandes pour les scripts Python

Le format d’une ligne de commande pour python ressemble à ceci :

python <fichier script> <fichier d’entrée> <fichier de sortie>

Sous Windows

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

Sous Linux

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

Partant du fait que Python est effectivement installé sur votre PC..

Structure du fichier de netliste intermédiaire

L’exemple qui suit donne une idée du format du fichier de netliste intermédiaire.

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

Structure générale

Le fichier de netliste intermédiaire contient cinq sections.

  • La section Entête.

  • The components section.

  • La section Composants en librairie.

  • La section Librairies.

  • La section Équipotentielles

Le contenu du fichier a pour balises de délimitations <export>

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

Section Entête (Header)

L’entête a pour balises de délimitations <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>

Cette section peut être considérée comme une section de commentaires.

Section Composants

La section composants a pour balises de délimitations <components>

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

Cette section contient la liste des composants de votre schéma. Chaque composant est décrit comme ceci :

<comp ref="P1">
<value>CONN_4</value>
<libsource lib="conn" part="CONN_4"/>
<sheetpath names="/" tstamps="/"/>
<tstamp>4C6E2141</tstamp>
</comp>
libsource name of the lib where this component was found.

part

component name inside this library.

sheetpath

path of the sheet inside the hierarchy: identify the sheet within the full schematic hierarchy.

tstamps (time stamps)

time stamp of the schematic file.

tstamp (time stamp)

time stamp of the component.

Note à propos de l’horodatage des composants

Pour identifier un composant dans une netliste, et par voie de conséquence sur le circuit, l’horodatage est utilisé comme référence unique pour chaque composant. Toutefois, Kicad fournit un autre moyen pour identifier un composant, qui est son empreinte correspondante sur le circuit. Ceci permet la ré-annotation de composants dans un projet de schéma sans perdre le lien entre le composant et son empreinte.

Un horodatage (timestamp) est un identifiant unique pour chaque composant, ou chaque feuille d’un projet schématique. Cependant, dans des hiérarchies complexes, la même feuille étant utilisée plus d’une fois, cette feuille contiendra des composants avec le même horodatage.

Une feuille donnée à l’intérieur d’une hiérarchie complexe dispose d’un identifiant unique : son chemin de feuille (sheetpath). Un composant donné (à l’intérieur d’une hiérarchie complexe) a donc un identifiant unique : le sheetpath + son timestamp.

Section Composants en librairie (libparts)

La section libparts a pour délimiteur <libparts>, et le contenu de cette section est celui défini dans les librairies schématiques. La section libparts contient :

  • Les empreintes autorisées (les noms peuvent utiliser des jokers (*?)), avec pour délimiteur <fp>.

  • Les champs définis en librairie, avec pour délimiteur <fields>.

  • La liste des pins, avec pour délimiteur <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>

Les lignes <pin num="1" type="passive"/> donnent aussi le type électrique de la pin. Les types électriques possibles sont :

Input

Entrée

Output

Sortie

Bidirectional

Entrée ou Sortie

Tri-state

Trois-états

Passive

Extrémités de composants passifs

Unspecified

Non-Spécifié

Power input

Entrée d’alimentation d’un composant

Power output

Sortie d’alimentation, comme celle des régulateurs

Open collector

Collecteur ouvert

Open emitter

Émetteur ouvert

Not connected

Non-connecté, sera laissé en l’air dans le schéma

Section Librairies

La section librairies a pour délimiteur <libraries>. Cette section contient la liste des librairies utilisées dans le projet.

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

Section Équipotentielles (nets)

La section nets a pour délimiteur <nets>. Cette section contient la liste des équipotentielles, la "connectivité" du schéma.

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

Cette section recense toutes les équipotentielles du schéma.

Une entrée net peut contenir :

<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

Identifiant interne pour ce net

name

Nom de ce net

node

Référence une pin de composant connectée à ce net

Complément sur xsltproc

Introduction

xsltproc est un outil en ligne de commande pour appliquer des feuilles de styles XSLT à des documents XML. Bien qu’il ait été développé au sein du projet GNOME, il peut opérer indépendamment du bureau GNOME.

xsltproc est invoqué à partir de la ligne de commande, avec le nom de la feuille de style à utiliser, suivi du nom du ou des fichiers auxquels la feuille de style doit être appliquée. Il utilisera l’entrée standard si le nom de fichier d’entrée fournit est - .

Si une feuille de style est incluse dans un document XML, au moyen d’une instruction de traitement de feuille de style, il n’est pas nécessaire de spécifier la feuille de style sur la ligne de commande. xsltproc détectera automatiquement la feuille de style incluse et l’utilisera. Par défaut, la sortie est la sortie standard. Vous pouvez préciser un fichier de sortie en utilisant l’option -o.

Synoptique

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* ]
[ *....* ]

Options de la ligne de commande

-V ou --version

Affiche les versions de libxml et libxslt qui sont utilisées.

-v ou --verbose

Affiche chaque étape de xsltproc lors du traitement du la feuille de style et du document.

-o ou --output fichier

Redirige la sortie vers le fichier nommé fichier. Pour des sorties multiples, que l’on appelle également ``chunking'', -o répertoire/ redirige les fichiers de sortie vers un répertoire donné. Le répertoire doit déjà exister.

--timing

Affiche le temps qu’il a fallu pour traiter la feuille de style, traiter le document, appliquer la feuille de style et enregistrer le résultat. Il est affiché en millisecondes.

--repeat

Lance la transformation 20 fois de suite. Utile pour des tests de vitesse.

--debug

Affiche un arbre XML du document transformé afin de déboguer.

--novalid

Évite le chargement de la DTD du document.

--noout

N’affiche pas le résultat.

--maxdepth valeur

Ajuste la profondeur maximale de la pile avant que libxslt ne conclue qu’il y ait une boucle infinie. La valeur par défaut est 500.

--html

Le document en entrée est un fichier HTML.

--param nom valeur

Passe un paramètre de nom nom et de valeur valeur à la feuille de style. Vous pouvez passer plusieurs paires nom/valeur, jusqu’à 32 valeurs. Si la valeur qui est spécifiée est une chaîne de caractères au lieu du nom d’identification d’un noeud, vous devez utiliser --stringparam à la place.

--stringparam nom valeur

Passe un paramètre de nom nom et de valeur valeur où valeur est une chaîne de caractères plutôt qu’un identifiant de noeud. (Note : La chaîne doit être en utf-8.)

--nonet

Ne pas utiliser Internet pour récupérer les DTD ou les entités.

--path chemins

Use the list (separated by space or colon) of filesystem paths specified by paths to load DTDs, entities or documents. Enclose space-separated lists by quotation marks.

--load-trace

Affiche sur la sortie d’erreurs standard (stderr) tous les documents chargés pendant le traitement.

--catalogs

Utilise les catalogues SGML pour résoudre l’emplacement des entités externes. Par défaut xsltproc utilise les catalogues XML installés dans /etc/xml/catalog.

--xinclude

Traite le document en entrée en utilisant les spécifications Xinclude. Vous pouvez obtenir plus de détails dans les spécifications de Xinclude : http://www.w3.org/TR/xinclude/.

--profile --norman

Donne des informations détaillant le temps passé pour chaque partie de la feuille de style. C’est utile pour optimiser les performances de la feuille de style.

--dumpextensions

Affiche la liste de toutes les extensions enregistrées sur la sortie standard (stdout).

--nowrite

N’écrit sur aucun fichier ni ressource.

--nomkdir

Ne crée aucun répertoire.

--writesubtree chemin

Autorise l’écriture de fichiers seulement sur le sous-répertoire chemin.

--nodtdattr

N’applique pas les attributs par défaut de la DTD du document.

Valeurs de retour de xsltproc

xsltproc renvoie un code fournissant des informations qui peuvent être très utiles lorsqu’on l’utilise dans des scripts.

0 : normal

1 : pas d’argument

2 : trop de paramètres

3 : option inconnue

4 : le traitement de la feuille de style a échoué

5 : erreur dans la feuille de style

6 : erreur dans un des documents

7 : méthode de sortie xsl (xsl:output) non-supportée

8 : la chaîne de paramètres contient à la fois des guillemets simples et doubles

9 : erreur interne de traitement

10 : le traitement a été stoppé par un signal d’achèvement

11: Impossible d’écrire le résultat dans le fichier de sortie

Plus d’infos sur xsltproc

Page web de la libxml : http://www.xmlsoft.org/

Page XSLT sur le W3C : http://www.w3.org/TR/xslt

Table of Contents