--- title: "Shelly Flood" description: "Shelly Flood akkumulátoros vízszivárgás-érzékelő MQTT-n keresztül csatlakoztatva a TapHome-hoz." url: "https://taphome.com/hu/compatibility/shelly-flood-mqtt/" language: hu lastmod: 2026-03-16 generator: hugo ai: topics: ["mqtt","sensor","wifi","water-leak-detection","battery-powered"] questions: ["Hogyan integrálhatod a Shelly Floodot a TapHome rendszerbe MQTT-n keresztül?","Mit érzékel a Shelly Flood TapHome-sablon?","Hogyan konfigurálhatod több Shelly Flood érzékelőt egy TapHome-sablonban?","Miért nem küld adatot a Shelly Flood érzékelőm?","Hogyan találhatod meg a Shelly Flood MQTT eszközazonosítóját?","Jelenti-e a Shelly Flood az akkumulátorszintet és a hőmérsékletet a TapHome rendszerben?"] --- # Shelly Flood Kommunikáció: Packet Parser → MQTT - [Shelly Flood termékoldal](https://www.shelly.com/en/products/shop/shelly-flood) 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-` formátumban, ahol a `` 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:///settings` → `mqtt.id` mező > [!TIP] > 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. > [!TIP] > 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//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//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//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 > [!WARNING] > 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. ## Telepítés a TapHome-ban ### Előfeltételek - Shelly eszköz csatlakoztatva a Wi-Fi-hez (2,4 GHz), pl. a Shelly alkalmazással vagy az eszköz saját hozzáférési pontján keresztül - MQTT broker fut a helyi hálózaton (pl. Mosquitto, Home Assistant vagy a TapHome beépített brokere) - TapHome CCU ugyanazon a hálózaton, mint a broker > [!WARNING] > A **Gen1** eszközökön az MQTT engedélyezése **letiltja a Shelly Cloudot**. A kettő nem futhat egyszerre. A Gen2/Plus eszközökön ez a korlátozás nem érvényes. ### 1. lépés — MQTT engedélyezése a Shelly eszközön #### Gen1 eszközök (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…) 1. Nyissa meg a Shelly webes felületet: `http:///` 2. Navigáljon az **Internet & Security** → **Advanced — MQTT** menüpontra 3. Engedélyezze az **MQTT**-t 4. Állítsa be az **MQTT Server**-t: `:` (pl. `192.168.1.10:1883`) 5. Opcionálisan állítsa be az **MQTT User** és **MQTT Password** mezőket, ha a broker hitelesítést igényel 6. Kattintson a **Save** gombra — az eszköz újraindul és csatlakozik a brokerhez #### Gen2 / Plus eszközök (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…) 1. Nyissa meg a Shelly webes felületet: `http:///` 2. Navigáljon a **Settings** → **MQTT** menüpontra 3. Engedélyezze az **MQTT**-t 4. Állítsa be a **Server**-t: `:` (pl. `192.168.1.10:1883`) 5. A **Client ID** előre ki van töltve az eszköz azonosítójával (pl. `shellyplus1pm-AABBCCDDEE`) — hagyja így, hacsak nincs konkrét oka a változtatásra 6. Kattintson a **Save** gombra és indítsa újra az eszközt > [!TIP] > Az MQTT működésének ellenőrzéséhez használjon egy MQTT klienst (pl. MQTT Explorer), és iratkozzon fel a `shellies/#` (Gen1) vagy `/#` (Gen2) topikra. Látnia kell az eszköz állapotüzeneteit. ### 2. lépés — Device ID / MQTT Client ID megkeresése Egyes sablonok **Device ID** vagy **MQTT Client ID** paramétert igényelnek. Ez az egyedi azonosító, amelyet az MQTT topikokban használnak. - **Gen1:** a címkén MAC-címként található (pl. `AABBCCDDEE`). Device ID = `shelly-`, pl. `shelly1pm-AABBCCDDEE` - **Gen2/Plus:** a Shelly webes felületén a **Settings** → **Device Info** → **Device ID** alatt található, vagy az eszköz címkéjén ### 3. lépés — Konfigurálás a TapHome-ban 1. A TapHome-ban adjon hozzá egy új **Packet Parser (MQTT)** modult 2. **IP Address:** adja meg az MQTT broker IP-címét (pl. `192.168.1.10`) 3. **Port:** `1883` (alapértelmezett; TLS esetén használjon `8883`-at) 4. **Device ID / MQTT Client ID:** adja meg a 2. lépésben kapott értéket (ha a sablon megköveteli) 5. Importálja a sablont — a TapHome automatikusan feliratkozik az eszköz topikjaira ## Elérhető eszközök Shelly Flood MQTT Modul Egyéni változók | | | |-------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | `sensor1_topic` (string) = shellyflood-deviceid | Az 1. vízszivárgás érzékelő MQTT topic neve — formátum: 'shellyflood-DEVICEID' (Device ID a Shelly web UI → Settings → Device Info) | | `sensor2_topic` (string) = shellyflood-deviceid | A 2. vízszivárgás érzékelő MQTT topic neve | | `sensor3_topic` (string) = shellyflood-deviceid | A 3. vízszivárgás érzékelő MQTT topic neve | | `sensor4_topic` (string) = shellyflood-deviceid | A 4. vízszivárgás érzékelő MQTT topic neve | | `sensor5_topic` (string) = shellyflood-deviceid | Az 5. vízszivárgás érzékelő MQTT topic neve | Vízszivárgás érzékelő 1 Reed kontaktus Csak olvasható Vízszivárgás érzékelés — riasztást jelez víz jelenlétében, OK száraz állapotban boolean Szerviz attribútumok | | |-------------| | Akkumulátor | | Hőmérséklet | Vízszivárgás érzékelő 2 Reed kontaktus Csak olvasható Vízszivárgás érzékelés — riasztást jelez víz jelenlétében, OK száraz állapotban boolean Szerviz attribútumok | | |-------------| | Akkumulátor | | Hőmérséklet | Vízszivárgás érzékelő 3 Reed kontaktus Csak olvasható Vízszivárgás érzékelés — riasztást jelez víz jelenlétében, OK száraz állapotban boolean Szerviz attribútumok | | |-------------| | Akkumulátor | | Hőmérséklet | Vízszivárgás érzékelő 4 Reed kontaktus Csak olvasható Vízszivárgás érzékelés — riasztást jelez víz jelenlétében, OK száraz állapotban boolean Szerviz attribútumok | | |-------------| | Akkumulátor | | Hőmérséklet | Vízszivárgás érzékelő 5 Reed kontaktus Csak olvasható Vízszivárgás érzékelés — riasztást jelez víz jelenlétében, OK száraz állapotban boolean Szerviz attribútumok | | |-------------| | Akkumulátor | | Hőmérséklet | **Kapcsolat:** Packet Parser → MQTT • Hostname: `shellyflood-{MAC}.local` Lehetséges fejlesztések (2) - Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline sensors. - Full Status JSON — Complete /status as JSON (fw ≥1.8.0). Could parse wifi\_sta.rssi, battery, act\_reasons. ## Források - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Shelly Flood — Device-Specific API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-flood-mqtt) 2026-03-12 ## Kapcsolódó dokumentáció - [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/) - [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/) - [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)