my-kicad-lib/README.de.md

279 lines
8.4 KiB
Markdown

# 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/
│ ├── 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]`
- **Beispiele**:
- `TPS54340_HTSSOP-14_PowerPAD`
- `STM32F407VGT6_LQFP-100`
- `USB-C_16Pin_Receptacle`
- `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
- `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. **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)*