ESP32 mit der Arduino IDE: Board-Paket installieren und den ersten Sketch ausführen

Die Arduino IDE ist der freundlichste Weg, einen ESP32 zu programmieren. Sie schreiben C++ mit den vertrauten Arduino-Funktionen, klicken auf Hochladen, und das Board führt Ihren Code aus. Dieser Leitfaden führt Sie von null zu einer blinkenden LED.
Wenn Ihr Board gar nicht erscheint, beginnen Sie mit unserer Checkliste für den ESP32-Einstieg und kommen Sie dann zurück.
Was Sie brauchen
- Ein ESP32-Board: das ESP32 DevKit oder das ESP32-S3 N16R8.
- Ein USB-Datenkabel.
- Eine LED und einen 330-Ohm-Widerstand (optional: Sie können die eingebaute LED nutzen).
- Einen Computer mit Windows, macOS oder Linux.

Schritt 1: Arduino IDE installieren
Laden Sie die aktuelle Arduino IDE von der offiziellen Arduino-Software-Seite herunter und installieren Sie sie. Öffnen Sie sie einmal, damit sie ihre Einrichtung abschließen kann.
Schritt 2: Espressif-Board-URL hinzufügen
Öffnen Sie Datei, Einstellungen. Tragen Sie unter Zusätzliche Boardverwalter-URLs den stabilen Paketindex von Espressif ein:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Das ist die URL der stabilen Version aus Espressifs Arduino-Einstiegsanleitung. Stehen dort schon andere URLs, behalten Sie sie und trennen die neue mit einem Komma ab. Klicken Sie auf OK.
Schritt 3: das esp32-Paket installieren
Öffnen Sie Werkzeuge, Board, Boardverwalter, suchen Sie nach esp32 und installieren Sie esp32 by Espressif Systems. Der Download ist groß, geben Sie ihm ein paar Minuten.
Eine Warnung: Es gibt auch ein Paket namens „Arduino ESP32 Boards". Es unterstützt nur Arduinos eigene Boards. Für die Boards in unserem Shop brauchen Sie das von Espressif. Die offizielle Installationsanleitung für Arduino-ESP32 beschreibt dasselbe Vorgehen und Alternativen.
Schritt 4: Board und Port wählen
- Wählen Sie unter Werkzeuge, Board ESP32 Dev Module für das klassische DevKit oder ESP32S3 Dev Module für einen ESP32-S3.
- Wählen Sie unter Werkzeuge, Port den seriellen Port, der beim Anstecken des Boards erscheint.
- Setzen Sie beim N16R8 zusätzlich Flash Size auf 16MB und PSRAM auf OPI PSRAM, wie in unserem N16R8-Leitfaden beschrieben.
Schritt 5: Ihr erster Sketch
Dieser Sketch lässt eine LED an GPIO4 blinken und gibt einmal pro Sekunde eine Meldung aus. Mit GPIO4 müssen Sie nicht raten, welcher Pin die Onboard-LED trägt; er ist ein sicherer Pin, siehe den Pinout-Leitfaden.
const int LED_PIN = 4;
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
Serial.println("Hello from the ESP32");
}
void loop() {
digitalWrite(LED_PIN, HIGH);
Serial.println("LED on");
delay(1000);
digitalWrite(LED_PIN, LOW);
Serial.println("LED off");
delay(1000);
}
Verbinden Sie das lange Bein der LED über den 330-Ohm-Widerstand mit GPIO4 und das kurze Bein mit GND.
Schritt 6: hochladen und die Ausgabe lesen
Klicken Sie auf den Hochladen-Pfeil. Die IDE kompiliert den Code und sendet ihn an das Board. Öffnen Sie Werkzeuge, Serieller Monitor und stellen Sie 115200 ein. Sie sollten die Meldungen und eine blinkende LED sehen.
Bleibt der Upload bei „Connecting..." hängen, halten Sie die BOOT-Taste am Board gedrückt, bis der Upload beginnt, und lassen Sie sie dann los. Manche Boards brauchen das beim ersten Mal.
Häufige Probleme
- Kein serieller Port: Probieren Sie ein anderes Kabel und installieren Sie den CP210x- oder CH340-Treiber, falls Ihr Board diesen Chip nutzt.
- „Failed to connect": Halten Sie BOOT während des Uploads gedrückt und prüfen Sie, ob das richtige Board gewählt ist.
- Zeichensalat im Seriellen Monitor: Die Baudrate passt nicht zu
Serial.begin(115200). - Upload klappt, aber nichts passiert: Prüfen Sie die Verdrahtung und ob Sie einen freien Pin genutzt haben.
- Board startet in einer Schleife neu: Prüfen Sie die Flash- und PSRAM-Einstellungen für Ihr genaues Board.
Nächste Schritte
- Einen Sensor lesen: Das DHT22-Tutorial nutzt dieselbe Verdrahtung, mit ESPHome.
- Mit Batterie laufen: ESP32 Deep Sleep.
- Lieber ohne Code? Probieren Sie ESPHome mit einem Xiaomi-Mijia-Thermometer.
Fazit
Vier Dinge zum Merken: die Espressif-URL hinzufügen, „esp32 by Espressif Systems" installieren, das richtige Board und den richtigen Port wählen und ein Datenkabel nutzen. Sobald Ihre erste LED blinkt, ist alles Weitere dieselbe Schleife mit anderen Sensoren.
Der Sketch nutzt nur Standard-Arduino-Funktionen. Er wurde in der Entstehungsumgebung dieses Artikels nicht kompiliert: Melden Sie sich, wenn Sie auf ein Problem stoßen.
Quellen
- Espressif: Installationsanleitung für Arduino-ESP32 (auf Englisch)
- Espressif Developer Portal: Einstieg in Arduino auf dem ESP32 (auf Englisch)
- Arduino: Software-Downloads
- Omar Ghader, ESP32-Smart-Home-Projekte (auf Englisch)