--- title: "Shelly H\u0026T" description: "Hőmérséklet és páratartalom olvasása a Shelly H\u0026T Gen1 érzékelőről MQTT-n keresztül. Elemes Wi-Fi érzékelő opcionális USB tápellátással." url: "https://taphome.com/hu/compatibility/shelly-hm/" language: hu lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","sensor","wifi","battery-powered","temperature","humidity"] questions: ["Hogyan integrálható a Shelly H\u0026T a TapHome-mal MQTT-n keresztül?","Mit mér a Shelly H\u0026T TapHome sablon?","Hogyan találod meg a Shelly H\u0026T MQTT Device ID-t?","Miért nem küld adatokat a Shelly H\u0026T a TapHome-ban?","Tud a Shelly H\u0026T folyamatosan mérni akkumulátor alvás nélkül?","Hogyan kezeli a TapHome a Shelly H\u0026T páratartalom-érték konvertálását?"] --- # Shelly H&T Kommunikáció: Packet Parser → MQTT - [Shelly H&T termékoldal](https://www.shelly.com/en/products/shop/shelly-humidity-temperature) > 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 H&T egy elemes (CR123A) Wi-Fi hőmérséklet- és páratartalom-érzékelő a Shelly Gen1 termékcsaládból. A TapHome MQTT-n keresztül kommunikál az eszközzel — ez az ajánlott protokoll az elemes Shelly érzékelőkhöz, mivel az eszköz a mérések között alszik, és csak ébredéskor küld adatokat. A sablon egyetlen Hőmérséklet-érzékelő eszközt hoz létre Páratartalom szervizattribútummal, amely egyetlen Shelly H&T egységből követi a környezeti hőmérsékletet és a relatív páratartalmat. ## Konfiguráció ### Device ID A Shelly H&T MQTT Device ID-t használ `shellyht-` formátumban, ahol a `` a MAC-cím utolsó 6 karaktere kisbetűs hexadecimális formában (pl. `shellyht-112233`). A Device ID megtalálható: - Az eszköz címkéjén (MAC-cím) - A Shelly webes felületen: **Settings** → **Device Info** - API-n keresztül: `GET http:///settings` → `mqtt.id` mező ### Sablon beállítása A sablon importálása után a TapHome-ban: 1. Nyisd meg a **Shelly H&T MQTT** modult 2. Állítsd be az **MQTT Broker IP**-t és a **Port**-ot (alapértelmezett `1883`) 3. Állítsd be a `deviceId` változót csak a Device ID hex részére (pl. `112233` a `shellyht-112233` esetén — a MAC-cím utolsó 6 hex karaktere) A modul feliratkozik a `shellies/#` topicra, és a listener szkript a beállított Device ID alapján szűri az üzeneteket. > [!WARNING] > A Shelly Gen1 eszközökön az MQTT engedélyezése letiltja a Shelly Cloudot — a kettő nem működhet egyszerre. Az MQTT-t a Shelly webes felületen engedélyezd az **Internet & Security** → **Advanced - Developer Settings** menüpontban. > [!TIP] > Az alapértelmezett alvási periódus 60 másodperc. Gyakoribb frissítésekhez opcionális USB adapter áll rendelkezésre — külső tápellátás esetén az alvó mód kikapcsol, és az érzékelő folyamatosan mér. ## Eszközfunkciók ### Hőmérséklet- és páratartalom-monitorozás A sablon egyetlen **Hőmérséklet-érzékelő** eszközt biztosít, amely a környezeti hőmérsékletet olvassa a `shellies/shellyht-{deviceId}/sensor/temperature` MQTT topicról. Az értékek lebegőpontos számként, Celsius-fokban kerülnek közzétételre. A **Páratartalom** szervizattribútum a relatív páratartalmat olvassa a `shellies/shellyht-{deviceId}/sensor/humidity` topicról. Az MQTT payload 0–100 % tartományban kerül közzétételre, de a sablon belsőleg 0–1 tartományra konvertálja (pl. az MQTT `45.2` érték a TapHome-ban `0.452`-ként tárolódik). Mindkét mérés az érzékelő alvó módból való ébredésekor frissül — alapértelmezetten 60 másodpercenként, vagy folyamatosan USB tápellátás esetén. ### További funkciók A Shelly H&T az akkumulátor töltöttségi szintjét (0–100 %, CR123A), online/offline állapotot az MQTT Last Will and Testament révén, valamint egy eszközbejelentő üzenetet is közzétesz modellel, MAC-címmel, IP-vel és firmware-verzióval (firmware >=1.6.0). Ezek a funkciók egy jövőbeli sablonfrissítésben adhatók hozzá. ## Hibaelhárítás ### Az érzékelő nem küld adatokat 1. Ellenőrizd, hogy a Shelly H&T csatlakozik a Wi-Fi-hez, és az MQTT engedélyezve van az eszköz beállításaiban (**Internet & Security** → **Advanced - Developer Settings**) 2. Ellenőrizd, hogy az MQTT broker címe és portja helyes mind a Shelly webes felületen, mind a TapHome modul beállításaiban 3. Győződj meg róla, hogy a `deviceId` változó pontosan megegyezik a Device ID-vel (a MAC utolsó 6 hex karaktere, pl. `112233`) 4. Használj MQTT klienst (pl. MQTT Explorer), iratkozz fel a `shellies/#` topicra, és ellenőrizd, hogy az érzékelő ébredéskor üzeneteket tesz közzé a `shellies/shellyht-/` alatt ### A páratartalom értéke helytelennek tűnik A sablon az MQTT páratartalom-értéket elosztja 100-zal — a 45,2 %-os páratartalom a TapHome-ban 0,452-ként tárolódik. Ez elvárt működés, mivel a TapHome 0–1 tartományt használ a páratartalom-értékekhez. A TapHome felület az értéket helyesen, százalékban jeleníti meg. ### Az akkumulátor gyorsan merül 1. A Shelly H&T akár 18 hónapos akkumulátor-élettartamra tervezett az alapértelmezett 60 másodperces alvási periódussal 2. A gyakori Wi-Fi újracsatlakozások (gyenge jel, csatornaváltás) jelentősen növelik az energiafogyasztást 3. Biztosíts erős Wi-Fi jelet az érzékelő helyén — az eszköz belső térben kb. 30 m hatótávolsággal rendelkezik > [!WARNING] > A Shelly Gen1 eszközök **nem támogatják** az MQTT-t TLS-en keresztül. Az érzékelő és az MQTT broker közötti kommunikáció titkosítatlan (plain MQTT, 1883-as port). Győződj meg róla, hogy az MQTT broker megbízható helyi hálózaton van. ## 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 H&T MQTT Modul Egyéni változók | | | |---------------------|--------------------------------------------------------------------------------| | `deviceId` (string) | A Shelly H&T MQTT Device ID-je — a MAC-cím utolsó 6 hex karaktere (pl. 112233) | Hőmérséklet-érzékelő Hőmérséklet-érzékelő Csak olvasható Környezeti hőmérséklet és páratartalom — °C olvasása MQTT-ről, páratartalom 0–100%-ról 0–1 tartományra konvertálva float Egység: °C Páratartalom olvasása ```taphome # Simple HTTP Request: # VAR response := SENDHTTPREQUEST("/example/getValue"); # IF response.IsSuccess # VAR content := response.Content; # VAR responseHeaders := response.Headers; # RETURN(PARSEXML(content, "//element1/value1")); # ELSE # ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")"); # RETURN(NaN); # END Hu := listenHum; # Set Http request method, body and headers # VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...); # OR # VAR request := HTTPREQUEST("/example/getValue", "POST", "some data"); # request.headers := { "header1:value1", "header2:value2", ...}; # request.method := "GET"; # request.data := null; # VAR response := SENDHTTPREQUEST(request); # # # Send TCP, UDP data: # VAR data1 := BYTECOLLECTION("0a bb ea df 01"); # SENDDATA(data1); # VAR data2 := "{\"name\":\"John\", \"age\":32}"; # SENDDATA(data2); # VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1"); # SENDDATA(data3); # Process received TCP or UDP data and set device values in the Listener script # # # Download data from FTP: # FTPDOWNLOAD("filePath"); ``` Hőmérséklet olvasása ```taphome # Simple HTTP Request: # VAR response := SENDHTTPREQUEST("/example/getValue"); # IF response.IsSuccess # VAR content := response.Content; # VAR responseHeaders := response.Headers; # RETURN(PARSEXML(content, "//element1/value1")); # ELSE # ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")"); # RETURN(NaN); # END te := listenTemp; # Set Http request method, body and headers # VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...); # OR # VAR request := HTTPREQUEST("/example/getValue", "POST", "some data"); # request.headers := { "header1:value1", "header2:value2", ...}; # request.method := "GET"; # request.data := null; # VAR response := SENDHTTPREQUEST(request); # # # Send TCP, UDP data: # VAR data1 := BYTECOLLECTION("0a bb ea df 01"); # SENDDATA(data1); # VAR data2 := "{\"name\":\"John\", \"age\":32}"; # SENDDATA(data2); # VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1"); # SENDDATA(data3); # Process received TCP or UDP data and set device values in the Listener script # # # Download data from FTP: # FTPDOWNLOAD("filePath"); ``` Figyelő ```taphome # Parse received bytes: IF(RECEIVEDMSG.TOPIC = "shellies/shellyht-"+ deviceId +"/sensor/temperature") listenTemp := todouble(TOSTRING(RECEIVEDMSG.PAYLOAD)); END IF(RECEIVEDMSG.TOPIC = "shellies/shellyht-"+ deviceId +"/sensor/humidity") listenHum := todouble(TOSTRING(RECEIVEDMSG.PAYLOAD))/100; END ``` **Kapcsolat:** Packet Parser → MQTT • Hostname: `shellyht-{MAC}.local` Lehetséges fejlesztések (3) - Battery Level — Battery percentage (0–100%, CR123A). Available via MQTT but not parsed in template listener script. - Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline sensor. - Device Announcement — JSON payload with device model, MAC, IP, firmware version. Published on connect (FW ≥1.6.0). ## 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 | `yourDeviceId` | ## Források - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12 - Shelly H&T — Device-Specific API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-h-amp-t) 2026-03-31 - Shelly H&T — Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-h-t) 2026-03-31 ## 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/)