CvPcb

Die globale Footprint Bibliothekstabelle enthält eine Liste von Bibliotheken die immer verfügbar sind, unabhängig von der aktuell geladenen Projektdatei. Diese Tabelle ist in der Datei fp-lib-table im Home Verzeichnis des Benutzers gespeichert. Die Position des Verzeichnisses für diese global vorhandenen Bibliotheken hängt vom verwendeten Betriebssystem ab.

Die projektspezifische Footprint Bibliothekstabelle enthält die Liste von Bibliotheken die spezifisch für die aktuell geladene Projektdatei verfügbar sind. Diese projektspezifische Footprint Bibliothekstabelle kann nur bearbeitet werden, wenn sie gleichzeitig mit der Projekt Netzliste geladen wird. Wenn keine Projektdatei geladen ist oder es keine Footprint Bibliothekstabellen Datei im Projektpfad gibt, wird eine leere Tabelle erzeugt, welche bearbeitet werden kann und später mit der Footprint Zuweisungsdatei gespeichert wird.

Wenn Pcbnew oder CvPcb erstmals ausgeführt werden und die globale Footprint Tabellendatei fp-lib-table wurde nicht im Home Verzeichnis des Benutzers gefunden, werden Pcbnew oder CvPcb versuchen die Standard Footprint Tabelle fp-lib-table, die im System KiCad Vorlagen-Verzeichnis gespeichert ist, in das Home Verzeichnis des Benutzers zu kopieren.

Wenn fp-lib-table nicht gefunden werden kann, wird eine leere Footprint-Bibliotheks-Tabelle im Home Verzeichnis des Benutzers erzeugt. Wenn das passiert, kann der Benutzer entweder eine fp-lib-table von Hand kopieren oder die Tabelle von Hand einrichten.

Die Standard Tabelle der Footprintbibliotheken enthält viele der Standard Footprint Bibliotheken, die als Teil von KiCad installiert werden.

Es ist recht offensichtlich als erstes diese Tabelle zu bearbeiten (Hinzufügen/Entfernen von Einträgen) entsprechend Ihrer Notwendigkeiten und den Bibliotheken, die Sie für all ihre Projekte benötigen.

(Das Laden von vielen Bibliotheken dauert sehr lange.)

Um eine Footprintbibliothek zu benutzen, muss diese zuerst entweder zur globalen oder zur projektspezifischen Tabelle hinzugefügt werden. Die projektspezifische Tabelle ist nur verwendbar, wenn Sie eine Netzlistendatei geöffnet haben.

Jeder Bibliothekseintrag muss einen eindeutigen Bezeichner haben.

Dieser Bezeichner braucht in keiner Weise mit dem tatsächlichen Bibliotheksnamen oder -pfad in Verbindung zu stehen. Der Doppelpunkt : darf nirgends im Namen verwendet werden. Jeder Bibliothekseintrag muss einen gültigen Pfad und/oder Dateinamen aufweisen, abhängig von der Art der Bibliothek. Pfade können absolut, relativ oder durch Umgebungsvariablenersetzung definiert werden. (Siehe nächster Abschnitt)

Der korrekte Plugintyp muss ausgewählt worden sein, damit die Bibliothek richtig gelesen werden kann. KiCad unterstützt derzeit das Lesen von KiCad alt, KiCad Pretty, Eagle und GEDA Footprintbibliotheken.

Es gibt ebenfalls ein Beschreibungsfeld um eine Beschreibung des Bibliothekseintrags zu ergänzen. Das Optionsfeld wird derzeit nicht verwendet, das Hinzufügen von Optionen hat keinen Einfluss wenn Bibliotheken geladen werden.

Eine der mächtigsten Funktionen der Footprint Bibliothekstabelle ist die Ersetzung von Umgebungsvariablen. Das erlaubt Ihnen, eigene Pfade in Umgebungsvariablen zu definieren in dem Ihre Bibliotheken gespeichert sind. Die Ersetzung von Umgebungsvariablen wird durch die Syntax ${ENV_VAR_NAME} im Footprint Bibliothekspfad unterstützt.

Standardmäßig definiert KiCad zur Laufzeit zwei Umgebungsvariablen:

