Condividere un progetto Arduino con gli studenti: il tuo

Quando un insegnante vuole condividere un progetto Arduino con gli studenti, la domanda di solito è questa: voglio fare lezione con un progetto che ho preparato io, come vedranno i miei studenti lo schema, il codice e l'elenco dei componenti sul telefono? In BlueGrays la strada è Impara > Forum > Nuova pubblicazione. Scegli Tutorial come categoria, aggiungi come immagini la foto del progetto e una foto del circuito, incolli il codice ed elenchi nella descrizione i componenti usati; la pubblicazione va online senza revisione. Poi mandi il link ai tuoi studenti con l'icona Condividi della pubblicazione, e nella loro app si apre la stessa pubblicazione.

In questo articolo trovi i requisiti, la preparazione di foto e codice, la compilazione della schermata Nuova pubblicazione campo per campo, un modello pronto da copiare per la descrizione, la pubblicazione e come la trovano gli studenti, una lezione di esempio di 40 minuti con il progetto e una lista di controllo prima di pubblicare. Una precisazione onesta fin dall'inizio: la pubblicazione che condividi non resta in uno spazio privato della tua classe. Appena va online è una pubblicazione pubblica del forum; più sotto spieghiamo cosa comporta.

Perché fare lezione con il tuo progetto?

I progetti pronti dell'app offrono una base solida per la maggior parte dei corsi: LED, pulsanti, sensori, display, motori. Ma quasi ogni insegnante ha un progetto suo. L'allarme di umidità montato nella serra della scuola, un timer simile alla campanella dell'intervallo, il luxmetro che usi in fisica o il piccolo robot che il club migliora da anni. Spiegarlo ogni anno con fotocopie, uno schema alla lavagna o un file di codice mandato nel gruppo della classe è faticoso: lo schema diventa sfocato, il codice viene copiato male, l'elenco dei componenti si perde.

Quando condividi il progetto come pubblicazione Tutorial nel forum, tutto finisce in un solo posto: foto del progetto e del circuito, codice copiabile, elenco dei componenti con quantità e i progetti pronti collegati che aggiungi. Lo studente apre la stessa pubblicazione a casa, porta il codice sul computer e vede quale componente gli manca. L'anno dopo ti basta mandare lo stesso link alla nuova classe invece di rispiegare tutto. Se la pubblicazione va aggiornata, la modifichi e salvi.

Prima di iniziare: i requisiti

Preparazione: foto, immagine del circuito, codice ed elenco dei componenti

Scrivere la pubblicazione richiede cinque minuti; il tempo vero va nella preparazione. Una pubblicazione ben preparata risponde a metà delle domande che gli studenti ti farebbero a lezione. Se segui questo elenco in ordine, avrai tutto a portata di mano quando si apre la schermata Nuova pubblicazione.

• Foto del progetto: Fotografa il progetto in funzione, alla luce del giorno o sotto una lampada da scrivania bianca. Tieni lo sfondo neutro e mostra scheda e uscita (LED acceso, testo sul display) nella stessa inquadratura. Tenere il telefono leggermente sopra, a circa 45 gradi, rende i fili più facili da seguire rispetto a una ripresa perfettamente dall'alto.
• Foto del circuito: Il risultato migliore arriva da uno schema fatto con un programma di disegno di circuiti. Se scatti una foto, inquadra la breadboard esattamente dall'alto in modo che si vedano entrambi i capi di ogni filo. Uniforma i colori: rosso per 5V o 3,3V, nero per GND, altri colori per i segnali. Scrivere i numeri dei pin su un foglietto accanto alla scheda la rende molto più leggibile.
• Codice: Definisci i pin come costanti all'inizio (per esempio const int ledPin = 8;), aggiungi un breve commento a ogni sezione ed elimina le righe di prova rimaste. Se usi una libreria, indicala nella descrizione. Compila e carica il codice un'ultima volta nell'Arduino IDE e incolla esattamente quella versione con Aggiungi codice.
• Video (facoltativo): In una pubblicazione del forum non puoi caricare video; se vuoi mostrare il progetto in funzione con una breve clip di 30–90 secondi, mettila su YouTube e aggiungi il link nella descrizione. Mostrare una volta il circuito da vicino aiuta lo studente a confrontarlo con il proprio montaggio.
• Elenco dei componenti: Annota ogni componente con la quantità e, per resistenze e LED, anche valore e colore: resistenza da 220 Ω × 3, LED rosso × 1, LED giallo × 1 e così via. Puoi inserire questa nota direttamente nella descrizione.

