ESP32 OTA-Updates: Firmware kabellos über WLAN aufspielen (ArduinoOTA & Web-Updater)

Wie funktioniert ein OTA-Update?

Der Flash-Speicher des ESP32 ist in Partitionen aufgeteilt – ähnlich wie eine Festplatte. Beim Standard-Schema gibt es zwei gleich große App-Partitionen: In der einen läuft dein aktuelles Programm, die andere ist frei. Ein OTA-Update schreibt die neue Firmware in die freie Partition, prüft sie und markiert sie als Boot-Partition. Beim nächsten Neustart startet der ESP32 aus der neuen Partition – schlägt irgendetwas fehl, bleibt die alte Firmware unangetastet.

Das Schöne daran: Dieses Sicherheitsnetz ist eingebaut. Ein abgebrochener Upload (WLAN weg, Strom weg) macht dein Board nicht kaputt – es läuft einfach mit der alten Version weiter. Voraussetzung ist nur, dass die laufende Firmware den OTA-Code enthält. Und das führt zur wichtigsten Regel dieses Tutorials:

Das brauchst du

Falls dein ESP32 noch nie am WLAN war: Die Grundlagen von WLAN-Verbindung und Webserver erklärt der Artikel ESP32 Webserver einrichten.

1ArduinoOTA aktivieren: der Basis-Sketch

Die Bibliothek ArduinoOTA ist im ESP32-Boardpaket schon enthalten – nichts zu installieren. Dieser Sketch verbindet sich mit dem WLAN und lauscht auf Update-Anfragen aus der IDE. Lade ihn einmal klassisch per USB hoch:

#include <WiFi.h>
#include <ArduinoOTA.h>

const char* WLAN_NAME     = "DeinWLAN";
const char* WLAN_PASSWORT = "DeinPasswort";

void setup() {
  Serial.begin(115200);

  WiFi.mode(WIFI_STA);
  WiFi.begin(WLAN_NAME, WLAN_PASSWORT);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.printf("\nVerbunden! IP: %s\n", WiFi.localIP().toString().c_str());

  ArduinoOTA.setHostname("esp32-wohnzimmer");   // Name im Netzwerk-Menue

  ArduinoOTA
    .onStart([]() { Serial.println("OTA-Update startet ..."); })
    .onProgress([](unsigned int done, unsigned int total) {
      Serial.printf("Fortschritt: %u %%\r", (done * 100) / total);
    })
    .onEnd([]() { Serial.println("\nFertig! Neustart ..."); })
    .onError([](ota_error_t fehler) {
      Serial.printf("Fehler [%u]\n", fehler);
    });

  ArduinoOTA.begin();
  Serial.println("Bereit fuer OTA-Updates.");
}

void loop() {
  ArduinoOTA.handle();   // MUSS regelmaessig aufgerufen werden
}

Nach dem Upload und Neustart erscheint das Board in der Arduino IDE als Netzwerkgerät. So flashst du ab jetzt kabellos:

1. Arduino IDE (neu) öffnen: Werkzeuge → Port – unter \"Netzwerk-Ports\" taucht esp32-wohnzimmer at 192.168.x.x auf
2. Diesen Netzwerk-Port auswählen (statt des seriellen COM-Ports)
3. Ganz normal auf Hochladen klicken – der Sketch wandert übers WLAN aufs Board
4. Der ESP32 startet automatisch mit der neuen Firmware neu

2OTA in dein echtes Projekt integrieren

Der Basis-Sketch tut nichts außer warten. In der Praxis soll OTA neben deiner eigentlichen Anwendung laufen. Dafür gibt es nur zwei Anforderungen: ArduinoOTA.handle() muss regelmäßig drankommen, und dein Code darf den loop() nicht mit langen delay()-Aufrufen blockieren. Hier das Muster mit einer nicht-blockierenden Blink-LED als Platzhalter für deine Anwendung:

#include <WiFi.h>
#include <ArduinoOTA.h>

const char* WLAN_NAME     = "DeinWLAN";
const char* WLAN_PASSWORT = "DeinPasswort";

const int LED = 2;                    // Onboard-LED
unsigned long letzterWechsel = 0;
bool ledAn = false;

