BoardPilot: vedi dentro la tua scheda

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.

1. MisuraUn 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. MostraIl 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. SpiegaLa 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.

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.

Domande frequenti