MSpa Mono Eco

Der MSpa Mono Eco (Modell F-MO062WE) ist ein runder aufblasbarer Whirlpool der MSpa FRAME-Serie für bis zu 6 Personen (930 L). Seine externe Steuerbox enthält eine Heizung mit 2200 W, ein Luftsprudel-Gebläse mit drei Stufen, eine Filterpumpe und einen UVC-Sterilisator und verbindet sich über 2,4-GHz-WLAN mit der MSpa-Cloud, über die die mobile App MSpa Link den Whirlpool fernsteuert.

Diese Community-Vorlage verbindet TapHome über HTTPS mit derselben MSpa-Cloud (api.iot.the-mspa.com, Port 443). Zwischen der TapHome-Steuereinheit und dem Whirlpool gibt es keine lokale Verbindung: Die Vorlage liest den Zustand des Whirlpools aus dem Objekt data, das die Cloud zurückgibt, und sendet Änderungen an den Cloud-Endpunkt /api/device/command. Es handelt sich nicht um eine offizielle MSpa-Integration.

1

[Spa control box] --2.4 GHz Wi-Fi--> [router] --internet--> [MSpa cloud] <--HTTPS 443-- [TapHome Control Unit]

Hardwareanschluss#

Der Whirlpool wird nicht mit TapHome verdrahtet. Die einzige elektrische Verbindung ist die Netzversorgung der Steuerbox:

• Schließen Sie den Whirlpool direkt an eine geerdete Steckdose an. Das MSpa-Handbuch verbietet Verlängerungskabel, Zeitschaltuhren, Steckeradapter und Adapterstecker in der Versorgung. Der Whirlpool wird daher nur über die Cloud gesteuert, nicht durch Schalten seiner Versorgung.
• Betreiben Sie den Whirlpool nur mit dem FI-Schutzschalter (Fehlerstrom-Schutzeinrichtung) an seinem Netzkabel, mit einem Bemessungsfehlerstrom von höchstens 30 mA. Prüfen Sie den FI-Schutzschalter vor jeder Benutzung: Drücken Sie RESET (die Anzeige leuchtet rot), drücken Sie TEST (die rote Anzeige muss erlöschen) und drücken Sie dann erneut RESET.
• Nach dem Einschalten und dem Zurücksetzen des FI-Schutzschalters zeigt das LED-Display die aktuelle Wassertemperatur an.

Konfiguration#

Netzwerkanforderungen

• Die Steuerbox unterstützt nur 2,4-GHz-WLAN (2412–2472 MHz). Verwenden Sie kein Netzwerk mit dem Suffix _5G. Wenn der Router kein 2,4-GHz-Netzwerk anzeigt, aktivieren Sie es in den Router-Einstellungen.
• Stellen Sie die Sicherheit des Routers auf WPA2 ein. Die App MSpa Link kann ein Netzwerk ablehnen, dessen SSID Sonderzeichen (nicht alphanumerische Zeichen) enthält.
• Halten Sie den Whirlpool, den Router und das Telefon für die Kopplung möglichst nah beieinander, damit das WLAN-Signal stark ist.
• Der Whirlpool und die TapHome-Steuereinheit müssen nicht im selben lokalen Netzwerk sein, aber die Steuereinheit braucht Internetzugang (ausgehendes HTTPS, Port 443) zu api.iot.the-mspa.com.
• api.iot.the-mspa.com ist die MSpa-Cloud für Europa und die übrige Welt. Whirlpools, die in der Region USA und Kanada (api.usiot.the-mspa.com) oder in der Region China registriert sind, nutzen eine andere Cloud-Adresse als die in der Vorlage eingestellte.

MSpa-Link-Konto anlegen

Der Whirlpool muss zuerst an ein Konto in der App MSpa Link gebunden werden (iOS 9.0 oder neuer, Android 7.0 oder neuer; suchen Sie im App Store nach „MSpa Link“).

1. Öffnen Sie die App und tippen Sie auf Sign Up. Fahren Sie nicht als Visitor fort — TapHome braucht die E-Mail-Adresse und das Passwort eines registrierten Kontos.
2. Wählen Sie Ihr Land und geben Sie Ihre E-Mail-Adresse ein.
3. Geben Sie den Bestätigungscode aus der E-Mail ein (15 Minuten gültig; er kann nach 60 Sekunden erneut gesendet werden).
4. Legen Sie ein Passwort aus 6–15 Buchstaben oder Ziffern fest.

Whirlpool an das Konto binden

