Anleitung zur Inbetriebnahme eines ESP32 in Arduino IDE

Diese Anleitung bietet eine detaillierte Schritt-für-Schritt-Anleitung für die erstmalige Inbetriebnahme eines ESP32-Entwicklungsboards in der Arduino IDE

67f7f0e70e9cc_esp32_development_board_rotated.webp

ESP32 mit Arduino IDE: Installation und erste Schritte

Der ESP32 ist ein leistungsstarker und vielseitiger Mikrocontroller, der sich durch seine integrierte Wi-Fi- und Bluetooth-Funktionalität auszeichnet und somit eine ideale Plattform für eine breite Palette von Anwendungen im Bereich des Internets der Dinge (IoT) und darüber hinaus darstellt. Die Arduino IDE ist eine benutzerfreundliche, plattformübergreifende Entwicklungsumgebung, die das Programmieren von Mikrocontrollern, einschließlich des ESP32, erheblich vereinfacht. Ihre intuitive Oberfläche und die große, aktive Community, die eine Fülle von Bibliotheken und Ressourcen bereitstellt, machen sie zu einem hervorragenden Werkzeug sowohl für Anfänger als auch für erfahrene Entwickler. Diese Anleitung führt Sie durch alle notwendigen Schritte, von der Installation der Arduino IDE über die Konfiguration für die Verwendung mit dem ESP32 bis hin zum ersten erfolgreichen Testprojekt.

Schritt 1: Installation der Arduino IDE

Bevor Sie mit der Programmierung des ESP32 beginnen können, ist es unerlässlich, die Arduino IDE auf Ihrem Computer zu installieren. Die offizielle Arduino-Webseite (arduino.cc) dient als zentrale Anlaufstelle für die aktuelle Version der IDE, die für verschiedene Betriebssysteme wie Windows, macOS und Linux verfügbar ist. Es wird empfohlen, die neueste Version der IDE (derzeit IDE 2.x) zu verwenden, da diese in der Regel Verbesserungen, neue Funktionen und eine optimierte Benutzererfahrung bietet.

Download der Arduino IDE

Laden Sie die aktuelle Version der Arduino IDE von der offiziellen Webseite herunter: arduino.cc/en/software

Installation unter Windows

  1. Laden Sie die .exe-Datei für Windows herunter
  2. Führen Sie die heruntergeladene Datei aus
  3. Folgen Sie den Anweisungen des Installationsassistenten
  4. Stimmen Sie den Lizenzbedingungen zu
  5. Wählen Sie optional einen anderen Installationspfad
  6. Schließen Sie die Installation ab und starten Sie die Arduino IDE

Fortgeschrittene Benutzer können auch die portable Installation verwenden, indem sie die ZIP-Datei herunterladen und einen Ordner namens "portable" im entpackten Verzeichnis erstellen.

Installation unter macOS

  1. Laden Sie die .dmg-Datei für macOS herunter
  2. Doppelklicken Sie auf die heruntergeladene Datei, um das Image zu mounten
  3. Ziehen Sie das Arduino-Anwendungssymbol in den Ordner "Applications"
  4. Starten Sie die Arduino IDE über den Launchpad oder Finder

Installation unter Linux

  1. Laden Sie die AppImage-Datei für Linux herunter
  2. Machen Sie die Datei ausführbar:
    chmod +x Arduino*.AppImage
  3. Starten Sie die Arduino IDE durch Doppelklick auf die AppImage-Datei

Bei Fehlermeldungen bezüglich fehlender Bibliotheken installieren Sie libfuse2:

sudo apt-get -y install libfuse2

Schritt 2: Hinzufügen der ESP32 Boardverwalter-URL

Nachdem die Arduino IDE erfolgreich installiert wurde, besteht der nächste Schritt darin, die Unterstützung für das ESP32-Board hinzuzufügen. Da ESP32-Boards nicht standardmäßig in der Arduino IDE enthalten sind, müssen Sie die entsprechende Boardverwalter-URL in den Einstellungen der IDE hinzufügen.

Starten Sie zunächst die Arduino IDE. Öffnen Sie dann das Einstellungsfenster.

Zugriff auf die Einstellungen:

  • Windows/Linux: Datei > Voreinstellungen
  • macOS: Arduino IDE > Einstellungen
Arduino Einstellungsfenster
Arduino Einstellungsfenster zum Eintragen der Boardverwalter-URL

