Arduino Sketch lässt sich nicht hochladen: avrdude-Fehler lösen

Dein Arduino-Sketch lässt sich nicht hochladen und im Ausgabefenster steht ein roter avrdude-Fehler? Keine Sorge: Fast nie ist das Board kaputt. Meist steckt ein reines Ladekabel, ein fehlender CH340-Treiber, ein falsch gewähltes Board oder ein falscher Port, ein Modul an Pin 0 und 1 oder ein anderes Programm dahinter, das den Port blockiert. Wenn du in der richtigen Reihenfolge prüfst, hast du das Problem meist in wenigen Minuten gelöst; und selbst wenn das Board wirklich defekt ist, kannst du das mit einem einfachen Test sicher feststellen.

In dieser Anleitung siehst du zuerst, was beim Hochladen im Hintergrund passiert und wie du die Fehlermeldung liest. Danach grenzen wir das Problem mit einer Diagnosetabelle aus Symptom, Ursache und Lösung Schritt für Schritt ein. Außerdem behandeln wir die Einstellung ATmega328P (Old Bootloader) beim Arduino Nano, den seriellen Monitor und andere Programme, die den Port sperren, den ESP32-Fehler Failed to connect mit der BOOT-Taste sowie die BOOTSEL- und UF2-Methode beim Raspberry Pi Pico. In jedem Abschnitt findest du einen kurzen Test-Sketch, mit dem du dein Board nach der Lösung prüfen kannst.

So funktioniert das Hochladen: Kompilierfehler oder Upload-Fehler?

Wenn du auf Hochladen klickst, passieren zwei getrennte Dinge. Zuerst kompiliert die IDE deinen Code; klappt das, zeigt das Ausgabefenster eine Zeile mit der Größe des Sketches in Bytes (in der englischen Oberfläche Sketch uses 924 bytes). Dann öffnet das Programm avrdude den gewählten Port, startet das Board über das DTR-Signal neu und nimmt Kontakt mit dem kleinen Ladeprogramm im Board auf, dem Bootloader. Nach einem Reset lauscht der Bootloader nur etwa eine Sekunde lang; kommen in dieser Zeit keine Daten, läuft das alte Programm einfach weiter. An der Fehlermeldung erkennst du, welches Glied dieser Kette gerissen ist. Erscheint der rote Text schon beim Kompilieren, liegt der Fehler in deinem Code und hat nichts mit Board oder Kabel zu tun.

Die häufigsten avrdude-Fehler und ihre Bedeutung

Diagnosetabelle Schritt für Schritt: Symptom, Ursache, Lösung

Lies die Tabelle von oben nach unten; die ersten Zeilen sind die häufigsten und am leichtesten zu behebenden Probleme. Versuche den Upload nach jeder Änderung erneut. Wenn du mehrere Dinge gleichzeitig änderst, weißt du nie, was geholfen hat, und derselbe Fehler überrascht dich beim nächsten Mal wieder.

Schnelle Checkliste und Test-Sketch für den Upload

1. Entferne alles vom Board: Shields, Module und die Kabel an Pin 0 und 1. Nur das USB-Kabel bleibt angesteckt.
2. Stecke das Board direkt in einen USB-Port auf der Rückseite des Computers; meide Hubs, Verlängerungen und Buchsen an der Gehäusefront.
3. Öffne Werkzeuge > Port und sieh dir die Liste an. Ziehe das Board ab, stecke es wieder an und merke dir, welcher Port verschwindet und wiederkommt. Ändert sich die Liste nie, liegt es am Kabel oder am Treiber.
4. Wähle unter Werkzeuge > Board genau dein Modell; beim Nano zusätzlich unter Werkzeuge > Processor den passenden Bootloader.
5. Stelle sicher, dass kein anderes Programm und kein zweites IDE-Fenster den Port benutzt; schließe im Zweifel alle.
6. Aktiviere die ausführliche Ausgabe beim Hochladen und lade den kleinen Test-Sketch unten hoch. Mit Code, der sicher fehlerfrei ist, schließt du Kompilierprobleme aus.
7. Klappt es immer noch nicht, drücke die Reset-Taste: Blinkt die L-LED ein- oder mehrmals kurz, lebt der Bootloader. Geh dann zum Loopback-Test weiter unten.
8. Teste an einem anderen Computer oder mit einem anderen Board. Wandert das Problem mit dem Board, liegt es am Board; bleibt es am Computer, liegt es am Treiber oder an den Systemeinstellungen.

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}

