OTA-Updates¶

Der WattWächter unterstützt Over-the-Air (OTA) Firmware-Updates. Neue Firmware-Versionen werden automatisch über den Cloud-Update-Server bereitgestellt.

Update prüfen¶

Prüfe ob ein Update verfügbar ist:

curl http://ww.local/api/v1/ota/check \
  -H "Authorization: Bearer READ_TOKEN"

Antwort (Update verfügbar)¶

{
  "ok": true,
  "data": {
    "update_available": true,
    "version": "1.2.0",
    "release_date": "2025-03-01",
    "release_note_de": "Optimierte Speicherverwaltung",
    "release_note_en": "Optimized memory management",
    "tag": "stable"
  }
}

Antwort (kein Update)¶

{
  "ok": true,
  "data": {
    "update_available": false
  }
}

Update starten¶

curl -X POST http://ww.local/api/v1/ota/start \
  -H "Authorization: Bearer WRITE_TOKEN"

Während des Updates

Die LED wechselt zu Magenta (dauerhaft) während der OTA-Aktualisierung
Stromversorgung nicht unterbrechen!
Das Gerät startet nach dem Update automatisch neu

Update-Ablauf¶

1. /ota/check     →  Prüft Update-Server auf neue Version
2. /ota/start     →  Startet Download der Firmware
3. Download       →  Firmware wird heruntergeladen (LED: Magenta)
4. Flash          →  Firmware wird geschrieben
5. Verify         →  MD5-Prüfsumme wird verifiziert
6. Reboot         →  Gerät startet mit neuer Firmware
7. /system/alive  →  Gerät meldet neue Version

Release-Kanäle¶

Kanal	Beschreibung
`stable`	Stabile Releases, empfohlen für den Dauerbetrieb
`test`	Test-Releases für Early Adopters

Fehlerbehebung¶

Problem	Lösung
Update-Check schlägt fehl	Internetverbindung prüfen, DNS prüfen
Download bricht ab	WLAN-Signalstärke prüfen, erneut versuchen
Gerät startet nicht nach Update	30 Sekunden warten, dann USB-C trennen und neu verbinden
Version unverändert	`/api/v1/system/alive` prüfen — ggf. Fallback auf vorherige Version

Automatische Updates

Über das Cloud-Portal kann konfiguriert werden, ob Updates automatisch installiert werden oder eine Bestätigung erfordern.