Im Einstellungsfenster suchen Sie nach dem Feld mit der Bezeichnung "Zusätzliche Boardverwalter-URLs" (oder "Additional Boards Manager URLs"). Dieses Feld ermöglicht es Ihnen, URLs zu Indexdateien hinzuzufügen, die Informationen über zusätzliche Board-Plattformen enthalten.

Boardverwalter Dialog
Textfeld zum Eintragen der Boardverwalter-URL

Boardverwalter-URL eintragen

ESP32 Boardverwalter-URL:

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Wenn Sie bereits andere URLs haben (z.B. für ESP8266), trennen Sie diese durch ein Komma.

  1. Kopieren Sie die URL in das Feld "Zusätzliche Boardverwalter-URLs"
  2. Klicken Sie auf "OK", um das URL-Fenster zu schließen
  3. Klicken Sie erneut auf "OK", um das Einstellungsfenster zu schließen

Schritt 3: Installation der ESP32 Boards über den Boardmanager

Nachdem Sie die ESP32 Boardverwalter-URL in den Einstellungen der Arduino IDE hinzugefügt haben, können Sie nun die eigentlichen ESP32-Boarddefinitionen installieren. Dies geschieht über den sogenannten Boardmanager.

Boardmanager öffnen:

Werkzeuge > Board > Boardverwalter...

  1. Geben Sie im Suchfeld des Boardmanagers "ESP32" ein
  2. Suchen Sie den Eintrag "ESP32 by Espressif Systems"
  3. Klicken Sie auf den Button "Installieren"
  4. Warten Sie, bis der Download und die Installation abgeschlossen sind
  5. Starten Sie die Arduino IDE neu, um sicherzustellen, dass alle Änderungen korrekt geladen wurden

67fcd32225c89_arduino_boardmanager_esp32.png

Schritt 4: Auswahl des richtigen ESP32 Boards

Nachdem die ESP32-Unterstützung in der Arduino IDE installiert wurde, müssen Sie das spezifische ESP32-Board auswählen, das Sie verwenden.

Board auswählen:

Werkzeuge > Board > ESP32 Arduino > [Ihr Board-Typ]

Wählen Sie die Variante aus, die am besten zu Ihrem verwendeten ESP32-Entwicklungsboard passt. Für die meisten gängigen ESP32-Entwicklungsboards ist die Option "ESP32 Dev Module" eine gute Wahl. Die genaue Bezeichnung Ihres Boards finden Sie in der Regel auf der Platine selbst oder in der Dokumentation des Herstellers.

67fcd3a8dbd77_arduino_boardmanager_esp32_dev_module.png

Schritt 5: Installation der notwendigen Treiber

In einigen Fällen kann es erforderlich sein, spezielle Treiber zu installieren, damit Ihr Computer mit dem ESP32-Board über USB kommunizieren kann. Dies hängt in erster Linie vom verwendeten USB-zu-Seriell-Konverter-Chip auf Ihrem ESP32-Board und Ihrem Betriebssystem ab.

Moderne Betriebssysteme sind oft in der Lage, die erforderlichen Treiber für gängige Chips wie den CP210x von Silicon Labs und den CH340/CH9102 von WCH automatisch zu installieren. Es empfiehlt sich, das ESP32-Board zunächst an Ihren Computer anzuschließen und zu prüfen, ob es erkannt wird.

Treiber für Windows

  1. Identifizieren Sie den USB-zu-Seriell-Chip auf Ihrem ESP32-Board
  2. Laden Sie den entsprechenden Treiber herunter:
  3. Führen Sie das Installationsprogramm aus
  4. Überprüfen Sie im Geräte-Manager, ob der Treiber korrekt installiert wurde

Treiber für macOS

  1. Identifizieren Sie den USB-zu-Seriell-Chip auf Ihrem ESP32-Board
  2. Laden Sie den entsprechenden Treiber herunter:
  3. Führen Sie die Installation durch
  4. Erlauben Sie gegebenenfalls in den Sicherheitseinstellungen die Installation von Software von Drittanbietern
  5. Starten Sie Ihren Mac neu
  6. Überprüfen Sie im Terminal, ob der Treiber korrekt installiert wurde:
    ls /dev/cu.*

Treiber für Linux