Hat der Upload geklappt, blinkt die L-LED kurz auf und bleibt länger aus, und der Zähler läuft hoch, wenn du den seriellen Monitor mit 9600 Baud öffnest. Willst du sicher sein, dass wirklich der neue Code auf dem Board ist, ändere delay(200) in delay(50) und lade erneut hoch: Ändert sich der Blinkrhythmus nicht, läuft noch das alte Programm. Siehst du im seriellen Monitor wirre Zeichen, passt die im seriellen Monitor eingestellte Baudrate nicht zum Code; das ist kein Upload-Fehler.

COM-Port wird nicht angezeigt: USB-Kabel und CH340-, CP2102-Treiber

Ist das Port-Menü grau oder leer, ist das Kabel der erste Verdächtige. Viele dünne Kabel aus Handy-Ladegeräten haben nur die beiden Stromadern; die Datenleitungen D+ und D- fehlen ganz. Mit so einem Kabel leuchtet die Power-LED des Boards, was in die Irre führt, aber der Computer erkennt kein Gerät und spielt nicht einmal den Anschluss-Ton. Teste dein Kabel, indem du Dateien auf ein Handy überträgst, oder mit einem Board, von dem du weißt, dass es funktioniert. Das dicke Typ-B-Kabel des Uno hat dieses Problem selten; sehr häufig tritt es beim Mini-USB des Nano und bei Micro-USB- oder USB-C-Kabeln von ESP32 und Pico auf.

Ist das Kabel in Ordnung, ist der Treiber der zweite Verdächtige. Lies die Aufschrift auf dem Chip neben der USB-Buchse: Original Arduino Uno und Mega nutzen einen ATmega16U2, geklonte Uno- und Nano-Boards meist einen CH340G oder CH340C, ESP32-Entwicklungsboards meist einen CP2102 oder CH340. Öffne unter Windows den Geräte-Manager: Wird das Board erkannt, steht es unter Anschlüsse (COM & LPT). Siehst du unter Andere Geräte ein USB2.0-Serial mit gelbem Ausrufezeichen, fehlt der CH340-Treiber.

Windows 10 und 11 installieren die Treiber für CH340 und CP2102 meist selbst über Windows Update. Falls nicht, lade von der Website des Chipherstellers den Treiber CH341SER für den CH340 oder CP210x VCP für den CP2102 herunter, installiere ihn und stecke das Board neu an. Aktuelle macOS-Versionen bringen Treiber für beide Chips mit; alte Treiber aus verschiedenen Quellen übereinander zu installieren, macht es meist schlimmer. Unter Linux sind die Treiber schon im Kernel, aber damit du den Port nutzen darfst, musst du deinen Benutzer zur Gruppe dialout hinzufügen (sudo usermod -a -G dialout $USER) und dich ab- und wieder anmelden; sonst erscheint Permission denied. Verschwindet der Port unter Ubuntu 22.04 oder neuer direkt nach dem Einstecken eines CH340-Boards, ist meist das Screenreader-Paket brltty schuld; wenn du es nicht brauchst, entferne es mit sudo apt remove brltty.

Falsches Board, falscher Prozessor oder falscher Port

In der Arduino IDE 2 wählst du Board und Port in der Auswahlliste oben oder über Werkzeuge > Board und Werkzeuge > Port. Unter Windows siehst du in der Liste eventuell COM1 oder einige virtuelle Bluetooth-Ports; den richtigen findest du am einfachsten, indem du das Board absteckst und schaust, welcher Port verschwindet. Ist im Board-Menü ein falsches Modell gewählt, etwa Mega statt Uno oder Leonardo statt Nano, bekommt avrdude entweder gar keine Antwort oder sieht in der Zeile Device signature eine unerwartete Chip-Kennung. Noch ein Hinweis: Nutze für einen normalen Upload Strg+U. Sketch > Mit Programmer hochladen erwartet einen externen ISP-Programmer und löscht bei Erfolg den Bootloader auf dem Board; danach nimmt das Board keine Uploads über USB mehr an.

Arduino Nano lässt sich nicht hochladen: ATmega328P (Old Bootloader)

