Einstellungen¶
Die meisten Geräteeinstellungen können auf vier Wegen geändert werden:
- Weboberfläche — Lokale UI direkt auf dem Gerät, erreichbar unter
http://wattwaechter-XXXXXXXXXXXX.localim selben Netzwerk - Smartphone-App — iOS & Android (dieselbe App, die auch für die Inbetriebnahme verwendet wird)
- Cloud-Portal — Fernzugriff über login.wattwächter.de
- REST-API — Direkt per HTTP, mit allen technischen Details und JSON-Schemata
Was bedeutet XXXXXXXXXXXX?
Die zwölf X stehen für die individuelle Geräte-ID Deines WattWächters (die letzten 12 Zeichen der MAC-Adresse, hexadezimal). Du findest sie z. B. im Cloud-Portal oder in der App.
Diese Seite erklärt, was die einzelnen Einstellungen bewirken. Die konkreten JSON-Felder, Endpunkte und das vollständige Schema sind in der REST-API-Referenz dokumentiert.
WLAN¶
Verbindung ins Heimnetzwerk. Standardmäßig verbindet sich der WattWächter bei jedem Start automatisch mit dem hinterlegten WLAN.
| Einstellung | Beschreibung |
|---|---|
| Netzwerkname (SSID) | Name des WLANs |
| Passwort | WLAN-Passwort (WPA2) |
| Aktiviert | Steuert, ob das hinterlegte WLAN verwendet wird |
API-Schlüssel: wifi.primary — siehe REST-API-Referenz.
MQTT¶
Sendet Telemetriedaten an einen MQTT-Broker — z. B. für die Einbindung in Home Assistant, ioBroker oder andere Smart-Home-Systeme. Standardmäßig deaktiviert.
→ Alle Felder (Broker, Port, TLS, Benutzer/Passwort, Topic-Prefix, Sendeintervall, CA-Zertifikat), Topic-Struktur, Payload-Format und Home-Assistant-Auto-Discovery sind unter Schnittstellen → MQTT dokumentiert.
Status-LED¶
Die mehrfarbige Status-LED am Gerät zeigt den aktuellen Verbindungs- und Fehlerstatus an (siehe LED-Statusanzeige). Sie kann komplett deaktiviert werden, falls das Gerät z. B. im Schlafzimmer betrieben wird.
API-Schlüssel: ledEnable — siehe REST-API-Referenz.
API-Authentifizierung¶
Standardmäßig ist die lokale REST-API ohne Token erreichbar, damit die Ersteinrichtung möglichst einfach bleibt. In gemeinsam genutzten Netzwerken empfehlen wir, die Token-basierte Authentifizierung zu aktivieren.
Wenn aktiviert, gibt es zwei Token-Stufen:
- READ-Token — Daten lesen (History, Status, Einstellungen anzeigen)
- WRITE-Token — Einstellungen ändern, OTA-Updates starten, Reboot auslösen
Token werden über einen zweistufigen Prozess erneuert, um ein versehentliches Aussperren zu verhindern.
Empfehlung
Aktiviere die Authentifizierung, wenn das Gerät in einem gemeinsam genutzten Netzwerk betrieben wird oder die REST-API von Dritten erreichbar sein könnte.
API-Schlüssel: api_auth_required (Aktivierung), /api/v1/auth/tokens/* (Token-Rotation) — siehe REST-API-Referenz.