A Shelly Flood egy akkumulátoros (CR123A) Wi-Fi vízszivárgás-érzékelő. A TapHome MQTT-n keresztül kommunikál az eszközzel — ez az ajánlott protokoll akkumulátoros Shelly eszközökhöz, mivel az érzékelő az idő nagy részében alszik, és csak ébredési eseményekkor küld adatokat.

A sablon modulonként legfeljebb 5 Shelly Flood érzékelőt támogat. Minden érzékelőpéldányt egy sensorN_topic egyéni változó azonosít, amely az eszköz MQTT Client ID-jára mutat.

Konfiguráció

Eszköz-azonosító

Minden Shelly Flood egyedi MQTT Device ID-val rendelkezik shellyflood-<MAC6> formátumban, ahol a <MAC6> a MAC-cím utolsó 6 karaktere kisbetűs hexadecimálisan (pl. shellyflood-112233).

A Device ID megtalálható:

• Az eszköz címkéjén (MAC-cím)
• A Shelly webes felületén: Settings → Device Info
• API-n keresztül: GET http://<device-ip>/settings → mqtt.id mező

Ez az eszköz támogatja az mDNS-felderítést. A TapHome konfigurálásakor IP-cím helyett a shellyflood-{MAC}.local hostnév is használható. A {MAC} részt az eszköz MAC-címének utolsó 6 karakterével kell helyettesíteni kisbetűs hexadecimálisan (pl. shellyflood-112233.local). A hostnév használata megelőzi a csatlakozási problémákat, ha az eszköz IP-címe megváltozik.

Sablon beállítása

A sablon TapHome-ba importálása után:

1. Nyissa meg a Shelly Flood MQTT modult
2. Adja meg az MQTT Broker IP és a Port értékét (alapértelmezett: 1883)
3. Minden érzékelőpéldánynál állítsa be a sensorN_topic egyéni változót a megfelelő Shelly Flood Device ID-jára (pl. shellyflood-112233)

A modul feliratkozik a shellies/# topicra, a figyelő szkriptek pedig a beállított topic-előtag alapján szűrik az üzeneteket.

Csak a ténylegesen használt érzékelőhelyeket konfigurálja. A nem konfigurált helyek (az alapértelmezett shellyflood-deviceid értékkel) hibaüzenetet jelenítenek meg, amely a helyes topic megadására kéri.

Eszközfunkciók

Vízszivárgás-érzékelés

Minden érzékelőpéldány Reed-kontaktus eszközként jelenik meg a TapHome-ban. Az áradási állapot a shellies/<id>/sensor/flood topicból olvasható:

• true → Riasztás (víz észlelve)
• false → OK (száraz)

Az érzékelő felébred és közzéteszi állapotát, amikor vizet észlel vagy a víz eltűnik, valamint az időszakos jelentési intervallumok során is.

Akkumulátor és hőmérséklet figyelése

Minden érzékelőpéldány két szolgáltatási attribútumot tesz elérhetővé:

• Akkumulátor — akkumulátor töltöttségi szint százalékban, a shellies/<id>/sensor/battery topicból olvasva. Alacsony akkumulátor-figyelmeztetés aktiválódik, ha a szint 20% alá csökken.
• Hőmérséklet — környezeti hőmérséklet °C-ban, a shellies/<id>/sensor/temperature topicból olvasva.

Mindkét attribútum csak olvasható, és frissül, amikor az érzékelő felébred és adatokat küld.

További funkciók

A Shelly Flood online/offline állapotot is közzétesz az MQTT Last Will and Testament (LWT) topicon, valamint egy teljes JSON állapotüzenetet (firmware ≥ 1.8.0). Elérhető egy rain_sensor beállítás, amely megfordítja az áradásérzékelési logikát a kültéri esőérzékelési célokra. Ezek a funkciók egy jövőbeli sablon-frissítésben adhatók hozzá.

Hibaelhárítás

Az érzékelő nem jelent adatokat

1. Ellenőrizze, hogy a Shelly Flood Wi-Fi-hez csatlakozik-e, és az MQTT engedélyezve van-e az eszközbeállításokban
2. Győződjön meg arról, hogy a sensorN_topic egyéni változó pontosan megegyezik a Device ID-val (pl. shellyflood-112233)
3. Ha az MQTT broker címe megváltozott, használja az mDNS hostnevet (shellyflood-AABBCCDDEE.local) annak ellenőrzésére, hogy az érzékelő elérhető-e a hálózaton
4. MQTT klienssel (pl. MQTT Explorer) iratkozzon fel a shellies/# topicra, és ellenőrizze, hogy az érzékelő küld-e üzeneteket ébredéskor

Az áradási riasztás nem aktiválódik

1. Ellenőrizze, hogy az eszköz alján lévő érzékelőkontaktusok tiszták és nem takartak-e el
2. Tesztelje úgy, hogy az érzékelőt nedves felületre helyezi — az eszköznek másodperceken belül true értéket kell küldenie a /sensor/flood topicra
3. Ellenőrizze a TapHome-ban a Reed-kontaktus eszköz állapotát — 1 = riasztás, 0 = OK

Az akkumulátor gyorsan lemerül

1. A Shelly Flood hosszú akkumulátor-élettartamra van tervezve (CR123A, jellemzően 1–2 év a jelentési gyakoriságtól függően)
2. A gyakori ébredések (pl. instabil Wi-Fi miatti ismételt újracsatlakozások) gyorsabban meríthetik az akkumulátort
3. Biztosítson erős Wi-Fi jelet az érzékelő elhelyezési helyén

A Gen1 Shelly eszközök nem támogatják az MQTT over TLS protokollt. Az érzékelő és az MQTT broker közötti kommunikáció titkosítatlan (plain MQTT, 1883-as port). Győződjön meg arról, hogy az MQTT broker megbízható helyi hálózaton üzemel.