Zum Inhalt

WiFi-Konfiguration

Der WattWächter unterstützt zwei Methoden zur WLAN-Einrichtung: Bluetooth (BLE) über die Smartphone-App oder AP-Modus über den Browser.

Methode 1: Bluetooth (App)

Die empfohlene Methode für die Ersteinrichtung.

  1. LED prüfen — Das Gerät muss blau pulsieren (BLE aktiv)
  2. App öffnen — WattWächter-App starten und „Gerät hinzufügen" wählen
  3. Gerät auswählen — Die App scannt automatisch nach WattWächter-Geräten in der Nähe
  4. WLAN wählen — Das Gerät scannt verfügbare Netzwerke und zeigt sie in der App an
  5. Passwort eingeben — WLAN-Passwort eingeben und bestätigen
  6. Warten — Das Gerät verbindet sich. LED wechselt zu grün bei Erfolg.

Bluetooth-Reichweite

Für die BLE-Einrichtung solltest du dich in der Nähe des Geräts befinden (max. 5–10 m).

Methode 2: AP-Modus (Browser)

Fallback-Methode falls kein Bluetooth verfügbar ist.

Verbinden

  1. Das Gerät spannt ein eigenes WLAN auf: WattWaechter-XXXX (XXXX = letzte 4 Zeichen der MAC-Adresse)
  2. Verbinde dich mit diesem Netzwerk (Passwort auf dem Geräte-Label)
  3. Öffne im Browser: http://192.168.4.1

Konfigurieren

  1. WLAN-Scan — Klicke auf „Netzwerke suchen". Verfügbare WLANs werden nach Signalstärke sortiert angezeigt.
  2. Netzwerk wählen — Wähle dein Heimnetzwerk aus der Liste
  3. Passwort eingeben — Gib dein WLAN-Passwort ein
  4. Speichern — Klicke auf „Verbinden"
  5. Das Gerät startet neu und verbindet sich mit deinem WLAN

AP-Modus endet

Nach erfolgreicher Verbindung wird der Access Point deaktiviert. Das Gerät ist dann unter http://ww.local erreichbar.

Nach der Verbindung

Sobald die LED grün leuchtet, ist das Gerät im Netzwerk erreichbar:

  • mDNS: http://ww.local
  • IP-Adresse: Wird in der App oder im Router angezeigt

Verbindung testen

curl http://ww.local/api/v1/system/alive

Erwartete Antwort:

{"alive": true, "version": "1.x.x"}

WiFi-Einstellungen ändern

Falls du später das WLAN wechseln möchtest:

  1. Über die API: Neues WLAN per POST an /api/v1/settings senden
  2. Factory Reset: Halte den Reset-Taster 10 Sekunden gedrückt — das Gerät startet neu im Setup-Modus
curl -X POST http://ww.local/api/v1/settings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer DEIN_WRITE_TOKEN" \
  -d '{"wifi": {"primary": {"ssid": "NeuesWLAN", "password": "passwort123", "enable": true}}}'

Fehlerbehebung

Problem Lösung
LED bleibt blau WLAN-Passwort prüfen, Reichweite zum Router sicherstellen
AP-Netzwerk nicht sichtbar Gerät aus- und einschalten, 30 Sekunden warten
ww.local nicht erreichbar mDNS muss im Netzwerk unterstützt werden. Alternativ IP-Adresse aus dem Router auslesen.
Verbindung bricht ab WLAN-Signalstärke prüfen (RSSI > -75 dBm empfohlen)