1. Stellen Sie sicher, dass der Whirlpool eingeschaltet ist und das Telefon mit dem 2,4-GHz-WLAN verbunden und sein Bluetooth eingeschaltet ist.
2. Tippen Sie in der App auf ADD DEVICE und wählen Sie den Steuerungstyp (CONTROL BOX).
3. Halten Sie die Taste UP an der Steuerbox gedrückt, bis das WLAN-Symbol zu blinken beginnt, und tippen Sie dann auf CONFIRM.
4. Geben Sie das Passwort des WLAN-Netzwerks ein.
5. Wählen Sie den gefundenen Whirlpool (MSPA MONO); dieser Schritt erfordert die Bluetooth-Berechtigung.
6. Warten Sie, bis der Bindevorgang abgeschlossen ist.

Um die Bindung des Whirlpools aufzuheben, drücken Sie gleichzeitig die Tasten HEATER und TIMER.

Ein Whirlpool kann gleichzeitig nur mit einem Hauptbenutzer gekoppelt sein. Koppelt ein anderes Konto den Whirlpool, wird der bisherige Benutzer von ihm getrennt. Koppeln Sie den Whirlpool nicht ein zweites Mal über das Konto, das für TapHome bestimmt ist.

Von TapHome verwendetes Konto

Die MSpa-Cloud hält pro Konto ein gültiges Anmelde-Token — eine neue Anmeldung mit demselben Konto macht das vorherige ungültig. Nutzen TapHome und die App MSpa Link dasselbe Konto, können sie sich gegenseitig abmelden, und die Verbindung von TapHome bricht zeitweise ab. Verwenden Sie für TapHome ein separates Gastkonto mit eigener E-Mail-Adresse und eigenem Passwort; registrierte Benutzer von MSpa Link können den Whirlpool mit anderen Benutzern teilen.

Importparameter

Die Vorlage fragt beim Import nach vier Parametern:

Die MSpa-Cloud akzeptiert das Passwort nicht in lesbarer Form, sondern nur seinen MD5-Hash. Beispielbefehle:

1
2
3
4
5
6

# Windows (PowerShell)
$p = "YourPassword"
-join ([Security.Cryptography.MD5]::Create().ComputeHash([Text.Encoding]::UTF8.GetBytes($p)) | % { $_.ToString("x2") })

# Linux
printf '%s' 'YourPassword' | md5sum

Verwenden Sie printf, nicht echo: echo hängt an das Ende des Passworts einen Zeilenumbruch an, der Hash ist dann ein anderer und die Anmeldung schlägt ohne klare Fehlermeldung fehl. Verwenden Sie keine Online-MD5-Generatoren — diese würden das Passwort erhalten.

Die MSpa-Dokumentation gibt nicht an, wo die App die Gerätekennungen anzeigt. Die MSpa-Cloud liefert sie in der Geräteliste des Kontos (/api/enduser/devices/, Listeneinträge mit device_id und product_id) nach einer Anmeldung unter /api/enduser/get_token/.

Importieren Sie in TapHome die Vorlage auf der Steuereinheit und tragen Sie im Importdialog Email, PasswordMd5, DeviceId und ProductId ein.

Gerätefunktionen#

Wassertemperatur und Heizung

• Wassertemperatur (Thermostat) — zeigt die aktuelle Wassertemperatur und stellt die Solltemperatur im Bereich 20–40 °C ein. Die Cloud überträgt Temperaturen in Halbgradschritten (Wert × 2), die Vorlage rechnet sie in °C um.
• Wassertemperatursensor — aktuelle Wassertemperatur, nur lesbar.
• Heizung — schaltet die Heizung ein und aus. Beim Einschalten wird auch die Filtration eingeschaltet; der Whirlpool selbst startet die Filtration immer, wenn die Heizung läuft.
• Heizzustand — vom Whirlpool gemeldete Heizphase; die Vorlage behandelt 2 als Vorheizen und 3 als Heizen.
• Aufgeheizt um — Schätzung, wann das Wasser die Solltemperatur erreicht, berechnet aus der vom Whirlpool gemeldeten Heizrate oder, wenn der Whirlpool keine meldet, aus der Modulvariable HeatRate (Standard 1,8 °C pro Stunde). Null, wenn die Heizung aus ist oder die Solltemperatur erreicht ist.
• Heizzeit (min) und Heizzeitschalter — nur lesbare Werte heat_time und heat_time_switch, wie die Cloud sie meldet.

Filtration und Wasserpflege

• Filtration — schaltet die Filterpumpe ein und aus. Beim Ausschalten der Filtration wird auch die Heizung ausgeschaltet.
• UVC-Sterilisation — schaltet den UVC-Sterilisator ein und aus.
• Filter-Restlaufzeit und Filternutzung — verbleibende Filterlebensdauer und Betriebsstunden des Filters, in Stunden.

Massage

• Sprudel — Mehrwertschalter mit den Zuständen Aus, Niedrig, Mittel und Hoch; Stufe und Ein/Aus-Zustand werden in einem Befehl gesendet. Laut MSpa nimmt das Gebläse je nach Stufe 300 W, 500 W oder 720 W auf und schaltet sich nach 20 Minuten Betrieb automatisch ab.
• Jets — Schalter für MSpa-Modelle mit Hydrojets. Das Bedienfeld des Mono Eco hat keine Jet-Funktion; das Gerät kann nach dem Import gelöscht werden.

MSpa warnt davor, die Sprudelmassage bei aufgelegter Abdeckung einzuschalten — im Whirlpool kann sich Luft ansammeln und Schäden sowie Verletzungen verursachen. Berücksichtigen Sie dies bei der Fernsteuerung und bei Automatisierungen, die den Sprudel schalten.

Status und Einstellungen

• Online-Status — Verbindung des Whirlpools zur MSpa-Cloud, Online oder Offline.
• Tastensperre — Zustand der Sperre des Bedienfelds (Gesperrt / Entsperrt), in TapHome nur lesbar.
• Temperatureinheit — schaltet die vom Whirlpool verwendete Einheit zwischen °C und °F um.
• Automatisches Aufblasen — nur lesbarer Wert des automatischen Aufblasens, wie der Whirlpool ihn meldet.
• WLAN-Firmwareversion — Firmwareversion des WLAN-Moduls des Whirlpools.
• Service-Attribute des Moduls: Fehlercode, Heizzustand, Filter-Restlaufzeit und Filternutzung.

Schätzung von Leistung und Energie

Die Vorlage misst keinen Strom. Leistung (W) ist eine Schätzung, berechnet aus den Zuständen von Filtration, Sprudel und Heizung und aus Nennwerten, die in Modulvariablen gespeichert sind:

Energie (kWh) zeigt den Wert der Modulvariable kWhTotal; es ist kein Zählerstand.

Das MSpa-Handbuch nennt für den Mono Eco eine Heizung mit 2200 W, ein Sprudelgebläse mit 300 / 500 / 720 W je Stufe und eine Nennleistung von 2300 W. Passen Sie die Modulvariablen an diese Werte an, um eine genauere Schätzung zu erhalten.

Fehlerbehebung#

Die App findet den Whirlpool beim Binden nicht

• Prüfen Sie, ob Bluetooth eingeschaltet ist und die App MSpa Link es verwenden darf.
• Haben die vorherigen Schritte zu lange gedauert, hat der Whirlpool den Kopplungsmodus möglicherweise verlassen. Bleiben Sie auf der Suchseite und halten Sie die Taste UP an der Steuerbox erneut gedrückt.

Das Binden schlägt fehl

• Failure to connect the device — meist ein schwaches Signal; bringen Sie Telefon, Whirlpool und Router näher zusammen.
• Failure to connect the device to the Wi-Fi network — prüfen Sie das WLAN-Passwort und stellen Sie die Sicherheit des Routers auf WPA2 ein; verwenden Sie ein 2,4-GHz-Netzwerk.
• Failure to bind the device to the account — stellen Sie sicher, dass das WLAN-Netzwerk stabil ist, und versuchen Sie es erneut.

Keine Werte in TapHome

• Prüfen Sie, ob PasswordMd5 der 32-stellige MD5-Hash in Kleinbuchstaben von genau dem Kontopasswort ist (ohne abschließenden Zeilenumbruch).
• Prüfen Sie DeviceId und ProductId anhand der Geräteliste des Kontos.
• Prüfen Sie, ob der Whirlpool in der Region Europa / übrige Welt der MSpa-Cloud registriert ist.
• Prüfen Sie den Online-Status und die WLAN-Verbindung des Whirlpools.

Die Verbindung von TapHome bricht ab, während die App verwendet wird

Die App und TapHome sind mit demselben Konto angemeldet und machen gegenseitig ihre Anmeldung ungültig. Verwenden Sie für TapHome ein separates Konto (siehe Von TapHome verwendetes Konto).

Das Wasser heizt langsam oder die Temperatur weicht ab

Laut MSpa ist das Heizen langsamer bei einer Umgebungstemperatur unter 10 °C, bei Windgeschwindigkeiten über 3,5–5,4 m/s, wenn der Sprudel während des Heizens läuft oder wenn die Abdeckung nicht richtig aufliegt. Die angezeigte Wassertemperatur kann von der tatsächlichen um etwa 1 °C abweichen.