In den meisten Fällen enthält Linux bereits die notwendigen Treiber für CP210x- und CH340/CH9102-Chips.

  1. Überprüfen Sie, ob Ihr ESP32-Board erkannt wird:
    ls /dev/ttyUSB*
    # oder
    ls /dev/ttyACM*
  2. Fügen Sie Ihren Benutzer zur Gruppe dialout oder uucp hinzu:
    # Für die meisten Distributionen:
    sudo usermod -a -G dialout $USER
    
    # Für Arch Linux:
    sudo usermod -a -G uucp $USER
  3. Starten Sie Ihren Computer neu
Betriebssystem USB-zu-Seriell-Chip Treiber-Downloadlink
Windows CP210x Silicon Labs Treiber
Windows CH340/CH9102 WCH Treiber
macOS CP210x Silicon Labs Treiber
macOS CH340/CH9102 GitHub Repository
Linux CP210x In der Regel im Kernel enthalten
Linux CH340/CH9102 In der Regel im Kernel enthalten

Schritt 6: Das erste Projekt: Der "Blink"-Sketch

Nachdem die Arduino IDE eingerichtet und die ESP32-Unterstützung installiert wurde, ist es an der Zeit, das erste Projekt zu starten. Ein traditioneller erster Schritt in der Welt der Mikrocontroller ist der sogenannte "Blink"-Sketch. Dieses einfache Programm lässt eine LED blinken und dient als grundlegender Test, um die Funktionalität der Hardware und Software zu überprüfen.

Blink-Beispiel öffnen:

Datei > Beispiele > 01.Basics > Blink

Der grundlegende Code des "Blink"-Sketches sieht in etwa so aus:

void setup() {  
    pinMode(LED_BUILTIN, OUTPUT); // LED_BUILTIN als Output definieren
}

void loop() {    
    digitalWrite(LED_BUILTIN, HIGH); // LED durch HIGH einschalten
    delay(1000); // 1 Sekunde warten
    digitalWrite(LED_BUILTIN, LOW); // LED durch LOW ausschalten  
    delay(1000); // 1 Sekunde warten
}

Die setup()-Funktion wird einmalig beim Start des Programms ausgeführt. Hier wird der Modus des Pins, an dem die LED angeschlossen ist, als Ausgang (OUTPUT) deklariert.

Die loop()-Funktion hingegen wird kontinuierlich wiederholt. In dieser Funktion wird die LED zunächst eingeschaltet (digitalWrite(LED_BUILTIN, HIGH);), dann für eine Sekunde gewartet (delay(1000);), anschließend ausgeschaltet (digitalWrite(LED_BUILTIN, LOW);) und erneut für eine Sekunde gewartet (delay(1000);).

Hinweis zum LED_BUILTIN Pin:

Der Begriff LED_BUILTIN ist eine in der Arduino-Welt gängige Konvention und steht oft für den GPIO-Pin, an dem eine interne LED auf dem Entwicklungsboard angeschlossen ist. Bei vielen ESP32-Boards ist dies der GPIO-Pin 2.

Falls die interne LED auf Ihrem Board an einem anderen Pin angeschlossen ist oder Sie eine externe LED verwenden möchten, müssen Sie möglicherweise den Wert anpassen:

const int ledPin = 2;  // GPIO-Pin Ihrer LED
// Verwenden Sie ledPin anstelle von LED_BUILTIN

Schritt 7: Hochladen des Sketches auf das ESP32 Board

Nachdem Sie den "Blink"-Sketch geöffnet und gegebenenfalls angepasst haben, können Sie ihn auf Ihr ESP32-Board hochladen.

Seriellen Port auswählen

Port auswählen:

Werkzeuge > Port > [Ihr Port]

  • Windows: Der Port wird als COMx angezeigt (x ist eine Zahl)
  • macOS: Der Port erscheint als /dev/cu.usbserial-... oder ähnlich
  • Linux: Der Port wird als /dev/ttyUSBx oder /dev/ttyACMx angezeigt

Tipp zur Port-Identifikation:

  1. Trennen Sie das ESP32-Board vom Computer
  2. Öffnen Sie das Port-Menü und notieren Sie die verfügbaren Ports
  3. Schließen Sie das Menü, verbinden Sie das Board wieder
  4. Öffnen Sie das Port-Menü erneut - der neue Eintrag ist Ihr Board

Sketch hochladen

  1. Klicken Sie auf den "Hochladen"-Button (Pfeil nach rechts) in der Arduino IDE-Toolbar
  2. Die IDE beginnt mit dem Kompilieren und dem anschließenden Hochladen
  3. Beobachten Sie den Fortschritt in der Konsole am unteren Rand des Arduino IDE-Fensters

