--- title: "Shelly Plus H\u0026T" description: "Shelly Plus H\u0026T elemes érzékelő a TapHome-ban MQTT-n: hőmérséklet, relatív páratartalom, akkumulátorszint és diagnosztika minden ébredéskor." url: "https://taphome.com/hu/compatibility/shelly-plus-ht-mqtt/" language: hu lastmod: 2026-03-30 generator: hugo ai: topics: ["mqtt","sensor","wifi","battery-powered","temperature-humidity"] questions: ["Hogyan integrálható a Shelly Plus H\u0026T a TapHome-mal MQTT-n keresztül?","Mit mér a Shelly Plus H\u0026T TapHome sablon?","Milyen szervizattribútumokat biztosít a Shelly Plus H\u0026T sablon?","Miért nem jelent hőmérsékletet és páratartalmat a Shelly Plus H\u0026T?","Jelenti a Shelly Plus H\u0026T az akkumulátorszintet és feszültséget a TapHome-ban?","Mi a különbség a Shelly Plus H\u0026T és a Shelly H\u0026T Gen3 között?"] --- # Shelly Plus H&T Kommunikáció: Packet Parser → MQTT - [Shelly Plus H&T termékoldal](https://www.shelly.com/en/products/shop/shelly-plus-h-t) > Hálózati cím > > A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató A Shelly Plus H&T (SNSN-0013A) egy elemes (4x AA) Wi-Fi hőmérséklet- és páratartalom-érzékelő e-paper kijelzővel. Ez egy Gen2 (Plus sorozat) eszköz, amelyet már nem gyártanak és a Shelly H&T Gen3 váltotta fel, de még széles körben használják. A TapHome MQTT-n keresztül kommunikál az eszközzel, egyedi `/status/` topicokat használva minden komponenshez. Ez a Gen2 Shelly eszközök szabványos megközelítése — a listener szkript feliratkozik a `/#` topicra és feldolgozza a bejövő állapotüzeneteket, amikor az érzékelő felébred a mély alvásból és adatokat publikál. A sablon egyetlen Hőmérséklet- és páratartalom-érzékelő eszközt hoz létre 9 eszközszintű szervizattribútummal, amelyek lefedik az akkumulátort, hálózatot és csatlakozási diagnosztikát. A Gen3 változattal ellentétben (amely konszolidált `events/rpc` értesítéseket használ), ez a Gen2 sablon egyedi `/status/temperature:0`, `/status/humidity:0`, `/status/devicepower:0` és egyéb komponens-specifikus topicokat dolgoz fel. ## Konfiguráció ### Device ID Minden Shelly Plus H&T egyedi Device ID-vel rendelkezik `shellyplusht-` formátumban, ahol a `` a teljes 12 karakteres MAC-cím nagybetűs hexadecimális formában (pl. `shellyplusht-A8032AB12CD3`). Ez az ID egyben az MQTT topic előtag is. A Device ID megtalálható: - Az eszköz címkéjén (MAC-cím) - A Shelly webes felületen: **Settings** → **Device Info** → **Device ID** - API-n keresztül: `GET http:///rpc/Mqtt.GetConfig` → `client_id` mező ### Sablon beállítása A sablon TapHome-ba importálása után: 1. Nyisd meg a **Shelly Plus H&T MQTT** modult 2. Állítsd be az **MQTT Broker IP**-t az MQTT broker címére 3. Állítsd be a **Port**-ot (alapértelmezett `1883`) 4. Állítsd be a **Device ID** import paramétert az eszköz Device ID-jére (pl. `shellyplusht-A8032AB12CD3`) A modul feliratkozik a `/#` topicra, és a listener szkript feldolgozza az egyedi `/status/` JSON üzeneteket minden komponens topicjáról. > [!TIP] > Győződj meg róla, hogy a Shelly Plus H&T-n engedélyezve van az MQTT és a `status_ntf` (állapotértesítések) `true` értékre van állítva. A sablon az egyedi állapot topicokra támaszkodik (`/status/temperature:0`, `/status/humidity:0` stb.), nem a konszolidált `events/rpc` topicra. ### Mérési és jelentési viselkedés A Shelly Plus H&T az áramforrástól függően eltérően működik: - **Elemes mód** — 1 percenként ébred mérésre. MQTT-n keresztül jelent, ha a hőmérséklet több mint 0,5 °C-kal vagy a páratartalom több mint 5%-kal változik. Feltétel nélküli állapotjelentés 2 óránként kerül küldésre, ha nem volt küszöbérték-alapú jelentés. 5 perces védőidőszak megakadályozza a túlzott ébredéseket. - **USB tápellátás** — 5 percenként ébred mérésre, kijelző frissítésre és feltétel nélküli jelentésre minden ciklusban. Az e-paper kijelző frissül, ha a hőmérséklet több mint 0,2 °C-kal vagy a páratartalom több mint 3%-kal változik. > [!WARNING] > Az eszköz elemről működik és az idő nagy részét mély alvásban tölti. A TapHome nem tudja aktívan lekérdezni az érzékelőt — arra támaszkodik, hogy az eszköz maga küldi az állapotot MQTT-n keresztül ébredéskor. Számíts szünetekre a mérések között, különösen elemes módban. Az USB Type-C tápellátás gyakoribb frissítéseket biztosít, de nem tölti a belső elemeket. ## Eszközképességek ### Hőmérséklet és páratartalom Az érzékelő eszköz egyedi MQTT állapot topicokból olvassa a hőmérsékletet és páratartalmat: - **Hőmérséklet** — környezeti hőmérséklet Celsiusban, a `tC` értékből a `/status/temperature:0` topicon - **Páratartalom** — relatív páratartalom százalékban, az `rh` értékből a `/status/humidity:0` topicon (a readhumidity szkript 100-zal osztja az értéket a TapHome által elvárt 0–1 tartományra való konvertáláshoz) Mindkét érték csak olvasható, és az érzékelő minden felébredésekor és adatpublikálásakor frissül. A hőmérséklet jelentési küszöbérték az eszközön konfigurálható (alapértelmezett 0,5 °C, tartomány 0,5–5,0 °C). A páratartalom küszöbérték alapértelmezetten 5% (tartomány 1–20%). Ezek a küszöbértékek a Shelly webes felületen vagy API-n keresztül módosíthatók a jelentési gyakoriság és az elem élettartam közötti egyensúly érdekében. ### Szervizattribútumok A sablon 9 eszközszintű szervizattribútumot biztosít, amelyek lefedik az akkumulátor állapotát és az eszközdiagnosztikát: **Akkumulátor monitorozás:** - **Battery** — akkumulátor töltöttségi szint százalékban a `battery.percent` értékből a `/status/devicepower:0` topicon - **Battery voltage** — akkumulátor feszültség Voltban a `battery.V` értékből a `/status/devicepower:0` topicon - **External power** — USB Type-C külső tápellátás csatlakoztatva van-e, az `external.present` értékből a `/status/devicepower:0` topicon **Hálózati diagnosztika:** - **WiFi** — csatlakoztatott WiFi hálózat SSID-je a `/status/wifi` topicról - **IP Address** — eszköz IP-címe a `/status/wifi` topicról - **MAC Address** — eszköz MAC-címe a `/status/sys` topicról **Csatlakozási állapot:** - **Cloud connected** — Shelly Cloud csatlakozási állapot a `/status/cloud` topicról - **MQTT connected** — MQTT broker csatlakozási állapot a `/status/mqtt` topicról - **BLE enabled** — Bluetooth Low Energy állapot a `/status/ble` topicról Minden szervizattribútum `"-"` értéket mutat, amíg nem érkeztek adatok (kezdeti állapot a sablon importálása után, az érzékelő első felébredése előtt). ### További képességek A Shelly Plus H&T hőmérsékletet is publikál Fahrenheitben (`tF` mező a `/status/temperature:0` topicon), Wi-Fi jelerősséget (RSSI dBm-ben) és támogatja a HT_UI komponenst az e-paper kijelző hőmérsékleti egységének konfigurálásához (°C/°F). Az eszköz online/offline állapotot is biztosít az MQTT Last Will and Testament (LWT) topicon. Ezek a képességek egy jövőbeli sablon frissítésben adhatók hozzá. ## Hibaelhárítás ### Az érzékelő nem jelent adatokat 1. Ellenőrizd, hogy a Shelly Plus H&T csatlakozik a Wi-Fi-hez és az MQTT engedélyezve van az eszközbeállításokban (**Settings** → **MQTT** → **Enable**) 2. Ellenőrizd, hogy a `status_ntf` `true` értékre van állítva — a sablon egyedi állapotértesítéseket igényel a `/status/` topicon 3. Győződj meg róla, hogy a **Device ID** import paraméter pontosan megegyezik az eszköz Device ID-jével (pl. `shellyplusht-A8032AB12CD3`) 4. Használj MQTT klienst (pl. MQTT Explorer) a `/#` topicra való feliratkozáshoz, és ellenőrizd, hogy az érzékelő állapotüzeneteket publikál felébredéskor 5. Ellenőrizd az eszköz elemszintjét — lemerült elemek megakadályozzák, hogy az érzékelő csatlakozzon a Wi-Fi-hez ### A páratartalom mérés helytelennek tűnik 1. A TapHome sablon 100-zal osztja a nyers páratartalom értéket (pl. `rh: 55.3` lesz `0.553` a TapHome-ban). Ez elvárt viselkedés — a TapHome belsőleg 0–1 tartományt használ 2. Az érzékelő konfigurálható páratartalom offsettel rendelkezik (`Humidity.SetConfig` → `offset`) — ellenőrizd, hogy nincs helytelen értékre állítva 3. Az érzékelő működési páratartalom tartománya 30–70% RH. A tartományon kívüli mérések kevésbé pontosak lehetnek ### Szervizattribútumok "-" értéket mutatnak 1. A szervizattribútumok `"-"` értéket mutatnak, amíg az érzékelő fel nem ébred és adatokat nem publikál a megfelelő állapot topicon 2. Elemről üzemelve az eszköznek akár 2 óráig is tarthat az első feltétel nélküli jelentés küldése — nyomd meg a reset gombot (a hátsó fedél mögött) az azonnali mérés és jelentés indításához 3. Ellenőrizd, hogy az MQTT broker üzeneteket fogad minden elvárt topicon (`/status/sys`, `/status/wifi`, `/status/cloud`, `/status/mqtt`, `/status/ble`) ### Különbségek a Shelly H&T Gen3-hoz képest A Shelly Plus H&T (Gen2) és a Shelly H&T Gen3 hasonló érzékelő képességekkel rendelkezik, de különbözik az MQTT kommunikációban: - **Gen2 (Plus H&T)** egyedi `/status/` topicokat használ komponensenként — `status_ntf: true` szükséges - **Gen3 (H&T Gen3)** konszolidált `events/rpc` topicot használ `NotifyStatus` JSON-RPC eseményekkel — `rpc_ntf: true` szükséges - A Gen3 sablon időbélyeg-alapú offline érzékelést is tartalmaz (>12 óra figyelmeztetés, >24 óra hiba), amelyet a Gen2 sablon nem valósít meg ## 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 A beépített TapHome broker esetén a `` a TapHome Core IP-címe. Adjon a Core-nak IP-foglalást a routerben, különben az eszköz elveszíti a brokert, amikor a router megváltoztatja a címet → [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/). > [!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:** a beépített TapHome brokerhez `127.0.0.1` (a vezérlőegység saját magához csatlakozik, a cím soha nem változik); külső broker esetén annak IP-címe (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 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Shelly Plus H&T MQTT Modul Egyéni változók `deviceId` (string) MQTT eszközazonosító topic előtagként — formátum: shellyplusht-{MACADDRESS} (Shelly webes felület → Settings → Device Info) Open http://shellyIpAddress → Settings → Device info → copy Device ID (e.g. shellyplusht-A8032AB12CD3) Hőmérséklet- és páratartalom-érzékelő Hőmérséklet-érzékelő Csak olvasható Környezeti hőmérséklet (°C) és relatív páratartalom egyedi /status/ MQTT topicokból — páratartalom 0–1 tartományra konvertálva a TapHome számára json Egység: °C / %RH json\_path Szerviz attribútumok | | | |------------------------|----------------------------------------------------------------------------------------------------| | Akkumulátor | Akkumulátor töltöttségi szint — '-' értéket mutat az érzékelő első felébredéséig | | Akkumulátor feszültség | Akkumulátor feszültség Voltban — hasznos az akkumulátor degradációjának időbeli nyomon követéséhez | | Külső tápellátás | USB Type-C külső tápellátás csatlakoztatva van-e (true/false) | | WiFi | Csatlakoztatott WiFi hálózat SSID-je | | IP-cím | | | MAC-cím | | | Felhő csatlakoztatva | Shelly Cloud csatlakozási állapot (true/false) | | MQTT csatlakoztatva | MQTT broker csatlakozási állapot (true/false) | | BLE engedélyezve | Bluetooth Low Energy állapot (true/false) | Páratartalom olvasása ```taphome Hu := listenHum / 100.0; ``` Figyelő ```taphome IF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/temperature:0") >= 0) Te := PARSEJSON(RECEIVEDMSG.PAYLOAD,"tC", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/humidity:0") >= 0) listenHum := PARSEJSON(RECEIVEDMSG.PAYLOAD,"rh", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/devicepower:0") >= 0) batteryPerc := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery.percent", true); batteryV := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery.V", true); externalPower := PARSEJSON(RECEIVEDMSG.PAYLOAD,"external.present", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/sys") >= 0) macAddress := PARSEJSON(RECEIVEDMSG.PAYLOAD,"mac", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/wifi") >= 0) ipaddress := PARSEJSON(RECEIVEDMSG.PAYLOAD,"sta_ip", true); wifi := PARSEJSON(RECEIVEDMSG.PAYLOAD,"ssid", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/cloud") >= 0) cloudConnected := PARSEJSON(RECEIVEDMSG.PAYLOAD,"connected", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/mqtt") >= 0) mqttConnected := PARSEJSON(RECEIVEDMSG.PAYLOAD,"connected", true); ELSEIF (INDEXOF(RECEIVEDMSG.TOPIC, deviceid +"/status/ble") >= 0) BLEenabled := PARSEJSON(RECEIVEDMSG.PAYLOAD,"enable", true); END ``` Szerviz attribútumok Battery ```taphome IF (ISNAN(batteryPerc), "-", batteryPerc + "%"); ``` Battery voltage ```taphome IF (ISNAN(batteryV), "-", batteryV + "V"); ``` External power ```taphome IF (LENGTH(externalPower) = 0, "-", externalPower); ``` WiFi ```taphome IF (LENGTH(wifi) = 0, "-", wifi); ``` IP Address ```taphome IF (LENGTH(ipaddress) = 0, "-", ipaddress); ``` MAC Address ```taphome IF (LENGTH(macAddress) = 0, "-", macAddress); ``` Cloud connected ```taphome IF (LENGTH(cloudConnected) = 0, "-", cloudConnected); ``` MQTT connected ```taphome IF (LENGTH(mqttConnected) = 0, "-", mqttConnected); ``` BLE enabled ```taphome IF (LENGTH(BLEenabled) = 0, "-", BLEenabled); ``` **Kapcsolat:** Packet Parser → MQTT • Hostname: `shellyplusht-{MAC}.local` Lehetséges fejlesztések (5) - RPC Event Notifications — Gen3 templates use consolidated events/rpc topic with NotifyFullStatus. This Gen2 template uses individual /status/ topics instead — functionally equivalent. - Connection Status (LWT) — Last Will and Testament topic — true on connect, false on disconnect. Not used by template. - Temperature in Fahrenheit — Temperature also available in Fahrenheit (tF field in /status/temperature:0). Template uses tC only. - E-Paper Display Configuration — Temperature unit (C/F) display setting — display-only configuration, not sensor data. - WiFi Signal Strength (RSSI) — WiFi signal strength in dBm. Template reads only SSID and IP, not RSSI. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |--------------------|-----------------------------| | Mqtt Broker IP-cím | `192.168.0.1` | | Mqtt Broker port | `1883` | | Device ID | `shellyplusht-yourDeviceId` | ## Források - Shelly Gen2+/Gen3 RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27 - Shelly Gen2+ System (Sys) Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27 - Shelly Gen2+ MQTT Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27 - Shelly Plus H&T Device API (Temperature, Humidity, DevicePower, HT\_UI) [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/0.14/Devices/ShellyPlusHT/) 2026-03-30 - Shelly Plus H&T Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-h-t) 2026-03-30 ## 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/)