Footprint Assignment Tool

La table des librairies globales d’empreintes contient la liste des librairies qui sont toujours disponibles, quel que soit le fichier de projet actuellement chargé. La table est enregistrée dans un fichier fp-lib-table dans le dossier personnel de l’utilisateur. L’emplacement de ce dossier dépend du système d’exploitation utilisé.

La table des librairies spécifiques au projet contient la liste des librairies d’empreintes qui sont disponibles spécifiquement pour le projet actuellement chargé. Cette table ne peut être modifiée que quand elle est chargée en même temps que le fichier netliste du projet. Si aucun fichier de projet n’est chargé, ou s’il n’y a pas de fichier de table de librairies d’empreintes dans le dossier du projet, une table vide sera créée, et pourra être éditée et enregistrée plus tard, avec le fichier d’affectation des empreintes.

Quand PcbNew ou CvPcb sont lancés pour la première fois, et que le fichier table des librairies d’empreintes globales fp-lib-table n’a pas été trouvé dans le dossier personnel de l’utilisateur, ils tenteront de copier le fichier fp-lib-table par défaut, du dossier système KiCad / template dans le dossier personnel de l’utilisateur.

Si le fichier fp-lib-table ne peut être trouvé, une table de librairies d’empreintes vide sera créée dans le dossier personnel de l’utilisateur. Dans ce cas, l’utilisateur pourra copier fp-lib-table manuellement, ou configurer la table à la main.

La table des librairies d’empreintes par défaut inclut beaucoup de librairies d’empreintes standards, qui sont installées en même temps que KiCad.

Évidemment, la première chose à faire est de modifier cette table (ajouter/supprimer des entrées), suivant vos travaux et les librairies dont vous aurez besoin dans vos projets.

(Charger trop de librairies fait perdre du temps)

Pour utiliser une librairie d’empreintes, elle doit d’abord être ajoutée à l’une ou l’autre des tables, globale ou spécifique au projet. La table spécifique au projet est utilisable uniquement lorsque vous avez un fichier netliste ouvert.

Chaque entrée de la table doit avoir un pseudo unique.

Ce pseudo n’a pas besoin d’être lié au nom réel du fichier ou au chemin de la librairie. Le caractère : ne peut pas être utilisé dans le pseudo. Chaque entrée de librairie doit avoir un chemin d’accès et/ou un nom de fichier valides, suivant le type de librairie. Les chemins peuvent être définis comme absolus, relatifs, ou par la substitution d’une variable d’environnement (voir section ci-dessous).

Le plugin approprié doit être sélectionné pour que la librairie soit lue correctement. KiCad prend actuellement en charge en lecture les librairies d’empreintes : anciennes KiCad, nouvelles KiCad Pretty, Eagle, et GEDA.

Il y a aussi un champ description pour ajouter une description de l’entrée de librairie. Le champ option n’est pas utilisé pour l’instant, donc les options ajoutées n’auront aucun effet lors du chargement des librairies.

Une des fonctionnalités les plus puissantes de la table des librairies d’empreintes est la substitution de variables d’environnement. Ceci permet d’avoir des chemins personnalisés dans des variables d’environnement, pour définir où vos librairies sont stockées. La substitution de variables d’environnement est supportée en utilisant la syntaxe $\{ENV_VAR_NAME\} dans le chemin de la librairie d’empreintes.

Par défaut, au lancement, KiCad définit deux variables d’environnement :

Vous pouvez redéfinir KISYSMOD dans le menu Préférences / Configurer les Chemins, ce qui vous permet de remplacer les librairies d’empreintes par défaut de KiCad par vos propres librairies.

Quand un fichier netliste est chargé, CvPcb définit KIPRJMOD en utilisant le chemin du fichier (le chemin du projet).

Pcbnew définit également cette variable d’environnement lors du chargement d’un fichier de circuit.

Cela vous permet de stocker des librairies dans le dossier du projet, sans avoir à définir leur chemin absolu (qui n’est pas toujours connu) dans la table des librairies spécifiques au projet.

The GitHub is a special plugin that provides an interface for read only access to a remote Git Hub repository consisting of pretty (Pretty is name of the KiCad footprint file format) footprints and optionally provides Copy On Write'' (COW) support for editing footprints read from the GitHub repo and saving them locally. Therefore the Git Hub'' plugin is for read only accessing remote pretty footprint libraries at https://github.com. To add a GitHub entry to the footprint library table the ``Library Path'' in the footprint library table row must be set to a valid GitHub URL.

Par exemple :

https://github.com/liftoff-sr/pretty_footprints

ou

https://github.com/KiCad

Typiquement, les URL GitHub ont cette forme :

https://github.com/nom_utilisateur/nom_dépot

