[Open Source] KiCadGen: librerie KiCad generate in automatico da datasheet e fotografie

[Mirko.Ugolini]

Quante volte vi è capitato di dover disegnare a mano footprint, simbolo e modello 3D per una breakout board senza librerie o per un componente SMD poco diffuso? Per togliermi questo lavoro ho scritto KiCadGen, uno strumento open source che genera in automatico i file .kicad_mod, .kicad_sym e .step partendo da una foto dall'alto e dai documenti del componente: datasheet, disegni quotati, pinout.

Come funziona

 

1. Visione artificiale in locale, senza costi

OpenCV calibra la scala della foto scattata dall'alto usando le dimensioni reali della scheda.
Un rilevatore YOLO individua i corpi dei componenti.
Una piccola rete neurale locale riconosce le forme dei package SMD standard.
Tutti i modelli girano in locale in formato ONNX e sono inclusi nel setup.

2. Interrogazioni AI mirate

I modelli di visione (via OpenRouter o con le API dirette di DeepSeek) vengono interpellati solo per ciò che serve: leggere pinout, datasheet e quote, o le zone della scheda che l'analisi locale non risolve. Non si spediscono immagini intere a ogni chiamata.
Il costo di ogni chiamata viene registrato e mostrato, separato per fornitore.
Per ogni passo dell'analisi si può scegliere il modello da usare.

3. Geometria deterministica, con controlli

I dati letti diventano misure in millimetri tramite regole deterministiche, non tramite la «fantasia» del modello.
Le posizioni dei pad lette dall'AI vengono confrontate con i fori disegnati nel disegno quotato.
Quando i documenti non bastano, il programma fa una domanda precisa invece di inventare. I valori stimati vengono segnalati come tali.
FreeCAD genera il modello STEP e riusa le primitive 3D di KiCad quando le dimensioni coincidono.

4. Integrazione con KiCad

Il componente si prova prima in un progetto temporaneo isolato, aperto nel PCB Editor.
Poi si installa nella libreria del progetto (percorsi con ${KIPRJMOD}, quindi portabile) o in una libreria globale, con backup e ripristino automatico in caso di errore.
I controlli sulle convenzioni delle librerie KiCad (KLC) segnalano errori e avvisi, con il rimedio.
Simbolo e footprint si ritoccano in editor integrati: pad, serigrafia, quote, layer.
Scheda tecnica

Licenza: AGPL-3.0
Piattaforma: Windows, file nei formati di KiCad 10
Python: 3.11 o superiore (la build di rilascio usa la 3.13)
Dipendenze: OpenCV e ONNX Runtime; FreeCAD facoltativo, solo per i modelli STEP
AI: una chiave OpenRouter o DeepSeek, conservata nel Gestore credenziali di Windows e mai in un file
Interfaccia: italiano, inglese, francese e tedesco, con guida d'uso nelle quattro lingue

Link

Repository: https://github.com/MirkoUgoliniDev/KiCad-ComponentGenerator
Installer per Windows e release: https://github.com/MirkoUgoliniDev/KiCad-ComponentGenerator/releases

Chi preferisce partire dai sorgenti o costruire il pacchetto da sé trova lo script scripts/build-windows.ps1 (Python + WiX).

 

Commenti, segnalazioni e pull request sono benvenuti. Mi interessano soprattutto i datasheet "difficili": disegni con quote insolite, pinout ambigui, package fuori standard. Sono il modo migliore per rendere lo strumento più robusto.