my-kicad-lib/README.de.md

Meine Persönliche KiCad-Bibliothek

Diese Bibliothek enthält benutzerdefinierte KiCad-Komponenten, die in der Standard-Bibliothek nicht verfügbar sind.

📁 Struktur

my-kicad-libs/
├── symbols/              # Symbol-Bibliotheken (.kicad_sym)
│   ├── Custom_Logic/
│   ├── Custom_Power/
│   ├── Custom_Connectors/
│   ├── Standard_Passives/    # Standard R/C/L mit LCSC
│   ├── Standard_ICs/         # CAN, STM32, Standard-ICs
│   ├── Logos_Artwork/
│   └── ...
├── footprints/           # Footprint-Bibliotheken (.pretty)
│   ├── Custom_QFN.pretty/
│   ├── Custom_BGA.pretty/
│   ├── Logos_Silkscreen.pretty/
│   └── ...    # Nur custom Footprints, Standard nutzt KiCad-Libs
├── 3d_models/           # 3D-Modelle (.step, .wrl)
│   ├── Connectors/
│   ├── IC_Packages/
│   ├── Mechanical/
│   └── ...
├── datasheets/          # Datenblätter (optional)
├── docs/                # Dokumentation
├── scripts/             # Automatisierungs-Scripts
└── templates/           # Projektvorlagen

🏷️ Naming Conventions

Symbole (.kicad_sym Dateien)

• Format: [Kategorie]_[Hersteller]_[Serie].kicad_sym
• Beispiele:
  • Logic_TI_74HC.kicad_sym
  • Power_LTC_Switching.kicad_sym
  • Connectors_JST_XH.kicad_sym
  • Logos_Personal.kicad_sym

Einzelne Symbol-Namen (innerhalb der .kicad_sym)

