--- title: "Shelly H\u0026T" description: "Čítanie teploty a vlhkosti zo senzora Shelly H\u0026T Gen1 cez MQTT. Batériový Wi-Fi senzor s voliteľným USB napájaním pre kontinuálne meranie." url: "https://taphome.com/sk/compatibility/shelly-hm/" language: sk lastmod: 2026-10-08 generator: hugo ai: topics: ["mqtt","sensor","wifi","battery-powered","temperature","humidity"] questions: ["Ako integrovať Shelly H\u0026T s TapHome cez MQTT?","Čo meria šablóna Shelly H\u0026T v TapHome?","Ako nájsť MQTT Device ID pre Shelly H\u0026T?","Prečo môj Shelly H\u0026T nehlási údaje v TapHome?","Môže Shelly H\u0026T merať kontinuálne bez uspávania batérie?","Ako TapHome spracováva konverziu hodnoty vlhkosti Shelly H\u0026T?"] --- # Shelly H&T Komunikácia: Packet Parser → MQTT - [Produktová stránka Shelly H&T](https://www.shelly.com/en/products/shop/shelly-humidity-temperature) > Adresa v sieti > > Pri MQTT brokeri vstavanom v TapHome zadajte v TapHome ako adresu brokera `127.0.0.1`. V zariadení zadajte IP adresu TapHome Core a jednotke Core dajte rezerváciu IP v routeri. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu Shelly H&T je batériový (CR123A) Wi-Fi senzor teploty a vlhkosti z produktovej línie Shelly Gen1. TapHome komunikuje so zariadením cez MQTT — odporúčaný protokol pre batériové Shelly senzory, keďže zariadenie medzi meraniami spí a dáta posiela len pri zobudení. Šablóna vytvorí jedno zariadenie Teplotný senzor so servisným atribútom Vlhkosť, ktoré sleduje teplotu okolia aj relatívnu vlhkosť z jednej jednotky Shelly H&T. ## Konfigurácia ### Device ID Shelly H&T používa MQTT Device ID vo formáte `shellyht-`, kde `` je posledných 6 znakov MAC adresy v hexadecimálnom tvare malými písmenami (napr. `shellyht-112233`). Device ID nájdete: - Na štítku zariadenia (MAC adresa) - Vo webovom rozhraní Shelly: **Settings** → **Device Info** - Cez API: `GET http:///settings` → pole `mqtt.id` ### Nastavenie šablóny Po importe šablóny v TapHome: 1. Otvorte modul **Shelly H&T MQTT** 2. Nastavte **MQTT Broker IP** a **Port** (predvolene `1883`) 3. Nastavte premennú `deviceId` len na hex časť Device ID (napr. `112233` pre `shellyht-112233` — posledných 6 hex znakov MAC adresy) Modul sa prihlási na odber `shellies/#` a listener skript filtruje správy podľa nakonfigurovaného Device ID. > [!WARNING] > Na zariadeniach Shelly Gen1 zapnutie MQTT vypne Shelly Cloud — oba nemôžu fungovať súčasne. MQTT zapnete vo webovom rozhraní Shelly v časti **Internet & Security** → **Advanced - Developer Settings**. > [!TIP] > Predvolená doba spánku je 60 sekúnd. Pre častejšie aktualizácie je k dispozícii voliteľný USB adaptér — pri externom napájaní sa režim spánku vypne a senzor meria kontinuálne. ## Možnosti zariadenia ### Monitorovanie teploty a vlhkosti Šablóna poskytuje jedno zariadenie **Teplotný senzor**, ktoré číta teplotu okolia z MQTT topicu `shellies/shellyht-{deviceId}/sensor/temperature`. Hodnoty sa publikujú ako desatinné číslo v stupňoch Celzia. Servisný atribút **Vlhkosť** číta relatívnu vlhkosť z `shellies/shellyht-{deviceId}/sensor/humidity`. MQTT payload sa publikuje v rozsahu 0–100 %, ale šablóna ho interne konvertuje na rozsah 0–1 (napr. MQTT hodnota `45.2` sa v TapHome uloží ako `0.452`). Obe merania sa aktualizujú pri každom zobudení senzora z režimu spánku — predvolene každých 60 sekúnd, alebo kontinuálne pri USB napájaní. ### Ďalšie možnosti Shelly H&T tiež publikuje úroveň batérie (0–100 %, CR123A), stav online/offline cez MQTT Last Will and Testament a správu o oznámení zariadenia s modelom, MAC, IP a verziou firmvéru (firmvér >=1.6.0). Tieto možnosti môžu byť pridané v budúcej aktualizácii šablóny. ## Riešenie problémov ### Senzor nehlási údaje 1. Overte, že Shelly H&T je pripojený k Wi-Fi a MQTT je zapnutý v nastaveniach zariadenia (**Internet & Security** → **Advanced - Developer Settings**) 2. Skontrolujte, či je adresa a port MQTT brokera správne nastavený vo webovom rozhraní Shelly aj v nastaveniach modulu TapHome 3. Potvrďte, že premenná `deviceId` presne zodpovedá Device ID (posledných 6 hex znakov MAC, napr. `112233`) 4. Použite MQTT klienta (napr. MQTT Explorer) na odber `shellies/#` a overte, že senzor publikuje správy pod `shellies/shellyht-/` pri zobudení ### Hodnota vlhkosti sa zdá nesprávna Šablóna delí hodnotu vlhkosti z MQTT stom — vlhkosť 45,2 % sa v TapHome uloží ako 0,452. Toto je očakávané správanie, keďže TapHome používa rozsah 0–1 pre hodnoty vlhkosti. Rozhranie TapHome zobrazí hodnotu správne ako percentá. ### Batéria sa rýchlo vybíja 1. Shelly H&T je navrhnutý na výdrž batérie až 18 mesiacov pri predvolenej 60-sekundovej dobe spánku 2. Časté opätovné pripájanie k Wi-Fi (slabý signál, zmena kanálov) výrazne zvyšuje spotrebu energie 3. Zabezpečte silný Wi-Fi signál na mieste senzora — zariadenie má približne 30 m dosah v interiéri > [!WARNING] > Zariadenia Shelly Gen1 **nepodporujú** MQTT cez TLS. Komunikácia medzi senzorom a MQTT brokerom nie je šifrovaná (plain MQTT, port 1883). Zabezpečte, aby bol MQTT broker v dôveryhodnej lokálnej sieti. ## Ako nainštalovať v TapHome ### Predpoklady - Zariadenie Shelly pripojené k Wi-Fi (2,4 GHz), napr. cez aplikáciu Shelly alebo vlastný prístupový bod zariadenia - MQTT broker bežiaci vo vašej lokálnej sieti (napr. Mosquitto, Home Assistant alebo vstavaný broker TapHome) - TapHome CCU v rovnakej sieti ako broker > [!WARNING] > Na zariadeniach **Gen1** povolenie MQTT **vypne Shelly Cloud**. Oboje nemôže bežať súčasne. Na zariadeniach Gen2/Plus toto obmedzenie neplatí. ### Krok 1 — Povoľte MQTT na zariadení Shelly #### Zariadenia Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…) 1. Otvorte webové rozhranie Shelly: `http:///` 2. Prejdite na **Internet & Security** → **Advanced — MQTT** 3. Povoľte **MQTT** 4. Nastavte **MQTT Server**: `:` (napr. `192.168.1.10:1883`) 5. Voliteľne nastavte **MQTT User** a **MQTT Password**, ak váš broker vyžaduje autentifikáciu 6. Kliknite na **Save** — zariadenie sa reštartuje a pripojí k brokeru #### Zariadenia Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…) 1. Otvorte webové rozhranie Shelly: `http:///` 2. Prejdite na **Settings** → **MQTT** 3. Povoľte **MQTT** 4. Nastavte **Server**: `:` (napr. `192.168.1.10:1883`) 5. **Client ID** je predvyplnené ID zariadenia (napr. `shellyplus1pm-AABBCCDDEE`) — ponechajte tak, pokiaľ nemáte konkrétny dôvod na zmenu 6. Kliknite na **Save** a reštartujte zariadenie Pri vstavanom brokeri TapHome je `` IP adresa TapHome Core. Dajte jednotke Core rezerváciu IP v routeri, inak zariadenie stratí broker, keď router adresu zmení → [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/). > [!TIP] > Na overenie funkčnosti MQTT použite MQTT klienta (napr. MQTT Explorer) a prihláste sa na odber `shellies/#` (Gen1) alebo `/#` (Gen2). Mali by ste vidieť stavové správy zo zariadenia. ### Krok 2 — Zistite Device ID / MQTT Client ID Niektoré šablóny vyžadujú parameter **Device ID** alebo **MQTT Client ID**. Ide o jedinečný identifikátor používaný v MQTT topicoch. - **Gen1:** nachádza sa na štítku ako MAC adresa (napr. `AABBCCDDEE`). Device ID = `shelly-`, napr. `shelly1pm-AABBCCDDEE` - **Gen2/Plus:** nachádza sa vo webovom rozhraní Shelly v časti **Settings** → **Device Info** → **Device ID**, alebo na štítku zariadenia ### Krok 3 — Konfigurácia v TapHome 1. V TapHome pridajte nový modul **Packet Parser (MQTT)** 2. **IP Address:** pre vstavaný broker TapHome `127.0.0.1` (jednotka sa pripája sama k sebe, adresa sa nikdy nezmení); pre externý broker jeho IP adresa (napr. `192.168.1.10`) 3. **Port:** `1883` (predvolený; pre TLS použite `8883`) 4. **Device ID / MQTT Client ID:** zadajte hodnotu z kroku 2 (ak to šablóna vyžaduje) 5. Importujte šablónu — TapHome sa automaticky prihlási na odber topicov zariadenia ## Dostupné zariadenia 1 Tieto zariadenia sa po importe zobrazia v TapHome. Shelly H&T MQTT Modul Vlastné premenné | | | |---------------------|------------------------------------------------------------------------------------------| | `deviceId` (string) | MQTT Device ID zariadenia Shelly H&T — posledných 6 hex znakov MAC adresy (napr. 112233) | Teplotný senzor Teplotný senzor Len na čítanie Teplota okolia a vlhkosť — číta °C z MQTT, vlhkosť konvertovaná z 0–100 % na rozsah 0–1 float Jednotka: °C Čítanie vlhkosti ```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"); ``` Čítanie teploty ```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"); ``` Listener ```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 ``` **Pripojenie:** Packet Parser → MQTT • Hostname: `shellyht-{MAC}.local` Možné vylepšenia (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). ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |-----------------------|----------------| | Mqtt Broker IP adresa | `192.168.0.1` | | Mqtt Broker port | `1883` | | Device ID | `yourDeviceId` | ## Zdroje - 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 ## Súvisiaca dokumentácia - [MQTT Integration](https://taphome.com/sk/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/) - [MQTT broker](https://taphome.com/sk/docs/integration/packet-parser/mqtt-broker/) - [Listener skripty](https://taphome.com/sk/docs/script/listener-scripts/)