Arduino non carica lo sketch: errori avrdude, porta e driver

Il tuo Arduino non carica lo sketch e nella finestra di output compare un errore rosso di avrdude? Niente panico: quasi mai significa che la scheda è guasta. Di solito la colpa è di un cavo USB che serve solo a caricare, un driver CH340 mancante, la scheda o la porta sbagliate, un modulo collegato ai pin 0 e 1 oppure un altro programma che tiene occupata la porta. Se controlli le cose nell'ordine giusto, nella maggior parte dei casi risolvi in pochi minuti; e anche se la scheda è davvero guasta, c'è un modo semplice per accertarlo.

In questa guida vedrai prima cosa succede dietro le quinte durante il caricamento e come leggere il messaggio di errore. Poi restringeremo il problema passo dopo passo con una tabella di diagnosi sintomo, causa e soluzione. Trattiamo anche l'impostazione ATmega328P (Old Bootloader) dell'Arduino Nano, il Monitor seriale e gli altri programmi che bloccano la porta, l'errore Failed to connect dell'ESP32 con il tasto BOOT e il metodo BOOTSEL e UF2 del Raspberry Pi Pico. Ogni sezione ha un breve sketch di prova per controllare la scheda una volta risolto il problema.

Come funziona il caricamento: errore di compilazione o di caricamento?

Quando premi Carica succedono due cose distinte. Prima l'IDE compila il codice; se va tutto bene, la finestra di output mostra una riga con i byte occupati dallo sketch (nell'interfaccia inglese Sketch uses 924 bytes). Poi un programma chiamato avrdude apre la porta scelta, riavvia la scheda con il segnale DTR e prende contatto con il piccolo programma di caricamento che si trova nella scheda, il bootloader. Dopo un reset il bootloader resta in ascolto solo per circa un secondo; se in quel tempo non arrivano dati, il vecchio programma continua a funzionare. Il messaggio di errore ti dice quale anello della catena si è rotto. Se il testo rosso compare durante la compilazione, il problema è nel codice e non ha nulla a che fare con la scheda o con il cavo.

Gli errori avrdude più comuni e cosa significano

Tabella di diagnosi passo passo: sintomo, causa, soluzione

Leggi la tabella dall'alto verso il basso; le prime righe sono i problemi più comuni e più facili da risolvere. Riprova il caricamento dopo ogni modifica. Se cambi più cose insieme non saprai mai quale ha risolto il problema, e lo stesso errore ti sorprenderà di nuovo la prossima volta.

Checklist rapida e sketch di prova

1. Togli tutto dalla scheda: shield, moduli e i fili sui pin 0 e 1. Lascia collegato solo il cavo USB.
2. Collega la scheda direttamente a una porta USB sul retro del computer; evita hub, prolunghe e le prese sul frontale del case.
3. Apri Strumenti > Porta e guarda l'elenco. Scollega e ricollega la scheda e annota quale porta sparisce e ricompare. Se l'elenco non cambia mai, il problema è nel cavo o nel driver.
4. Scegli il modello esatto della tua scheda in Strumenti > Scheda; con un Nano scegli anche il bootloader giusto in Strumenti > Processor.
5. Assicurati che nessun altro programma né una seconda finestra dell'IDE stia usando la porta; nel dubbio chiudili tutti.
6. Attiva l'output dettagliato del caricamento e carica il piccolo sketch di prova qui sotto. Provare con un codice che sai essere senza errori esclude i problemi di compilazione.
7. Ancora niente? Premi il tasto reset: se il LED L lampeggia rapidamente una o più volte, il bootloader è vivo. Poi passa al test di loopback più sotto.
8. Prova su un altro computer o con un'altra scheda. Se il problema segue la scheda, è nella scheda; se resta sul computer, è nel driver o nelle impostazioni del sistema operativo.

1// Yükleme testi: LED yanıp söner, sayaç yazılır / Upload test: blinks the LED, prints a counter
2unsigned long sayac = 0;   // çalışma sayacı / run counter
3
4void setup() {
5  pinMode(LED_BUILTIN, OUTPUT);   // Uno ve Nano'da pin 13 / pin 13 on Uno and Nano
6  Serial.begin(9600);
7  Serial.println("Yukleme basarili / Upload OK");
8}
9
10void loop() {
11  digitalWrite(LED_BUILTIN, HIGH);
12  delay(200);                     // yanma süresi: değiştirip tekrar yükle / on time: change it and re-upload
13  digitalWrite(LED_BUILTIN, LOW);
14  delay(800);
15  Serial.println(sayac++);        // Seri Monitör 9600 baud / Serial Monitor at 9600 baud
16}

