Blog
ESP32-Bibliotheken: Installieren, Nutzen, Fixen
Eine Bibliothek zu installieren ist die einfache Hälfte — die harte ist der Versionskonflikt, der den nächsten Compile bricht. Wo Bibliotheken leben, wie man eine funktionierende wählt und was zu tun ist, wenn das Beispiel nicht baut.
Wie installiere ich eine ESP32-Bibliothek in Arduino?
Bibliotheksverwalter (Sketch → Bibliothek einbinden → Bibliotheken verwalten), suchen, installieren — die meisten ESP32-Bibliotheken sind dort. Der manuelle Weg: das ZIP herunterladen, Sketch → Bibliothek einbinden → .ZIP-Bibliothek hinzufügen. Ein Haken: Der Bibliotheksverwalter listet alles für jedes Board, also nach ESP32-Tags filtern oder prüfen, ob das Repo arduino-esp32 nennt. Das Arduino-IDE-FAQ behandelt die Ordnerstruktur.
Wie nutze ich die Animated-GIF-Bibliothek auf ESP32?
AnimatedGIF von Larry Bank ist der Standard — kombiniert mit TFT_eSPI spielt sie GIFs auf gängigen SPI-Displays ab. GIFs dekodieren zu Rohframes, also zählt der RAM: Ein 320×240-Frame ist grob 150 KB, deshalb stottert Animation auf 2-MB-Chips und singt auf PSRAM-Platinen. Auf meinem 240×320-ILI9341 lief sie mit etwa 15 FPS, flüssig genug für eine Endlosschleife. Die Beispielprojekte-Seite hat einen funktionierenden Aufbau.
Gibt es eine Hardware-Serial-Bibliothek im ESP32?
Ja — HardwareSerial ist in den Kern eingebaut, keine Installation nötig. Serial, Serial1 und Serial2 existieren auf dem klassischen ESP32; auf C3 und S3 hängt die Verfügbarkeit von Serial1 und Serial2 von der UART-Anzahl des Chips ab. „Harware serial“ ist ein Suchtippfehler; dieselbe eingebaute Bibliothek in beiden Fällen.
Warum kompiliert meine Bibliothek auf einer Platine, aber nicht auf einer anderen?
Platinenspezifische Konfiguration — Pins in #define, PSRAM-Vorhandensein, Flash-Größe. Viele ESP32-Bibliotheken setzen einen WROOM-32 mit 4 MB Flash voraus und hartkodieren Pins, die S3-Platinen anders verdrahten. Lesen Sie die Board-Tabelle im README der Bibliothek; wenn sie Platinen listet, muss Ihre darauf stehen.
Bibliothek installiert, aber nicht gefunden?
Die IDE neu starten, dann den Sketchbook-Ordner prüfen: Datei → Voreinstellungen zeigt ihn, und Benutzerbibliotheken leben in <sketchbook>/libraries. Zwei häufige Fehler: Das ZIP wurde in einen verschachtelten Ordner entpackt (Arduino will die .h eine Ebene tief), oder die IDE hat eine korrupte Kopie gecacht — löschen und neu installieren. Die Wissensdatenbank hat den Screenshot-Durchlauf.
Ein Kern-Update hat meine Bibliothek zerbrochen — und jetzt?
Der Sprung von arduino-esp32 2.x auf 3.x hat APIs umbenannt; Bibliotheken, die auf alte Namen gepinnt sind, scheitern mit verwirrenden Fehlern. Die Fixes der Reihe nach: Bibliothek aktualisieren, ihr Changelog lesen oder den Kern im Boardverwalter auf die Version pinnen, die die Bibliothek nennt.
Eingebaute vs. Drittanbieter-Bibliotheken — was ist der Unterschied?
Eingebaut heißt, der Kern liefert sie mit — WiFi.h, HardwareSerial, SPI, Wire. Drittanbieter heißt externes Repo — Sensoren, Displays, Dienste. Eingebaute aktualisieren sich mit dem Kern; Drittanbieter-Bibliotheken nach ihrem eigenen Zeitplan, und genau deshalb zählt Pinnen.
Zwei Bibliotheken definieren dieselbe Funktion — Konflikt?
Ja, und der Linker wählt still eine aus oder wirft einen Fehler. C++ hält Sie nicht davon ab; das Ergebnis ist ein Münzwurf, welche aufgerufen wird. Finden Sie das Duplikat über die Fehlermeldung und deinstallieren Sie eine Bibliothek oder nutzen Sie ihren Namespace, falls sie einen hat. Ich bin einmal auf zwei DHT-Bibliotheken gestoßen; der Fix war, die zu löschen, die ich nie nutzte.
Woher weiß ich, welche Bibliothek ein Sketch braucht?
Die #include-Zeilen lesen, dann jeden Namen im Bibliotheksverwalter suchen — Adafruit BMP280, U8g2, was auch immer. Das README oder der Beispiel-Header nennt meist den gepflegten Fork des Autors, was bei umbenannten Bibliotheken zählt. Die Bibliothek, deren Issues tatsächlich geschlossen werden, ist die, die funktioniert.
Kann ich meine eigene ESP32-Bibliothek schreiben?
Ja — ein Ordner mit .h, .cpp und library.properties in <sketchbook>/libraries ist eine Bibliothek. Exportieren Sie die API, die Sie nutzen, halten Sie Hardware-Details in der Header-Konfiguration, und eine ESP32-Bibliothek ist einfach eine Arduino-Bibliothek, die ESP32-Header per #ifdef einbindet.
Die Projekte zu diesem Thema laufen direkt im kostenlosen sensbench-Simulator: Schaltung verkabelt, Firmware inklusive – ohne Konto, ohne Installation.