Sketch Arduino, come scriverlo e risolvere gli errori di caricamento

15 novembre 2026

Schema di collegamento di un Arduino UNO con un microcontrollore ATmega328 su breadboard, con resistori e condensatori.

Indice

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.

Schema elettrico di un Arduino S3v3 con componenti, microcontrollore ATmega e connettori.

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 .ino con 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ò servire millis().
  • 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.

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.

Domande frequenti

setup() viene eseguita una sola volta all’avvio e serve a configurare la scheda, per esempio impostando un pin come uscita. loop() ripete le istruzioni mentre la scheda resta accesa, come accendere e spegnere un LED.

Nella struttura standard di uno sketch, il file principale con estensione .ino deve avere lo stesso nome della cartella del progetto. La cartella può contenere anche altri file di codice e di supporto, quindi per copiare o archiviare il progetto è meglio trasferire l’intera cartella.

La verifica conferma che il codice è stato compilato per la scheda selezionata, ma non che il computer riesca a comunicare con la scheda. Controlla che siano selezionate la scheda e la porta corrette, prova un cavo USB che supporti il trasferimento dati e chiudi il Monitor seriale o altri programmi che potrebbero occupare la porta. Se compare “exit status 1”, leggi le righe precedenti del log per trovare l’errore specifico.

delay() mette in pausa il programma per il tempo indicato, impedendo nel frattempo di svolgere altre attività nel ciclo. Per controllare, per esempio, anche un pulsante durante l’attesa, puoi usare un approccio basato su millis(), come nell’esempio Blink Without Delay indicato nella documentazione Arduino.

Sulla Arduino UNO R3, analogWrite() funziona soltanto sui sei pin contrassegnati dal simbolo PWM. Controlla la serigrafia della scheda e usa un pin PWM; la mappa dei pin può variare tra i diversi modelli Arduino.

Valuta l'articolo

Valutazione: 5.00 Numero di voti: 1

Tag:

arduino ide pwm millis() sketch arduino blink

Condividi post

Scrivi un commento