ARUKU ACADEMY · KAIROS LAB
FRIDAY INSEGNA ESP32 & M5STACK
12 moduli · 60 lezioni accessibili · spiegazioni, esercitazioni e quiz
Percorso didattico in sviluppo. Gli esempi di collegamento richiedono sempre la verifica del pinout ufficiale.
Apri un modulo, poi una lezione
MODULO 1 — ELETTRONICA DI BASE: NUOVA VERSIONE
Lezioni complete con disegni di alimentazione, resistenza, LED, schema elettrico e spiegazioni passo passo.
MODULO 1 — VERSIONE ILLUSTRATA E INTERATTIVA
Le cinque lezioni complete del primo modulo sono disponibili nella nuova aula didattica, con spiegazioni, diagrammi, esercizi e quiz funzionanti.
MODULO 1 — Fondamenti e sicurezza · 5 lezioni
Lezione 1.1 — Microcontrollori
Microcontrollori
Un microcontrollore è un computer dedicato a un compito fisico: acquisisce segnali, li elabora e pilota uscite. ESP32 esegue continuamente il programma caricato nella memoria flash.
Laboratorio / esercizio: Disegna tre blocchi: sensore → ESP32 → indicatore. Descrivi il dato che passa tra ciascuno.
Verifica: Un microcontrollore può leggere un sensore e controllare un LED.
Lezione 1.2 — Architettura ESP32
Architettura ESP32
ESP32 indica una famiglia di chip, non un unico modello. CPU, RAM, radio, GPIO e periferiche variano fra ESP32, S3 e C3. Il firmware deve essere compilato per la scheda effettiva.
Laboratorio / esercizio: Apri la scheda tecnica di due modelli e confronta CPU, memoria e periferiche.
Verifica: Tutti i modelli ESP32 hanno identico pinout.
Lezione 1.3 — Famiglia M5Stack
Famiglia M5Stack
Core2, CoreS3, Atom e Cardputer combinano chip ESP32 e periferiche diverse. Display, sensori, tastiera, batteria e porte cambiano; anche le librerie possono richiedere versioni specifiche.
Laboratorio / esercizio: Scegli un dispositivo per un data logger tascabile e giustifica la scelta.
Verifica: La scelta della scheda dipende dalle periferiche richieste.
Lezione 1.4 — Componenti
Componenti
Una resistenza limita la corrente; un LED emette luce; un pulsante genera un ingresso; una breadboard consente prototipi. Con la legge di Ohm I=V/R, 2 V su 1000 Ω corrispondono a 2 mA.
Laboratorio / esercizio: Calcola la corrente per 3 V su 1500 Ω e verifica l’unità di misura.
Verifica: Un LED va sempre collegato senza limitazione di corrente.
Lezione 1.5 — Alimentazione sicura
Alimentazione sicura
Molti GPIO ESP32 utilizzano logica a 3,3 V e non devono ricevere direttamente 5 V. Prima di collegare dispositivi controlla tensione, polarità, massa comune e pin riservati. Le batterie al litio richiedono ricarica e protezione idonee.
Laboratorio / esercizio: Prepara una checklist con cinque verifiche prima dell’accensione.
Verifica: La tensione della porta USB coincide sempre con quella ammessa sui GPIO.
MODULO 2 — Hardware M5Stack · 5 lezioni
Lezione 2.1 — Core2
Core2
Core2 è un dispositivo con touchscreen e periferiche integrate. Prima di programmare identifica revisione hardware, chip, porte e libreria; non copiare pin da esempi destinati ad altre schede.
Laboratorio / esercizio: Individua nella documentazione display, IMU e connettori del tuo Core2.
Verifica: Il pinout di Core2 si può presumere uguale a qualsiasi ESP32.
Lezione 2.2 — CoreS3
CoreS3
CoreS3 utilizza un chip della famiglia ESP32-S3. Rispetto a Core2 cambiano hardware e alcune periferiche: scegli il target corretto in Arduino IDE e una versione compatibile di M5Unified.
Laboratorio / esercizio: Confronta le specifiche ufficiali di Core2 e CoreS3.
Verifica: Core2 e CoreS3 richiedono sempre lo stesso firmware binario.
Lezione 2.3 — Atom
Atom
La famiglia Atom privilegia dimensioni compatte. Le funzioni disponibili dipendono dal modello: alcuni dispositivi sono adatti a nodi sensore o trasmettitori, ma hanno interfacce limitate.
Laboratorio / esercizio: Disegna un nodo Atom con un sensore esterno e un collegamento dati.
Verifica: Le dimensioni ridotte eliminano la necessità di controllare alimentazione e GPIO.
Lezione 2.4 — StickC e Cardputer
StickC e Cardputer
StickC e Cardputer sono dispositivi portatili con interfacce differenti. Il Cardputer include una tastiera, utile per inserire parametri; StickC è adatto a visualizzazioni e controlli compatti.
Laboratorio / esercizio: Progetta un menu per impostare la frequenza di campionamento.
Verifica: Una tastiera integrata può essere utile per inserire configurazioni.
Lezione 2.5 — Grove
Grove
Grove identifica un sistema di connettori modulari. Un connettore compatibile meccanicamente non garantisce che tensioni, pin o protocolli siano compatibili elettricamente.
Laboratorio / esercizio: Controlla SDA, SCL, alimentazione e massa di un sensore Grove I²C.
Verifica: La forma del connettore basta a garantire compatibilità elettrica.
MODULO 3 — Ambiente di sviluppo · 5 lezioni
Lezione 3.1 — Arduino IDE
Arduino IDE
Arduino IDE consente di scrivere, compilare e caricare sketch. La compilazione traduce il codice in firmware; il caricamento lo trasferisce sulla scheda.
Laboratorio / esercizio: Installa Arduino IDE, crea uno sketch vuoto e individua i comandi Verifica e Carica.
Verifica: Compilare e caricare sono la stessa operazione.
Lezione 3.2 — Supporto ESP32
Supporto ESP32
Per programmare ESP32 in Arduino IDE serve il pacchetto schede appropriato. Installa la versione indicata dalla documentazione aggiornata e seleziona il modello corretto.
Laboratorio / esercizio: Annota versione del core ESP32 e scheda selezionata.
Verifica: Il modello selezionato nell’IDE influenza la compilazione.
Lezione 3.3 — Driver e USB
Driver e USB
Il collegamento richiede un cavo USB capace di trasferire dati. Alcune schede usano convertitori USB-seriale che necessitano driver; altre hanno USB nativa.
Laboratorio / esercizio: Controlla quale porta compare collegando e scollegando la scheda.
Verifica: Qualsiasi cavo USB di sola ricarica permette il caricamento firmware.
Lezione 3.4 — Primo sketch
Primo sketch
Arduino esegue setup() una volta all’avvio e loop() ripetutamente. Per iniziare puoi stampare un messaggio seriale senza componenti esterni.
Laboratorio / esercizio: Compila questo esempio: void setup(){Serial.begin(115200);} void loop(){Serial.println("Ciao Friday");delay(1000);}
Verifica: loop() viene eseguita una sola volta.
Lezione 3.5 — Monitor seriale
Monitor seriale
Serial.begin(115200) imposta la comunicazione. Il monitor seriale deve usare la stessa velocità per leggere correttamente i messaggi; le stampe aiutano il debug.
Laboratorio / esercizio: Apri il monitor a 115200 baud e osserva il messaggio del primo sketch.
Verifica: Il monitor seriale può mostrare valori e messaggi di debug.
MODULO 4 — Programmazione C++ · 5 lezioni
Lezione 4.1 — Variabili
Variabili
Una variabile memorizza un valore. int contiene interi, float numeri decimali e bool vero/falso. Nomi chiari e tipi appropriati rendono il codice più comprensibile.
Laboratorio / esercizio: Dichiara int campioni=0; float temperatura=22.5; bool pronto=false; e stampali.
Verifica: bool rappresenta soltanto vero o falso.
Lezione 4.2 — Condizioni
Condizioni
if ed else scelgono azioni in base a una condizione. Per esempio if(valore>30) attiva una segnalazione; altrimenti il programma continua normalmente.
Laboratorio / esercizio: Scrivi una condizione che stampi ALLARME quando un valore supera 50.
Verifica: Una condizione if può dipendere dal valore di un sensore.
Lezione 4.3 — Cicli
Cicli
for e while ripetono istruzioni. Il loop principale di Arduino è già ripetitivo; un while infinito può bloccare la gestione di altri eventi.
Laboratorio / esercizio: Stampa i numeri da 0 a 9 usando for(int i=0;i<10;i++).
Verifica: Un ciclo bloccante è sempre la soluzione migliore per gestire più sensori.
Lezione 4.4 — LED e pulsanti
LED e pulsanti
I LED sono uscite digitali e i pulsanti ingressi. Per un pulsante si possono usare resistenze pull-up o pull-down; il debounce filtra i rimbalzi meccanici.
Laboratorio / esercizio: Disegna pulsante, ingresso e resistenza pull-up, senza collegare pin non verificati.
Verifica: Un ingresso lasciato flottante può fornire letture instabili.
Lezione 4.5 — Debug
Debug
Un errore di compilazione impedisce di generare il firmware; un errore di upload impedisce di trasferirlo; un errore logico emerge durante l’esecuzione.
Laboratorio / esercizio: Registra per ogni errore messaggio completo, causa ipotizzata, test e risultato.
Verifica: Cambiare contemporaneamente molte impostazioni facilita l’individuazione della causa.
MODULO 5 — Elettronica e GPIO · 5 lezioni
Lezione 5.1 — Tensione e corrente
Tensione e corrente
La tensione si misura in volt, la corrente in ampere e la resistenza in ohm. La legge di Ohm V=R×I aiuta a stimare la corrente in circuiti semplici.
Laboratorio / esercizio: Calcola I=3/1000 A e converti in milliampere.
Verifica: 3 V su 1 kΩ corrispondono idealmente a 3 mA.
Lezione 5.2 — Breadboard
Breadboard
La breadboard collega internamente gruppi di fori. Le piste laterali e le file centrali possono essere interrotte: verifica lo schema del modello prima di alimentare.
Laboratorio / esercizio: Usa un multimetro in continuità per identificare le piste collegate.
Verifica: Tutti i fori di una breadboard sono sempre collegati fra loro.
Lezione 5.3 — Ingressi digitali
Ingressi digitali
Un GPIO digitale distingue stati logici. Se un ingresso non è vincolato a un livello, può fluttuare; pull-up e pull-down rendono stabile la lettura.
Laboratorio / esercizio: Scrivi una tabella con pulsante premuto e rilasciato usando INPUT_PULLUP, se supportato.
Verifica: Un ingresso flottante è affidabile senza alcuna resistenza.
Lezione 5.4 — PWM
PWM
PWM alterna stati alto e basso con una frequenza e un duty cycle. Variando il duty cycle si modifica l’effetto medio su carichi compatibili, per esempio la luminosità di un LED.
Laboratorio / esercizio: Disegna un periodo PWM con duty cycle 25% e 75%.
Verifica: Duty cycle 75% significa segnale alto per tre quarti del periodo.
Lezione 5.5 — ADC
ADC
L’ADC converte una tensione analogica in un numero. Risoluzione, attenuazione e precisione dipendono dal chip e dalla configurazione; non superare i limiti del pin.
Laboratorio / esercizio: Individua un GPIO ADC valido nel pinout del tuo modello.
Verifica: Un ADC può leggere direttamente qualsiasi tensione senza limiti.
MODULO 6 — Sensori e IMU · 5 lezioni
Lezione 6.1 — Sensori
Sensori
Un sensore converte una grandezza fisica in un segnale. Per interpretarlo servono unità, intervallo di misura, rumore, frequenza e accuratezza dichiarata.
Laboratorio / esercizio: Prepara una scheda tecnica con unità e intervallo di un sensore.
Verifica: Due sensori con unità diverse possono essere confrontati senza conversione.
Lezione 6.2 — I²C
I²C
I²C usa SDA per i dati e SCL per il clock. Dispositivi sullo stesso bus sono identificati da indirizzi; servono livelli elettrici e pull-up compatibili.
Laboratorio / esercizio: Disegna ESP32 con due sensori collegati alle stesse linee SDA e SCL.
Verifica: I²C utilizza comunemente due linee di segnale.
Lezione 6.3 — Accelerometro
Accelerometro
Un accelerometro misura accelerazione specifica lungo gli assi X, Y e Z. A riposo rileva anche l’effetto della gravità: il segnale non è direttamente un angolo posturale.
Laboratorio / esercizio: Registra valori con dispositivo fermo, poi ruotato di 90 gradi.
Verifica: Le letture accelerometriche equivalgono automaticamente a una diagnosi clinica.
Lezione 6.4 — Giroscopio
Giroscopio
Il giroscopio misura velocità angolare. Integrare la velocità nel tempo può stimare la rotazione, ma bias e rumore provocano deriva.
Laboratorio / esercizio: Annota valori a riposo e spiega perché un piccolo offset accumula errore.
Verifica: La deriva è un possibile problema nell’integrazione del giroscopio.
Lezione 6.5 — Campionamento e calibrazione
Campionamento e calibrazione
A 50 Hz acquisisci circa 50 campioni al secondo. Una calibrazione stima offset e altri errori; la validazione confronta le misure con un riferimento indipendente.
Laboratorio / esercizio: Calcola quanti campioni produci in 20 secondi a 50 Hz.
Verifica: Calibrazione e validazione sono sinonimi perfetti.
MODULO 7 — Display e interfacce · 5 lezioni
Lezione 7.1 — Grafica
Grafica
I display usano coordinate, dimensioni e colori. Librerie come M5Unified astraggono alcune differenze hardware, ma richiedono versioni e configurazioni compatibili.
Laboratorio / esercizio: Disegna una schermata con titolo, misura, unità e stato batteria.
Verifica: Una schermata utile deve mostrare chiaramente le unità di misura.
Lezione 7.2 — Testo
Testo
Dimensioni dei caratteri, contrasto e spaziatura determinano la leggibilità. Su schermi piccoli privilegia poche informazioni essenziali.
Laboratorio / esercizio: Confronta un layout con testo piccolo e uno con due valori grandi.
Verifica: Aumentare il contrasto può migliorare la leggibilità.
Lezione 7.3 — Touch
Touch
Un touchscreen produce eventi e coordinate di tocco. Per evitare attivazioni accidentali occorre gestire pressione, rilascio e dimensioni dei pulsanti.
Laboratorio / esercizio: Progetta un pulsante Avvia e uno Stop sufficientemente grandi.
Verifica: Ogni dispositivo M5Stack possiede necessariamente un touchscreen.
Lezione 7.4 — Menu
Menu
Una macchina a stati separa schermate come Home, Misura e Risultato. Le transizioni dipendono da eventi dell’utente o del programma.
Laboratorio / esercizio: Disegna Home → Misura → Risultato → Home.
Verifica: Una macchina a stati rende più chiara la navigazione.
Lezione 7.5 — Grafici
Grafici
Un grafico temporale deve avere asse del tempo, unità e scala. Se il dato è filtrato, il filtro va documentato per non confondere misura e trasformazione.
Laboratorio / esercizio: Disegna dieci campioni di accelerazione in funzione del tempo.
Verifica: Un grafico senza unità può risultare ambiguo.
MODULO 8 — Wi-Fi e IoT · 5 lezioni
Lezione 8.1 — Wi-Fi
Wi-Fi
Wi-Fi consente la comunicazione in rete. SSID e password devono restare riservati; una connessione fallita va gestita con timeout e riconnessione controllata.
Laboratorio / esercizio: Disegna la sequenza avvio → connessione → successo/errore.
Verifica: Pubblicare password nel codice di esempio è una buona pratica.
Lezione 8.2 — HTTP
HTTP
HTTP organizza richieste e risposte fra client e server. Una GET può richiedere dati; la risposta include codice di stato e contenuto, spesso JSON.
Laboratorio / esercizio: Descrivi una GET /stato e una risposta con batteria e temperatura.
Verifica: Il codice 200 indica normalmente una richiesta HTTP riuscita.
Lezione 8.3 — Server locale
Server locale
ESP32 può servire una pagina sulla rete locale. Un server dimostrativo senza autenticazione non deve essere esposto direttamente a Internet.
Laboratorio / esercizio: Disegna browser → router → ESP32 e annota i confini della rete.
Verifica: Un server HTTP locale senza autenticazione è automaticamente sicuro su Internet.
Lezione 8.4 — BLE
BLE
Bluetooth Low Energy organizza i dati in servizi e caratteristiche. Il dispositivo periferico può pubblicare una misura che una centrale legge o riceve tramite notifiche.
Laboratorio / esercizio: Definisci una caratteristica batteria e il suo formato.
Verifica: BLE significa Bluetooth Low Energy.
Lezione 8.5 — MQTT e sicurezza
MQTT e sicurezza
MQTT usa un broker e topic per publish/subscribe. Credenziali, autorizzazioni, TLS e configurazione del broker sono fondamentali per applicazioni reali.
Laboratorio / esercizio: Progetta i topic sensori/imu e dispositivi/stato.
Verifica: Un broker MQTT può instradare messaggi tra dispositivi.
MODULO 9 — Dati e dashboard · 5 lezioni
Lezione 9.1 — Seriale
Seriale
La seriale è un canale semplice per debug e trasferimento di misure. Un timestamp consente di ordinare i campioni; specifica sempre il riferimento temporale.
Laboratorio / esercizio: Stampa timestamp e misura separati da virgola.
Verifica: Un timestamp rende più semplice ricostruire la sequenza temporale.
Lezione 9.2 — CSV e JSON
CSV e JSON
CSV organizza dati tabellari in righe e colonne. JSON rappresenta oggetti e liste con chiavi esplicite. Scegli il formato in base al destinatario.
Laboratorio / esercizio: Scrivi tre misure in CSV e poi in JSON.
Verifica: JSON può rappresentare coppie chiave-valore.
Lezione 9.3 — Logging
Logging
Un logger deve considerare frequenza, spazio, interruzioni di alimentazione e perdita dei campioni. L’intervallo reale tra timestamp va controllato.
Laboratorio / esercizio: Stima il numero di righe in un’ora a 20 Hz.
Verifica: A 20 Hz si ottengono teoricamente 72.000 campioni in un’ora.
Lezione 9.4 — Dashboard
Dashboard
Una dashboard mostra dati e stato del sistema con unità, grafici e avvisi. Il design deve distinguere misure reali, stime e valori non disponibili.
Laboratorio / esercizio: Progetta una schermata con tre indicatori e un grafico.
Verifica: Mostrare l’unità accanto a un valore riduce le ambiguità.
Lezione 9.5 — Privacy
Privacy
Dati riconducibili a persone richiedono finalità chiare, accessi controllati e minimizzazione. Le misure biomeccaniche possono essere sensibili nel contesto d’uso.
Laboratorio / esercizio: Distingui identificativo utente, misura anonima e dato associato a una persona.
Verifica: La minimizzazione significa raccogliere soltanto i dati necessari.
MODULO 10 — Dispositivi portatili · 5 lezioni
Lezione 10.1 — Consumi
Consumi
L’autonomia dipende da capacità della batteria e corrente media. Una stima ideale è ore ≈ mAh/mA, ma perdite e variazioni di consumo riducono la precisione.
Laboratorio / esercizio: Calcola autonomia ideale con 1000 mAh e 100 mA.
Verifica: La stima mAh/mA è sempre esatta in ogni condizione.
Lezione 10.2 — Sleep
Sleep
Le modalità sleep riducono i consumi spegnendo o rallentando parti del chip. Occorre scegliere una sorgente di risveglio e valutare cosa rimane attivo.
Laboratorio / esercizio: Disegna misura → trasmissione → sleep → risveglio.
Verifica: Lo sleep può aiutare a ridurre il consumo energetico.
Lezione 10.3 — Batterie
Batterie
Le batterie Li-ion e Li-Po richiedono ricarica, protezione e gestione termica adatte. Non collegare direttamente una cella a un GPIO o a un caricatore improvvisato.
Laboratorio / esercizio: Elenca tre controlli di sicurezza di un modulo batteria.
Verifica: Qualsiasi alimentatore USB può essere collegato direttamente ai terminali di una cella.
Lezione 10.4 — Contenitori
Contenitori
Un contenitore deve proteggere circuito e batteria, lasciare accessibili i connettori e consentire adeguata dissipazione. Per dispositivi indossabili conta anche il comfort.
Laboratorio / esercizio: Disegna una custodia con USB, fissaggi e spazio per la batteria.
Verifica: Il contenitore influenza anche sicurezza e manutenzione.
Lezione 10.5 — Progettazione
Progettazione
Un dispositivo portatile deve bilanciare peso, autonomia, frequenza di campionamento, robustezza e qualità del dato. Definisci i vincoli prima di miniaturizzare.
Laboratorio / esercizio: Scrivi cinque requisiti misurabili di un data logger indossabile.
Verifica: Miniaturizzare senza verificare consumi e sicurezza è sempre consigliabile.
MODULO 11 — Friday e debug · 5 lezioni
Lezione 11.1 — Prompt tecnici
Prompt tecnici
Per ottenere aiuto utile indica modello esatto, versione Arduino ESP32, librerie, codice minimo, errore completo e risultato atteso. Evita credenziali e dati personali.
Laboratorio / esercizio: Scrivi un prompt di diagnosi con tutti questi elementi.
Verifica: Un messaggio di errore completo aiuta la diagnosi.
Lezione 11.2 — Errori
Errori
Procedi per ipotesi: distingui compilazione, caricamento, cablaggio ed esecuzione. Cambia una variabile per volta e registra il risultato.
Laboratorio / esercizio: Prepara una tabella causa → prova → esito.
Verifica: Cambiare cinque cose insieme rende sempre più semplice individuare la causa.
Lezione 11.3 — Revisione codice
Revisione codice
Una code review controlla leggibilità, limiti elettrici, uso della memoria, gestione errori e protezione delle credenziali. Un codice che compila non è automaticamente sicuro.
Laboratorio / esercizio: Rivedi uno sketch cercando tre possibili punti di guasto.
Verifica: Compilare senza errori garantisce il corretto funzionamento hardware.
Lezione 11.4 — Test
Test
Ogni test deve indicare prerequisiti, procedura, risultato atteso e risultato osservato. I test ripetibili consentono confronti dopo le modifiche.
Laboratorio / esercizio: Definisci cinque casi di test per un logger IMU.
Verifica: Un test ripetibile richiede una procedura definita.
Lezione 11.5 — Documentazione
Documentazione
Registra versione hardware, firmware, librerie, configurazione e limiti noti. Una buona documentazione permette a un’altra persona di riprodurre il progetto.
Laboratorio / esercizio: Crea una scheda di rilascio con versioni e risultati di test.
Verifica: La documentazione è utile soltanto quando il progetto è finito.
MODULO 12 — Progetto finale · 5 lezioni
Lezione 12.1 — Requisiti
Requisiti
Definisci un prototipo con una misura, una visualizzazione e una forma di esportazione. Specifica frequenza, durata e criteri di riuscita misurabili.
Laboratorio / esercizio: Scrivi tre requisiti e il test che li dimostra.
Verifica: Un requisito verificabile ha un criterio di accettazione.
Lezione 12.2 — Architettura
Architettura
Dividi il progetto in acquisizione, elaborazione, visualizzazione, archiviazione e alimentazione. Descrivi le interfacce fra blocchi prima di scrivere tutto il codice.
Laboratorio / esercizio: Disegna uno schema a blocchi e le direzioni dei dati.
Verifica: Separare i sottosistemi può semplificare i test.
Lezione 12.3 — Implementazione
Implementazione
Realizza prima una versione minima: acquisisci un valore, visualizzalo, poi aggiungi esportazione e gestione errori. Verifica ogni passo prima di integrare il successivo.
Laboratorio / esercizio: Pianifica quattro milestone con un risultato misurabile.
Verifica: Aggiungere tutte le funzioni contemporaneamente è sempre più facile da verificare.
Lezione 12.4 — Validazione
Validazione
Confronta le misure con un riferimento appropriato, documenta ripetibilità, perdita campioni e limiti. Un prototipo dimostrativo non è automaticamente uno strumento clinico.
Laboratorio / esercizio: Progetta un test di ripetibilità con dispositivo fermo.
Verifica: Un prototipo non validato può essere presentato come dispositivo diagnostico.
Lezione 12.5 — Presentazione
Presentazione
La consegna finale comprende componenti, codice, schema funzionale, test, risultati, limiti e possibili miglioramenti. La demo deve essere riproducibile.
Laboratorio / esercizio: Prepara una presentazione di tre minuti con una misura reale e un grafico.
Verifica: Descrivere anche i limiti aumenta la qualità della relazione.
Documentazione di riferimento: M5Stack · Arduino ESP32.