Die meisten günstigen Nano-Boards im Handel sind Klone mit CH340, und viele davon haben noch den alten Bootloader. Anfang 2018 ersetzte Arduino den Bootloader des Nano durch den kleineren und schnelleren Optiboot vom Uno; seitdem spricht die Standardoption ATmega328P der IDE mit 115200 Baud. Der alte Bootloader erwartet 57600 Baud. Passen die Geschwindigkeiten nicht, scheint das Board gar nicht zu antworten, und der Fehler not in sync: resp=0x00 wiederholt sich zehnmal. Die Lösung ist eine einzige Menüeinstellung: Werkzeuge > Processor > ATmega328P (Old Bootloader). Weil diese Optionen aus dem Board-Paket stammen, heißt das Menü in der Arduino IDE 2 auch in der deutschen Oberfläche Processor (in der alten IDE 1.8 Prozessor). Wenn du nicht weißt, welche Option stimmt, probiere sie nacheinander aus; eine falsche Wahl schadet dem Board nicht.

Module an Pin 0 und 1 blockieren den Upload

Beim Uno und Nano ist der USB-Seriell-Chip über 1-kΩ-Widerstände an den Pins D0 (RX) und D1 (TX) mit dem ATmega328P verbunden. Während des Uploads gehört diese Leitung dem Computer. Hängt ein serielles Modul wie ein HC-05-Bluetooth-Modul, ein GPS, ein ESP-01 oder ein Fingerabdrucksensor an diesen Pins, sendet es eigene Daten auf die Leitung oder hält sie auf einem festen Pegel und stört die Synchronisation des Bootloaders. Das Ergebnis ist wieder programmer is not responding oder not in sync. Am schnellsten hilft es, die Kabel an D0 und D1 während des Uploads abzuziehen; dauerhaft löst du es, indem du das Modul per SoftwareSerial an andere Pins legst:

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 diesem Sketch kommt TX des HC-05 an D10 und RX an D11. Der RX-Eingang des HC-05 arbeitet mit 3,3 V, setze deshalb zwischen ihn und D11 einen Spannungsteiler aus 1 kΩ und 2 kΩ. Jetzt kannst du mit angeschlossenem Modul hochladen und alles, was du in den seriellen Monitor tippst, an dein Handy schicken. Die komplette Verdrahtung und den AT-Befehlsmodus findest du im Artikel HC-05 Bluetooth-Modul. Mit einem Mega brauchst du kein SoftwareSerial: Er hat zusätzliche Hardware-Schnittstellen wie Serial1 (TX1 = D18, RX1 = D19).

Serieller Monitor und Programme, die den Port blockieren

Ein serieller Port kann immer nur von einem Programm geöffnet werden. Deshalb meldet Windows Access is denied (auf Deutsch Zugriff verweigert) und macOS sowie Linux Resource busy. Die Arduino IDE pausiert ihren eigenen seriellen Monitor beim Hochladen normalerweise automatisch, aber das klappt nicht in jeder Version und mit jedem Board zuverlässig, vor allem nicht beim ESP32; bekommst du den Fehler, schließe zuerst den Tab des seriellen Monitors. Häufiger hält etwas anderes den Port fest: ein zweites IDE-Fenster, ein offener serieller Plotter, PuTTY, 3D-Drucker-Software wie Cura, der PlatformIO-Monitor in VS Code oder ein Python-Skript im Hintergrund. Schließe sie, stecke das Board neu an und versuche es noch einmal. Unter Linux siehst du mit sudo lsof /dev/ttyUSB0, welches Programm den Port belegt.

Ist das Board kaputt? Loopback-Test und Bootloader brennen

Hast du alles oben probiert und der Upload klappt immer noch nicht, musst du herausfinden, ob das Problem auf der USB-Seite oder im Hauptprozessor liegt. Die klassische Methode für Uno und Nano ist der Loopback-Test: Du hältst den Hauptprozessor im Reset und lässt den USB-Seriell-Chip mit sich selbst sprechen. Für diesen Test musst du keinen Code hochladen.

1. Ziehe alle Kabel vom Board ab, nur das USB-Kabel bleibt angesteckt.
2. Verbinde mit einem Jumper-Kabel den Pin RESET mit GND; so bleibt der ATmega328P im Reset und stört die Leitung nicht.
3. Verbinde mit einem zweiten Kabel die Pins D0 und D1 miteinander.
4. Wähle in der IDE den Port des Boards und öffne den seriellen Monitor; die Baudrate spielt für diesen Test keine Rolle.
5. Tippe ein paar Zeichen in das Eingabefeld und sende sie. Kommt dein Text genau so zurück, sind Kabel, Treiber und USB-Seriell-Chip in Ordnung und das Problem liegt im Hauptprozessor oder im Bootloader. Kommt nichts zurück, liegt das Problem auf der USB-Seite.
6. Vergiss nicht, nach dem Test beide Kabel wieder abzuziehen.