void otaEinrichten() {
  ArduinoOTA.setHostname("esp32-projekt");
  ArduinoOTA.begin();
}

void setup() {
  Serial.begin(115200);
  pinMode(LED, OUTPUT);

  WiFi.mode(WIFI_STA);
  WiFi.begin(WLAN_NAME, WLAN_PASSWORT);
  while (WiFi.status() != WL_CONNECTED) delay(500);

  otaEinrichten();
  Serial.printf("Laeuft! IP: %s\n", WiFi.localIP().toString().c_str());
}

void loop() {
  ArduinoOTA.handle();                // 1. immer zuerst

  // 2. deine Anwendung - nicht-blockierend mit millis()
  if (millis() - letzterWechsel >= 1000) {
    letzterWechsel = millis();
    ledAn = !ledAn;
    digitalWrite(LED, ledAn);
  }
}

3Web-Updater: Firmware per Browser hochladen

ArduinoOTA setzt voraus, dass auf dem Rechner die Arduino IDE läuft. Es geht auch ohne: Der ESP32 kann selbst eine Update-Webseite ausliefern, auf der du eine kompilierte .bin-Datei hochlädst – praktisch, wenn du Firmware an Freunde weitergibst, die keine IDE installiert haben. Dafür exportierst du in der IDE mit Sketch → Kompilierte Binärdatei exportieren die .bin-Datei.

#include <WiFi.h>
#include <WebServer.h>
#include <Update.h>

const char* WLAN_NAME     = "DeinWLAN";
const char* WLAN_PASSWORT = "DeinPasswort";

WebServer server(80);

const char* SEITE =
  "<h1>ESP32 Web-Updater</h1>"
  "<form method='POST' action='/update' enctype='multipart/form-data'>"
  "<input type='file' name='firmware'>"
  "<input type='submit' value='Update starten'></form>";

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin(WLAN_NAME, WLAN_PASSWORT);
  while (WiFi.status() != WL_CONNECTED) delay(500);
  Serial.printf("Web-Updater: http://%s\n", WiFi.localIP().toString().c_str());

  server.on("/", HTTP_GET, []() { server.send(200, "text/html", SEITE); });

  server.on("/update", HTTP_POST,
    []() {   // Antwort nach dem Upload
      server.send(200, "text/plain", Update.hasError() ? "FEHLER" : "OK - Neustart");
      delay(500);
      ESP.restart();
    },
    []() {   // Upload-Datenstrom verarbeiten
      HTTPUpload& up = server.upload();
      if (up.status == UPLOAD_FILE_START) {
        Update.begin();                          // freie Partition oeffnen
      } else if (up.status == UPLOAD_FILE_WRITE) {
        Update.write(up.buf, up.currentSize);    // Firmware-Haeppchen schreiben
      } else if (up.status == UPLOAD_FILE_END) {
        Update.end(true);                        // pruefen und aktivieren
      }
    });

  server.begin();
}

void loop() {
  server.handleClient();
}

Rufe die IP des Boards im Browser auf, wähle die .bin-Datei und klicke auf \"Update starten\" – nach wenigen Sekunden bootet der ESP32 mit der neuen Firmware. Die Weboberfläche kannst du beliebig ausbauen, zum Beispiel mit Statusanzeigen deiner Sensoren auf derselben Seite.

4Absichern: Passwortschutz für OTA

Ohne Schutz kann jeder im selben WLAN deinem ESP32 neue Firmware unterschieben. Für ArduinoOTA genügt eine Zeile vor ArduinoOTA.begin():

ArduinoOTA.setPassword("geheim123");

// besser: nur den MD5-Hash im Code speichern
// (Hash von "geheim123" vorher z. B. per Online-Tool erzeugen)
// ArduinoOTA.setPasswordHash("5715790a892990382d98858c4aa38d0e");

Die IDE fragt das Passwort dann beim ersten kabellosen Upload ab. Beim Web-Updater schützt du die Seite mit HTTP-Basic-Auth:

server.on("/", HTTP_GET, []() {
  if (!server.authenticate("admin", "geheim123")) {
    return server.requestAuthentication();
  }
  server.send(200, "text/html", SEITE);
});

Wofür sich OTA besonders lohnt

Troubleshooting