Sie können KISYSMOD überschreiben indem Sie es in den „Einstellungen - Pfad konfigurieren“ festlegen, was es Ihnen erlaubt, eigene Bibliotheken anstelle der KiCad Standard Footprintbibliotheken zu verwenden.

Wenn eine Projektnetzlistendatei geladen ist, definiert CvPcb KIPRJMOD indem es den Dateipfad verwendet (den Projektpfad).

Pcbnew definiert ebenfalls diese Umgebungsvariable, wenn es eine Boarddatei lädt.

Das erlaubt es Ihnen Bibliotheken im Projektpfad zu speichern, ohne den absoluten Pfad (welcher nicht immer bekannt ist) zur Bibliothek in der projektspezifischen Footprintbibliotheksdatei angeben zu müssen.

Für GitHub gibt es ein spezielles Plugin, welches eine Schnittstelle mit Nur-Lese Zugriff auf GitHub Repositorys mit .pretty Footprints zur Verfügung stellt. (Pretty ist die Bezeichnung des KiCad Footprint Dateiformats). Das Plugin ermöglicht optional „Copy on Write“ (COW) Unterstützung, um Footprints, die von GitHub geladen wurden, bearbeiten und lokal speichern zu können. Deshalb ist das „GitHub“ Plugin nur für Lesezugriff auf .pretty Footprintbibliotheken auf https://github.com. Um einen GitHub Eintrag zur Footprintbibliothekstabelle hinzuzufügen muss der „Bibliothekspfad“ in der Footprintbibliothekstabelle auf eine gültige GitHub URL verweisen.

Zum Beispiel:

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

oder

https://github.com/KiCad

Typischerweise haben GitHub-URLs diese Form:

https://github.com/user_name/repo_name

Der „Plugin Typ“ muss auf „Github“ gesetzt sein. Um die „Copy On Write“-Funktion ("COW") einzuschalten, muss die Option allow_pretty_writing_to_this_dir in den „Optionen“-Einstellungen des Footprint-Bibliotheks-Tabellen-Eintrags ergänzt werden. Diese Option ist der „Bibliothekspfad“ für das lokale Speichern von geänderten Kopien von Footprints, die vom GitHub Repository gelesen wurden. Die Footprints, die in diesem Verzeichnis gespeichert werden, sind mit dem Nur-Lese-Teil des GitHub Repositorys kombiniert um die Footprintbibliothek zu erzeugen. Wenn diese Option fehlt, dann ist die GitHub Bibliothek schreibgeschützt. Wenn die Option für eine GitHub Bibliothek gesetzt ist, dann werden alle Schreibvorgänge auf diese Hybrid-Bibliothek auf das lokale *.pretty Verzeichnis ausgeführt. Beachten Sie, dass der auf github.com angesiedelte Teil dieser hybriden "COW" Bibliothek immer schreibgeschützt ist, was bedeutet, dass Sie nichts löschen können oder irgendeinen Footprint direkt im angegebenen GitHub Repository ändern können. Der kombinierte Bibliothekstyp wird weiter "Github" genannt werden, in allen weiteren Ausführungen, aber er besteht aus sowohl dem lokalen Schreib-/Lese-Teil als auch dem schreibgeschützten Teil (auf github.com).

Die Tabelle unten zeigt einen Eintrag der Footprintbibliothekstabelle ohne die Option allow_pretty_writing_to_this_dir:

Die nachfolgende Tabelle zeigt einen Footprint-Bibliotheks-Tabellen-Eintrag mit der gesetzten "COW" Option. Betrachten Sie die Benutzung der Umgebungsvariablen ${HOME} nur als ein Beispiel. Das github.pretty Verzeichnis befindet sich im &{HOME}/pretty/ Verzeichnis. Immer wenn Sie die Option allow_pretty_writing_to_this_dir verwenden, werden Sie dieses Verzeichnis manuell vorher anlegen müssen und es muss mit der Erweiterung .pretty enden.

Das Laden von Footprints wird immer vorrangig mit den lokalen Footprints erfolgen die im Verzeichnis liegen, das durch die Option allow_pretty_writing_to_this_dir vorgegeben ist. Sobald sie einmal einen Footprint in das lokale Verzeichnis der "COW" Bibliothek gespeichert haben, indem sie einen Footprint im Footprint-Editor abspeichern, werden keine Updates von GitHub mehr durchgeführt, wenn ein Footprint geladen wird, von dem es eine lokale Speicherung gibt.