• Format: [Partnumber]_[Package]_[Variante]
• Format (Standard-Passives): [Wert]_[Package]_[LCSC]
• Beispiele:
  • TPS54340_HTSSOP-14_PowerPAD
  • STM32F407VGT6_LQFP-100
  • USB-C_16Pin_Receptacle
  • 100nF_0402_C1525 (Kondensator mit LCSC#)
  • 10k_0603_C25804 (Widerstand mit LCSC#)
  • Logo_MyCompany_10mm

Footprints (.pretty Ordner)

• Format: [Kategorie]_[Spezifikation].pretty
• Beispiele:
  • QFN_Custom.pretty
  • USB_Connectors.pretty
  • Logos_Silkscreen.pretty
  • Mechanical_Standoffs.pretty

Einzelne Footprint-Namen (innerhalb .pretty)

• Format: [Package]_[Größe]_[Pitch]_[Besonderheit]
• Beispiele:
  • QFN-32_5x5mm_0.5mm_EP3.3x3.3mm
  • USB-C_SMD_16Pin_6.2x7.3mm
  • Logo_MyCompany_10x5mm_Silkscreen
  • TestPoint_1.5mm_Drill0.7mm

3D-Modelle

• Format: [Kategorie]/[Bauteil]_[Größe].[step|wrl]
• Beispiele:
  • IC_Packages/QFN-32_5x5mm.step
  • Connectors/USB-C_SMD_16Pin.step
  • Mechanical/Standoff_M3_10mm.step

📋 Kategorien-System

Symbole

• Amplifiers_Custom - Spezielle Operationsverstärker
• Audio_Custom - Audio-ICs, Codecs
• Communication_Custom - CAN, RS485, Ethernet (spezielle)
• Connectors_Custom - Spezielle Steckverbinder
• Display_Custom - LCDs, OLEDs, E-Paper
• Logic_Custom - Spezielle Logik-ICs
• MCU_Custom - Mikrocontroller (spezielle)
• Memory_Custom - Flash, EEPROM, RAM
• Standard_Passives - Standard R/C/L mit LCSC (nutzt KiCad-Footprints)
• Standard_ICs - Standard CAN-Transceiver, STM32, etc. (nutzt KiCad-Footprints)
• Power_Custom - DC-DC, LDOs, Power Management
• RF_Custom - HF-Module, Antennen
• Sensors_Custom - Sensoren aller Art
• Logos_Artwork - Firmenlogos, CC-Lizenzen, Artwork

Footprints

• BGA_Custom.pretty - Ball Grid Arrays (nur wenn nicht in KiCad vorhanden)
• Connectors_Audio.pretty - Audio-Steckverbinder
• Connectors_Power.pretty - Power-Steckverbinder
• Connectors_USB.pretty - USB-Varianten
• IC_Custom.pretty - Spezielle IC-Gehäuse
• Logos_Silkscreen.pretty - Logos für Silkscreen
• Mechanical.pretty - Mechanische Teile
• Modules_Custom.pretty - Komplette Module
• QFN_Custom.pretty - Quad Flat No-leads (nur Custom-Varianten)
• Sensors_Custom.pretty - Sensor-Gehäuse
• TestPoints.pretty - Testpunkte

Hinweis: Standard-Passivbauteile und Standard-IC-Packages nutzen die vorhandenen KiCad-Footprints!

🎨 Artwork & Logos

CC-Lizenzen

• Format: CC_[Lizenz]_[Größe]mm
• Beispiele: CC_BY-SA_5mm, CC_BY-NC_3mm

Persönliche Logos

• Format: Logo_[Name]_[Größe]mm_[Typ]
• Beispiele: Logo_MyCompany_10mm_Full, Logo_MyCompany_5mm_Icon

OSHW (Open Source Hardware)

• Format: OSHW_[Land]_[Größe]mm
• Beispiel: OSHW_DE_4mm

⚙️ Best Practices

Allgemeine Regeln

1. Konsistenz: Immer das gleiche Namensschema verwenden
2. Englisch: Alle Namen auf Englisch für universelle Verwendbarkeit
3. Keine Sonderzeichen: Nur A-Z, a-z, 0-9, Unterstrich und Bindestrich
4. Versionierung: Bei Updates neue Symbole/Footprints erstellen statt überschreiben
5. Dokumentation: Jedes neue Teil dokumentieren

Symbol-Design

• Pin-Namen: Verwenden Sie offizielle Pin-Namen aus dem Datenblatt
• Pin-Nummern: Korrekte Pin-Nummern entsprechend Package
• Referenz: Standard-Referenz (U, R, C, L, etc.)
• Value: Leer lassen oder generischen Namen verwenden
• Datasheet: URL im Symbol hinterlegen

Footprint-Design

• Courtyard: 0.25mm Mindestabstand zu anderen Komponenten
• Fab Layer: Bauteil-Umriss auf F.Fab/B.Fab
• Silkscreen: Klare Orientierung, keine Überlappung mit Pads
• Reference: Standardposition, gut lesbar
• 3D-Modell: Wenn verfügbar, immer zuweisen

3D-Modelle

• Format: STEP bevorzugt, WRL für Legacy
• Größe: Realistisch, aber nicht übermäßig detailliert
• Farben: Realistische Materialfarben
• Position: Korrekte Ausrichtung zum Footprint

📂 Ordnerstruktur Detail

/symbols/

symbols/
├── Amplifiers_Custom.kicad_sym
├── Communication_Custom.kicad_sym
├── Connectors_Custom.kicad_sym
├── Display_Custom.kicad_sym
├── Logic_Custom.kicad_sym
├── Logos_Artwork.kicad_sym
├── MCU_Custom.kicad_sym
├── Memory_Custom.kicad_sym
├── Power_Custom.kicad_sym
├── RF_Custom.kicad_sym
└── Sensors_Custom.kicad_sym

/footprints/

footprints/
├── BGA_Custom.pretty/
├── Connectors_Audio.pretty/
├── Connectors_Power.pretty/
├── Connectors_USB.pretty/
├── IC_Custom.pretty/
├── Logos_Silkscreen.pretty/
├── Mechanical.pretty/
├── Modules_Custom.pretty/
├── QFN_Custom.pretty/
├── Sensors_Custom.pretty/
└── TestPoints.pretty/

/3d_models/

3d_models/
├── Connectors/
│   ├── Audio/
│   ├── Power/
│   └── USB/
├── IC_Packages/
│   ├── BGA/
│   ├── QFN/
│   └── Custom/
├── Mechanical/
│   ├── Standoffs/
│   ├── Heatsinks/
│   └── Enclosures/
└── Modules/
    ├── RF/
    ├── Sensors/
    └── Display/

🔧 KiCad Konfiguration

Symbol-Bibliotheken hinzufügen

1. Preferences → Manage Symbol Libraries
2. Project Specific Libraries hinzufügen
3. Nickname: Custom_[Kategorie]
4. Library Path: Relativer Pfad zu .kicad_sym Datei

Footprint-Bibliotheken hinzufügen

1. Preferences → Manage Footprint Libraries
2. Project Specific Libraries hinzufügen
3. Nickname: Custom_[Kategorie]
4. Library Path: Relativer Pfad zu .pretty Ordner

📝 Dokumentationsrichtlinien

Pro Komponente dokumentieren

• Partnummer: Vollständige Herstellerbezeichnung
• Hersteller: Firmenname
• Datenblatt: URL oder lokaler Pfad
• Besonderheiten: Spezielle Anforderungen
• Erstellt: Datum und Version
• Getestet: Status der Verifikation

Changelog führen

• Alle Änderungen in CHANGELOG.md dokumentieren
• Datum, Komponente, Art der Änderung
• Grund für die Änderung

🚀 Workflow

Neue Komponente hinzufügen

1. Research: Datenblatt studieren, ähnliche Komponenten prüfen
2. LCSC-Check: Bei Standard-Passivbauteilen LCSC-Verfügbarkeit prüfen
3. Symbol erstellen: In passende Kategorie-Datei
4. Footprint erstellen: In passenden .pretty Ordner
5. 3D-Modell: Suchen oder erstellen
6. Verknüpfung: Symbol ↔ Footprint ↔ 3D-Modell
7. Test: In Testschaltung verwenden
8. Dokumentation: In README und Changelog eintragen

Qualitätskontrolle

• Elektrische Regeln Check (ERC)
• Design Rules Check (DRC)
• 3D-Ansicht prüfen
• Testbestückung (falls möglich)

📜 Lizenz & Copyright

Eigene Designs

• Alle eigenen Symbole, Footprints und 3D-Modelle unter CC BY-SA 4.0
• Copyright-Vermerk in jeder Datei

Fremde 3D-Modelle

• Nur lizenzfreie oder kompatible Modelle verwenden
• Quellenangabe in Datei-Metadaten
• Bei Unsicherheit: Eigenes Modell erstellen

Logos & Artwork

• Nur eigene Logos oder explizit erlaubte verwenden
• CC-Lizenz-Symbole korrekt implementieren
• Markenrechte beachten

🔄 Wartung & Updates

Regelmäßige Aufgaben

• Footprints mit neuen KiCad-Versionen testen
• 3D-Modell-Links überprüfen
• Obsolete Komponenten markieren
• Neue KiCad-Features nutzen

Versionierung

• Git für Versionskontrolle nutzen
• Tags für stabile Versionen
• Branches für experimentelle Features

---

Letzte Aktualisierung: $(date)