feat: implement JLCPCB Basic Parts system with Fabrication Toolkit support
- Replace custom footprints approach with standard KiCad footprints - Add comprehensive JLCPCB Basic Parts database with real part numbers - Create dual-platform symbol generators (PowerShell + Bash) - Support bennymeg/JLC-Plugin-for-KiCad with proper field names - Include standard ICs (STM32, CAN, power, interface) - Generate BOM templates for JLCPCB assembly - Add German (.de.md) and English (.md) documentation versions - Remove old LCSC-only approach in favor of complete JLCPCB solution Breaking changes: - Removed custom footprints for standard passives - Updated naming conventions for JLCPCB compatibility - Replaced LCSC_Parts_Database.csv with JLCPCB_Basic_Parts.csv
This commit is contained in:
parent
b969b55799
commit
dda87cfbae
|
|
@ -0,0 +1,47 @@
|
||||||
|
# Changelog
|
||||||
|
|
||||||
|
Alle wichtigen Änderungen an dieser Bibliothek werden in dieser Datei dokumentiert.
|
||||||
|
|
||||||
|
Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/),
|
||||||
|
und dieses Projekt folgt der [Semantischen Versionierung](https://semver.org/lang/de/).
|
||||||
|
|
||||||
|
## [Unreleased]
|
||||||
|
|
||||||
|
### Geplant
|
||||||
|
- Erste Sammlung von Power Management ICs
|
||||||
|
- USB-C Connector-Serie
|
||||||
|
- Firmenlogo-Varianten für verschiedene Größen
|
||||||
|
|
||||||
|
## [1.0.0] - 2024-12-09
|
||||||
|
|
||||||
|
### Hinzugefügt
|
||||||
|
- Initiale Projektstruktur
|
||||||
|
- README mit Naming Conventions
|
||||||
|
- .gitignore für KiCad-Dateien
|
||||||
|
- Changelog-Datei
|
||||||
|
- Ordnerstruktur für symbols/, footprints/, 3d_models/
|
||||||
|
|
||||||
|
### Geändert
|
||||||
|
- Nichts (Erstversion)
|
||||||
|
|
||||||
|
### Entfernt
|
||||||
|
- Nichts (Erstversion)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Template für neue Einträge
|
||||||
|
|
||||||
|
### Hinzugefügt
|
||||||
|
- Neue Symbole: [Liste]
|
||||||
|
- Neue Footprints: [Liste]
|
||||||
|
- Neue 3D-Modelle: [Liste]
|
||||||
|
|
||||||
|
### Geändert
|
||||||
|
- Überarbeitete Symbole: [Liste mit Grund]
|
||||||
|
- Überarbeitete Footprints: [Liste mit Grund]
|
||||||
|
|
||||||
|
### Entfernt
|
||||||
|
- Obsolete Komponenten: [Liste mit Grund]
|
||||||
|
|
||||||
|
### Behoben
|
||||||
|
- Bugfixes: [Liste]
|
||||||
|
|
@ -0,0 +1,286 @@
|
||||||
|
# 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)*
|
||||||
|
|
@ -0,0 +1,105 @@
|
||||||
|
# My Personal KiCad Library
|
||||||
|
|
||||||
|
This library contains custom KiCad components that are not available in the standard library.
|
||||||
|
|
||||||
|
## 📁 Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
my-kicad-libs/
|
||||||
|
├── symbols/ # Symbol libraries (.kicad_sym)
|
||||||
|
│ ├── Custom_Logic/
|
||||||
|
│ ├── Custom_Power/
|
||||||
|
│ ├── Custom_Connectors/
|
||||||
|
│ ├── Standard_Passives/ # Standard R/C/L with LCSC
|
||||||
|
│ ├── Standard_ICs/ # CAN, STM32, Standard ICs
|
||||||
|
│ ├── Logos_Artwork/
|
||||||
|
│ └── ...
|
||||||
|
├── footprints/ # Footprint libraries (.pretty)
|
||||||
|
│ ├── Custom_QFN.pretty/
|
||||||
|
│ ├── Custom_BGA.pretty/
|
||||||
|
│ ├── Logos_Silkscreen.pretty/
|
||||||
|
│ └── ... # Only custom footprints, standard uses KiCad libs
|
||||||
|
├── 3d_models/ # 3D models (.step, .wrl)
|
||||||
|
│ ├── Connectors/
|
||||||
|
│ ├── IC_Packages/
|
||||||
|
│ ├── Mechanical/
|
||||||
|
│ └── ...
|
||||||
|
├── datasheets/ # Datasheets (optional)
|
||||||
|
├── docs/ # Documentation
|
||||||
|
├── scripts/ # Automation scripts
|
||||||
|
└── templates/ # Project templates
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🏷️ Naming Conventions
|
||||||
|
|
||||||
|
### Symbols (.kicad_sym files)
|
||||||
|
- **Format**: `[Category]_[Manufacturer]_[Series].kicad_sym`
|
||||||
|
- **Examples**:
|
||||||
|
- `Logic_TI_74HC.kicad_sym`
|
||||||
|
- `Power_LTC_Switching.kicad_sym`
|
||||||
|
- `Connectors_JST_XH.kicad_sym`
|
||||||
|
- `Standard_Passives.kicad_sym`
|
||||||
|
- `Standard_ICs.kicad_sym`
|
||||||
|
- `Logos_Personal.kicad_sym`
|
||||||
|
|
||||||
|
### Individual Symbol Names (within .kicad_sym)
|
||||||
|
- **Format**: `[Partnumber]_[Package]_[Variant]`
|
||||||
|
- **Format (Standard Passives)**: `[Value]_[Package]_[LCSC]`
|
||||||
|
- **Format (Standard ICs)**: `[Partnumber]_[Package]_[LCSC]`
|
||||||
|
- **Examples**:
|
||||||
|
- `TPS54340_HTSSOP-14_PowerPAD`
|
||||||
|
- `STM32F407VGT6_LQFP-100`
|
||||||
|
- `USB-C_16Pin_Receptacle`
|
||||||
|
- `100nF_0603_C14663` (Capacitor with LCSC#)
|
||||||
|
- `10k_0603_C25804` (Resistor with LCSC#)
|
||||||
|
- `MCP2515_SOIC-18_C55199` (CAN controller with LCSC#)
|
||||||
|
- `Logo_MyCompany_10mm`
|
||||||
|
|
||||||
|
### Footprints (.pretty folders)
|
||||||
|
**Note**: Standard passives and common ICs use existing KiCad footprints!
|
||||||
|
|
||||||
|
- **Format**: `[Category]_[Specification].pretty`
|
||||||
|
- **Examples**:
|
||||||
|
- `QFN_Custom.pretty`
|
||||||
|
- `USB_Connectors.pretty`
|
||||||
|
- `Logos_Silkscreen.pretty`
|
||||||
|
- `Mechanical_Standoffs.pretty`
|
||||||
|
|
||||||
|
## 📊 Standard Components with LCSC
|
||||||
|
|
||||||
|
### Standard Passives (R/C/L)
|
||||||
|
- **Purpose**: Consistent, cost-optimized parts with LCSC numbers
|
||||||
|
- **Footprints**: Use standard KiCad footprints (Resistor_SMD, Capacitor_SMD, etc.)
|
||||||
|
- **Symbols**: Custom symbols with LCSC part numbers and manufacturer data
|
||||||
|
- **Examples**: `100nF_0603_C14663`, `10k_0603_C25804`
|
||||||
|
|
||||||
|
### Standard ICs
|
||||||
|
- **Purpose**: Common ICs with LCSC numbers for automated assembly
|
||||||
|
- **Categories**:
|
||||||
|
- CAN transceivers: `MCP2515_SOIC-18_C55199`
|
||||||
|
- STM32 MCUs: `STM32F103C8T6_LQFP-48_C8734`
|
||||||
|
- Voltage regulators: `AMS1117-3.3_SOT-223_C6186`
|
||||||
|
- Op-amps: `LM358_SOIC-8_C7950`
|
||||||
|
- **Footprints**: Use standard KiCad footprints (Package_SO, Package_QFP, etc.)
|
||||||
|
|
||||||
|
## ⚙️ Best Practices
|
||||||
|
|
||||||
|
### Standard Component Strategy
|
||||||
|
1. **Use KiCad footprints**: Don't reinvent the wheel for standard packages
|
||||||
|
2. **LCSC integration**: Add LCSC numbers for cost optimization
|
||||||
|
3. **Manufacturer data**: Include MPN and manufacturer in symbols
|
||||||
|
4. **BOM automation**: Enable direct JLCPCB assembly integration
|
||||||
|
|
||||||
|
### Workflow
|
||||||
|
|
||||||
|
#### Adding New Standard Component
|
||||||
|
1. **Check KiCad**: Verify symbol/footprint don't exist in standard libraries
|
||||||
|
2. **LCSC lookup**: Find LCSC part number and basic part status
|
||||||
|
3. **Create symbol**: With complete manufacturer data and LCSC number
|
||||||
|
4. **Link footprint**: Use existing KiCad footprint
|
||||||
|
5. **Test**: Use in test circuit
|
||||||
|
6. **Document**: Add to documentation
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Last update: December 9, 2024*
|
||||||
|
|
@ -0,0 +1,61 @@
|
||||||
|
# JLCPCB Basic Parts Database
|
||||||
|
# Master database for JLCPCB Basic Parts with Fabrication Toolkit fields
|
||||||
|
# Compatible with bennymeg/JLC-Plugin-for-KiCad
|
||||||
|
|
||||||
|
Component,Value,Package,LCSC Part #,Manufacturer,MFG Part #,Description,FT Rotation Offset,Stock Status,Price 1k,Last Update
|
||||||
|
# RESISTORS - UniOhm Basic Parts 1% Thick Film
|
||||||
|
R,0R,0603,C21189,UniOhm,0603WAF0000T5E,"Resistor 0R 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,10R,0603,C22859,UniOhm,0603WAF100JT5E,"Resistor 10R 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,22R,0603,C23179,UniOhm,0603WAF220JT5E,"Resistor 22R 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,100R,0603,C22775,UniOhm,0603WAF1000T5E,"Resistor 100R 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,330R,0603,C23138,UniOhm,0603WAF3300T5E,"Resistor 330R 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,1k,0603,C21190,UniOhm,0603WAF1001T5E,"Resistor 1k 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,4.7k,0603,C23162,UniOhm,0603WAF4701T5E,"Resistor 4.7k 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,10k,0603,C25804,UniOhm,0603WAF1002T5E,"Resistor 10k 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,47k,0603,C25819,UniOhm,0603WAF4702T5E,"Resistor 47k 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
R,100k,0603,C25803,UniOhm,0603WAF1003T5E,"Resistor 100k 1% 1/10W 0603",0,In Stock,0.002,2024-12-09
|
||||||
|
# CAPACITORS - Samsung Basic Parts X7R/X5R
|
||||||
|
C,22pF,0603,C1653,Samsung,CL10B220KB8NNNC,"Capacitor 22pF 50V X7R 0603",0,In Stock,0.003,2024-12-09
|
||||||
|
C,100pF,0603,C14858,Samsung,CL10B101KB8NNNC,"Capacitor 100pF 50V X7R 0603",0,In Stock,0.003,2024-12-09
|
||||||
|
C,1nF,0603,C1588,Samsung,CL10B102KB8NNNC,"Capacitor 1nF 50V X7R 0603",0,In Stock,0.003,2024-12-09
|
||||||
|
C,10nF,0603,C57112,Samsung,CL10B103KB8NNNC,"Capacitor 10nF 50V X7R 0603",0,In Stock,0.003,2024-12-09
|
||||||
|
C,100nF,0603,C14663,Samsung,CL10B104KB8NNNC,"Capacitor 100nF 50V X7R 0603",0,In Stock,0.003,2024-12-09
|
||||||
|
C,1µF,0603,C15849,Samsung,CL10A105KA8NNNC,"Capacitor 1µF 25V X5R 0603",0,In Stock,0.004,2024-12-09
|
||||||
|
C,4.7µF,0603,C19666,Samsung,CL10A475KQ8NNNC,"Capacitor 4.7µF 16V X5R 0603",0,In Stock,0.006,2024-12-09
|
||||||
|
C,10µF,0603,C19702,Samsung,CL10A106KP8NNNC,"Capacitor 10µF 10V X5R 0603",0,In Stock,0.008,2024-12-09
|
||||||
|
C,22µF,0805,C45783,Samsung,CL21A226KQCLRNC,"Capacitor 22µF 6.3V X5R 0805",0,In Stock,0.015,2024-12-09
|
||||||
|
C,47µF,1206,C13585,Samsung,CL31A476MQHNNNE,"Capacitor 47µF 6.3V X5R 1206",0,In Stock,0.025,2024-12-09
|
||||||
|
# INDUCTORS - Murata Basic Parts
|
||||||
|
L,10nH,0603,C1649,Murata,LQG18HN10NJ00D,"Inductor 10nH ±5% 0603",0,In Stock,0.008,2024-12-09
|
||||||
|
L,100nH,0603,C1588,Murata,LQG18HN101J00D,"Inductor 100nH ±5% 0603",0,In Stock,0.008,2024-12-09
|
||||||
|
L,1µH,0603,C1617,Murata,LQG18HN1R0J00D,"Inductor 1µH ±5% 0603",0,In Stock,0.008,2024-12-09
|
||||||
|
L,10µH,0805,C1046,Murata,LQG21HN100J10D,"Inductor 10µH ±5% 0805",0,In Stock,0.010,2024-12-09
|
||||||
|
L,100µH,1206,C51942,Murata,LQG31HN101J03L,"Inductor 100µH ±5% 1206",0,In Stock,0.015,2024-12-09
|
||||||
|
# STANDARD ICs - Basic Parts for common designs
|
||||||
|
IC,STM32F103C8T6,LQFP-48,C8734,STMicroelectronics,STM32F103C8T6,"MCU 32-bit ARM Cortex M3 72MHz 64KB Flash 20KB RAM",0,In Stock,2.89,2024-12-09
|
||||||
|
IC,STM32F030F4P6,TSSOP-20,C9900,STMicroelectronics,STM32F030F4P6,"MCU 32-bit ARM Cortex M0 48MHz 16KB Flash 4KB RAM",0,In Stock,0.89,2024-12-09
|
||||||
|
IC,MCP2515,SOIC-18,C55199,Microchip,MCP2515-I/SO,"CAN Controller SPI Interface",0,In Stock,1.67,2024-12-09
|
||||||
|
IC,SN65HVD230,SOIC-8,C12084,Texas Instruments,SN65HVD230DR,"CAN Transceiver 3.3V",0,In Stock,0.39,2024-12-09
|
||||||
|
IC,AMS1117-3.3,SOT-223,C6186,Advanced Monolithic Systems,AMS1117-3.3,"LDO 3.3V 1A Low Dropout Regulator",180,In Stock,0.11,2024-12-09
|
||||||
|
IC,AMS1117-5.0,SOT-223,C347222,Advanced Monolithic Systems,AMS1117-5.0,"LDO 5.0V 1A Low Dropout Regulator",180,In Stock,0.11,2024-12-09
|
||||||
|
IC,LM358,SOIC-8,C7950,Texas Instruments,LM358DR,"Dual Operational Amplifier",0,In Stock,0.11,2024-12-09
|
||||||
|
IC,LM324,SOIC-14,C6744,Texas Instruments,LM324DR,"Quad Operational Amplifier",0,In Stock,0.15,2024-12-09
|
||||||
|
IC,74HC595,SOIC-16,C5947,Texas Instruments,SN74HC595DR,"8-bit Shift Register with Output Latches",0,In Stock,0.15,2024-12-09
|
||||||
|
IC,74HC4051,SOIC-16,C6977,Texas Instruments,CD74HC4051M,"8-channel Analog Multiplexer",0,In Stock,0.18,2024-12-09
|
||||||
|
IC,FT232RL,SSOP-28,C8690,FTDI,FT232RL,"USB to Serial UART Interface",0,In Stock,3.45,2024-12-09
|
||||||
|
IC,CH340G,SOIC-16,C14267,WCH,CH340G,"USB to Serial UART Interface",0,In Stock,0.44,2024-12-09
|
||||||
|
IC,ESP32-WROOM-32,MODULE,C82899,Espressif,ESP32-WROOM-32,"WiFi+Bluetooth Module",0,In Stock,2.84,2024-12-09
|
||||||
|
IC,ESP8266-12F,MODULE,C8619,AI-Thinker,ESP-12F,"WiFi Module",0,In Stock,1.77,2024-12-09
|
||||||
|
# CRYSTALS & OSCILLATORS
|
||||||
|
XTAL,8MHz,HC-49S,C13738,Yangxing Tech,X49SM8MSD2SC,"Crystal 8MHz ±30ppm",0,In Stock,0.12,2024-12-09
|
||||||
|
XTAL,16MHz,HC-49S,C13741,Yangxing Tech,X49SM16MSD2SC,"Crystal 16MHz ±30ppm",0,In Stock,0.13,2024-12-09
|
||||||
|
XTAL,25MHz,HC-49S,C13749,Yangxing Tech,X49SM25MSD2SC,"Crystal 25MHz ±30ppm",0,In Stock,0.14,2024-12-09
|
||||||
|
XTAL,32.768kHz,3215,C32346,Seiko,SC32S-20PF30RSPN,"Crystal 32.768kHz ±20ppm Watch Crystal",0,In Stock,0.25,2024-12-09
|
||||||
|
# LEDs - Basic Parts
|
||||||
|
LED,Red,0603,C2286,Hubei KENTO,KT-0603R,"LED Red 2V 20mA 0603",0,In Stock,0.02,2024-12-09
|
||||||
|
LED,Green,0603,C2290,Hubei KENTO,KT-0603G,"LED Green 3.2V 20mA 0603",0,In Stock,0.02,2024-12-09
|
||||||
|
LED,Blue,0603,C72041,Hubei KENTO,KT-0603B,"LED Blue 3.2V 20mA 0603",0,In Stock,0.02,2024-12-09
|
||||||
|
LED,White,0603,C72043,Hubei KENTO,KT-0603W,"LED White 3.2V 20mA 0603",0,In Stock,0.03,2024-12-09
|
||||||
|
# DIODES
|
||||||
|
D,1N4148W,SOD-123,C81598,Changjiang Electronics,1N4148W,"Switching Diode 75V 150mA",0,In Stock,0.015,2024-12-09
|
||||||
|
D,1N5819,SOD-123FL,C8598,Changjiang Electronics,1N5819,"Schottky Diode 40V 1A",180,In Stock,0.03,2024-12-09
|
||||||
|
Can't render this file because it has a wrong number of fields in line 5.
|
|
|
@ -0,0 +1,160 @@
|
||||||
|
# JLCPCB Basic Parts Generator
|
||||||
|
|
||||||
|
This guide describes how to use the automated symbol generation for JLCPCB Basic Parts.
|
||||||
|
|
||||||
|
## 🎯 Purpose
|
||||||
|
|
||||||
|
The generator creates KiCad symbol libraries with proper **Fabrication Toolkit** properties for seamless JLCPCB assembly integration. All symbols use standard KiCad footprints - no custom footprints needed!
|
||||||
|
|
||||||
|
## 📋 Compatible with Fabrication Toolkit
|
||||||
|
|
||||||
|
The generated symbols include all properties required by [bennymeg/JLC-Plugin-for-KiCad](https://github.com/bennymeg/JLC-Plugin-for-KiCad):
|
||||||
|
|
||||||
|
- `LCSC Part #` - For automatic part matching
|
||||||
|
- `Manufacturer` - Component manufacturer
|
||||||
|
- `MFG Part #` - Manufacturer part number
|
||||||
|
- `FT Rotation Offset` - Pick-and-place rotation correction
|
||||||
|
- Standard KiCad footprint references
|
||||||
|
|
||||||
|
## 🗂️ Input Database
|
||||||
|
|
||||||
|
The database `docs/JLCPCB_Basic_Parts.csv` contains:
|
||||||
|
- **Resistors**: UniOhm Basic Parts (0603 preferred)
|
||||||
|
- **Capacitors**: Samsung Basic Parts (0603, 0805)
|
||||||
|
- **Inductors**: Murata Basic Parts (0603, 0805)
|
||||||
|
- **ICs**: STM32, CAN, Power, Interface ICs
|
||||||
|
- **Components**: LEDs, Diodes, Crystals
|
||||||
|
|
||||||
|
All parts are JLCPCB Basic Parts for lowest assembly cost.
|
||||||
|
|
||||||
|
## ⚙️ Usage
|
||||||
|
|
||||||
|
### Windows PowerShell
|
||||||
|
```powershell
|
||||||
|
# Generate all libraries and reports
|
||||||
|
.\scripts\Generate_JLCPCB_Symbols.ps1 -CsvPath ".\docs\JLCPCB_Basic_Parts.csv" -OutputPath "."
|
||||||
|
|
||||||
|
# Dry run (preview only)
|
||||||
|
.\scripts\Generate_JLCPCB_Symbols.ps1 -CsvPath ".\docs\JLCPCB_Basic_Parts.csv" -OutputPath "." -DryRun
|
||||||
|
```
|
||||||
|
|
||||||
|
### Linux/macOS Bash
|
||||||
|
```bash
|
||||||
|
# Generate all libraries and reports
|
||||||
|
./scripts/generate_jlcpcb_symbols.sh -c ./docs/JLCPCB_Basic_Parts.csv -o .
|
||||||
|
|
||||||
|
# Dry run (preview only)
|
||||||
|
./scripts/generate_jlcpcb_symbols.sh -c ./docs/JLCPCB_Basic_Parts.csv -o . --dry-run
|
||||||
|
|
||||||
|
# Skip symbol generation, only generate reports
|
||||||
|
./scripts/generate_jlcpcb_symbols.sh -c ./docs/JLCPCB_Basic_Parts.csv -o . --skip-symbols
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📤 Output
|
||||||
|
|
||||||
|
### Symbol Libraries
|
||||||
|
- `symbols/Standard_Passives.kicad_sym` - Resistors, Capacitors, Inductors
|
||||||
|
- `symbols/Standard_ICs.kicad_sym` - Microcontrollers, CAN, Power ICs
|
||||||
|
- `symbols/Standard_Components.kicad_sym` - LEDs, Diodes, Crystals
|
||||||
|
|
||||||
|
### BOM Template
|
||||||
|
- `docs/JLCPCB_BOM_Template.csv` - Ready for JLCPCB assembly upload
|
||||||
|
|
||||||
|
### Reports
|
||||||
|
- Component statistics by package and manufacturer
|
||||||
|
- Cost analysis for complete starter kit
|
||||||
|
- Footprint mapping summary
|
||||||
|
|
||||||
|
## 🔧 KiCad Integration
|
||||||
|
|
||||||
|
### 1. Add Symbol Libraries
|
||||||
|
```
|
||||||
|
KiCad → Preferences → Manage Symbol Libraries → Project Specific Libraries
|
||||||
|
|
||||||
|
Add:
|
||||||
|
- Nickname: Standard_Passives
|
||||||
|
- Library Path: ${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Standard_Passives.kicad_sym
|
||||||
|
|
||||||
|
- Nickname: Standard_ICs
|
||||||
|
- Library Path: ${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Standard_ICs.kicad_sym
|
||||||
|
|
||||||
|
- Nickname: Standard_Components
|
||||||
|
- Library Path: ${KIPRJMOD}/kicad_libs/my-kicad-libs/symbols/Standard_Components.kicad_sym
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Use Standard Footprints
|
||||||
|
No footprint configuration needed - symbols automatically reference standard KiCad footprints:
|
||||||
|
- Resistors → `Resistor_SMD:R_0603_1608Metric`
|
||||||
|
- Capacitors → `Capacitor_SMD:C_0603_1608Metric`
|
||||||
|
- ICs → `Package_SO:SOIC-16_3.9x9.9mm_P1.27mm`
|
||||||
|
|
||||||
|
### 3. JLCPCB Assembly Workflow
|
||||||
|
1. Design schematic using generated symbols
|
||||||
|
2. Create PCB layout
|
||||||
|
3. Export BOM with Fabrication Toolkit plugin
|
||||||
|
4. Upload to JLCPCB with automatic part matching
|
||||||
|
|
||||||
|
## 📊 Example Components
|
||||||
|
|
||||||
|
### Standard Passives
|
||||||
|
| Component | Value | Package | LCSC | Footprint |
|
||||||
|
|-----------|-------|---------|------|-----------|
|
||||||
|
| Resistor | 10k | 0603 | C25804 | Resistor_SMD:R_0603_1608Metric |
|
||||||
|
| Capacitor | 100nF | 0603 | C14663 | Capacitor_SMD:C_0603_1608Metric |
|
||||||
|
| Inductor | 10µH | 0805 | C1046 | Inductor_SMD:L_0805_2012Metric |
|
||||||
|
|
||||||
|
### Standard ICs
|
||||||
|
| Component | Package | LCSC | Footprint |
|
||||||
|
|-----------|---------|------|-----------|
|
||||||
|
| STM32F103C8T6 | LQFP-48 | C8734 | Package_QFP:LQFP-48_7x7mm_P0.5mm |
|
||||||
|
| MCP2515 | SOIC-18 | C55199 | Package_SO:SOIC-18W_7.5x11.6mm_P1.27mm |
|
||||||
|
| AMS1117-3.3 | SOT-223 | C6186 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 |
|
||||||
|
|
||||||
|
## 🔄 Updating the Database
|
||||||
|
|
||||||
|
### Adding New Parts
|
||||||
|
1. Edit `docs/JLCPCB_Basic_Parts.csv`
|
||||||
|
2. Add new line with format: `Component,Value,Package,LCSC Part #,Manufacturer,MFG Part #,Description,FT Rotation Offset,Stock Status,Price 1k,Last Update`
|
||||||
|
3. Run generator script
|
||||||
|
4. Test symbols in KiCad
|
||||||
|
|
||||||
|
### Verifying LCSC Numbers
|
||||||
|
- Check [lcsc.com](https://lcsc.com) for current availability
|
||||||
|
- Prefer "Basic Parts" (marked with green "Basic" label)
|
||||||
|
- Verify pricing and stock status
|
||||||
|
|
||||||
|
## ⚠️ Important Notes
|
||||||
|
|
||||||
|
### Rotation Offsets
|
||||||
|
- Most components: `0` (no rotation needed)
|
||||||
|
- SOT-223 regulators: `180` (common requirement)
|
||||||
|
- Check actual assembly if rotation issues occur
|
||||||
|
|
||||||
|
### Symbol Limitations
|
||||||
|
- ICs use generic rectangular symbols
|
||||||
|
- Actual pinout must be defined manually for complex ICs
|
||||||
|
- Passives are ready-to-use with correct pin assignments
|
||||||
|
|
||||||
|
### Cost Optimization
|
||||||
|
- All parts are JLCPCB Basic Parts
|
||||||
|
- Complete kit cost: ~$50 for 1000 pieces each
|
||||||
|
- Setup fee applies for each unique part (~$3)
|
||||||
|
- Minimize unique parts to reduce cost
|
||||||
|
|
||||||
|
## 🛠️ Customization
|
||||||
|
|
||||||
|
### Adding New Component Types
|
||||||
|
1. Add entries to CSV database
|
||||||
|
2. Update `get_kicad_footprint()` function in scripts
|
||||||
|
3. Add symbol graphics in `get_symbol_graphics()`
|
||||||
|
4. Test generation
|
||||||
|
|
||||||
|
### Custom Footprints
|
||||||
|
If standard KiCad footprints don't fit:
|
||||||
|
1. Create custom footprint in your library
|
||||||
|
2. Update footprint mapping in script
|
||||||
|
3. Ensure 3D model compatibility
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Compatible with KiCad 7.0+ and Fabrication Toolkit plugin*
|
||||||
|
|
@ -0,0 +1,153 @@
|
||||||
|
# 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)
|
||||||
|
|
||||||
|
```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
|
||||||
|
```bash
|
||||||
|
# .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
|
||||||
|
|
@ -0,0 +1,108 @@
|
||||||
|
# Komponenten-Dokumentation Template
|
||||||
|
|
||||||
|
Verwenden Sie diese Vorlage für die Dokumentation neuer Komponenten.
|
||||||
|
|
||||||
|
## [Komponenten-Name]
|
||||||
|
|
||||||
|
### Grundinformationen
|
||||||
|
- **Partnummer**: [Vollständige Herstellerbezeichnung]
|
||||||
|
- **Hersteller**: [Firmenname]
|
||||||
|
- **Kategorie**: [Logic/Power/Sensors/etc.]
|
||||||
|
- **Package**: [QFN-32, LQFP-100, etc.]
|
||||||
|
- **Erstellt**: [YYYY-MM-DD]
|
||||||
|
- **Ersteller**: [Name]
|
||||||
|
- **Status**: [In Arbeit/Testing/Verified/Obsolete]
|
||||||
|
|
||||||
|
### Dateien
|
||||||
|
- **Symbol**: `symbols/[Kategorie]_Custom.kicad_sym` → `[Komponenten-Name]`
|
||||||
|
- **Footprint**: `footprints/[Kategorie].pretty/[Footprint-Name].kicad_mod`
|
||||||
|
- **3D-Modell**: `3d_models/[Kategorie]/[Modell-Name].[step/wrl]`
|
||||||
|
- **Datenblatt**: `datasheets/[Hersteller]/[Partnummer].pdf` oder [URL]
|
||||||
|
|
||||||
|
### Technische Daten
|
||||||
|
- **Versorgungsspannung**: [V]
|
||||||
|
- **Betriebstemperatur**: [°C]
|
||||||
|
- **Besondere Eigenschaften**: [Liste wichtiger Features]
|
||||||
|
- **Pin-Count**: [Anzahl Pins]
|
||||||
|
- **Gehäusegröße**: [mm x mm x mm]
|
||||||
|
|
||||||
|
### Elektrische Eigenschaften
|
||||||
|
| Parameter | Min | Typ | Max | Einheit | Bemerkungen |
|
||||||
|
|-----------|-----|-----|-----|---------|-------------|
|
||||||
|
| VCC | | | | V | |
|
||||||
|
| ICC | | | | mA | |
|
||||||
|
| ... | | | | | |
|
||||||
|
|
||||||
|
### Pin-Belegung
|
||||||
|
| Pin | Name | Typ | Funktion | Bemerkungen |
|
||||||
|
|-----|------|-----|----------|-------------|
|
||||||
|
| 1 | | I/O | | |
|
||||||
|
| 2 | | PWR | | |
|
||||||
|
| ... | | | | |
|
||||||
|
|
||||||
|
### Design Notes
|
||||||
|
- **Layout-Hinweise**: [Spezielle Anforderungen für PCB-Layout]
|
||||||
|
- **Bestückung**: [Besondere Löt-/Bestückungshinweise]
|
||||||
|
- **Thermal**: [Wärmeableitung, Thermal Vias, etc.]
|
||||||
|
- **EMV**: [Schirmung, Filterung, etc.]
|
||||||
|
|
||||||
|
### Verwendung
|
||||||
|
- **Anwendungen**: [Typische Einsatzgebiete]
|
||||||
|
- **Referenz-Design**: [Link zu Beispielschaltung]
|
||||||
|
- **Ähnliche Komponenten**: [Alternative/kompatible Teile]
|
||||||
|
|
||||||
|
### Testing
|
||||||
|
- **ERC**: ✅/❌ [Elektrische Regelprüfung]
|
||||||
|
- **DRC**: ✅/❌ [Design-Regelprüfung]
|
||||||
|
- **3D-Ansicht**: ✅/❌ [3D-Darstellung korrekt]
|
||||||
|
- **Prototyp**: ✅/❌ [Realer Test durchgeführt]
|
||||||
|
- **Produktion**: ✅/❌ [In Produktion verwendet]
|
||||||
|
|
||||||
|
### Changelog
|
||||||
|
| Datum | Version | Änderung | Grund |
|
||||||
|
|-------|---------|----------|-------|
|
||||||
|
| YYYY-MM-DD | v1.0 | Erstellt | Initial |
|
||||||
|
|
||||||
|
### Links
|
||||||
|
- [Datenblatt]([URL])
|
||||||
|
- [Hersteller-Seite]([URL])
|
||||||
|
- [Distributor]([URL])
|
||||||
|
- [Reference Design]([URL])
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Beispiel: TPS54340
|
||||||
|
|
||||||
|
### Grundinformationen
|
||||||
|
- **Partnumber**: TPS54340DDAR
|
||||||
|
- **Hersteller**: Texas Instruments
|
||||||
|
- **Kategorie**: Power
|
||||||
|
- **Package**: HTSSOP-14 PowerPAD
|
||||||
|
- **Erstellt**: 2024-12-09
|
||||||
|
- **Ersteller**: Max Mustermann
|
||||||
|
- **Status**: Verified
|
||||||
|
|
||||||
|
### Dateien
|
||||||
|
- **Symbol**: `symbols/Power_Custom.kicad_sym` → `TPS54340_HTSSOP-14_PowerPAD`
|
||||||
|
- **Footprint**: `footprints/IC_Custom.pretty/HTSSOP-14_4.4x5mm_0.65mm_PowerPAD2.84x3.05mm.kicad_mod`
|
||||||
|
- **3D-Modell**: `3d_models/IC_Packages/HTSSOP-14_4.4x5mm_PowerPAD.step`
|
||||||
|
- **Datenblatt**: https://www.ti.com/lit/ds/symlink/tps54340.pdf
|
||||||
|
|
||||||
|
### Technische Daten
|
||||||
|
- **Versorgungsspannung**: 4.5V - 42V
|
||||||
|
- **Betriebstemperatur**: -40°C bis +125°C
|
||||||
|
- **Besondere Eigenschaften**: 3.5A Step-Down Converter, 570kHz
|
||||||
|
- **Pin-Count**: 14 (+ PowerPAD)
|
||||||
|
- **Gehäusegröße**: 4.4 x 5.0 x 1.0 mm
|
||||||
|
|
||||||
|
### Design Notes
|
||||||
|
- **Layout-Hinweise**: PowerPAD mit 9x 0.3mm Vias verbinden, kurze Verbindungen zu Input/Output-Caps
|
||||||
|
- **Bestückung**: Reflow-Löten, PowerPAD vor Bestückung verzinnen
|
||||||
|
- **Thermal**: PowerPAD für Wärmeableitung essential, min. 4-Layer PCB empfohlen
|
||||||
|
|
||||||
|
### Testing
|
||||||
|
- **ERC**: ✅ Keine Fehler
|
||||||
|
- **DRC**: ✅ Alle Regeln erfüllt
|
||||||
|
- **3D-Ansicht**: ✅ Korrekte Darstellung
|
||||||
|
- **Prototyp**: ✅ Erfolgreich getestet in 12V→3.3V Applikation
|
||||||
|
- **Produktion**: ✅ In 3 Projekten erfolgreich eingesetzt
|
||||||
|
|
@ -0,0 +1,224 @@
|
||||||
|
# Logo & Artwork Anleitung
|
||||||
|
|
||||||
|
Diese Anleitung beschreibt, wie Sie Logos und Artwork für Ihre KiCad-Bibliothek erstellen.
|
||||||
|
|
||||||
|
## 🎨 Logo-Erstellung für Silkscreen
|
||||||
|
|
||||||
|
### Vorbereitung
|
||||||
|
1. **Originalbild**: Hochauflösende Vektorgrafik (SVG) oder mindestens 300 DPI
|
||||||
|
2. **Vereinfachung**: Logo muss silkscreen-tauglich sein (keine feinen Details)
|
||||||
|
3. **Mindestgröße**: Linien mindestens 0.15mm breit
|
||||||
|
4. **Kontrast**: Schwarz-weiß, keine Graustufen
|
||||||
|
|
||||||
|
### Größenrichtlinien
|
||||||
|
- **Große Logos**: 10-15mm (Hauptlogo auf PCB)
|
||||||
|
- **Mittlere Logos**: 5-8mm (Seitlicher Branding)
|
||||||
|
- **Kleine Logos**: 2-4mm (Diskrete Kennzeichnung)
|
||||||
|
- **Mini-Logos**: 1-2mm (Nur einfache Symbole)
|
||||||
|
|
||||||
|
### Bitmap zu Footprint Konvertierung
|
||||||
|
|
||||||
|
#### Option 1: KiCad Bitmap2Component
|
||||||
|
1. KiCad → Tools → Bitmap to Component Converter
|
||||||
|
2. Bitmap laden (PNG, JPG)
|
||||||
|
3. Format: "Footprint" wählen
|
||||||
|
4. Negative ausgeben: Ja (für Silkscreen)
|
||||||
|
5. Board layer: F.SilkS oder B.SilkS
|
||||||
|
6. Threshold anpassen für saubere Konturen
|
||||||
|
7. Export als .kicad_mod
|
||||||
|
|
||||||
|
#### Option 2: SVG2Shenzhen Plugin
|
||||||
|
1. Inkscape mit svg2shenzhen Plugin
|
||||||
|
2. SVG mit definierten Layern erstellen
|
||||||
|
3. Export direkt zu KiCad Footprint
|
||||||
|
|
||||||
|
### CC-Lizenz Logos
|
||||||
|
|
||||||
|
#### Creative Commons BY-SA
|
||||||
|
```
|
||||||
|
Größen: 3mm, 5mm, 8mm, 10mm
|
||||||
|
Dateien:
|
||||||
|
- CC_BY-SA_3mm.kicad_mod
|
||||||
|
- CC_BY-SA_5mm.kicad_mod
|
||||||
|
- CC_BY-SA_8mm.kicad_mod
|
||||||
|
- CC_BY-SA_10mm.kicad_mod
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Creative Commons BY-NC-SA
|
||||||
|
```
|
||||||
|
Größen: 3mm, 5mm, 8mm, 10mm
|
||||||
|
Dateien:
|
||||||
|
- CC_BY-NC-SA_3mm.kicad_mod
|
||||||
|
- CC_BY-NC-SA_5mm.kicad_mod
|
||||||
|
- CC_BY-NC-SA_8mm.kicad_mod
|
||||||
|
- CC_BY-NC-SA_10mm.kicad_mod
|
||||||
|
```
|
||||||
|
|
||||||
|
### OSHW (Open Source Hardware) Logos
|
||||||
|
```
|
||||||
|
Varianten:
|
||||||
|
- OSHW_DE_3mm.kicad_mod (Deutschland)
|
||||||
|
- OSHW_US_3mm.kicad_mod (USA)
|
||||||
|
- OSHW_Generic_3mm.kicad_mod (Ohne Land)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📏 Technische Spezifikationen
|
||||||
|
|
||||||
|
### Silkscreen-Beschränkungen
|
||||||
|
- **Minimale Linienbreite**: 0.15mm (0.006")
|
||||||
|
- **Minimaler Text**: 0.8mm hoch, 0.15mm Strichbreite
|
||||||
|
- **Minimaler Abstand**: 0.1mm zwischen Elementen
|
||||||
|
- **Farben**: Nur eine Farbe pro Layer
|
||||||
|
|
||||||
|
### Footprint-Layer
|
||||||
|
- **F.SilkS**: Vordere Silkscreen-Schicht
|
||||||
|
- **B.SilkS**: Rückere Silkscreen-Schicht
|
||||||
|
- **F.Fab**: Fabrication-Layer (interne Dokumentation)
|
||||||
|
- **F.CrtYd**: Courtyard (Platzierungsbereich)
|
||||||
|
|
||||||
|
### Positionierung
|
||||||
|
- **Referenz**: Automatisch generiert, verschiebbar
|
||||||
|
- **Value**: Versteckt oder "LOGO" setzen
|
||||||
|
- **Courtyard**: 0.1mm um Logo-Kontur
|
||||||
|
|
||||||
|
## 🛠️ Workflow
|
||||||
|
|
||||||
|
### 1. Logo vorbereiten
|
||||||
|
```bash
|
||||||
|
# Bildbearbeitung (GIMP/Photoshop)
|
||||||
|
1. Logo öffnen
|
||||||
|
2. Auf 300 DPI skalieren
|
||||||
|
3. Schwarz-weiß konvertieren
|
||||||
|
4. Rauschen entfernen
|
||||||
|
5. Als PNG exportieren (schwarz auf weiß)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. In KiCad konvertieren
|
||||||
|
```
|
||||||
|
Bitmap2Component:
|
||||||
|
- Width: Zielbreite in mm
|
||||||
|
- Height: Automatisch berechnet
|
||||||
|
- Resolution: 300 DPI
|
||||||
|
- Format: Footprint
|
||||||
|
- Negative: Aktiviert
|
||||||
|
- Layers: F.SilkS
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Footprint nachbearbeiten
|
||||||
|
```
|
||||||
|
Im Footprint-Editor:
|
||||||
|
1. Unnötige Linien entfernen
|
||||||
|
2. Referenz positionieren
|
||||||
|
3. Courtyard hinzufügen
|
||||||
|
4. Eigenschaften setzen:
|
||||||
|
- Keywords: logo, artwork
|
||||||
|
- Description: "Company logo - [size]mm"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. In Bibliothek einordnen
|
||||||
|
```
|
||||||
|
Speichern unter:
|
||||||
|
footprints/Logos_Silkscreen.pretty/Logo_[Name]_[Size]mm.kicad_mod
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📁 Dateiorganisation
|
||||||
|
|
||||||
|
### Footprint-Namen
|
||||||
|
```
|
||||||
|
Logo_[Firmenname]_[Größe]mm.kicad_mod
|
||||||
|
Logo_[Firmenname]_[Größe]mm_[Variante].kicad_mod
|
||||||
|
|
||||||
|
Beispiele:
|
||||||
|
- Logo_MyCompany_10mm.kicad_mod
|
||||||
|
- Logo_MyCompany_5mm_Icon.kicad_mod
|
||||||
|
- Logo_Stadler_8mm_Text.kicad_mod
|
||||||
|
```
|
||||||
|
|
||||||
|
### CC-Lizenz Namen
|
||||||
|
```
|
||||||
|
CC_[Lizenz]_[Größe]mm.kicad_mod
|
||||||
|
|
||||||
|
Beispiele:
|
||||||
|
- CC_BY-SA_5mm.kicad_mod
|
||||||
|
- CC_BY-NC-SA_3mm.kicad_mod
|
||||||
|
```
|
||||||
|
|
||||||
|
### Quellmaterial
|
||||||
|
```
|
||||||
|
docs/logos/
|
||||||
|
├── source_images/
|
||||||
|
│ ├── company_logo.svg
|
||||||
|
│ ├── cc_by_sa.svg
|
||||||
|
│ └── oshw_logo.svg
|
||||||
|
├── processed/
|
||||||
|
│ ├── company_logo_10mm.png
|
||||||
|
│ ├── company_logo_5mm.png
|
||||||
|
│ └── ...
|
||||||
|
└── guidelines.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## ⚙️ Symbol-Erstellung für Logos
|
||||||
|
|
||||||
|
### Logo-Symbole
|
||||||
|
Manchmal sind Logo-Symbole nützlich für Schaltpläne:
|
||||||
|
|
||||||
|
```
|
||||||
|
Symbol-Name: LOGO_[Name]_[Typ]
|
||||||
|
Beispiel: LOGO_MyCompany_Silkscreen
|
||||||
|
|
||||||
|
Eigenschaften:
|
||||||
|
- Reference: #LOGO
|
||||||
|
- Value: Logo
|
||||||
|
- Footprint: Logos_Silkscreen:Logo_MyCompany_5mm
|
||||||
|
- No Pin: Aktiviert (graphisches Symbol)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Symbol-Bibliothek
|
||||||
|
Speichern in: `symbols/Logos_Artwork.kicad_sym`
|
||||||
|
|
||||||
|
## 🎯 Best Practices
|
||||||
|
|
||||||
|
### Design-Richtlinien
|
||||||
|
1. **Einfachheit**: Details, die kleiner als 0.2mm sind, entfernen
|
||||||
|
2. **Kontrast**: Starker Schwarz-weiß-Kontrast
|
||||||
|
3. **Skalierbarkeit**: Logo muss in verschiedenen Größen funktionieren
|
||||||
|
4. **Lesbarkeit**: Text ab 1mm Höhe lesbar
|
||||||
|
|
||||||
|
### Qualitätskontrolle
|
||||||
|
- [ ] 3D-Ansicht prüfen
|
||||||
|
- [ ] Verschiedene Zoom-Stufen testen
|
||||||
|
- [ ] Gerber-Viewer verwenden
|
||||||
|
- [ ] Probedruck auf Transparent-Folie
|
||||||
|
|
||||||
|
### Rechtliche Aspekte
|
||||||
|
1. **Eigene Logos**: Frei verwendbar
|
||||||
|
2. **Lizenz-Logos**: Nutzungsbedingungen beachten
|
||||||
|
3. **Fremde Marken**: Nur mit Erlaubnis
|
||||||
|
4. **Standards**: OSHW-Logo korrekt verwenden
|
||||||
|
|
||||||
|
## 📋 Checkliste
|
||||||
|
|
||||||
|
### Vor der Erstellung
|
||||||
|
- [ ] Logo-Rechte geklärt
|
||||||
|
- [ ] Zielgrößen definiert
|
||||||
|
- [ ] Qualität des Quellmaterials geprüft
|
||||||
|
|
||||||
|
### Nach der Erstellung
|
||||||
|
- [ ] Mindestlinienbreite eingehalten (0.15mm)
|
||||||
|
- [ ] 3D-Ansicht kontrolliert
|
||||||
|
- [ ] Verschiedene Größen getestet
|
||||||
|
- [ ] Dokumentation aktualisiert
|
||||||
|
- [ ] In Git committed
|
||||||
|
|
||||||
|
### Vor Produktion
|
||||||
|
- [ ] Gerber-Files geprüft
|
||||||
|
- [ ] Silkscreen-Preview angeschaut
|
||||||
|
- [ ] Bei Unklarheit: Prototyp bestellen
|
||||||
|
|
||||||
|
## 🔗 Nützliche Links
|
||||||
|
|
||||||
|
- [KiCad Bitmap2Component Tutorial](https://docs.kicad.org/8.0/en/bitmap2component/bitmap2component.html)
|
||||||
|
- [svg2shenzhen Plugin](https://github.com/badgeek/svg2shenzhen)
|
||||||
|
- [Creative Commons Logos](https://creativecommons.org/about/downloads/)
|
||||||
|
- [OSHW Logo Guidelines](https://www.oshwa.org/open-source-hardware-logo/)
|
||||||
|
- [PCB Silkscreen Guidelines](https://www.pcbway.com/pcb_prototype/What_is_Silkscreen_in_PCB.html)
|
||||||
|
|
@ -0,0 +1,237 @@
|
||||||
|
# Standard Components with LCSC Integration
|
||||||
|
|
||||||
|
This guide describes the system for standard passive components (R, C, L) and common ICs with LCSC part numbers.
|
||||||
|
|
||||||
|
## 🎯 Objectives
|
||||||
|
|
||||||
|
- **Consistent assembly**: Always use the same, well-available parts
|
||||||
|
- **Cost optimization**: LCSC Basic Parts for low costs
|
||||||
|
- **Automation**: Direct BOM generation for JLCPCB/LCSC
|
||||||
|
- **Standardization**: Fixed value series for all projects
|
||||||
|
|
||||||
|
## 📊 Standard Component Categories
|
||||||
|
|
||||||
|
### Standard Passives (R/C/L)
|
||||||
|
- **Purpose**: Cost-optimized standard values with LCSC numbers
|
||||||
|
- **Footprints**: Use existing KiCad footprints (Resistor_SMD, Capacitor_SMD, Inductor_SMD)
|
||||||
|
- **Symbols**: Custom symbols with complete LCSC data
|
||||||
|
- **Examples**: `100nF_0603_C14663`, `10k_0603_C25804`, `100uH_0805_C1046`
|
||||||
|
|
||||||
|
### Standard ICs
|
||||||
|
- **Purpose**: Common ICs with LCSC numbers for automated assembly
|
||||||
|
- **Categories**:
|
||||||
|
- **CAN Controllers**: MCP2515, SN65HVD230
|
||||||
|
- **STM32 MCUs**: STM32F103C8T6, STM32F407VGT6
|
||||||
|
- **Voltage Regulators**: AMS1117-3.3, LM2596
|
||||||
|
- **Op-Amps**: LM358, LM324, TL074
|
||||||
|
- **Logic**: 74HC595, 74HC4051
|
||||||
|
- **Interface**: FT232RL, CH340G
|
||||||
|
- **Footprints**: Use existing KiCad footprints (Package_SO, Package_QFP, etc.)
|
||||||
|
|
||||||
|
## 🏷️ Naming Convention
|
||||||
|
|
||||||
|
### Symbol Names
|
||||||
|
```
|
||||||
|
Standard Passives: [Value]_[Package]_[LCSC]
|
||||||
|
Standard ICs: [Partnumber]_[Package]_[LCSC]
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
100nF_0603_C14663
|
||||||
|
10k_0603_C25804
|
||||||
|
1uF_0805_C28323
|
||||||
|
STM32F103C8T6_LQFP-48_C8734
|
||||||
|
MCP2515_SOIC-18_C55199
|
||||||
|
AMS1117-3.3_SOT-223_C6186
|
||||||
|
```
|
||||||
|
|
||||||
|
### Symbol Properties
|
||||||
|
```
|
||||||
|
Reference: R?, C?, L?, U?
|
||||||
|
Value: [Value] (e.g. "100nF", "10k", "STM32F103C8T6")
|
||||||
|
Footprint: [KiCad_Library]:[Standard_Footprint]
|
||||||
|
Examples:
|
||||||
|
- Resistor_SMD:R_0603_1608Metric
|
||||||
|
- Capacitor_SMD:C_0603_1608Metric
|
||||||
|
- Package_SO:SOIC-18W_7.5x11.6mm_P1.27mm
|
||||||
|
- Package_QFP:LQFP-48_7x7mm_P0.5mm
|
||||||
|
Datasheet: [LCSC-URL]
|
||||||
|
Description: [Full specification]
|
||||||
|
LCSC: [C-Number]
|
||||||
|
Manufacturer: [Manufacturer name]
|
||||||
|
MPN: [Manufacturer Part Number]
|
||||||
|
Package: [0603/SOIC-18/LQFP-48/etc.]
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📋 LCSC Basic Parts Database
|
||||||
|
|
||||||
|
### Resistors (UniOhm Thick Film, 1%)
|
||||||
|
| Value | Package | LCSC | MPN | Description | Price@1k |
|
||||||
|
|-------|---------|------|-----|-------------|----------|
|
||||||
|
| 0R | 0603 | C21189 | 0603WAF0000T5E | Res 0R 1/10W 0603 | $0.002 |
|
||||||
|
| 10R | 0603 | C22859 | 0603WAF100JT5E | Res 10R 1% 1/10W 0603 | $0.002 |
|
||||||
|
| 100R | 0603 | C22775 | 0603WAF1000T5E | Res 100R 1% 1/10W 0603 | $0.002 |
|
||||||
|
| 1k | 0603 | C21190 | 0603WAF1001T5E | Res 1k 1% 1/10W 0603 | $0.002 |
|
||||||
|
| 10k | 0603 | C25804 | 0603WAF1002T5E | Res 10k 1% 1/10W 0603 | $0.002 |
|
||||||
|
| 100k | 0603 | C25803 | 0603WAF1003T5E | Res 100k 1% 1/10W 0603 | $0.002 |
|
||||||
|
|
||||||
|
### Capacitors (Samsung CL Series, X7R, 50V)
|
||||||
|
| Value | Package | LCSC | MPN | Description | Price@1k |
|
||||||
|
|-------|---------|------|-----|-------------|----------|
|
||||||
|
| 100pF | 0603 | C1524 | CL10B101KB8NNNC | Cap 100pF 50V X7R 0603 | $0.002 |
|
||||||
|
| 1nF | 0603 | C1523 | CL10B102KB8NNNC | Cap 1nF 50V X7R 0603 | $0.002 |
|
||||||
|
| 10nF | 0603 | C57112 | CL10B103KB8NNNC | Cap 10nF 50V X7R 0603 | $0.003 |
|
||||||
|
| 100nF | 0603 | C14663 | CL10B104KB8NNNC | Cap 100nF 50V X7R 0603 | $0.003 |
|
||||||
|
| 1µF | 0603 | C15849 | CL10A105KA8NNNC | Cap 1µF 25V X5R 0603 | $0.004 |
|
||||||
|
| 10µF | 0805 | C15850 | CL21A106KAQNNNE | Cap 10µF 25V X5R 0805 | $0.008 |
|
||||||
|
|
||||||
|
### Standard ICs (LCSC Basic Parts)
|
||||||
|
| Component | Package | LCSC | MPN | Description | Price@1k |
|
||||||
|
|-----------|---------|------|-----|-------------|----------|
|
||||||
|
| STM32F103C8T6 | LQFP-48 | C8734 | STM32F103C8T6 | MCU 32-bit ARM Cortex M3 | $2.89 |
|
||||||
|
| MCP2515 | SOIC-18 | C55199 | MCP2515-I/SO | CAN Controller | $1.67 |
|
||||||
|
| SN65HVD230 | SOIC-8 | C12084 | SN65HVD230DR | CAN Transceiver | $0.39 |
|
||||||
|
| AMS1117-3.3 | SOT-223 | C6186 | AMS1117-3.3 | LDO 3.3V 1A | $0.11 |
|
||||||
|
| LM358 | SOIC-8 | C7950 | LM358DR | Dual Op-Amp | $0.11 |
|
||||||
|
| 74HC595 | SOIC-16 | C5947 | 74HC595D | 8-bit Shift Register | $0.15 |
|
||||||
|
| FT232RL | SSOP-28 | C8690 | FT232RL | USB to Serial | $3.45 |
|
||||||
|
|
||||||
|
## 🗂️ Library Structure
|
||||||
|
|
||||||
|
### Symbol Libraries
|
||||||
|
```
|
||||||
|
symbols/
|
||||||
|
├── Standard_Passives.kicad_sym
|
||||||
|
│ ├── Resistors/
|
||||||
|
│ │ ├── 10R_0603_C22859
|
||||||
|
│ │ ├── 100R_0603_C22775
|
||||||
|
│ │ ├── 1k_0603_C21190
|
||||||
|
│ │ └── ...
|
||||||
|
│ ├── Capacitors/
|
||||||
|
│ │ ├── 100nF_0603_C14663
|
||||||
|
│ │ ├── 1uF_0603_C15849
|
||||||
|
│ │ └── ...
|
||||||
|
│ └── Inductors/
|
||||||
|
│ ├── 100nH_0603_C1588
|
||||||
|
│ └── ...
|
||||||
|
└── Standard_ICs.kicad_sym
|
||||||
|
├── Microcontrollers/
|
||||||
|
│ ├── STM32F103C8T6_LQFP-48_C8734
|
||||||
|
│ └── ...
|
||||||
|
├── CAN/
|
||||||
|
│ ├── MCP2515_SOIC-18_C55199
|
||||||
|
│ ├── SN65HVD230_SOIC-8_C12084
|
||||||
|
│ └── ...
|
||||||
|
└── Power/
|
||||||
|
├── AMS1117-3.3_SOT-223_C6186
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
|
|
||||||
|
### Footprint Mapping
|
||||||
|
**Standard components use existing KiCad footprints:**
|
||||||
|
|
||||||
|
```
|
||||||
|
Resistors → Resistor_SMD:R_[Package]_[Metric]
|
||||||
|
Capacitors → Capacitor_SMD:C_[Package]_[Metric]
|
||||||
|
Inductors → Inductor_SMD:L_[Package]_[Metric]
|
||||||
|
|
||||||
|
ICs → Package_SO:SOIC-[pins]...
|
||||||
|
Package_QFP:LQFP-[pins]...
|
||||||
|
Package_TO_SOT_SMD:SOT-223...
|
||||||
|
etc.
|
||||||
|
```
|
||||||
|
|
||||||
|
## ⚙️ Workflow
|
||||||
|
|
||||||
|
### Adding New Standard Component
|
||||||
|
|
||||||
|
#### 1. Research Phase
|
||||||
|
```bash
|
||||||
|
# Check if component exists in KiCad
|
||||||
|
1. Open KiCad Symbol Editor
|
||||||
|
2. Search for component in standard libraries
|
||||||
|
3. If exists: Note library and symbol name
|
||||||
|
4. If not exists: Create custom symbol
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. LCSC Lookup
|
||||||
|
```bash
|
||||||
|
# Find LCSC part number
|
||||||
|
1. Search component on lcsc.com
|
||||||
|
2. Check if it's a "Basic Part" (lower cost)
|
||||||
|
3. Verify stock status and pricing
|
||||||
|
4. Note: LCSC#, Manufacturer, MPN
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. Symbol Creation
|
||||||
|
```bash
|
||||||
|
# Create symbol with LCSC data
|
||||||
|
1. Use existing KiCad symbol as template (if available)
|
||||||
|
2. Add LCSC properties:
|
||||||
|
- LCSC: C-Number
|
||||||
|
- Manufacturer: Company name
|
||||||
|
- MPN: Manufacturer Part Number
|
||||||
|
3. Set footprint to standard KiCad footprint
|
||||||
|
4. Add datasheet URL
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. Testing
|
||||||
|
```bash
|
||||||
|
# Verify in test circuit
|
||||||
|
1. Create test schematic
|
||||||
|
2. Run ERC (Electrical Rules Check)
|
||||||
|
3. Create test PCB
|
||||||
|
4. Run DRC (Design Rules Check)
|
||||||
|
5. Check 3D view
|
||||||
|
```
|
||||||
|
|
||||||
|
### BOM Generation for JLCPCB
|
||||||
|
|
||||||
|
#### Export Format
|
||||||
|
```csv
|
||||||
|
Comment,Designator,Footprint,LCSC,Manufacturer,MPN
|
||||||
|
100nF,C1;C2;C5,C_0603_1608Metric,C14663,Samsung,CL10B104KB8NNNC
|
||||||
|
10k,R1;R3;R7,R_0603_1608Metric,C25804,UniOhm,0603WAF1002T5E
|
||||||
|
STM32F103C8T6,U1,LQFP-48_7x7mm_P0.5mm,C8734,STMicroelectronics,STM32F103C8T6
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 Best Practices
|
||||||
|
|
||||||
|
### Component Selection Strategy
|
||||||
|
1. **Always check LCSC first**: Use Basic Parts when possible
|
||||||
|
2. **Standardize values**: Prefer E24 series for resistors
|
||||||
|
3. **Package consistency**: Use 0603 for most passives
|
||||||
|
4. **Verify availability**: Check stock before committing to design
|
||||||
|
|
||||||
|
### Cost Optimization
|
||||||
|
| Strategy | Savings | Implementation |
|
||||||
|
|----------|---------|----------------|
|
||||||
|
| Basic Parts only | 50-80% | Use LCSC Basic Parts database |
|
||||||
|
| Standard packages | 20-30% | Stick to 0603, SOIC, QFP |
|
||||||
|
| Volume planning | 10-20% | Order 1000+ pieces |
|
||||||
|
| Setup minimization | $2-5 per unique part | Reuse same values |
|
||||||
|
|
||||||
|
### Design Guidelines
|
||||||
|
- **0603 preferred**: Good balance of size/handling
|
||||||
|
- **Basic Parts first**: Always check Basic Parts availability
|
||||||
|
- **Standard values**: E24 series for resistors, E6 for capacitors
|
||||||
|
- **Safety margins**: +20% on critical values
|
||||||
|
|
||||||
|
## 🔄 Maintenance
|
||||||
|
|
||||||
|
### Regular Updates
|
||||||
|
1. **Monthly**: Check LCSC availability and pricing
|
||||||
|
2. **Quarterly**: Update Basic Parts list
|
||||||
|
3. **Per project**: Verify all parts in stock before ordering
|
||||||
|
4. **KiCad updates**: Test footprint compatibility
|
||||||
|
|
||||||
|
### Version Control
|
||||||
|
```bash
|
||||||
|
# Git workflow
|
||||||
|
git add symbols/Standard_*.kicad_sym
|
||||||
|
git commit -m "feat: add STM32F407 with LCSC C13303"
|
||||||
|
git tag -a v1.2.0 -m "Standard ICs v1.2.0"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*This document is regularly synchronized with current LCSC data.*
|
||||||
|
|
@ -0,0 +1,306 @@
|
||||||
|
# Standard-Passivbauteile mit LCSC-Integration
|
||||||
|
|
||||||
|
Diese Anleitung beschreibt das System für Standard-Passivbauteile (R, C, L) mit LCSC-Bestellnummern.
|
||||||
|
|
||||||
|
## 🎯 Zielsetzung
|
||||||
|
|
||||||
|
- **Einheitliche Bestückung**: Immer die gleichen, gut verfügbaren Teile verwenden
|
||||||
|
- **Kostenoptimierung**: LCSC Basic Parts für niedrige Kosten
|
||||||
|
- **Automatisierung**: Direkte BOM-Generierung für JLCPCB/LCSC
|
||||||
|
- **Standardisierung**: Feste Werte-Reihen für alle Projekte
|
||||||
|
|
||||||
|
## 📊 Standard-Werte-Reihen
|
||||||
|
|
||||||
|
### Kondensatoren (Keramik, X7R, 50V)
|
||||||
|
```
|
||||||
|
Übliche Werte:
|
||||||
|
100pF, 220pF, 470pF, 1nF, 2.2nF, 4.7nF, 10nF, 22nF, 47nF, 100nF, 220nF, 470nF, 1µF, 2.2µF, 4.7µF, 10µF, 22µF, 47µF, 100µF
|
||||||
|
|
||||||
|
Packages:
|
||||||
|
0402: 100pF - 1µF
|
||||||
|
0603: 100pF - 10µF
|
||||||
|
0805: 100pF - 22µF
|
||||||
|
1206: 100pF - 47µF
|
||||||
|
```
|
||||||
|
|
||||||
|
### Widerstände (Dickschicht, 1%, 1/16W-1/4W)
|
||||||
|
```
|
||||||
|
E24-Reihe bevorzugt:
|
||||||
|
1.0, 1.1, 1.2, 1.3, 1.5, 1.6, 1.8, 2.0, 2.2, 2.4, 2.7, 3.0, 3.3, 3.6, 3.9, 4.3, 4.7, 5.1, 5.6, 6.2, 6.8, 7.5, 8.2, 9.1
|
||||||
|
|
||||||
|
Dekaden: 1Ω - 10MΩ
|
||||||
|
|
||||||
|
Packages:
|
||||||
|
0402: 1Ω - 1MΩ
|
||||||
|
0603: 1Ω - 10MΩ
|
||||||
|
0805: 1Ω - 10MΩ
|
||||||
|
1206: 1Ω - 10MΩ
|
||||||
|
```
|
||||||
|
|
||||||
|
### Induktivitäten (Ferrit, 20%)
|
||||||
|
```
|
||||||
|
Übliche Werte:
|
||||||
|
10nH, 22nH, 47nH, 100nH, 220nH, 470nH, 1µH, 2.2µH, 4.7µH, 10µH, 22µH, 47µH, 100µH, 220µH, 470µH, 1mH
|
||||||
|
|
||||||
|
Packages:
|
||||||
|
0402: 1nH - 47nH (HF)
|
||||||
|
0603: 10nH - 470nH
|
||||||
|
0805: 100nH - 10µH
|
||||||
|
1206: 470nH - 1mH
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🏷️ Naming Convention
|
||||||
|
|
||||||
|
|||||||