Le Type de Plugin'' doit être réglé sur Github''. Pour activer le Copy On Write'', une option allow_pretty_writing_to_this_dir doit être ajoutée dans le champ Options'' de l’entrée. Cette option donne le Chemin de Librairie'' pour le stockage local des empreintes modifiées, lues depuis le dépôt GitHub. Les empreintes enregistrées dans ce chemin sont combinées avec la partie en lecture seule du dépôt GitHub pour créer la librairie d’empreinte. Si cette option est manquante, alors la librairie GitHub est en lecture uniquement. Si l’option est présente pour une librairie GitHub, alors toute écriture vers cette librairie hybride se fera dans le répertoire local. Notez que la partie résidant sur github.com de cette librairie COW hybride est toujours en lecture seule, ce qui signifie que vous ne pouvez pas modifier ou supprimer quelque empreinte que ce soit directement dans le dépôt GitHub. Le type de ces librairies hybrides restera GitHub'' dans les paragraphes à venir, mais il se compose à la fois de la portion locale en lecture/écriture et de la portion distante en lecture seule.

Le tableau ci-dessous montre une entrée de table de librairies d’empreintes sans option allow_pretty_writing_to_this_dir :

Le tableau ci-dessous montre une entrée de table de librairies d’empreintes avec une option COW. Notez, pour exemple seulement, l’utilisation de la variable d’environnement ${HOME}. Le dossier github.pretty est situé dans le chemin ${HOME}/pretty/. Chaque fois que vous utilisez l’option allow_pretty_writing_to_this_dir, vous devez créer ce dossier manuellement au préalable, et il doit se terminer par l’extension .pretty.

Le chargement des empreintes donnera toujours la priorité aux empreintes locales trouvées dans le chemin donné par l’option allow_pretty_writing_to_this_dir. Une fois que vous avez enregistré une empreinte dans le dossier local de la librairie COW avec l’éditeur de l’empreinte, aucune empreinte GitHub mise à jour ne sera visible lorsque vous chargerez une empreinte avec le même nom qu’une empreinte enregistrée localement.

Ayez toujours un dossier local *.pretty distinct pour chaque librairie GitHub, et ne les combinez jamais en vous référant plus d’une fois au même dossier.

Également, n’utilisez pas le même dossier COW (*.pretty) dans une entrée de table de librairies d’empreintes. Ça pourrait foutre le bordel.

La valeur de l’option allow_pretty_writing_to_this_dir substituera toute variable d’environnement utilisant la notation $\{\} pour désigner le chemin, de la même façon que pour le champ ``Chemin Librairie''.

Quelle est la finalité du système COW ? Il est là pour booster le partage des empreintes.

Si vous envoyez périodiquement vos modifications d’empreintes pretty COW au mainteneur du dépôt GitHub, vous aiderez à mettre à jour la copie GitHub. Envoyez simplement les fichiers individuels .kicad_mod que vous aurez dans vos dossiers COW au mainteneur du dépôt GitHub. Une fois que vous aurez reçu la confirmation que vos modifications ont été validées, vous pourrez supprimer en toute sécurité vos fichiers COW, et l’empreinte mise à jour de la librairie GitHub la remplacera. Votre objectif doit être de garder le dossier COW local aussi petit que possible en contribuant souvent aux copies maîtresses partagées sur https://github.com.

Les librairies d’empreintes peuvent être définies comme globales, ou spécifiques au projet courant. Les librairies d’empreintes définies dans la table globale de l’utilisateur sont toujours disponibles, et sont décrites dans le fichier fp-lib-table du dossier personnel de l’utilisateur.

Les librairies d’empreintes globales sont toujours accessibles, même s’il n’y a pas de fichier netliste ouvert.

La table des librairies spécifiques au projet n’est active que pour le fichier netliste courant ouvert.

La table des librairies spécifiques au projet est enregistrée dans le fichier fp-lib-table, dans le chemin du fichier netliste actuellement ouvert. Vous êtes libres de définir des librairies dans chaque table.

Chaque méthode présente des avantages et des inconvénients. Vous pouvez définir toutes vos librairies dans la table globale, ce qui signifie qu’elles seront toujours disponibles quand vous en aurez besoin. L’inconvénient, c’est que vous devrez parfois parcourir beaucoup de librairies pour trouver l’empreinte que vous cherchez. Vous pouvez aussi définir toutes vos librairies sur une base spécifique par projet.

L’avantage, c’est que vous aurez uniquement à définir les librairies nécessaires pour le projet, ce qui réduit la recherche.

L’inconvénient c’est que vous devrez toujours vous rappeler d’ajouter chaque librairie d’empreintes dont vous avez besoin, pour chaque projet. Vous pouvez aussi définir à la fois des librairies d’empreintes globales, et des librairies spécifiques au projet.

Un autre scénario d’utilisation est de définir vos librairies les plus couramment utilisées de façon globale et les librairies seulement nécessaires pour le projet courant dans la table des librairies spécifiques. Il n’y a aucune restriction à la façon dont vous définissez vos librairies.

La barre d’état se trouve au bas de la fenêtre principale de CvPcb et fournit des informations utiles à l’utilisateur. Le tableau suivant définit le contenu de chaque volet dans la barre d’état.

S’affiche d’un clic droit sur la souris :