Compilare la schermata Nuova pubblicazione campo per campo

Finita la preparazione, tocca la scheda Impara nella barra in basso, passa alla sezione Forum in alto e tocca Nuova pubblicazione. Scegli Tutorial come categoria. Ecco i campi della schermata e i nostri consigli:

Nella tua pubblicazione, la descrizione è il testo principale che lo studente legge. Sostituisce la spiegazione passo passo dei progetti pronti, quindi usa una struttura con sezioni invece di un unico paragrafo. Copia questo modello e compilalo per il tuo progetto:

1. Obiettivo: Cosa fa il progetto? Una frase. (Quando il terreno si secca, il LED si accende e il buzzer emette brevi bip.)
2. Cosa imparerai: Due o tre concetti. (Leggere un sensore con analogRead, un valore soglia, decidere con if-else.)
3. Collegamenti: A quale pin va ogni componente, riga per riga. (Sensore AO → A0, LED → D8 + 220 Ω → GND, buzzer → D9.)
4. Come funziona: Il flusso del codice in quattro-sei passi. (Leggi il sensore, scrivi il valore nel monitor seriale, confrontalo con la soglia, comanda LED e buzzer, attendi un secondo.)
5. Prova tu: Due o tre piccole modifiche. (Alza la soglia da 500 a 600 e osserva la differenza; fai suonare il buzzer solo quando il terreno è molto secco.)
6. Sicurezza: Brevi avvertenze. (Scollega l'USB prima di modificare il circuito; immergi il sensore in acqua solo fino alla linea segnata.)

Elenco dei componenti e livello di difficoltà

Scrivi nella descrizione l'elenco dei componenti con le quantità. Tieni ben distinti i pezzi dello stesso tipo: "330R", "10K", "LED blu", "Maschio-Femmina" e così via. Se usi resistenze di due valori diversi, metti ognuna su una riga con valore e quantità, così lo studente legge nell'elenco quale resistenza va dove. Puoi anche collegare alla pubblicazione i componenti principali nella sezione Progetto, componente o strumento collegato (fino a 5 componenti); se un componente manca dall'elenco, puoi segnalarlo dalla sezione Assistenza dell'app.

Il forum non ha un campo separato per la difficoltà, quindi indica il livello nel titolo o all'inizio della descrizione. Per decidere il livello considera insieme il numero di righe di codice e la complessità del circuito. La tabella dà un'indicazione di massima. Nel dubbio scegli il livello inferiore: uno studente che si blocca su un progetto segnato come Principiante perde la motivazione prima di uno che trova facile un progetto Intermedio.

Pubblicazione: nessuna revisione, ma conta la lingua

Quando compili i campi e tocchi Pubblica, la pubblicazione va online nel forum senza revisione. Viene pubblicata nella lingua in cui stai usando l'app in quel momento e non viene tradotta automaticamente; gli studenti che usano l'app in un'altra lingua la vedono scegliendo quella lingua, oppure Tutti, nel selettore Lingua degli argomenti del forum. Se in seguito devi correggere qualcosa, aggiorni la pubblicazione con Modifica pubblicazione.

Dopo la pubblicazione: come gli studenti trovano il tuo progetto

La tua pubblicazione compare nel forum, nella categoria Tutorial, con il tuo nome. Poiché non viene tradotta automaticamente, gli studenti che usano l'app in un'altra lingua devono scegliere la tua lingua nel selettore Lingua degli argomenti del forum. Gli studenti arrivano alla tua pubblicazione in tre modi:

• Link di condivisione: Con l'icona Condividi in alto nella pubblicazione mandi il link nel canale della classe; toccandolo, lo studente apre la stessa pubblicazione nell'app (se non ha effettuato l'accesso, gli viene chiesto di accedere prima).
• Ricerca nel forum: Se hai dato alla pubblicazione un titolo unico (per esempio "Allarme Umidità del Terreno (LED e Buzzer)"), basta scriverlo nella barra di ricerca del forum; scegliendo la categoria Tutorial l'elenco si restringe.
• Link ai progetti pronti: Puoi mandare anche i progetti pronti che hai collegato con Condividi nella pagina del progetto; gli studenti salvano quelli che gli piacciono in Officina > Preferiti con Preferito.

C'è un dettaglio importante: leggere una pubblicazione del forum è gratuito, ma per vedere completi i progetti Premium che colleghi lo studente ha bisogno di Premium. Per una classe la soluzione più semplice è un pacchetto educatore: dai un codice a ogni studente e si sbloccano tutti i 200+ progetti dell'app. Iniziare le prime lezioni con progetti gratuiti e distribuire i codici nella settimana in cui passi ai progetti Premium è anche un buon ordine.

Lezione di esempio di 40 minuti con questo progetto

Supponiamo che il tuo progetto sia un "Allarme Umidità del Terreno": sensore di umidità su A0, LED rosso su D8 e buzzer su D9; quando il terreno si secca, il LED si accende e il buzzer emette brevi bip. Dividi una classe di 24 studenti in 8 gruppi da tre. Questo schema si adatta a qualsiasi tuo progetto:

La parte più preziosa sono i minuti 27–35: quando lo studente sostituisce la tua soglia con numeri misurati da lui, capisce che il codice non è un testo fisso ma un meccanismo di decisione regolabile. Per questo non lasciare mai vuota la sezione Prova tu della descrizione. Se vuoi prima mostrare la stessa logica con un progetto pronto, il progetto gratuito Luce notturna con LDR insegna la stessa idea di soglia con la luce; farlo la settimana prima del tuo progetto è un'ottima preparazione.

Limiti onesti: cosa manca e cosa fare invece

Lista di controllo prima di pubblicare

1. Il codice finale compila e funziona su un circuito reale.
2. I numeri dei pin coincidono nel codice, nella descrizione e nella foto del circuito.
3. La foto del progetto lo mostra in funzione, nitida e ben illuminata.
4. Nella foto del circuito si vedono entrambi i capi di ogni filo.
5. Nelle foto non compaiono volti, nomi della scuola o dati personali.
6. Ogni componente è nell'elenco della descrizione con la quantità; i valori delle resistenze sono scritti per esteso.
7. La descrizione segue il modello in sei sezioni: obiettivo, apprendimenti, collegamenti, funzionamento, attività, sicurezza.
8. I nomi delle librerie usate sono nella descrizione.
9. Il livello di difficoltà indicato nel titolo o nella descrizione è adatto al circuito e alla lunghezza del codice; nel dubbio è stato indicato quello inferiore.
10. La pubblicazione è andata online prima della lezione in cui la userai e l'hai aperta una volta sul tuo telefono per controllarla.

Una volta pubblicato, il tuo progetto si inserisce facilmente in un percorso insieme ai progetti pronti: nelle prime settimane i gratuiti LED lampeggiante e Semaforo, a metà percorso progetti con sensori e a fine quadrimestre il tuo progetto. Se cerchi uno schema settimana per settimana, il piano di 8 settimane di robotica e coding è un buon inizio; per nuove idee dai un'occhiata alle 30 idee di progetti Arduino. Quando sei pronto a condividere il tuo progetto, puoi fare il primo passo nell'app BlueGrays da Impara > Forum > Nuova pubblicazione.