# BoardPilot: vedi dentro la tua scheda > L’app desktop per macOS e Windows che ho progettato e sviluppato: misura i pin reali di ESP32, Raspberry Pi Pico, Arduino, STM32, nRF52 e Teensy, trova gli errori di cablaggio e mostra ogni pin, filo e transazione sul bus su una scheda 3D dal vivo. - URL: https://mojtabaamini.com/projects/boardpilot - Language: it - Author: Mojtaba Amini, AI Software Engineer (Verona, Italy) - Details: Prodotto · Set 2026 — oggi · Verona ## Il problema che risolve Quasi sempre “il sensore non funziona” è un problema di cablaggio: SDA e SCL invertiti, una massa mancante, un modulo a 5 V su un pin a 3,3 V, un LED su un pin di solo ingresso, un pin di strapping che impedisce l’avvio. BoardPilot non tira a indovinare: misura, mostra e spiega. BoardPilot trova SDA e SCL invertiti su un BME280 collegato a un ESP32: il filo sbagliato è evidenziato sulla scheda 3D, con le misure che lo dimostrano. 1. **Misura**: Un piccolo firmware diagnostico legge i pin reali: pull-up, scansione I2C, test di scambio SDA/SCL, registro ID del chip (distingue un BMP280 da un BME280), brownout e baud rate. 2. **Mostra**: Il risultato compare su un modello 3D della scheda generato dai suoi dati: ogni pin è un oggetto cliccabile e ogni riga del log porta la camera sul pin o sul filo di cui parla. 3. **Spiega**: La causa in parole semplici, con le misure e la sezione del datasheet dietro ogni affermazione, e cosa fare dopo. ## Cosa fa - **Debug guidato**: procedure passo passo per sensore che non risponde, scheda non rilevata, riavvii continui e caratteri illeggibili sulla seriale. Rileva da sola scheda, chip, flash e convertitore USB, e chiede solo ciò che non può vedere. - **Test hardware**: griglia degli indirizzi I2C, schema del bus e transazioni decodificate bit per bit, test di GPIO e ADC. - **Monitor**: console seriale, grafici dal vivo colorati per pin, registrazione in CSV, heap e stack del firmware. - **Progetto in 3D**: parti da una libreria di oltre 380 componenti, fili, regole di cablaggio che segnalano gli errori mentre disegni, pianificatore dei pin, lista della spesa, schema di cablaggio in SVG e controllo del codice Arduino contro il disegno. - **Flash sicuro**: sola lettura finché non confermi; prima della prima scrittura il firmware viene salvato e torna con un clic, e un controllo preliminare verifica che il file sia fatto per quella scheda. - **Template e lezioni**: cinque progetti pronti che si costruiscono su qualsiasi scheda, una vista di esecuzione dal vivo nel simulatore e undici lezioni interattive di embedded. - **Report**: la sessione in Markdown e PDF, con schema e snapshot 3D. Test hardware: griglia I2C e transazione decodificata bit per bit. Monitor: valori dal vivo per pin, console seriale e memoria. Libreria parti: aggiungi e collega le parti in 3D, le regole segnalano gli errori. Collega e identifica: chip, flash e convertitore USB rilevati in automatico. ## 13 schede supportate Nessuna scheda è scritta nel codice: ogni scheda è un file di dati con pin, funzioni, regole, toolchain e fonti, validato automaticamente. Il modello 3D e le regole nascono da quel file. - **ESP32**: ESP32 DevKit (30 pin), ESP32-S3-DevKitC-1, ESP32-C3-DevKitM-1 · esptool - **Raspberry Pi**: Pico, Pico W (RP2040), Pico 2 (RP2350) · picotool / UF2 - **Arduino (AVR)**: Uno R3, Nano, Mega 2560 · avrdude - **STM32**: NUCLEO-F401RE, Black Pill F411CE · STM32CubeProgrammer, stlink o dfu-util - **Nordic e Teensy**: nRF52840 DK · nrfjprog; Teensy 4.1 · Teensy Loader ## Una libreria di parti aperta Oltre 380 sensori, display, driver, radio e moduli, ciascuno con pin e ruoli, tensione, indirizzi I2C, registro ID del chip, forma 3D e fonti. I dati sono liberi sotto licenza CC BY 4.0, e il sito genera una pagina per ogni parte, un pinout per ogni scheda e guide di collegamento parte per scheda, in inglese e in italiano. ## AI onesta, anche per gli agenti - **Assistente opzionale** con Claude, GPT o Gemini, con la tua chiave salvata cifrata sul computer. Afferma solo ciò che ha misurato, etichetta le ipotesi come suggerimenti e cita le fonti. - **Server MCP**: agenti di programmazione come Claude Code, Cursor e Claude Desktop usano la scheda vera attraverso BoardPilot. Ogni risultato riporta la sua provenienza e nessuna scrittura avviene senza il clic dell’utente. ## Come è costruito - **App desktop**: Electron, React e TypeScript in modalità strict, stato con Zustand; il renderer non tocca mai porte seriali, file o chiavi API. - **3D**: three.js con React Three Fiber; la scheda è generata dal file di dati, pin per pin. - **Hardware**: serialport ed esptool, avrdude, picotool, STM32CubeProgrammer, nrfjprog e Teensy Loader, dietro un’unica interfaccia con timeout ed errori in linguaggio semplice. - **Firmware**: un agente diagnostico in C++ compilato per tutte le 13 schede e la libreria BoardPilotProbe, entrambi con licenza MIT. - **Simulatore**: un driver simulato con la stessa interfaccia di quello reale e scenari di guasto, così l’app funziona e si prova anche senza hardware. - **Qualità**: 2.335 test automatici (Vitest) su regole di cablaggio, protocolli, flussi e dati delle schede, CI e release per macOS e Windows con GitHub Actions; interfaccia in inglese e italiano, verificata dai test. ## Cosa dimostra, per la tua azienda BoardPilot unisce le due metà del mio lavoro: firmware e hardware da un lato, software e AI dall’altro. Le stesse competenze servono per acquisire dati affidabili dai tuoi dispositivi e costruirci sopra strumenti e modelli. - [Sistemi embedded, IoT e acquisizione dati](https://mojtabaamini.com/servizi/sistemi-embedded-iot) (Embedded e IoT): Firmware C/C++, sensori, CAN bus e telemetria, fino ai modelli AI sui dati raccolti. - [Chatbot aziendale e assistenti AI](https://mojtabaamini.com/servizi/chatbot-aziendale) (LLM e RAG): Assistenti LLM che rispondono da manuali e procedure, citando le fonti. ## Domande frequenti **Chi ha sviluppato BoardPilot?** L’ho progettato e sviluppato io, Mojtaba Amini, AI Software Engineer a Verona: prodotto, app desktop, firmware diagnostico, libreria di parti e sito. **Serve una scheda per provarlo?** No: la modalità simulatore fa girare tutta l’app senza hardware. Per le schede vere basta collegarle via USB. **È gratuito?** Si prova gratis per 30 giorni, poi serve una licenza. Il codice è pubblico (source-available), il firmware è sotto licenza MIT e i dati della libreria di parti sotto CC BY 4.0. **Su quali sistemi funziona?** macOS (Apple Silicon e Intel) e Windows, in inglese e in italiano. ## Parliamo del tuo progetto Raccontami il processo che vuoi migliorare: ti rispondo con una prima valutazione di dove l'AI può aiutare e da dove partire.