Se il caricamento è riuscito, il LED L lampeggia brevemente e resta spento più a lungo, e il contatore sale quando apri il Monitor seriale a 9600 baud. Per essere sicuro che il nuovo codice sia davvero arrivato sulla scheda, cambia delay(200) in delay(50) e ricarica: se il ritmo del lampeggio non cambia, sta ancora girando il vecchio programma. Se nel Monitor seriale vedi caratteri strani, la velocità impostata nel Monitor seriale non coincide con quella del codice; non è un errore di caricamento.

La porta COM non compare: cavo USB e driver CH340, CP2102

Se il menu delle porte è grigio o vuoto, il primo sospettato è il cavo. Molti cavi sottili dei caricabatterie per telefono hanno solo i due fili di alimentazione; i fili dati D+ e D- mancano del tutto. Con un cavo così il LED di alimentazione della scheda si accende, il che trae in inganno, ma il computer non vede alcun dispositivo e non suona nemmeno l'avviso di collegamento. Prova il cavo trasferendo file su un telefono oppure con un'altra scheda che sai funzionare. Il grosso cavo di tipo B dell'Uno ha raramente questo problema; è invece molto frequente con il mini USB del Nano e con i cavi micro USB o USB-C di ESP32 e Pico.

Se il cavo è a posto, il secondo sospettato è il driver. Leggi la scritta sul chip accanto alla presa USB: Arduino Uno e Mega originali usano un ATmega16U2, i cloni di Uno e Nano quasi sempre un CH340G o CH340C, le schede di sviluppo ESP32 di solito un CP2102 o un CH340. Su Windows apri Gestione dispositivi: se la scheda viene riconosciuta, compare sotto Porte (COM e LPT). Se sotto Altri dispositivi vedi USB2.0-Serial con un punto esclamativo giallo, manca il driver CH340.

Windows 10 e 11 di solito installano da soli i driver di CH340 e CP2102 tramite Windows Update. Se non lo fanno, scarica dal sito del produttore del chip il driver CH341SER per il CH340 o il driver CP210x VCP per il CP2102, installalo e poi scollega e ricollega la scheda. Le versioni attuali di macOS includono i driver per entrambi i chip; installare uno sopra l'altro vecchi driver presi da fonti diverse spesso peggiora le cose. Su Linux i driver sono già nel kernel, ma per usare la porta devi aggiungere il tuo utente al gruppo dialout (sudo usermod -a -G dialout $USER) e poi uscire e rientrare nella sessione; altrimenti ottieni l'errore Permission denied. Se su Ubuntu 22.04 o successivo la porta sparisce subito dopo aver collegato una scheda con CH340, il colpevole è di solito il pacchetto per lettori di schermo brltty; se non lo usi, rimuovilo con sudo apt remove brltty.

Scheda, processore o porta sbagliati

Nell'Arduino IDE 2 scegli scheda e porta dal menu a tendina nella barra in alto oppure dai menu Strumenti > Scheda e Strumenti > Porta. Su Windows nell'elenco potresti vedere COM1 o alcune porte Bluetooth virtuali; il modo più semplice per trovare quella giusta è scollegare la scheda e vedere quale porta sparisce. Se nel menu delle schede è scelto un modello sbagliato, per esempio Mega invece di Uno o Leonardo invece di Nano, avrdude non riceve alcuna risposta oppure vede un identificativo di chip inatteso nella riga Device signature. Un'altra cosa: per un caricamento normale usa Ctrl+U. Sketch > Carica tramite programmatore si aspetta un programmatore ISP esterno e, se riesce, cancella il bootloader della scheda; da quel momento la scheda non accetta più caricamenti via USB.

Arduino Nano non carica lo sketch: ATmega328P (Old Bootloader)