Führen Sie immer ein separates lokales *.pretty Verzeichnis für jede GitHub Bibliothek, kombinieren Sie diese nie indem Sie auf das gleiche Verzeichnis mehr als einmal verweisen.

Verwenden Sie ebenfalls nicht das gleiche "COW" (*.pretty)-Verzeichnis in einem Footprint-Bibliotheks-Tabellen-Eintrag. Das wird höchstwahrscheinlich zu einem Durcheinander führen.

Der Wert der Option allow_pretty_writing_to_this_dir wird jede Umgebungsvariable erweitern unter Benutzung der ${} Notation um den Pfad in der gleichen Weise zu erzeugen wie die „Bibliotheks-Pfad“ Einstellung.

Was ist der Sinn von "COW"? Es ist der Turbolader für das Teilen von Footprints.

Wenn Sie regelmäßig ihre "COW" pretty Footprint Änderungen an den GitHub Repository Betreiber schicken (per E-Mail), können Sie dabei helfen die GitHub Kopie aktuell zu halten. Mailen Sie einfach die individuellen *.kicad_mod Dateien, die Sie in Ihrem "COW" Verzeichnis finden an den Betreiber des GitHub Repositorys. Nachdem Sie die Bestätigung erhalten haben, dass ihre Änderungen übernommen wurden, können Sie sicher Ihre "COW" Dateien löschen und der auf GitHub aktualisierte schreibgeschützte Teil der Bibliothek wird übernommen. Ihr Ziel sollte es sein, den Teil der "COW" Dateien so klein wie möglich zu halten indem Sie häufig Kopien an die geteilten Hauptbibliothek auf https://github.com schicken.

Footprintbibliotheken können entweder global oder spezifisch für das aktuell geladene Projekt definiert werden. Footprintbibliotheken, die in der globalen Tabelle des Benutzers definiert sind, sind immer verfügbar und werden in der fp-lib-table Datei im Home Verzeichnis des Benutzers gespeichert.

Auf globale Footprintbibliotheken kann immer zugegriffen werden, selbst wenn keine Projekt-Netzlisten-Datei geöffnet ist.

Die projektspezifische Footprinttabelle ist nur für die aktuell geöffnete Netzlistendatei aktiv.

Die projektspezifische Footprint-Bibliotheks-Tabelle wird in die fp-lib-table Datei im Pfad der aktuell geöffneten Netzliste gespeichert. Sie können Bibliotheken frei in jeder der beiden Tabellen definieren.

Es gibt Vor- und Nachteile bei jeder Methode. Sie können alle Ihre Bibliotheken in der globalen Tabelle definieren, was bedeutet, dass sie immer verfügbar sind, wenn Sie sie brauchen. Der Nachteil dabei ist, dass Sie immer eine (große) Menge von Bibliotheken durchsuchen müssen, um den Footprint zu finden, den Sie suchen. Sie können alle Ihre Bibliotheken auf einer projektspezifischen Basis definieren.

Der Vorteil davon ist, dass Sie nur die Bibliotheken definieren müssen, die Sie tatsächlich für das Projekt brauchen, was die Suche verkleinert.

Es ergibt sich der Nachteil, dass Sie immer daran denken müssen, jede benötigte Footprintbibliothek für jedes Projekt hinzuzufügen. Sie können ebenfalls Footprintbibliotheken sowohl global und projektspezifisch definieren.

Ein Nutzungsmuster könnte sein, dass Sie ihre meistgenutzten Bibliotheken global definieren und die nur für das Projekt benötigten in der projektspezifischen Bibliothekstabelle. Es gibt keine Einschränkung wie Sie ihre Bibliotheken definieren.

Die Statuszeile befindet sich am unteren Ende des neuen CvPcb Hauptfensters und stellt nützliche Informationen für den Benutzer bereit. Die folgende Tabelle definiert die Inhalte jedes Bereichs in der Statuszeile.

Auswahlmöglichkeiten nach einem Rechtsklick auf der Maus: