La MSpa Mono Eco (modello F-MO062WE) è una spa gonfiabile rotonda della serie MSpa FRAME per un massimo di 6 persone (930 L). La centralina esterna contiene un riscaldatore da 2200 W, un soffiatore per bolle d’aria a tre livelli, una pompa di filtrazione e uno sterilizzatore UVC, e si collega tramite Wi-Fi a 2,4 GHz al cloud MSpa, che l’app mobile MSpa Link usa per il controllo remoto.
Questo template della community collega TapHome allo stesso cloud MSpa tramite HTTPS (api.iot.the-mspa.com, porta 443). Tra l’unità di controllo TapHome e la spa non c’è alcuna connessione locale: il template legge lo stato della spa dall’oggetto data restituito dal cloud e invia le modifiche all’endpoint del cloud /api/device/command. Non è un’integrazione ufficiale MSpa.
| |
Collegamento hardware
La spa non è cablata a TapHome. L’unico collegamento elettrico è l’alimentazione di rete della centralina:
- Collega la spa direttamente a una presa con messa a terra. Il manuale MSpa vieta prolunghe, timer, adattatori e spine di conversione sull’alimentazione, quindi la spa si controlla solo tramite il cloud, non interrompendo l’alimentazione.
- Usa la spa solo con l’interruttore differenziale (RCD) presente sul cavo di alimentazione, con corrente differenziale nominale di intervento non superiore a 30 mA. Prova l’RCD prima di ogni utilizzo: premi RESET (l’indicatore diventa rosso), premi TEST (l’indicatore rosso deve spegnersi), poi premi di nuovo RESET.
- Dopo l’accensione e il reset dell’RCD, il display LED mostra la temperatura attuale dell’acqua.

Configurazione
Requisiti di rete
- La centralina supporta solo Wi-Fi a 2,4 GHz (2412–2472 MHz). Non usare una rete con il suffisso
_5G; se il router non mostra una rete a 2,4 GHz, attivala nelle impostazioni del router. - Imposta la sicurezza del router su WPA2. L’app MSpa Link potrebbe rifiutare una rete il cui SSID contiene caratteri speciali (non alfanumerici).
- Tieni la spa, il router e il telefono usato per l’abbinamento il più vicino possibile tra loro, per avere un segnale Wi-Fi forte.
- La spa e l’unità di controllo TapHome non devono trovarsi nella stessa rete locale, ma l’unità di controllo ha bisogno dell’accesso a Internet (HTTPS in uscita, porta 443) verso
api.iot.the-mspa.com. api.iot.the-mspa.comè il cloud MSpa per l’Europa e il resto del mondo. Le spa registrate nella regione Stati Uniti e Canada (api.usiot.the-mspa.com) o nella regione Cina usano un indirizzo cloud diverso da quello impostato nel template.
Creazione di un account MSpa Link
La spa deve prima essere associata a un account nell’app MSpa Link (iOS 9.0 o successivo, Android 7.0 o successivo; cerca “MSpa Link” nell’app store).

- Apri l’app e tocca Sign Up. Non continuare come Visitor: TapHome ha bisogno dell’indirizzo email e della password di un account registrato.
- Seleziona il tuo paese e inserisci il tuo indirizzo email.
- Inserisci il codice di verifica ricevuto via email (valido 15 minuti; può essere inviato di nuovo dopo 60 secondi).
- Imposta una password di 6–15 lettere o numeri.
Associazione della spa all’account
- Assicurati che la spa sia accesa e che il telefono sia connesso alla rete Wi-Fi a 2,4 GHz con il Bluetooth attivo.
- Nell’app tocca ADD DEVICE e scegli il tipo di controller (CONTROL BOX).
- Tieni premuto il pulsante UP sulla centralina finché l’icona Wi-Fi non inizia a lampeggiare, poi tocca CONFIRM.
- Inserisci la password della rete Wi-Fi.
- Scegli la spa trovata (MSPA MONO); questo passaggio richiede l’autorizzazione Bluetooth.
- Attendi il completamento dell’associazione.

