Software & Firmware Update für dein WifiWhirl-Modul

Halte dein WifiWhirl-Modul immer auf dem neuesten Stand! Diese Anleitung zeigt dir, wie du die Software und Firmware deines Moduls aktualisieren kannst, um von den neuesten Funktionen und Verbesserungen zu profitieren.

Update-Dateien herunterladen

Wenn du das WifiWhirl-Modul bei mir gekauft hast, nutze den Downloadassistenten, um die Update-Dateien zu erhalten. Den Assistenten findest du unter update.wifiwhirl.de. Melde dich mit dem Benutzernamen update und dem OTA-Passwort deines WifiWhirl-Moduls an. Du findest das OTA-Passwort auf dem deinem Modul beiliegenden Aufkleber, der Anleitung und dem Gehäuse deines WifiWhirl-Moduls.

Entpacke die heruntergeladene .zip-Datei auf deinem Computer.

Update Tool starten

Das Update Tool bietet dir eine grafische Oberfläche (Windows) bzw. ein Menü (Linux), das dich durch alle Schritte führt.

Windows

Starte WIFIWHIRL_UPDATE.bat per Doppelklick. Es öffnet sich das WifiWhirl Update Tool mit einer grafischen Benutzeroberfläche.

Linux

Starte WIFIWHIRL_UPDATE.sh per Doppelklick oder im Terminal:

./WIFIWHIRL_UPDATE.sh

Update-Methoden

Das Update Tool bietet dir drei Methoden zur Auswahl. Wähle die Methode, die am besten zu deiner Situation passt.

Option 1: Update über die Weboberfläche (Empfohlene Methode)

Dies ist die einfachste Methode. Du benötigst lediglich einen Browser und musst keine zusätzliche Software installieren.

Voraussetzung: Auf deinem Modul ist mindestens Softwareversion 1.1.4 installiert.

Schritte

1. Wähle im Update Tool die Option "Update über die Weboberfläche".
2. Das Tool öffnet automatisch die Update-Seite deines Moduls im Browser.
3. Klicke auf "Software" und wähle "Datei auswählen".
4. Navigiere in den Ordner binaries und wähle die Firmware-Datei (z.B. firmware_1.2.0.fw.bin).
5. Klicke auf "Upload".

Nach dem Upload: Leere den Browser-Cache mit Strg + F5 (Windows/Linux) oder Cmd + Shift + R (macOS), um die neue Oberfläche korrekt anzuzeigen.

Option 2: Update per WLAN (OTA)

Bei dieser Methode wird die Firmware kabellos über dein WLAN-Netzwerk auf das Modul übertragen.

Voraussetzungen:

• Dein Computer befindet sich im selben Netzwerk wie dein WifiWhirl-Modul.
• Das Modul ist über das Netzwerk erreichbar.

Schritte

1. Wähle im Update Tool die Option "Update per WLAN (OTA)".
2. Das Tool prüft automatisch die Netzwerkverbindung zu deinem Modul.
3. Bestätige den Start des Updates.
4. Das Tool überträgt die Firmware und zeigt dir den Fortschritt an.
5. Bei einem Fehler bietet das Tool bis zu 3 automatische Wiederholungsversuche an.

Option 3: Update per USB-Kabel

Diese Methode ist für den Fall gedacht, dass weder die Weboberfläche noch das WLAN-Update funktionieren.

Voraussetzungen:

• USB-C- oder Micro-USB-Kabel (modellabhängig)

Neuere WifiWhirl-Module (mit USB-C-Anschluss auf der Platine)

Bei neueren Modulen befindet sich ein USB-C-Anschluss direkt auf der Platine. Es muss kein Chip entfernt werden.

1. Öffne das Gehäuse des WifiWhirl-Moduls.
2. Verbinde den USB-C-Anschluss auf der Platine mit deinem Computer.
3. Wähle im Update Tool die Option "Update per USB-Kabel".
4. Folge den Anweisungen im Programm.

Ältere WifiWhirl-Module (NodeMCU, D1 Mini, D1 Mini Pro)

Bei älteren Modulen muss der Mikrocontroller-Chip von der Platine entfernt werden.

