my-kicad-lib/docs/KiCad_Setup.md

6.8 KiB

KiCad Library Configuration

Diese Dateien helfen beim Setup der Custom Library in KiCad.

Symbol Libraries (sym-lib-table)

Fügen Sie diese Zeilen zu Ihrer sym-lib-table hinzu:

  (lib (name "Custom_Amplifiers")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Amplifiers_Custom.kicad_sym")(options "")(descr "Custom Amplifiers"))
  (lib (name "Custom_Communication")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Communication_Custom.kicad_sym")(options "")(descr "Custom Communication ICs"))
  (lib (name "Custom_Connectors")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Connectors_Custom.kicad_sym")(options "")(descr "Custom Connectors"))
  (lib (name "Custom_Display")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Display_Custom.kicad_sym")(options "")(descr "Custom Display Components"))
  (lib (name "Custom_Logic")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Logic_Custom.kicad_sym")(options "")(descr "Custom Logic ICs"))
  (lib (name "Custom_MCU")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/MCU_Custom.kicad_sym")(options "")(descr "Custom Microcontrollers"))
  (lib (name "Custom_Memory")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Memory_Custom.kicad_sym")(options "")(descr "Custom Memory Components"))
  (lib (name "Custom_Power")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Power_Custom.kicad_sym")(options "")(descr "Custom Power Management"))
  (lib (name "Custom_RF")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/RF_Custom.kicad_sym")(options "")(descr "Custom RF Components"))
  (lib (name "Custom_Sensors")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Sensors_Custom.kicad_sym")(options "")(descr "Custom Sensors"))
  (lib (name "Logos_Artwork")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Logos_Artwork.kicad_sym")(options "")(descr "Logos and Artwork"))

Footprint Libraries (fp-lib-table)

Fügen Sie diese Zeilen zu Ihrer fp-lib-table hinzu:

  (lib (name "Custom_BGA")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/BGA_Custom.pretty")(options "")(descr "Custom BGA Packages"))
  (lib (name "Custom_Connectors_Audio")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Connectors_Audio.pretty")(options "")(descr "Custom Audio Connectors"))
  (lib (name "Custom_Connectors_Power")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Connectors_Power.pretty")(options "")(descr "Custom Power Connectors"))
  (lib (name "Custom_Connectors_USB")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Connectors_USB.pretty")(options "")(descr "Custom USB Connectors"))
  (lib (name "Custom_IC")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/IC_Custom.pretty")(options "")(descr "Custom IC Packages"))
  (lib (name "Custom_Mechanical")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Mechanical.pretty")(options "")(descr "Mechanical Components"))
  (lib (name "Custom_Modules")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Modules_Custom.pretty")(options "")(descr "Custom Modules"))
  (lib (name "Custom_QFN")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/QFN_Custom.pretty")(options "")(descr "Custom QFN Packages"))
  (lib (name "Custom_Sensors")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Sensors_Custom.pretty")(options "")(descr "Custom Sensor Packages"))
  (lib (name "Custom_TestPoints")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/TestPoints.pretty")(options "")(descr "Test Points"))
  (lib (name "Logos_Silkscreen")(type "KiCad")(uri "${KIPRJMOD}/kicad_libs/my-kicad-libs/footprints/Logos_Silkscreen.pretty")(options "")(descr "Logos for Silkscreen"))

Setup-Anleitung

1. Projekt-spezifisch (empfohlen)

  1. Kopieren Sie den gesamten my-kicad-libs Ordner in Ihr Projekt-Verzeichnis
  2. Erstellen/bearbeiten Sie sym-lib-table im Projektordner
  3. Erstellen/bearbeiten Sie fp-lib-table im Projektordner
  4. Relative Pfade verwenden (${KIPRJMOD}/kicad_libs/my-kicad-libs/...)

2. Global (für alle Projekte)

  1. Kopieren Sie my-kicad-libs in einen permanenten Ordner
  2. KiCad → Preferences → Manage Symbol Libraries → Global Libraries
  3. KiCad → Preferences → Manage Footprint Libraries → Global Libraries
  4. Absolute Pfade verwenden

3. Environment Variable (flexibelste Lösung)

  1. Erstellen Sie Environment Variable: CUSTOM_KICAD_LIBS
  2. Setzen Sie Pfad zu my-kicad-libs Ordner
  3. In Library-Tabellen verwenden: ${CUSTOM_KICAD_LIBS}/symbols/...

Automatisches Setup Script (Windows PowerShell)

# setup_kicad_libs.ps1
param(
    [string]$ProjectPath = (Get-Location).Path,
    [switch]$Global
)

$libPath = Join-Path $ProjectPath "kicad_libs\my-kicad-libs"

if (-not (Test-Path $libPath)) {
    Write-Error "Library path not found: $libPath"
    exit 1
}

# Symbol Library Setup
$symLibTable = if ($Global) {
    Join-Path $env:APPDATA "kicad\8.0\sym-lib-table"
} else {
    Join-Path $ProjectPath "sym-lib-table"
}

# Footprint Library Setup  
$fpLibTable = if ($Global) {
    Join-Path $env:APPDATA "kicad\8.0\fp-lib-table"
} else {
    Join-Path $ProjectPath "fp-lib-table"
}

Write-Host "Setting up KiCad libraries..."
Write-Host "Symbol table: $symLibTable"
Write-Host "Footprint table: $fpLibTable"

# Hier würde der eigentliche Setup-Code stehen...

Überprüfung der Installation

Nach dem Setup sollten Sie folgendes sehen:

Im Symbol-Browser

  • Custom_Amplifiers
  • Custom_Communication
  • Custom_Connectors
  • etc...

Im Footprint-Browser

  • Custom_BGA
  • Custom_Connectors_Audio
  • Custom_Connectors_Power
  • etc...

Test

  1. Erstellen Sie ein neues Schaltplan-Symbol
  2. Schauen Sie, ob die Custom-Libraries in der Liste erscheinen
  3. Erstellen Sie einen neuen Footprint
  4. Prüfen Sie die Verfügbarkeit der Custom-Footprint-Libraries

Troubleshooting

Libraries erscheinen nicht

  • Pfade in sym-lib-table und fp-lib-table prüfen
  • ${KIPRJMOD} Variable korrekt?
  • Dateirechte prüfen
  • KiCad neustarten

3D-Modelle fehlen

  • Pfade in Footprints korrekt?
  • ${KIPRJMOD} oder absolute Pfade verwenden
  • 3D-Viewer-Cache leeren

Performance-Probleme

  • Große Bibliotheken können KiCad verlangsamen
  • Nur benötigte Libraries aktivieren
  • Projekt-spezifische Tables verwenden

Backup & Versionierung

Git Integration

# .gitignore anpassen
echo "fp-info-cache" >> .gitignore
echo "*.kicad_prl" >> .gitignore

# Libraries tracken
git add kicad_libs/
git commit -m "Add custom KiCad libraries"

Backup-Strategie

  1. Regelmäßige Commits der Library-Änderungen
  2. Tags für stabile Versionen
  3. Separate Branches für experimentelle Features