Hai collegato la scheda, hai scritto qualche riga e Arduino IDE segnala un errore: il problema potrebbe essere nel codice, ma anche nella scheda o nella porta selezionata. Uno sketch Arduino è il programma che carichi sul microcontrollore e, di solito, contiene le funzioni setup() e loop(), anche se la struttura del progetto può riservare qualche sorpresa.

Uno sketch diventa più semplice da gestire quando separi codice, scheda e caricamento
- setup() configura la scheda una volta all’avvio; loop() ripete le istruzioni.
- Il progetto è una cartella: al suo interno serve un file
.inocon lo stesso nome. - Verifica controlla la compilazione; Carica trasferisce il programma alla scheda.
- Con
delay()il programma si ferma durante l’attesa; per leggere pulsanti nel frattempo, può serviremillis(). - Se la compilazione riesce ma il caricamento fallisce, controlla prima scheda, porta e cavo dati USB.
Uno sketch ha due tempi diversi, l’avvio e il ciclo continuo
Un LED che lampeggia sembra un esercizio minuscolo, ma mostra già l’ossatura del programma. In setup() imposti ciò che serve all’avvio; in loop() inserisci le azioni da ripetere mentre la scheda resta accesa.
Per esempio, il LED integrato di una UNO R3 si può controllare con LED_BUILTIN, evitando di legare il codice a un numero di pin scritto a mano:
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}
Le due attese fanno lampeggiare il LED, ma bloccano il resto del programma per la loro durata. Se vuoi che lo sketch controlli anche un pulsante durante l’attesa, preferisco un approccio basato su millis(): la documentazione Arduino descrive delay() come una pausa e rimanda a “Blink Without Delay” per gestire il tempo senza fermare il ciclo. ([docs.arduino.cc](https://docs.arduino.cc/language-reference/en/functions/time/delay/?source=post_page---------------------------&utm_source=openai))
Il progetto è una cartella, non soltanto il file .ino
Un errore facile da incontrare arriva prima ancora della compilazione: il file si chiama Lampada.ino, ma è stato salvato in una cartella con un altro nome. Per la struttura standard, il file principale .ino deve avere lo stesso nome della cartella che contiene il progetto.
Questa distinzione diventa utile quando il codice cresce. La cartella può raccogliere più schede di codice e file di supporto; quindi copiare soltanto il file visibile nell’editor può non bastare per trasferire o archiviare l’intero sketch. La specifica ufficiale degli sketch Arduino chiarisce quali file possono far parte del progetto e come si organizzano.
Un’altra sorpresa: durante la compilazione, Arduino concatena i file .ino e aggiunge automaticamente alcuni elementi, fra cui dichiarazioni preliminari delle funzioni. Questa comodità non vale allo stesso modo per i file .cpp: in quel caso servono dichiarazioni e inclusioni gestite correttamente. La trasformazione è descritta nel processo di compilazione degli sketch.
Una verifica riuscita non garantisce ancora il caricamento
La spunta verde dice che il codice è stato compilato per la scheda selezionata; non dimostra che il computer riesca a comunicare con la scheda collegata. È una distinzione piccola, ma evita di cercare per ore un errore nel programma quando il problema è un cavo solo per la ricarica o una porta sbagliata.
| Situazione | Possibile causa | Cosa fare |
|---|---|---|
| La verifica si interrompe con errori di sintassi | Parentesi, punto e virgola o nome di funzione errati | Leggi il primo errore dettagliato nella console e correggi quella riga prima di caricare. |
| La verifica riesce, ma l’IDE non mostra una porta | Cavo USB senza dati, connessione o driver non riconosciuti | Prova un cavo dati e un’altra porta USB; scollega e ricollega la scheda. |
| La porta compare, ma il caricamento fallisce | Modello o porta selezionati in modo errato, oppure porta occupata | Seleziona la scheda esatta, aggiorna la scelta della porta e chiudi il Monitor seriale o altri programmi che la usano. |
| Il log termina con “exit status 1” | Messaggio generico, non diagnosi sufficiente | Esamina le righe precedenti del log: lì compare l’errore più specifico. |
Questa separazione tra errore di compilazione e di caricamento è anche il punto che chiarisce molti messaggi d’aiuto nei forum: “exit status 1” da solo non identifica la causa. La guida Arduino per il mancato caricamento dello sketch consiglia di controllare codice, scheda, porta e collegamento in sequenza.
Il pin giusto dipende dalla scheda e dalla funzione richiesta
Il codice può essere corretto e produrre comunque un risultato diverso da quello atteso, se il pin non supporta la funzione usata. Sulla Arduino UNO R3, per esempio, analogWrite() funziona soltanto sui pin contrassegnati dal simbolo PWM; la funzione produce un segnale modulato, utile per regolare la luminosità di un LED o la velocità di un motore tramite un driver.
La UNO R3 dispone di sei uscite PWM, ma non bisogna trasferire automaticamente la stessa mappa dei pin a ogni scheda Arduino: capacità e disposizione cambiano secondo il modello. Per questo, prima di modificare il programma, confronta la funzione desiderata con la serigrafia della scheda e la relativa documentazione ufficiale.
Un controllo pratico: se digitalWrite() accende o spegne il LED ma analogWrite() non ne cambia la luminosità, prova un pin PWM indicato per quel modello. La pagina Arduino sulla struttura della UNO R3 segnala quali pin supportano la modulazione.
Per il primo test, parti da Blink e cambia una sola cosa
Quando il progetto non dà segni di vita, aggiungere subito un sensore, una libreria e altri collegamenti rende difficile capire dov’è l’errore. Io considero Blink il test iniziale più utile: verifica in una volta sola che scheda, porta, caricamento e LED integrato funzionino insieme.
Apri l’esempio Blink nell’IDE, seleziona il modello e la porta corretti, poi premi prima Verifica e infine Carica. Se il LED lampeggia, aggiungi un solo elemento alla volta, per esempio una lettura seriale o un pulsante: se qualcosa smette di funzionare, l’ultima modifica restringe subito la ricerca.
Così il piccolo sketch iniziale smette di essere soltanto un esercizio: diventa un test di controllo. Quando codice, cartella e comunicazione con la scheda sono distinti, anche il messaggio d’errore più ostico indica con più chiarezza dove intervenire.