Besteht das Board den Loopback-Test, der Upload scheitert aber weiter und die L-LED blinkt beim Druck auf Reset nicht kurz auf, ist der Bootloader vielleicht gelöscht oder der Chip wurde getauscht. Mit einem zweiten Uno kannst du den Bootloader neu brennen. Lade auf den Uno, der als Programmer dienen soll, den Sketch Datei > Beispiele > 11.ArduinoISP > ArduinoISP. Verbinde dann D10 des Programmers mit dem RESET-Pin des Ziel-Boards, D11, D12 und D13 mit den gleichnamigen Pins des Ziels sowie 5V und GND miteinander. Stecke beim Programmer-Uno einen 10-µF-Kondensator zwischen RESET und GND; das verhindert, dass er sich selbst zurücksetzt. Wähle zum Schluss Werkzeuge > Programmer > Arduino as ISP, stelle im Board-Menü das Ziel-Board ein und starte Werkzeuge > Bootloader brennen. So kannst du auch einem Nano-Klon den neuen Optiboot verpassen.

ESP32 lässt sich nicht flashen: Failed to connect und die BOOT-Taste

Beim ESP32 übernimmt nicht avrdude, sondern esptool den Upload. In der Ausgabe erscheint zuerst die Zeile Connecting........_____....., während esptool versucht, das Board in den Download-Modus zu bringen. Klappt das nicht, bekommst du einen Fehler, der mit A fatal error occurred: Failed to connect to ESP32 beginnt. In aktuellen esptool-Versionen geht die Meldung, wenn das Board normal gestartet ist, mit Wrong boot mode detected (0x13)! The chip needs to be in download mode. weiter; 0x13 bedeutet, dass das Board im normalen Startmodus statt im Download-Modus gestartet ist. Antwortet das Board gar nicht, endet die Meldung mit No serial data received; ältere Versionen schreiben dafür Timed out waiting for packet header. Schafft das Board den Download-Modus nicht von selbst, erledigst du das von Hand.

1. Klicke in der IDE auf Hochladen und beobachte das Ausgabefenster.
2. Sobald Connecting... erscheint, halte die BOOT-Taste auf dem Board gedrückt.
3. Verbindet es sich immer noch nicht, drücke bei gehaltener BOOT-Taste einmal kurz auf EN und lass los.
4. Lass BOOT los, wenn in der Ausgabe Zeilen mit Writing at und die Prozentwerte des Uploads durchlaufen.
5. Der Upload endet mit Hard resetting via RTS pin.... Startet das Programm nicht, drücke einmal EN.

Warum passiert das? Damit der ESP32 in den Download-Modus geht, muss sein Pin GPIO0 beim Start LOW sein. Die Auto-Reset-Schaltung aus zwei Transistoren auf den Entwicklungsboards erledigt das automatisch über die Signale DTR und RTS des USB-Chips; bei billigen Boards verpasst diese Schaltung manchmal das Timing. Wenn du nicht jedes Mal BOOT drücken willst, gibt es eine dauerhafte Lösung: Schließe zwischen den Pin EN und GND einen 10-µF-Elektrolytkondensator an (Minus an GND). Der Kondensator verzögert den Anstieg der EN-Leitung und gibt der Auto-Reset-Schaltung Zeit, GPIO0 auf LOW zu halten.

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: Hochladen mit BOOTSEL und UF2

Der Pico hat keinen eigenen USB-Seriell-Chip; der RP2040 besitzt einen eigenen USB-Controller, und der Bootloader liegt im ROM des Chips, das sich nicht löschen lässt. Deshalb kannst du einen Pico per Software praktisch nicht unbrauchbar machen. Hältst du beim Einstecken des USB-Kabels die Taste BOOTSEL gedrückt, erscheint der Pico am Computer als Laufwerk namens RPI-RP2 (beim Pico 2 heißt es RP2350). Jede .uf2-Datei, die du auf dieses Laufwerk ziehst, wird auf das Board geschrieben, das danach von selbst neu startet; so installierst du auch MicroPython.

