Bedienungsanleitung WifiWhirl® Software 2.0.0
Einrichtung, Bedienung und Konfiguration deines WifiWhirl-Moduls mit der neuen Web-App - vom Einrichtungsassistenten bis zur Cloud-Anbindung.
Version 2.0.0 ersetzt die bisherige Mehrseiten-Oberfläche durch eine einheitliche Web-App. Neu sind unter anderem der Einrichtungsassistent, die WifiWhirl Cloud (PoolLink), ein anpassbares Dashboard, der Expertenmodus und der Gastgebermodus. Was sich beim Umstieg von 1.2.x ändert, steht unter Umstieg von Version 1.2.x.
Erste Inbetriebnahme
Einrichtungsassistent Schritt für Schritt
Aufbau der Web-App
Navigation, Sprache, Dunkelmodus
Übersicht
Dashboard, Steuerung, Zähler
Automatisierung
Planer und Befehlswarteschlange
Smart Schedule
Intelligente Heizplanung
SPA-Konfiguration
Profil, Tarife, Wartung, Gastgeber
Geräteeinstellungen
Anmeldung, Identität, Webhooks
Expertenmodus
Leistungswerte und Fallback-WLAN
Cloud-Verbindung
PoolLink und Konto-Kopplung
MQTT-Konfiguration
Eigener Broker und Home Assistant
Netzwerkkonfiguration
WLAN, statische IP, Zeitserver
Softwareinfo & Update
Firmware-Update und Supportpaket
Erste Inbetriebnahme
Modul montieren
Wähle zuerst die Montageanleitung für dein Pumpenmodell:
S100101 AirJet Pumpen
Standardmodelle ab Baujahr 2021
S100101 AirJet (Modelljahr 24/25)
Neuere AirJet Modelle
S200102 HydroJet Pumpen
HydroJet Pro Modelle ab 2021
Eiförmige AirJet Pumpen
Eiförmige Modelle mit 6-Kabel
Die dem Modul beiliegende gedruckte Anleitung gibt es auch als PDF zum Herunterladen:
- Montage- und Installationsanleitung 1.2 - AirJet (PDF, 3,8 MB)
- Montage- und Installationsanleitung 1.2 - HydroJet / Eiförmig (PDF, 3,7 MB)
Der Einrichtungsassistent
Ab Version 2.0.0 richtest du das Modul über einen Einrichtungsassistenten in der Web-App ein. Das bisherige Captive-Portal (WiFiManager) entfällt.
Nach dem ersten Einschalten öffnet das Modul ein eigenes WLAN. Verbinde dich damit und rufe die Web-App im Browser auf. Der Assistent führt dich durch fünf Schritte und zeigt oben jeweils "Schritt n von 5" an.
Am schnellsten geht es mit dem QR-Code. Du findest ihn dreifach im Lieferumfang:
- auf der letzten Seite der gedruckten Anleitung,
- auf der Rückseite des Moduls,
- und als separaten Aufkleber in der Verpackung.
Scanne ihn mit dem Handy - es verbindet sich mit dem WLAN des Moduls, und der Einrichtungsassistent öffnet sich direkt. Bleibt die Seite aus, gib im Browser http://192.168.4.1 ein: Das ist die Adresse des Moduls, solange es sein eigenes WLAN aufspannt.
Willkommen bei WifiWhirl
Der Assistent begrüßt dich und erklärt kurz den Ablauf. Weiter geht es mit "Weiter".
WLAN-Netzwerk
Wähle dein WLAN aus der Liste und gib das Passwort ein. Ist dein Netzwerk nicht sichtbar, nutze "SSID manuell eingeben".
Nach "Verbinden" speichert das Modul die Zugangsdaten und startet neu. Verbinde dein Handy oder deinen Computer danach wieder mit dem Heim-WLAN und öffne die App erneut.
Pumpenmodell
Wähle dein Pumpenmodell als Symbolkachel aus. Das Modul startet nach dem Speichern neu, damit die Tasten deiner Pumpe richtig erkannt werden. Der Assistent setzt danach automatisch an dieser Stelle fort.
Pool & Region
Hinterlege Poolinhalt, Temperatureinheit, Strompreis, Währung und Zeitzone. Diese Werte sind die Grundlage für Aufheizzeit-Schätzung, Kostenberechnung und Smart Schedule.
Fast geschafft
Optional kannst du hier die Anmeldung für die Weboberfläche aktivieren und die automatische Update-Prüfung einschalten. Mit "Fertig" wird die Einrichtung abgeschlossen.
Hast du die Anmeldung aktiviert, startet das Modul neu und die Seite lädt zur Anmeldung neu.
Bereits eingerichtete Module starten den Assistenten nicht erneut. Alle Einstellungen bleiben später über die normalen Konfigurationsseiten änderbar.
Web-App auf dem Homescreen speichern
Die Web-App ist eine Progressive Web App (PWA). Du kannst sie über das Browsermenü als Symbol auf dem Homescreen ablegen und danach wie eine App starten.
Verknüpfung anlegen (Android & iOS)
Schritt-für-Schritt mit Bildern
Modul nicht erreichbar?
Hilfe bei Verbindungsproblemen
Aufbau der Web-App
Die gesamte Oberfläche läuft als Single-Page-App - alle Seiten liegen in einer Anwendung und sind für Smartphone und Tablet optimiert.
Navigation
Untere Tab-Leiste
Die vier wichtigsten Bereiche sind immer erreichbar: Start, Auto, Plan und Menü.
Seitenmenü
Über Menü erreichst du alle weiteren Seiten: SPA-Konfiguration, Geräteeinstellungen, Pumpenkonfiguration, Experte, Netzwerkkonfiguration, MQTT-Konfiguration, Cloud-Verbindung, WifiWhirl neu starten und Softwareinfo.
In der Kopfzeile zeigen Statusanzeigen die Verbindung von WLAN und MQTT beziehungsweise Cloud. Ein Tipp darauf öffnet die Details. Besteht keine Verbindung zum Modul, erscheint der Hinweis "Keine Verbindung zum Modul".
Sprache und Darstellung
Sprache
Deutsch und Englisch sind vollständig übersetzt. Französisch, Niederländisch und Polnisch sind als Beta enthalten. Mit "Auto (Browser)" übernimmt die App die Sprache deines Browsers.
Dunkelmodus
Über "Dunkelmodus" wechselst du zwischen heller und dunkler Darstellung. Die Einstellung bleibt gespeichert.
Übersicht: das Dashboard
Die Seite Übersicht ist die Hauptsteuerung. Sie besteht aus Widgets, die du selbst anordnen kannst.
Displayanzeige und Temperatur
Die Displayanzeige spiegelt das physische Display deiner Pumpe - inklusive Helligkeit. Darunter stellst du über den Thermostat-Drehregler die Zieltemperatur ein, per Touch oder Maus.
Angezeigt werden außerdem die aktuelle Temperatur, die Umgebungstemperatur und - sofern berechenbar - "Bereit in" mit der geschätzten Restheizzeit. Ist der Whirlpool auf Temperatur, erscheint "Zeit für ein Bad!".
Steuerung
Die Kacheln im Bereich Steuerung schalten die Funktionen deiner Pumpe:
Ein/Aus
Schaltet das Gesamtgerät.
Heizung
Schaltet die Heizung ein oder aus.
Filterpumpe
Schaltet die Filterpumpe.
Airjet
Massagedüsen (modellabhängig).
Hydrojet
Wasserdüsen (nur HydroJet-Modelle).
Tastensperre
Sperrt die Tasten am physischen Bedienfeld.
Zusätzlich lässt sich die Helligkeit des Pumpendisplays einstellen.
Wasserqualität
Erfasse deine Messwerte mit Zeitstempel: pH-Wert, Chlor (mg/L) und optional Cyanursäure (mg/L) und Alkalinität (mg/L). Die beiden letzten Felder sind standardmäßig ausgeblendet und lassen sich über Dashboard anpassen einblenden. Zu jedem Wert zeigt die App den Idealbereich und "Zuletzt geprüft".
Timer und Zähler
Der Bereich Timer erinnert an Chlor hinzufügen, Filterreinigung, Filterwechsel und Wasserwechsel. Jeder Timer lässt sich nach erledigter Arbeit einzeln zurücksetzen.
Nach wie vielen Tagen die Timer erinnern, legst du unter Wartungsintervalle in der SPA-Konfiguration fest.
Unter Zähler stehen Gerätelaufzeit sowie die Laufzeiten von Filterpumpe, Heizung, Airjet und Hydrojet.
Energie & Kosten
Energie & Kosten zeigt Aktuelle Leistung, Energieverbrauch heute, Gesamtenergieverbrauch, Energiekosten heute und Gesamtenergiekosten. Die Kosten werden fortlaufend mit dem jeweils gültigen Tarif aufsummiert - siehe Nachttarif.
"zurücksetzen" im Bereich Zähler setzt auch alle Energie- und Kostenwerte zurück. Die App fragt vorher nach.
Dashboard anpassen
Mit "Bearbeiten" wechselst du in den Layout-Modus:
- Ziehen ordnet Widgets um.
- Breite ändern und Höhe ändern skalieren ein Widget.
- Widgets lassen sich ein- und ausblenden. Hier schaltest du auch die standardmäßig ausgeblendeten Felder Cyanursäure und Alkalinität in der Wasserqualität ein.
- "Layout zurücksetzen" stellt die Standardanordnung wieder her.
- "Fertig" beendet den Bearbeitungsmodus.
Das Layout wird im Browser gespeichert - jedes Gerät kann also seine eigene Anordnung haben.
Automatisierung
Auf der Seite Automatisierung planst du Befehle, die das Modul zu festen Zeiten ausführt. Oben steht immer der nächste Befehl mit seiner Ausführungszeit sowie die Anzahl geplanter Befehle.
Planer
Im Planer erstellst du einmalige oder wiederkehrende Befehle in drei Schritten: Befehl auswählen, Befehlsdetails festlegen und Zeitplan bestimmen.
Zur Auswahl stehen unter anderem:
| Befehl | Wirkung |
|---|---|
| Filterpumpe | Filterpumpe ein-/ausschalten |
| Heizung | Heizung ein-/ausschalten |
| Airjet / Hydrojet | Düsen ein-/ausschalten |
| Ein/Aus (Gesamtgerät) | Gesamtgerät schalten |
| Tastensperre | Tasten am Bedienfeld sperren |
| Zieltemperatur | Zieltemperatur setzen |
| Displayhelligkeit | Helligkeit des Pumpendisplays setzen |
| Text ausgeben | Text auf dem Pumpendisplay anzeigen (nur Kleinbuchstaben und Zahlen) |
| Einheit | Zwischen °C und °F umschalten |
| Bedientasten | Tasten am Bedienfeld sperren oder entsperren |
| Zeiten zurücksetzen | Laufzeitzähler zurücksetzen |
| WLAN Modul neu starten | Modul neu starten |
Wiederholung
Für die Wiederholung stehen fünf Vorgaben bereit:
Einmalig
Wird einmal zur gewählten Zeit ausgeführt.
Stündlich
Wiederholt sich ab der Startzeit jede Stunde.
Täglich
Wiederholt sich täglich zur gleichen Uhrzeit.
Wöchentlich
Wiederholt sich wöchentlich am gleichen Wochentag.
Benutzerdefiniert
Freies Intervall über "Alle … Stunden".
Vorlage: Täglicher Filterpumpenlauf
Unter Vorlagen erstellt "Täglicher Filterpumpenlauf" mit einem Klick ein tägliches Zeitfenster für die Filterpumpe - du gibst nur Startzeit und Endzeit an, der Start- und der Stopp-Befehl werden zusammen angelegt. Zeitfenster über Mitternacht sind möglich; der Stopp-Befehl läuft dann am nächsten Tag.
Warteschlange verwalten
Die Zeitachse der Warteschlange zeigt alle geplanten Befehle in ihrer Reihenfolge. Unter Warteschlangen-Werkzeuge stehen:
- Warteschlange aktiviert - globaler Schalter. Ist er aus, führt das Modul keine geplanten Befehle aus, ohne dass etwas gelöscht wird.
- Aktivieren / Deaktivieren je Befehl - einzelne Einträge stilllegen und später wieder scharf schalten.
- Sichern und Wiederherstellen - Warteschlange als Datei speichern und zurückladen.
- Warteschlange leeren - löscht alle geplanten Befehle nach Rückfrage.
Smart Schedule
Smart Schedule dreht die Logik um: Du sagst nicht, wann geheizt werden soll, sondern wann der Whirlpool fertig sein soll. Den Heizstart berechnet WifiWhirl selbst.
Neuen Zeitplan erstellen
Lege Zielzeit und Zieltemperatur fest (zwischen 20 °C und 40 °C) und aktiviere den Zeitplan mit "Zeitplan aktivieren".
Unter Optionen stehen:
- Wiederholen - Nie, Täglich oder Wöchentlich. Nach der Zielzeit stellt sich der Zeitplan automatisch auf den nächsten Termin. Das gilt auch nach einem Stromausfall.
- Heizung bei Erreichen der Zielzeit eingeschaltet lassen - hält die Temperatur über die Zielzeit hinaus.
Statusanzeige
Ist ein Zeitplan aktiv, zeigt der Aktive Zeitplan unter anderem Zielzeit, Verbleibende Zeit, Zieltemperatur, Aktuelle Temperatur, Heizdauer (Schätzung), Sicherheitspuffer, Startzeit, Start in, Nächste Prüfung und die Geschätzten Kosten.
Erreicht der Whirlpool die Temperatur, erscheint "Zieltemperatur erreicht - die Heizung hält die Temperatur.".
So funktioniert Smart Schedule
- Der Heizstart wird aus aktueller Wassertemperatur, Zieltemperatur, Umgebungstemperatur und Poolinhalt berechnet.
- Vor der Planung läuft die Filterpumpe kurz an (etwa 20 Sekunden), um eine genaue Wassertemperatur zu messen.
- Adaptive Prüfintervalle aktualisieren die Schätzung, je näher die Zielzeit kommt.
Für belastbare Schätzungen braucht das Modul den Poolinhalt aus der SPA-Konfiguration und die Außentemperatur. Die Seite meldet mit "Konfiguration braucht Aufmerksamkeit", wenn etwas fehlt.
Die Außentemperatur stellst du nicht am Modul ein: Sie kommt über die Cloud-Verbindung, und der Standort dafür wird in der Cloud-App festgelegt.
SPA-Konfiguration
Die SPA-Konfiguration bündelt alle Einstellungen zu deinem Whirlpool. Oben zeigt das Whirlpool-Profil, ob die Angaben vollständig sind: "Konfiguration vollständig" oder "Konfiguration braucht Aufmerksamkeit".
Grunddaten
| Einstellung | Bedeutung |
|---|---|
| Poolinhalt in Liter | Basis für Aufheizzeit- und Kostenschätzung |
| Temperatureinheit | °C oder °F |
| Preis pro kWh | Grundlage der Kostenberechnung |
| Währung | EUR, PLN oder GBP |
| Zeitzone | Bestimmt, wann der Tageszähler um Mitternacht zurückgesetzt wird |
| Wetterdaten verwenden | Schaltet die Außentemperatur ein, die in Aufheizzeit und Smart Schedule einfließt |
Energiekosten und Nachttarif
Unter Nachttarif hinterlegst du einen zweiten Strompreis:
- Nachttarif aktivieren
- Preis pro kWh (Nacht)
- Nachtbeginn und Nachtende
- Wochenende komplett zum Nachttarif
Die Kosten werden fortlaufend mit dem jeweils gültigen Tarif aufsummiert - Tages- und Gesamtkosten berücksichtigen also automatisch, wann welcher Preis galt.
Wartungsintervalle
Lege fest, nach wie vielen Tagen die Timer auf dem Dashboard erinnern: Chlor hinzufügen, Filterreinigung, Filterwechsel und Wasserwechsel.
Whirlpool
Der Block Whirlpool fasst das Verhalten von Pumpe und Display zusammen:
- Töne (ein/aus) - Signaltöne der Pumpe.
- Airjet Timeout - nach wie vielen Minuten sich die AirJet-Düsen selbst abschalten (5 bis 30 Minuten).
- Hydrojet Timeout - dasselbe für die HydroJet-Düsen (5 bis 60 Minuten). Erscheint nur bei Pumpen mit HydroJet.
Unter Display-Aufhellung wird die Helligkeit des Pumpendisplays bei jedem Tastendruck kurzzeitig angehoben. Einstellbar sind Helligkeit erhöhen um (Stufen) und Dauer der Aufhellung (Sekunden).
Ab Version 2.0.0 ruft das Modul die Wetterdaten nicht mehr selbst über eine Postleitzahl ab. Die Außentemperatur kommt über die Cloud-Verbindung; der Standort wird in der Cloud-App festgelegt. Das spart Speicher auf dem Modul und entlastet es im Betrieb.
Bedientasten
Hier aktivierst oder deaktivierst du einzelne Tasten am physischen Bedienfeld der Pumpe - etwa Aufwärts, Abwärts und Einheit.
Deaktivierte Tasten können nur noch über WifiWhirl gesteuert werden. Die App fragt deshalb vor dem Speichern nach.
Gastgebermodus
Der Gastgebermodus ist für Ferienwohnungen, Airbnb und Hotels gedacht: Gäste bedienen den Whirlpool nur über das physische Bedienfeld, und zwar eingeschränkt.
- Gastgebermodus aktivieren sperrt am Bedienfeld die Tasten Timer, Power und Einheit (°C/°F). Airjet, Hydrojet, Heizung, Pumpe, Tastensperre und Zieltemperatur bleiben bedienbar.
- Max. Zieltemperatur begrenzt, wie warm Gäste stellen können. Das Limit gilt immer in °C.
- Heizung aus nach Erreichen der Zieltemperatur schaltet die Heizung nach der eingestellten Zeit ab;
0deaktiviert die Funktion. Ein erneuter Druck auf die Heiztaste startet einen neuen Zyklus.
Web-UI, MQTT und Apps bleiben uneingeschränkt nutzbar. Der Gastgebermodus betrifft ausschließlich das physische Bedienfeld.
Geräteeinstellungen
Globale Anmeldung
Die Globale Anmeldung schützt die gesamte Weboberfläche mit Benutzername und Passwort. Erst wenn sie aktiv ist, lassen sich Gerätename, Fallback-WLAN-Passwort und OTA-/Update-Passwort ändern.
- Zum Aktivieren musst du dein aktuelles OTA-/Update-Passwort zur Bestätigung eingeben.
- Beim Aktivieren oder Ändern des Passworts startet das Modul neu.
- "Angemeldet bleiben" hält die Sitzung über einen gehashten Token.
- Nach fünf Fehlversuchen wird die Anmeldung 30 Sekunden gesperrt.
Die Tastenfolge POWER - LOCK - TIMER - POWER am Gerät setzt das Modul zurück und entfernt die Anmeldung.
Geräteidentität
- Gerätename - 1 bis 63 Buchstaben, Ziffern oder Bindestriche, nicht mit Bindestrich beginnend oder endend.
- Fallback-WLAN-Passwort - Passwort des eigenen Zugangspunkts.
- OTA-/Update-Passwort - für Softwareupdates und den Downloadassistenten.
Webhooks
Webhooks erlauben externen Systemen, über /hook/ Befehle auszulösen - etwa aus Home Assistant, Node-RED, Skripten oder HTTP-Tastern.
- Webhooks aktivieren schaltet die Schnittstelle frei.
- Webhooks schützen aktiviert eine eigene HTTP-Basic-Auth. Dieselben Zugangsdaten schützen auch den Prometheus-Endpunkt
/metrics.
Deaktiviere den Schutz nur in vertrauenswürdigen lokalen Netzwerken oder für bestehende Integrationen, die keine Zugangsdaten senden können. Details zu den Aufrufen stehen unter Webhooks.
Für Monitoring-Systeme liefert das Modul unter /metrics zusätzlich Prometheus-Metriken. Dieser Endpunkt ist immer erreichbar und wird von derselben Webhook-Basic-Auth geschützt.
Sprache & Zeitzone
Sprache und Zeitzone lassen sich hier jederzeit ändern. Ebenfalls auf dieser Seite schaltest du den Expertenmodus frei.
Expertenmodus
Der Expertenmodus ist optional und schaltet eine zusätzliche Seite frei: Dort passt du das Energiemodell an deine Hardware an und schaltest das Fallback-WLAN. Aktiviert wird er in den Geräteeinstellungen.
Leistungsaufnahme
Unter Leistungsaufnahme (W) hinterlegst du die Wattwerte für Heizung, Filterpumpe, AirJet, HydroJet und Standby. Die Standardwerte entsprechen deinem Spa-Modell; "Auf Standard zurücksetzen" stellt sie wieder her.
Diese Werte bestimmen, wie genau Verbrauch und Kosten geschätzt werden.
Fallback-WLAN
Schlägt die WLAN-Verbindung fehl, kann das Modul einen eigenen Zugangspunkt öffnen, über den du es wieder erreichst. Der Schalter dafür liegt ab Version 2.0.0 hier im Expertenmodus, nicht mehr in der Netzwerkkonfiguration.
Pumpenkonfiguration
Unter Pumpenkonfiguration wählst du dein Pumpenmodell als Symbolkachel:
Airjet S100101
AirJet-Pumpen ab Baujahr 2021.
Hydrojet S200102
HydroJet-Pro-Pumpen ab Baujahr 2021.
Eiförmige Airjet Pumpe
Eiförmige AirJet-Modelle mit 6-Kabel-Anschluss.
MSPA
MSPA-Pumpen - Beta, nur mit ESP32-Modulen.
Nach dem Speichern startet das Modul neu, um das neue Modell zu initialisieren. Welches Modell du hast, verrät das Typenschild deiner Pumpe - siehe Kompatibilität.
Netzwerkkonfiguration
Die Seite Netzwerkkonfiguration zeigt oben den Verbindungsweg Whirlpool → Router mit Netzwerk, Signal und IP-Adresse.
WLAN
"WLAN-Netzwerke suchen" listet die verfügbaren Netzwerke mit Signalstärke (sehr gut, gut, mittel, schwach) und dem Hinweis gesichert. Wähle dein Netz aus und gib das Passwort ein.
- WLAN-Namen dürfen 1 bis 32 Zeichen lang sein.
- WLAN-Passwörter müssen 8 bis 63 Zeichen lang sein oder für ein offenes Netzwerk leer bleiben.
- "WLAN zurücksetzen" verwirft die gespeicherten Zugangsdaten.
Statische IP-Adresse
Standardmäßig bezieht das Modul seine Adresse automatisch (DHCP). Mit "Statische IP-Adresse aktivieren" hinterlegst du IP-Adresse, Subnetzmaske, Gateway sowie DNS-Server (primär) und (sekundär).
Zeit-Server (NTP)
Für Zeitpläne braucht das Modul die korrekte Uhrzeit. Standardmäßig fragt es einen öffentlichen NTP-Server; du kannst einen eigenen Domänennamen oder eine IP-Adresse hinterlegen.
Nach Änderungen an den Netzwerkeinstellungen startet das Modul neu. Rechne mit etwa 30 Sekunden.
Cloud-Verbindung (PoolLink)
Die WifiWhirl Cloud - intern PoolLink - ist eine verschlüsselte Verbindung zwischen deinem Modul und dem Cloud-Server. Damit steuerst und überwachst du deinen Whirlpool von überall, ohne VPN und ohne Portfreigabe im Router.
Status
Die Seite zeigt den Weg Whirlpool → Verbindung → Cloud und dazu Server, Web-App und Geräteschlüssel (Hinterlegt oder Nicht hinterlegt). Der Verbindungsstatus ist Deaktiviert, Getrennt, Verbinde…, Handshake… oder Verbunden.
Konto-Kopplung
Die Verbindungsdaten - Schlüssel, Server und Web-Adresse - sind bei gekauften Modulen werksseitig provisioniert. Du musst nichts eintragen.
Cloud-Verbindung aktivieren
Schalte "Cloud-Verbindung aktivieren" ein und speichere. Das Modul startet neu, um die Einstellung zu übernehmen.
Mit Cloud-Konto verbinden
Klicke auf "Mit Cloud-Konto verbinden". Du wirst zur Cloud-App unter cloud.wifiwhirl.de weitergeleitet und meldest dich dort an. Das Modul weist sich mit einem einmaligen Nachweis aus - der Geräteschlüssel selbst bleibt dabei auf dem Modul.
Nach der Kopplung werden Zustand, Befehlswarteschlange und Einstellungen mit der Cloud synchronisiert. Auch Außentemperatur und Standort kommen über diesen Weg.
Cloud-Verbindung und MQTT können nicht gleichzeitig aktiv sein. Wird eines eingeschaltet, bleibt das andere aus. Willst du wechseln, deaktiviere zuerst den anderen Kanal und speichere.
Alternative: Fernzugriff per VPN
Statt der Cloud kannst du dein Heimnetzwerk auch per VPN erreichen. Die Einrichtung erfolgt in deinem Router - etwa bei der AVM Fritz!Box - und ist von WifiWhirl unabhängig. Bei aktiver VPN-Verbindung erreichst du das Modul über seine IP-Adresse.
Module ohne werksseitig hinterlegten Schlüssel - etwa aus dem Selbstbau - zeigen die Cloud-Navigation nicht an. Die lokale Web-App und MQTT funktionieren wie gewohnt.
MQTT-Konfiguration
Über MQTT bindest du WifiWhirl in dein eigenes Smart Home ein - etwa in Home Assistant, ioBroker oder openHAB.
| Einstellung | Bedeutung |
|---|---|
| MQTT aktivieren | Schaltet die Broker-Verbindung ein |
| MQTT Server | Hostname oder IPv4-Adresse des Brokers |
| Port | 1 bis 65535, typisch 1883 |
| Benutzername / Passwort | Zugangsdaten des Brokers; leeres Passwortfeld behält das aktuelle |
| Client-ID | 1 bis 64 Zeichen |
| Basis-Topic | Ohne Leerzeichen, Wildcards oder Schrägstriche am Anfang und Ende |
| Telemetrie-Intervall (s) | 10 bis 86400 Sekunden |
Der Verbindungsstatus meldet unter anderem Verbunden, Getrennt, Zeitüberschreitung beim Verbindungsaufbau, Falsche Zugangsdaten oder Server nicht verfügbar.
Nach dem Speichern startet das Modul neu, um die Home Assistant Discovery auszuführen. Die MQTT-Topics und das Befehlsprotokoll sind zu Version 1.2.x abwärtskompatibel.
Softwareinfo und Firmware-Update
Die Seite Softwareinfo zeigt die Installierte Version und dein WifiWhirl Model.
Firmware-Update-Prüfung
Das Modul kann sich selbst aktuell halten:
- "Nach Firmware-Updates suchen" aktiviert die Prüfung. Sie läuft einmal täglich.
- Liegt eine neuere Version vor, erscheint im Menü das Abzeichen "Update verfügbar".
- "Nach Updates suchen" prüft sofort, "Update installieren" spielt die neue Version ein.
- Ist alles aktuell, meldet die Seite "Du verwendest die neueste Version."
Das Modul installiert nichts von allein - die Installation startest du selbst. Akzeptiert wird nur signierte Firmware.
Trenne die Stromversorgung nicht, solange "Wird heruntergeladen und installiert …" angezeigt wird.
Alternativ kannst du eine Firmware-Datei manuell hochladen. Dafür ist eine Anmeldung mit dem Benutzer update und deinem OTA-Passwort nötig - es steht auf dem Aufkleber deines Moduls und in der beiliegenden Anleitung. Alle Wege beschreibt die Seite Softwareupdate.
Supportpaket
Unter Hilfe & Support erstellt "Supportpaket erstellen" eine JSON-Datei mit Diagnosedaten - inklusive Absturz-Backtraces. Schicke sie bei Problemen mit, das beschleunigt die Fehlersuche deutlich.
Der Browser fragt dabei nach Zugangsdaten:
| Feld | Eingabe |
|---|---|
| Benutzername | support |
| Passwort | dein OTA-Passwort |
Das OTA-Passwort findest du auf dem Aufkleber am Modul, auf dem Gehäuse und in der gedruckten Anleitung. Es ist dasselbe Passwort wie beim Softwareupdate über die Weboberfläche - dort lautet der Benutzername allerdings update.
Hast du die globale Anmeldung eingeschaltet, entfällt diese Abfrage: Das Supportpaket nutzt dann deine bestehende Sitzung.
Das Paket enthält keine Klartext-Passwörter deines WLANs oder MQTT-Brokers.
Modul neu starten und zurücksetzen
WifiWhirl neu starten
"WifiWhirl neu starten" im Menü startet das Modul nach Rückfrage neu. Es ist nach etwa 30 Sekunden wieder erreichbar. Zähler, Einstellungen und Warteschlange bleiben erhalten.
Anmeldung zurücksetzen
Die Tastenfolge POWER - LOCK - TIMER - POWER am Gerät setzt das Modul zurück und entfernt die Anmeldung.
Umstieg von Version 1.2.x
Nur die Firmware aktualisieren
Ein separates Dateisystem-Update entfällt. Deine Einstellungen und die Befehlswarteschlange bleiben erhalten.
Neue Oberfläche, alte Lesezeichen
Lesezeichen auf alte HTML-Seiten werden automatisch auf die neuen Routen umgeleitet, etwa #/config oder #/info.
Wetter kommt aus der Cloud
Die PLZ-Einstellung entfällt. Außentemperatur und Standort liefert die Cloud, wenn die Verbindung aktiv und Wetter eingeschaltet ist.
MQTT bleibt nutzbar
MQTT funktioniert unverändert weiter - als Alternative zur Cloud, nicht parallel dazu.
Live-Updates ohne WebSocket
Die App nutzt HTTP-Polling. Das ist auf dem ESP8266 stabiler und braucht keine Konfiguration.
Einrichtung nur für neue Module
Bereits eingerichtete Module starten den Einrichtungsassistenten nicht erneut.
Den vollständigen Changelog findest du auf der GitHub Releases Seite und im Blogbeitrag WifiWhirl 2.0.0.
Wartung und Pflege
Wasserwerte prüfen
Miss pH-Wert und Chlor regelmäßig und trage die Werte im Dashboard ein. Die Timer erinnern dich an den nächsten Termin.
Filter reinigen und wechseln
Reinige den Filter regelmäßig und wechsle ihn nach Herstellerangabe. Setze den passenden Timer nach der Arbeit zurück.
Modul trocken halten
Das WifiWhirl-Modul gehört ins Pumpengehäuse und darf nicht mit Wasser in Berührung kommen.