Shelly Flood è un sensore Wi-Fi di rilevamento allagamento alimentato a batteria (CR123A). TapHome comunica con il dispositivo tramite MQTT — il protocollo raccomandato per i dispositivi Shelly a batteria, poiché il sensore rimane in standby la maggior parte del tempo e pubblica dati solo al risveglio.

Il template supporta fino a 5 sensori Shelly Flood per modulo. Ogni istanza sensore è identificata da una variabile personalizzata sensorN_topic che punta al Client ID MQTT del dispositivo.

Configurazione

Device ID

Ogni sensore Shelly Flood ha un Device ID MQTT univoco nel formato shellyflood-<MAC6>, dove <MAC6> è il 6 caratteri finali dell’indirizzo MAC in esadecimale minuscolo (es. shellyflood-112233).

Il Device ID si trova:

• Sull’etichetta del dispositivo (indirizzo MAC)
• Nell’interfaccia web di Shelly: Settings → Device Info
• Tramite API: GET http://<device-ip>/settings → campo mqtt.id

Questo dispositivo supporta la scoperta mDNS. È possibile usare il nome host shellyflood-{MAC}.local al posto di un indirizzo IP nella configurazione di TapHome. Sostituire {MAC} con gli ultimi 6 caratteri dell’indirizzo MAC del dispositivo in esadecimale minuscolo (es. shellyflood-112233.local). L’uso del nome host evita problemi di connettività quando l’indirizzo IP del dispositivo cambia.

Configurazione del template

Dopo aver importato il template in TapHome:

1. Aprire il modulo Shelly Flood MQTT
2. Impostare l’IP del broker MQTT e la porta (default 1883)
3. Per ogni istanza sensore, impostare la variabile personalizzata sensorN_topic sul Device ID del corrispondente Shelly Flood (es. shellyflood-112233)

Il modulo si iscrive a shellies/# e gli script listener filtrano i messaggi in base al prefisso del topic configurato.

Configura solo gli slot sensore che utilizzi effettivamente. Gli slot non configurati (con il valore predefinito shellyflood-deviceid) mostrano un messaggio di errore che invita a impostare il topic corretto.

Funzionalità del dispositivo

Rilevamento allagamento

Ogni istanza sensore è mappata come dispositivo Reed Contact in TapHome. Lo stato di allagamento viene letto dal topic shellies/<id>/sensor/flood:

• true → Allarme (acqua rilevata)
• false → OK (asciutto)

Il sensore si risveglia e pubblica il proprio stato quando viene rilevata o rimossa l’acqua, e anche durante gli intervalli di segnalazione periodica.

Monitoraggio batteria e temperatura

Ogni istanza sensore espone due attributi di servizio:

• Batteria — percentuale del livello batteria letta da shellies/<id>/sensor/battery. Viene generato un avviso di batteria scarica quando il livello scende sotto il 20%.
• Temperatura — temperatura ambiente in °C letta da shellies/<id>/sensor/temperature.

Entrambi gli attributi sono in sola lettura e si aggiornano ogni volta che il sensore si risveglia e pubblica dati.

Funzionalità aggiuntive

Shelly Flood pubblica anche uno stato online/offline tramite il topic MQTT Last Will and Testament (LWT) e un messaggio di stato JSON completo (firmware ≥1.8.0). È disponibile un’impostazione rain_sensor che inverte la logica di rilevamento allagamento per l’uso come rilevatore di pioggia all’aperto. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template.

Risoluzione dei problemi

Il sensore non riporta dati

1. Verificare che Shelly Flood sia connesso al Wi-Fi e che MQTT sia abilitato nelle impostazioni del dispositivo
2. Controllare che la variabile personalizzata sensorN_topic corrisponda esattamente al Device ID (es. shellyflood-112233)
3. Se l’indirizzo del broker MQTT è cambiato, provare con il nome host mDNS (shellyflood-AABBCCDDEE.local) per verificare che il sensore sia raggiungibile in rete
4. Usare un client MQTT (es. MQTT Explorer) per iscriversi a shellies/# e verificare che il sensore pubblichi messaggi al risveglio

L’allarme allagamento non si attiva

1. Verificare che i contatti del sensore sul fondo del dispositivo siano puliti e liberi da ostruzioni
2. Testare posizionando il sensore su una superficie bagnata — il dispositivo dovrebbe pubblicare true sul topic /sensor/flood entro pochi secondi
3. Controllare in TapHome lo stato del dispositivo Reed Contact — 1 = allarme, 0 = OK

La batteria si scarica rapidamente

1. Shelly Flood è progettato per una lunga durata della batteria (CR123A, tipicamente 1–2 anni in base alla frequenza di segnalazione)
2. Risvegli frequenti (es. per instabilità Wi-Fi che richiede riconnessioni ripetute) possono scaricare la batteria più velocemente
3. Garantire un segnale Wi-Fi forte nella posizione del sensore

I dispositivi Shelly Gen1 non supportano MQTT over TLS. La comunicazione tra il sensore e il broker MQTT non è cifrata (MQTT plain, porta 1883). Assicurarsi che il broker MQTT si trovi su una rete locale affidabile.