Per dissociare la spa, premi contemporaneamente i pulsanti HEATER e TIMER.
Una spa può essere abbinata a un solo utente principale alla volta. Se un altro account abbina la spa, l’utente precedente viene disconnesso. Non abbinare la spa una seconda volta dall’account destinato a TapHome.
Account usato da TapHome
Il cloud MSpa mantiene un solo token di accesso valido per account: un nuovo login con lo stesso account invalida quello precedente. Se TapHome e l’app MSpa Link usano lo stesso account, possono disconnettersi a vicenda e la connessione di TapHome cade a intermittenza. Per TapHome usa un account ospite separato, con indirizzo email e password propri; gli utenti registrati di MSpa Link possono condividere la spa con altri utenti.
Parametri di importazione
Il template richiede quattro parametri durante l’importazione:
| Parametro | Significato | Come ottenerlo |
|---|---|---|
Email | Indirizzo email dell’account MSpa Link usato da TapHome | L’indirizzo usato in fase di registrazione |
PasswordMd5 | Hash MD5 della password dell’account: 32 caratteri esadecimali minuscoli. Non la password leggibile | Calcolalo in locale con qualsiasi strumento MD5 (vedi sotto) |
DeviceId | Identificativo della spa nel cloud MSpa | Elenco dispositivi dell’account, campo device_id |
ProductId | Identificativo del prodotto spa nel cloud MSpa | Elenco dispositivi dell’account, campo product_id |
Il cloud MSpa non accetta la password in chiaro, solo il suo hash MD5. Comandi di esempio:
| |
Usa printf, non echo: echo aggiunge un a capo alla fine della password, l’hash risulta diverso e il login fallisce senza un errore chiaro. Non usare generatori MD5 online: riceverebbero la password.
La documentazione MSpa non indica dove l’app mostra gli identificativi del dispositivo. Il cloud MSpa li restituisce nell’elenco dispositivi dell’account (/api/enduser/devices/, voci dell’elenco con device_id e product_id) dopo un login su /api/enduser/get_token/.
In TapHome importa il template sull’unità di controllo e compila Email, PasswordMd5, DeviceId e ProductId nella finestra di importazione.
Funzionalità del dispositivo
Temperatura dell’acqua e riscaldamento
- Temperatura acqua (termostato): mostra la temperatura attuale dell’acqua e imposta la temperatura obiettivo nell’intervallo 20–40 °C. Il cloud trasferisce le temperature a passi di mezzo grado (valore × 2), il template le converte in °C.
- Sensore temperatura acqua: temperatura attuale dell’acqua, in sola lettura.
- Riscaldatore: accende e spegne il riscaldamento. Accendendolo si accende anche la filtrazione; la spa stessa avvia la filtrazione ogni volta che il riscaldamento è attivo.
- Stato riscaldamento: fase di riscaldamento segnalata dalla spa; il template interpreta 2 come preriscaldamento e 3 come riscaldamento.
- Riscaldata entro: stima del momento in cui l’acqua raggiunge la temperatura obiettivo, calcolata dalla velocità di riscaldamento segnalata dalla spa oppure dalla variabile del modulo
HeatRate(predefinita 1,8 °C all’ora) quando la spa non la segnala. Zero quando il riscaldatore è spento o la temperatura obiettivo è raggiunta. - Tempo di riscaldamento (min) e Interruttore tempo di riscaldamento: valori in sola lettura
heat_timeeheat_time_switch, così come li riporta il cloud.
Filtrazione e trattamento dell’acqua
- Filtrazione: accende e spegne la pompa di filtrazione. Spegnendo la filtrazione si spegne anche il riscaldatore.
- Sterilizzazione UVC: accende e spegne lo sterilizzatore UVC.
- Filtro residuo e Utilizzo filtro: durata residua del filtro e ore di funzionamento del filtro, in ore.
Massaggio
- Bolle: interruttore multivalore con gli stati Spento, Basso, Medio e Alto; livello e stato acceso/spento vengono inviati con un unico comando. Secondo MSpa, il soffiatore assorbe 300 W, 500 W o 720 W a seconda del livello e si spegne automaticamente dopo 20 minuti di funzionamento.
- Getti: interruttore per i modelli MSpa con getti idromassaggio. Il pannello di controllo della Mono Eco non ha la funzione getti; il dispositivo può essere eliminato dopo l’importazione.
MSpa avverte di non attivare il massaggio a bolle con la copertura montata: l’aria può accumularsi all’interno della spa e causare danni e lesioni. Tienilo presente per il controllo remoto e per le automazioni che attivano le bolle.
Stato e impostazioni
- Stato online: connessione della spa al cloud MSpa, Online oppure Offline.
- Blocco di sicurezza: stato del blocco del pannello di controllo (bloccato / sbloccato), in TapHome in sola lettura.
- Unità di temperatura: commuta l’unità usata dalla spa tra °C e °F.
- Gonfiaggio automatico: valore di gonfiaggio automatico segnalato dalla spa, in sola lettura.
- Versione firmware Wi-Fi: versione firmware del modulo Wi-Fi della spa.
- Attributi di servizio del modulo: codice di errore, stato riscaldamento, filtro residuo e utilizzo filtro.
Stima di potenza ed energia
Il template non misura l’elettricità. Potenza (W) è una stima calcolata dagli stati di filtrazione, bolle e riscaldamento e dai valori nominali salvati nelle variabili del modulo:
| Variabile | Predefinito | Aggiunto quando |
|---|---|---|
PumpW | 60 W | la filtrazione è attiva |
BubbleW | 900 W | le bolle sono attive |
HeaterPreheatW | 1500 W | il riscaldatore è acceso e lo stato riscaldamento è 2 (preriscaldamento) |
HeaterHeatW | 2000 W | il riscaldatore è acceso e lo stato riscaldamento è 3 (riscaldamento) |
Energia (kWh) mostra il valore della variabile del modulo kWhTotal; non è la lettura di un contatore.
Il manuale MSpa indica per la Mono Eco un riscaldatore da 2200 W, un soffiatore per bolle da 300 / 500 / 720 W a seconda del livello e una potenza nominale di 2300 W. Adegua le variabili del modulo a questi valori per una stima più precisa.
Risoluzione dei problemi
L’app non trova la spa durante l’associazione
- Verifica che il Bluetooth sia attivo e che l’app MSpa Link abbia il permesso di usarlo.
- Se i passaggi precedenti hanno richiesto troppo tempo, la spa potrebbe essere uscita dalla modalità di abbinamento. Resta nella pagina di ricerca e tieni di nuovo premuto il pulsante UP sulla centralina.
L’associazione non riesce
- Failure to connect the device: di solito il segnale è debole; avvicina tra loro il telefono, la spa e il router.
- Failure to connect the device to the Wi-Fi network: controlla la password Wi-Fi e imposta la sicurezza del router su WPA2; usa una rete a 2,4 GHz.
- Failure to bind the device to the account: assicurati che la rete Wi-Fi sia stabile e riprova.
Nessun valore in TapHome
- Verifica che
PasswordMd5sia l’hash MD5 di 32 caratteri minuscoli calcolato esattamente dalla password dell’account (senza a capo finale). - Confronta
DeviceIdeProductIdcon l’elenco dispositivi dell’account. - Verifica che la spa sia registrata nella regione Europa / resto del mondo del cloud MSpa.
- Controlla Stato online e la connessione Wi-Fi della spa.
La connessione di TapHome cade mentre si usa l’app
L’app e TapHome hanno effettuato l’accesso con lo stesso account e si invalidano il login a vicenda. Usa un account separato per TapHome (vedi Account usato da TapHome).
L’acqua si scalda lentamente o la temperatura è diversa
Secondo MSpa, il riscaldamento è più lento con una temperatura ambiente inferiore a 10 °C, con vento oltre 3,5–5,4 m/s, con le bolle in funzione durante il riscaldamento o senza la copertura correttamente posizionata. La temperatura dell’acqua visualizzata può differire da quella reale di circa 1 °C.