Boot-Modus für den Upload:

Falls der Upload fehlschlägt und eine Fehlermeldung wie "Failed to connect to ESP32: Timed out... Connecting..." angezeigt wird:

  1. Halten Sie die "BOOT"- oder "GPIO0"-Taste auf Ihrem ESP32-Board gedrückt
  2. Klicken Sie in der Arduino IDE auf "Hochladen"
  3. Lassen Sie die Taste erst los, nachdem in der Konsole die Meldung "Connecting..." erscheint
  4. Bei manchen Boards müssen Sie zusätzlich kurz die "RESET"- oder "EN"-Taste drücken, während Sie die "BOOT"-Taste gedrückt halten

Nach erfolgreichem Upload sollte in der Arduino IDE die Meldung "Done uploading." angezeigt werden. Die interne LED auf Ihrem ESP32-Board sollte nun im Sekundentakt blinken, was bestätigt, dass der Sketch erfolgreich hochgeladen und ausgeführt wird.

Schritt 8: Fehlerbehebung und häufige Probleme

Die Inbetriebnahme eines ESP32 kann manchmal auf unerwartete Schwierigkeiten stoßen. Hier sind einige häufige Probleme und deren mögliche Lösungen:

Verbindungsprobleme

Fehler: "Failed to connect to ESP32: Timed out Connecting..." oder "No serial data received."

  • Überprüfen Sie das USB-Kabel und stellen Sie sicher, dass es ein Datenkabel ist
  • Stellen Sie sicher, dass Sie das richtige Board und den korrekten Port ausgewählt haben
  • Versuchen Sie, das Board manuell in den Boot-Modus zu versetzen (siehe oben)
  • Überprüfen Sie, ob die Treiber korrekt installiert sind
  • Verwenden Sie ein kürzeres USB-Kabel oder einen anderen USB-Port
  • Schließen Sie alle anderen Programme, die den seriellen Port verwenden könnten

Probleme mit dem seriellen Port

Serieller Port nicht gefunden oder ausgegraut

  • Stellen Sie sicher, dass die Treiber installiert sind
  • Überprüfen Sie, ob das richtige Board ausgewählt ist
  • Starten Sie die Arduino IDE neu
  • Verwenden Sie ein USB-Kabel, das Datenübertragung unterstützt

Fehler beim Hochladen

Allgemeine Upload-Fehler

  • Achten Sie auf die genauen Fehlermeldungen in der Arduino IDE-Konsole
  • Stellen Sie sicher, dass der richtige Boardtyp ausgewählt ist
  • Versuchen Sie, mit einer niedrigeren Baudrate hochzuladen
  • Überprüfen Sie, ob der Sketch die Speicherplatzgrenzen nicht überschreitet

Sonstige häufige Probleme

  • Treiberprobleme: Installieren Sie die Treiber neu oder aktualisieren Sie sie
  • Falsche Boardauswahl: Vergewissern Sie sich, dass Sie das korrekte ESP32-Boardmodell ausgewählt haben
  • Inkompatible Arduino IDE Version: Verwenden Sie die neueste Version der Arduino IDE
  • "Brownout detector was triggered"-Fehler: Überprüfen Sie die Stromversorgung
  • Probleme mit der seriellen Monitorausgabe (Kauderwelsch): Stellen Sie sicher, dass die Baudrate im seriellen Monitor mit der im Sketch verwendeten Baudrate übereinstimmt (meist 115200)

Fazit und Ausblick

Die erfolgreiche Inbetriebnahme eines ESP32 in der Arduino IDE eröffnet Ihnen eine Welt voller Möglichkeiten im Bereich der Mikrocontroller und des Internets der Dinge. Mit dieser detaillierten Anleitung sollten Sie in der Lage sein, die ersten Schritte erfolgreich zu meistern.

Scheuen Sie sich nicht, mit dem ESP32 zu experimentieren und eigene Projekte zu entwickeln. Für weiterführende Informationen und fortgeschrittenere Themen stehen Ihnen zahlreiche Ressourcen zur Verfügung, darunter die offizielle ESP32-Dokumentation auf der Webseite von Espressif, die Arduino-Webseite sowie eine Vielzahl von Online-Tutorials und Community-Foren.

Viel Erfolg bei Ihren zukünftigen Projekten!

Zurück zu den Artikeln