Programmierst du den Pico mit der Arduino IDE, gibt es beim ersten Upload noch keinen COM-Port; stecke das Board mit gedrückter BOOTSEL-Taste an und klicke auf Hochladen. Nach dem ersten Sketch öffnet das Board einen seriellen Port, und spätere Uploads brauchen kein BOOTSEL mehr. Stürzt dein Code ab oder schaltet er USB ab, verschwindet der Port wieder und du bekommst den Fehler No drive to deploy; dann gehst du zurück zur BOOTSEL-Methode. Nutzt du MicroPython, muss in Thonny unten rechts der Interpreter MicroPython (Raspberry Pi Pico) ausgewählt sein. Pins und Einrichtung des Pico findest du im Artikel Was ist der 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)

Kleine, aber tückische Ursachen, die man leicht übersieht

• Leonardo, Micro und Uno R4: Bei diesen Boards mit nativem USB kann der Port während des Uploads kurz wechseln. Hängt der Upload, klicke auf Hochladen und drücke die Reset-Taste einmal, sobald das Kompilieren fertig ist und der Upload beginnt (beim Uno R4 zweimal schnell); das Board wartet dann eine Weile im Bootloader, und der Code wird in dieser Zeit hochgeladen.
• Defekter Auto-Reset: Funktioniert der Auto-Reset beim Uno oder Nano nicht, halte die Reset-Taste gedrückt, klicke auf Hochladen und lass die Taste los, sobald in der Ausgabe die Zeile mit der Sketch-Größe erscheint.
• Shields und externe Schaltungen: Ein Motortreiber-Shield oder eine Schaltung, die die 5-V-Leitung belastet, kann die Versorgungsspannung beim Upload einbrechen lassen und den Schreibvorgang abbrechen.
• Falscher Port unter macOS: /dev/cu.Bluetooth-Incoming-Port und /dev/cu.debug-console in der Portliste sind nicht dein Board, sondern Ports des Systems. Der Port deines Boards enthält usbmodem, usbserial oder wchusbserial im Namen; bist du unsicher, stecke das Board ab und wieder an und schau, welcher Port verschwindet.
• Umlaute im Benutzernamen: Enthält dein Windows-Benutzerordner Umlaute oder Sonderzeichen, finden die Kompilier- und Upload-Werkzeuge mancher Board-Pakete, vor allem beim ESP32, Dateien eventuell nicht. Verlege den Sketchbook-Ordner in den Einstellungen auf einen Pfad ohne solche Zeichen; hilft das nicht, lege einen neuen Windows-Benutzer an.
• Sketch zu groß: Die Warnung Sketch too big ist kein Upload-Fehler; sie bedeutet, dass dein Code nicht in die rund 31,5 KB Flash passt, die beim Uno nach dem Bootloader übrig bleiben. Spare bei Bibliotheken und langen Texten oder nimm ein größeres Board.
• Port hängt nach dem Standby: Nach dem Aufwachen aus dem Standby kann der Port hängen bleiben; die IDE neu zu starten oder das Board an einen anderen USB-Port zu stecken, reicht meist.

Der Upload klappt: Wie geht es weiter?

• Erste Schaltung: Baue mit einer LED und einem Widerstand deine eigene Blink-Schaltung und ergänze dann einen Taster für dein erstes interaktives Projekt.
• Serielle Kommunikation: Jetzt, wo du weißt, wie Pin 0 und 1 den Upload beeinflussen, schalte mit dem HC-05-Bluetooth-Modul eine LED per Handy.
• Sensoren auslesen: Such dir mit dem Arduino-Sensoren-Ratgeber erste Projekte aus, die Temperatur, Entfernung und Licht messen.
• Kabellos werden: Baue mit dem ESP32 ein Projekt, das sich ins WLAN einwählt und per Handy gesteuert wird; dank OTA kannst du Code später sogar kabellos hochladen.
• Das richtige Board wählen: Kannst du dich zwischen Uno, Nano und Mega nicht entscheiden, lies Welchen Arduino soll ich kaufen?.

Upload-Fehler nerven beim ersten Mal, aber jeder hat eine logische Ursache, und fast alle findest du in derselben Reihenfolge: Kabel, Treiber, Port, Board-Einstellungen, serielle Leitung und zuletzt der Bootloader. Behalte diese Reihenfolge im Kopf, dann löst du den nächsten Fehler in Minuten. Sobald dein Board Code annimmt, findest du in der BlueGrays-App viele Projekte für Arduino, ESP32 und Raspberry Pi Pico, vom Blinken einer LED bis zu WLAN und kabellosen OTA-Updates, jeweils mit Schritt-für-Schritt-Schaltplan und fertigem Code, damit dein Board sofort etwas zu tun bekommt.