La maggior parte dei Nano economici in commercio sono cloni con CH340, e molti hanno ancora il vecchio bootloader. All'inizio del 2018 Arduino ha sostituito il bootloader del Nano con l'Optiboot dell'Uno, più piccolo e veloce, e da allora l'opzione predefinita ATmega328P dell'IDE comunica a 115200 baud. Il vecchio bootloader si aspetta 57600 baud. Quando le velocità non coincidono, la scheda sembra non rispondere affatto e l'errore not in sync: resp=0x00 si ripete per dieci tentativi. La soluzione è una sola impostazione di menu: Strumenti > Processor > ATmega328P (Old Bootloader). Poiché queste opzioni arrivano dal pacchetto della scheda, nell'Arduino IDE 2 il menu si chiama Processor anche con l'interfaccia in italiano (nel vecchio IDE 1.8, Processore). Se non sai quale sia quella giusta, prova le opzioni una dopo l'altra; una scelta sbagliata non danneggia la scheda.

I moduli sui pin 0 e 1 bloccano il caricamento

Su Uno e Nano il chip USB-seriale è collegato all'ATmega328P tramite resistenze da 1 kΩ sui pin D0 (RX) e D1 (TX). Durante il caricamento quella linea appartiene al computer. Se a questi pin è collegato un modulo seriale come un modulo Bluetooth HC-05, un GPS, un ESP-01 o un sensore di impronte, invia i propri dati sulla linea oppure la tiene a un livello fisso e rompe la sincronizzazione del bootloader. Il risultato è di nuovo programmer is not responding o not in sync. La soluzione più rapida è scollegare i fili di D0 e D1 durante il caricamento; quella definitiva è spostare il modulo su altri pin con SoftwareSerial:

1#include <SoftwareSerial.h>
2
3// HC-05 TX -> D10, HC-05 RX <- D11 (gerilim bölücüyle / through a voltage divider)
4SoftwareSerial bt(10, 11);   // RX, TX pinleri / RX, TX pins
5
6void setup() {
7  Serial.begin(9600);        // USB: Seri Monitör / USB: Serial Monitor
8  bt.begin(9600);            // HC-05 veri modu hızı / HC-05 data mode baud rate
9  Serial.println("Hazir / Ready");
10}
11
12void loop() {
13  if (bt.available()) Serial.write(bt.read());      // telefondan bilgisayara / phone to PC
14  if (Serial.available()) bt.write(Serial.read());  // bilgisayardan telefona / PC to phone
15}

In questo sketch il TX dell'HC-05 va su D10 e il suo RX su D11. L'ingresso RX dell'HC-05 lavora a 3,3 V, quindi metti tra esso e D11 un partitore di tensione con resistenze da 1 kΩ e 2 kΩ. Ora puoi caricare il codice con il modulo collegato e inviare al telefono ciò che scrivi nel Monitor seriale. Per il collegamento completo e la modalità comandi AT, leggi la guida al modulo Bluetooth HC-05. Con una Mega non serve SoftwareSerial: la scheda ha porte seriali hardware aggiuntive come Serial1 (TX1 = D18, RX1 = D19).

Il Monitor seriale e i programmi che occupano la porta

Una porta seriale può essere aperta da un solo programma alla volta. Per questo Windows mostra Access is denied (in italiano Accesso negato) e macOS e Linux mostrano Resource busy. L'Arduino IDE di solito mette in pausa il proprio Monitor seriale durante il caricamento, ma non funziona alla perfezione in ogni versione e con ogni scheda, soprattutto con l'ESP32; se ricevi l'errore, chiudi prima il pannello del Monitor seriale. Più spesso la porta è tenuta da qualcos'altro: una seconda finestra dell'IDE, il Plotter seriale rimasto aperto, PuTTY, programmi per stampanti 3D come Cura, il monitor di PlatformIO in VS Code o uno script Python in background. Chiudili, scollega e ricollega la scheda e riprova. Su Linux puoi vedere quale programma occupa la porta con sudo lsof /dev/ttyUSB0.

La scheda è guasta? Test di loopback e scrittura del bootloader

Se hai provato tutto quanto sopra e il caricamento continua a non andare, devi capire se il problema è nella parte USB o nel processore principale. Il metodo classico per Uno e Nano è il test di loopback: tieni il processore principale in reset e fai parlare il chip USB-seriale con se stesso. Per questa prova non serve caricare alcun codice.

1. Togli tutti i fili dalla scheda e lascia collegato solo il cavo USB.
2. Con un cavetto jumper collega il pin RESET a GND; così l'ATmega328P resta in reset e non disturba la linea.
3. Con un secondo cavetto collega tra loro i pin D0 e D1.
4. Seleziona nell'IDE la porta della scheda e apri il Monitor seriale; la velocità non conta per questa prova.
5. Scrivi qualche carattere nella casella e invialo. Se il testo torna identico, cavo, driver e chip USB-seriale funzionano e il problema è nel processore principale o nel bootloader. Se non torna nulla, il problema è nella parte USB.
6. Alla fine della prova non dimenticare di togliere entrambi i cavetti.

