feat: focus library on custom components only

- Remove all JLCPCB/LCSC related files and documentation
- Clean up README files to focus on custom components not in standard library
- Translate CHANGELOG to English
- Add .gitkeep files to preserve directory structure
- Library now focused on: missing 3D models, custom artwork, personal logos
This commit is contained in:
Eduard Iten 2025-12-09 15:16:14 +01:00
parent dda87cfbae
commit 5bffe55486
21 changed files with 56 additions and 2634 deletions

View File

@ -0,0 +1,2 @@
# This file ensures the 3d_models/Connectors/ directory is tracked by git
# Place connector 3D models (.step/.wrl) here

View File

@ -0,0 +1,2 @@
# This file ensures the 3d_models/IC_Packages/ directory is tracked by git
# Place IC package 3D models (.step/.wrl) here

View File

@ -0,0 +1,2 @@
# This file ensures the 3d_models/Mechanical/ directory is tracked by git
# Place mechanical component 3D models (.step/.wrl) here

View File

@ -1,47 +1,47 @@
# Changelog # Changelog
Alle wichtigen Änderungen an dieser Bibliothek werden in dieser Datei dokumentiert. All notable changes to this library will be documented in this file.
Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/), The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
und dieses Projekt folgt der [Semantischen Versionierung](https://semver.org/lang/de/). and this project adheres to [Semantic Versioning](https://semver.org/).
## [Unreleased] ## [Unreleased]
### Geplant ### Planned
- Erste Sammlung von Power Management ICs - First collection of Power Management ICs
- USB-C Connector-Serie - USB-C Connector series
- Firmenlogo-Varianten für verschiedene Größen - Company logo variants for different sizes
## [1.0.0] - 2024-12-09 ## [1.0.0] - 2024-12-09
### Hinzugefügt ### Added
- Initiale Projektstruktur - Initial project structure
- README mit Naming Conventions - README with naming conventions
- .gitignore für KiCad-Dateien - .gitignore for KiCad files
- Changelog-Datei - Changelog file
- Ordnerstruktur für symbols/, footprints/, 3d_models/ - Folder structure for symbols/, footprints/, 3d_models/
### Geändert ### Changed
- Nichts (Erstversion) - Nothing (initial version)
### Entfernt ### Removed
- Nichts (Erstversion) - Nothing (initial version)
--- ---
## Template für neue Einträge ## Template for new entries
### Hinzugefügt ### Added
- Neue Symbole: [Liste] - New symbols: [List]
- Neue Footprints: [Liste] - New footprints: [List]
- Neue 3D-Modelle: [Liste] - New 3D models: [List]
### Geändert ### Changed
- Überarbeitete Symbole: [Liste mit Grund] - Updated symbols: [List with reason]
- Überarbeitete Footprints: [Liste mit Grund] - Updated footprints: [List with reason]
### Entfernt ### Removed
- Obsolete Komponenten: [Liste mit Grund] - Obsolete components: [List with reason]
### Behoben ### Fixed
- Bugfixes: [Liste] - Bugfixes: [List]

View File

@ -10,8 +10,6 @@ my-kicad-libs/
│ ├── Custom_Logic/ │ ├── Custom_Logic/
│ ├── Custom_Power/ │ ├── Custom_Power/
│ ├── Custom_Connectors/ │ ├── Custom_Connectors/
│ ├── Standard_Passives/ # Standard R/C/L mit LCSC
│ ├── Standard_ICs/ # CAN, STM32, Standard-ICs
│ ├── Logos_Artwork/ │ ├── Logos_Artwork/
│ └── ... │ └── ...
├── footprints/ # Footprint-Bibliotheken (.pretty) ├── footprints/ # Footprint-Bibliotheken (.pretty)
@ -42,13 +40,10 @@ my-kicad-libs/
### Einzelne Symbol-Namen (innerhalb der .kicad_sym) ### Einzelne Symbol-Namen (innerhalb der .kicad_sym)
- **Format**: `[Partnumber]_[Package]_[Variante]` - **Format**: `[Partnumber]_[Package]_[Variante]`
- **Format (Standard-Passives)**: `[Wert]_[Package]_[LCSC]`
- **Beispiele**: - **Beispiele**:
- `TPS54340_HTSSOP-14_PowerPAD` - `TPS54340_HTSSOP-14_PowerPAD`
- `STM32F407VGT6_LQFP-100` - `STM32F407VGT6_LQFP-100`
- `USB-C_16Pin_Receptacle` - `USB-C_16Pin_Receptacle`
- `100nF_0402_C1525` (Kondensator mit LCSC#)
- `10k_0603_C25804` (Widerstand mit LCSC#)
- `Logo_MyCompany_10mm` - `Logo_MyCompany_10mm`
### Footprints (.pretty Ordner) ### Footprints (.pretty Ordner)
@ -85,8 +80,7 @@ my-kicad-libs/
- `Logic_Custom` - Spezielle Logik-ICs - `Logic_Custom` - Spezielle Logik-ICs
- `MCU_Custom` - Mikrocontroller (spezielle) - `MCU_Custom` - Mikrocontroller (spezielle)
- `Memory_Custom` - Flash, EEPROM, RAM - `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 - `Power_Custom` - DC-DC, LDOs, Power Management
- `RF_Custom` - HF-Module, Antennen - `RF_Custom` - HF-Module, Antennen
- `Sensors_Custom` - Sensoren aller Art - `Sensors_Custom` - Sensoren aller Art
@ -238,8 +232,7 @@ footprints/
### Neue Komponente hinzufügen ### Neue Komponente hinzufügen
1. **Research**: Datenblatt studieren, ähnliche Komponenten prüfen 1. **Research**: Datenblatt studieren, ähnliche Komponenten prüfen
2. **LCSC-Check**: Bei Standard-Passivbauteilen LCSC-Verfügbarkeit prüfen 2. **Symbol erstellen**: In passende Kategorie-Datei
3. **Symbol erstellen**: In passende Kategorie-Datei
4. **Footprint erstellen**: In passenden .pretty Ordner 4. **Footprint erstellen**: In passenden .pretty Ordner
5. **3D-Modell**: Suchen oder erstellen 5. **3D-Modell**: Suchen oder erstellen
6. **Verknüpfung**: Symbol ↔ Footprint ↔ 3D-Modell 6. **Verknüpfung**: Symbol ↔ Footprint ↔ 3D-Modell

View File

@ -10,8 +10,6 @@ my-kicad-libs/
│ ├── Custom_Logic/ │ ├── Custom_Logic/
│ ├── Custom_Power/ │ ├── Custom_Power/
│ ├── Custom_Connectors/ │ ├── Custom_Connectors/
│ ├── Standard_Passives/ # Standard R/C/L with LCSC
│ ├── Standard_ICs/ # CAN, STM32, Standard ICs
│ ├── Logos_Artwork/ │ ├── Logos_Artwork/
│ └── ... │ └── ...
├── footprints/ # Footprint libraries (.pretty) ├── footprints/ # Footprint libraries (.pretty)
@ -38,21 +36,15 @@ my-kicad-libs/
- `Logic_TI_74HC.kicad_sym` - `Logic_TI_74HC.kicad_sym`
- `Power_LTC_Switching.kicad_sym` - `Power_LTC_Switching.kicad_sym`
- `Connectors_JST_XH.kicad_sym` - `Connectors_JST_XH.kicad_sym`
- `Standard_Passives.kicad_sym`
- `Standard_ICs.kicad_sym`
- `Logos_Personal.kicad_sym` - `Logos_Personal.kicad_sym`
### Individual Symbol Names (within .kicad_sym) ### Individual Symbol Names (within .kicad_sym)
- **Format**: `[Partnumber]_[Package]_[Variant]` - **Format**: `[Partnumber]_[Package]_[Variant]`
- **Format (Standard Passives)**: `[Value]_[Package]_[LCSC]`
- **Format (Standard ICs)**: `[Partnumber]_[Package]_[LCSC]`
- **Examples**: - **Examples**:
- `TPS54340_HTSSOP-14_PowerPAD` - `TPS54340_HTSSOP-14_PowerPAD`
- `STM32F407VGT6_LQFP-100` - `STM32F407VGT6_LQFP-100`
- `USB-C_16Pin_Receptacle` - `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` - `Logo_MyCompany_10mm`
### Footprints (.pretty folders) ### Footprints (.pretty folders)
@ -65,38 +57,21 @@ my-kicad-libs/
- `Logos_Silkscreen.pretty` - `Logos_Silkscreen.pretty`
- `Mechanical_Standoffs.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 ## ⚙️ Best Practices
### Standard Component Strategy ### Component Strategy
1. **Use KiCad footprints**: Don't reinvent the wheel for standard packages 1. **Use KiCad footprints**: Don't reinvent the wheel for standard packages
2. **LCSC integration**: Add LCSC numbers for cost optimization 2. **Consistent naming**: Follow established naming conventions
3. **Manufacturer data**: Include MPN and manufacturer in symbols 3. **Documentation**: Include manufacturer data and datasheets
4. **BOM automation**: Enable direct JLCPCB assembly integration 4. **Quality**: Test all components before adding to library
### Workflow ### Workflow
#### Adding New Standard Component #### Adding New Component
1. **Check KiCad**: Verify symbol/footprint don't exist in standard libraries 1. **Check KiCad**: Verify symbol/footprint don't exist in standard libraries
2. **LCSC lookup**: Find LCSC part number and basic part status 2. **Research**: Find datasheet and manufacturer information
3. **Create symbol**: With complete manufacturer data and LCSC number 3. **Create symbol**: With complete manufacturer data
4. **Link footprint**: Use existing KiCad footprint 4. **Link footprint**: Use existing KiCad footprint or create custom
5. **Test**: Use in test circuit 5. **Test**: Use in test circuit
6. **Document**: Add to documentation 6. **Document**: Add to documentation

2
datasheets/.gitkeep Normal file
View File

@ -0,0 +1,2 @@
# This file ensures the datasheets/ directory is tracked by git
# Place component datasheets (.pdf) here (optional)

View File

@ -1,61 +0,0 @@
# 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.

View File

@ -1,160 +0,0 @@
# 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*

View File

@ -1,153 +0,0 @@
# 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

View File

@ -1,108 +0,0 @@
# 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

View File

@ -1,224 +0,0 @@
# 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