1. Öffne das Gehäuse des WifiWhirl-Moduls (zwei Kreuzschlitz-Schrauben).
2. Entferne den gesteckten Mikrocontroller-Chip von der Platine.
3. Verbinde den Chip über USB (Micro-USB oder USB-C, je nach Chip) mit deinem Computer. Lege den Chip dabei auf eine nicht-leitende Oberfläche.
4. Wähle im Update Tool die Option "Update per USB-Kabel".
5. Folge den Anweisungen im Programm.
6. Nach dem Update: Stecke den Chip vorsichtig zurück auf die Platine. Achte darauf, dass der USB-Anschluss des Chips nach unten zeigt und alle Pins korrekt sitzen.
7. Verschraube das Gehäuse und schließe das Modul wieder an die Pumpe an.

Erweiterte Optionen (nur Support)

Das Update Tool bietet unter "Erweiterte Optionen" zusätzliche Funktionen, die ausschließlich auf Anweisung des WifiWhirl-Supports genutzt werden sollten:

• Nur Firmware installieren (OTA oder USB)
• Nur Dateisystem installieren (OTA oder USB)
• Vollinstallation (Firmware + Dateisystem)
• Chip löschen (USB) – löscht den gesamten Flash-Speicher
• Rescue-Firmware (OTA) – spielt eine Notfall-Firmware auf, falls vorhanden

Changelogs (Änderungsprotokolle)

Hier sind die Details zu den letzten Software-Versionen. Die vollständigen Release-Informationen und Download-Dateien findest du immer auf der WifiWhirl GitHub Releases Seite.

Version 1.2.0

(Veröffentlicht: 01. März 2026)

Version 1.2.0 führt ein neues, einheitliches Update Tool mit grafischer Benutzeroberfläche (Windows) und Menüsteuerung (Linux) ein. Die Firmware- und Dateisystem-Updates wurden zusammengeführt, sodass nur noch ein einzelner Update-Schritt nötig ist. Alle Einstellungen und Zählerstände bleiben beim Update erhalten. Dieses Release dreht sich um drei grosse Themen: intelligente Automatisierung, erweiterte Überwachungsmöglichkeiten und eine grundlegend modernisierte Benutzeroberfläche.

Link zur GitHub Release Seite für v1.2.0

Version 1.1.6

(Veröffentlicht: 20. Juni 2025)

Version 1.1.6 ist ein umfangreiches Stabilitäts-Release. Es beinhaltet eine komplett überarbeitete Home Assistant-Integration für deutlich höhere Zuverlässigkeit, einen neuen /getstates/ Endpunkt zur JSON-Abfrage des Modulstatus und zahlreiche Verbesserungen der Benutzerfreundlichkeit, wie z.B. Sicherheitsabfragen und eine adaptive Oberfläche. Zudem wurden wichtige Fehler, wie die Verarbeitung von Postleitzahlen mit führenden Nullen und das Verhalten von UI-Slidern, behoben.

Link zur GitHub Release Seite für v1.1.6

Version 1.1.5

(Veröffentlicht: 29. April 2025)

Version 1.1.5 bringt wichtige Neuerungen wie Wartungs-Timer und Wetterdatenintegration, vereinfacht die Hardware-Einrichtung und verbessert zahlreiche UI-Elemente. Zudem wurden diverse Fehler behoben und interne Optimierungen vorgenommen. Für eine detaillierte Auflistung aller Änderungen und Verbesserungen, sieh dir bitte den vollständigen Changelog auf GitHub an.

Link zur GitHub Release Seite für v1.1.5

Version 1.1.4

(Veröffentlicht: 01. Juni 2024)

Version 1.1.4 führte eine Webupdate-Funktion für einfachere Aktualisierungen ein, verbesserte das Caching für schnellere Ladezeiten und die Darstellung der WLAN-Verbindungsstärke. Daneben gab es verschiedene Fehlerbehebungen und Verbesserungen der Systemstabilität. Den kompletten Changelog mit allen Details findest du auf GitHub.

Link zur GitHub Release Seite für v1.1.4

Version 1.1.3

(Veröffentlicht: 05. Mai 2024)

Mit Version 1.1.3 wurde die Webhook-Unterstützung als neue Funktion implementiert. Außerdem wurde ein Fehler im Ticker-Timing behoben, um potenzielle Datenverluste zu verhindern. Für weitere Informationen sieh dir bitte den vollständigen Changelog auf GitHub an.

Link zur GitHub Release Seite für v1.1.3

Weitere Fragen zum Update?

Antworten auf weitere Fragen findest du möglicherweise in unseren Häufig gestellten Fragen (FAQ).