Se il test di loopback va a buon fine ma il caricamento continua a fallire, e premendo reset il LED L non lampeggia brevemente, il bootloader potrebbe essere stato cancellato o il chip sostituito. Puoi riscrivere il bootloader con un secondo Uno. Carica File > Esempi > 11.ArduinoISP > ArduinoISP sull'Uno che farà da programmatore. Poi collega il D10 del programmatore al pin RESET della scheda di destinazione, D11, D12 e D13 ai pin con lo stesso numero della destinazione, e 5V e GND tra loro. Metti un condensatore da 10 µF tra RESET e GND dell'Uno programmatore; così eviti che si resetti da solo. Infine scegli Strumenti > Programmatore > Arduino as ISP, seleziona la scheda di destinazione nel menu delle schede e avvia Strumenti > Scrivi il bootloader. Con questo metodo puoi anche dare il nuovo Optiboot a un clone di Nano.

ESP32 non carica lo sketch: Failed to connect e il tasto BOOT

Sull'ESP32 il caricamento non lo fa avrdude, ma esptool. Nell'output compare prima la riga Connecting........_____..... mentre esptool cerca di mettere la scheda in modalità download. Se non ci riesce, ottieni un errore che inizia con A fatal error occurred: Failed to connect to ESP32. Nelle versioni attuali di esptool, se la scheda si è avviata normalmente, il messaggio prosegue con Wrong boot mode detected (0x13)! The chip needs to be in download mode.; 0x13 indica che la scheda si è avviata nella modalità normale invece che in quella di download. Se la scheda non risponde affatto, il messaggio termina con No serial data received; le versioni più vecchie lo scrivono come Timed out waiting for packet header. Se la scheda non entra da sola in modalità download, lo fai tu a mano.

1. Fai clic su Carica nell'IDE e osserva la finestra di output.
2. Appena compare Connecting..., tieni premuto il tasto BOOT sulla scheda.
3. Se ancora non si collega, con BOOT premuto dai una breve pressione a EN e rilascialo.
4. Rilascia BOOT quando nell'output iniziano a scorrere le righe Writing at e la percentuale del caricamento.
5. Il caricamento termina con Hard resetting via RTS pin.... Se il programma non parte, premi EN una volta.

Perché succede? Per entrare in modalità download, il pin GPIO0 dell'ESP32 deve essere LOW al momento dell'avvio. Il circuito di reset automatico a due transistor delle schede di sviluppo lo fa da solo con i segnali DTR e RTS del chip USB; sulle schede economiche questo circuito può sbagliare i tempi. Se ti sei stancato di premere BOOT ogni volta, c'è una soluzione permanente: collega un condensatore elettrolitico da 10 µF tra il pin EN e GND della scheda (il terminale negativo su GND). Il condensatore rallenta la salita della linea EN e dà al circuito di reset automatico il tempo di tenere GPIO0 a LOW.

1// ESP32 yükleme testi / ESP32 upload test
2const int LED_PIN = 2;   // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);   // Seri Monitör 115200 baud / Serial Monitor at 115200 baud
7  delay(500);
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                 // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Flash (MB): ");
11  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
12  Serial.print("CPU (MHz): ");
13  Serial.println(getCpuFrequencyMhz());
14}
15
16void loop() {
17  digitalWrite(LED_PIN, !digitalRead(LED_PIN));   // LED'i tersle / toggle the LED
18  delay(500);
19}

Raspberry Pi Pico: caricare con BOOTSEL e UF2

Il Pico non ha un chip USB-seriale separato; l'RP2040 ha un proprio controller USB e il bootloader si trova nella ROM del chip, che non si può cancellare. Per questo è quasi impossibile rendere inutilizzabile un Pico via software. Se tieni premuto il tasto BOOTSEL mentre colleghi il cavo USB, il Pico compare sul computer come un'unità chiamata RPI-RP2 (sul Pico 2 l'unità si chiama RP2350). Qualsiasi file .uf2 trascinato su questa unità viene scritto sulla scheda, che poi si riavvia da sola; è così che si installa anche MicroPython.

Se programmi il Pico con l'Arduino IDE, al primo caricamento non c'è ancora una porta COM; collega la scheda tenendo premuto BOOTSEL e fai clic su Carica. Dopo il primo sketch la scheda apre una porta seriale e i caricamenti successivi non richiedono più BOOTSEL. Se il codice si blocca o spegne la USB, la porta sparisce di nuovo e compare l'errore No drive to deploy; allora torna al metodo BOOTSEL. Se usi MicroPython, in basso a destra in Thonny deve essere selezionato l'interprete MicroPython (Raspberry Pi Pico). Per i pin e la configurazione del Pico, leggi la guida Che cos'è il Raspberry Pi Pico?.

1import time
2from machine import Pin
3
4time.sleep(3)   # açılışta 3 sn bekle, Thonny durdurabilsin / wait 3 s so Thonny can stop the script
5
6led = Pin("LED", Pin.OUT)   # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
7sayac = 0
8while True:
9    led.toggle()
10    print("Calisiyor / running", sayac)
11    sayac += 1
12    time.sleep(0.5)

Piccole cause subdole che è facile trascurare

• Leonardo, Micro e Uno R4: su queste schede con USB nativa la porta può cambiare per un attimo durante il caricamento. Se il caricamento si blocca, fai clic su Carica e premi una volta il tasto reset appena la compilazione finisce e inizia il caricamento (due volte rapidamente sull'Uno R4); la scheda resta per un po' nel bootloader e il codice viene caricato in quel momento.
• Reset automatico guasto: se il reset automatico non funziona su Uno o Nano, tieni premuto reset, fai clic su Carica e rilascialo appena nell'output compare la riga con la dimensione dello sketch.
• Shield e circuiti esterni: uno shield motori o un circuito che carica la linea 5V può far calare la tensione durante il caricamento e interrompere la scrittura a metà.
• Porta sbagliata su macOS: /dev/cu.Bluetooth-Incoming-Port e /dev/cu.debug-console nell'elenco delle porte non sono la tua scheda, ma porte del sistema. La porta della scheda contiene usbmodem, usbserial o wchusbserial nel nome; se hai dubbi, scollega e ricollega la scheda e guarda quale sparisce.
• Caratteri speciali nel nome utente: se la cartella del tuo utente Windows contiene lettere accentate o altri caratteri speciali, gli strumenti di compilazione e caricamento di alcuni pacchetti di schede, soprattutto quello dell'ESP32, potrebbero non trovare i file. Sposta la cartella degli sketch su un percorso senza questi caratteri dalle Impostazioni; se il problema resta, crea un nuovo utente Windows.
• Sketch troppo grande: l'avviso Sketch too big non è un errore di caricamento; significa che il codice non entra nei circa 31,5 KB di flash che restano all'Uno dopo il bootloader. Riduci librerie e testi lunghi o passa a una scheda più grande.
• Porta bloccata dopo lo standby: quando il computer esce dallo standby la porta può restare bloccata; riavviare l'IDE o collegare la scheda a un'altra porta USB di solito basta.

Il caricamento funziona: e adesso?

• Primo circuito: monta il tuo circuito Blink con un LED e una resistenza, poi aggiungi un pulsante per il tuo primo progetto interattivo.
• Comunicazione seriale: ora che sai come i pin 0 e 1 influiscono sul caricamento, prova ad accendere un LED dal telefono con il modulo Bluetooth HC-05.
• Leggere i sensori: con la guida ai sensori per Arduino scegli i tuoi primi progetti per misurare temperatura, distanza e luce.
• Passare al wireless: realizza con l'ESP32 un progetto che si collega al Wi-Fi e si controlla dal telefono; grazie all'OTA, più avanti potrai caricare il codice anche senza fili.
• Scegliere la scheda giusta: se sei indeciso tra Uno, Nano e Mega, leggi Quale Arduino comprare?.

Gli errori di caricamento sono fastidiosi la prima volta, ma ognuno ha una causa logica e quasi tutti si trovano nello stesso ordine: cavo, driver, porta, impostazioni della scheda, linea seriale e infine bootloader. Tieni a mente questo ordine e risolverai il prossimo errore in pochi minuti. Appena la tua scheda accetta codice, nell'app BlueGrays trovi tanti progetti per Arduino, ESP32 e Raspberry Pi Pico, dall'accensione di un LED fino al Wi-Fi e agli aggiornamenti OTA senza fili, ognuno con lo schema di collegamento passo passo e il codice pronto, per mettere subito al lavoro la tua scheda.