TapHome

Shelly H&T

Packet Parser → MQTT
Autor
Posljednje ažuriranje: 10. 2026

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellyht-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Shelly H&T

Shelly H&T je Wi-Fi senzor temperature i vlažnosti na baterije (CR123A) iz linije proizvoda Shelly Gen1. TapHome s uređajem komunicira preko MQTT-a, što je preporučeni protokol za senzore Shelly na baterije: uređaj između mjerenja spava i podatke objavljuje samo kada se probudi.

Predložak stvara jedan uređaj Senzor temperature sa servisnim atributom Vlažnost, koji prati temperaturu okoline i relativnu vlažnost iz jednog uređaja Shelly H&T.

Konfiguracija

Device ID

Shelly H&T koristi MQTT Device ID u obliku shellyht-<MAC6>, gdje je <MAC6> zadnjih 6 znakova MAC adrese malim slovima u heksadecimalnom zapisu (npr. shellyht-112233).

Device ID možete pronaći:

  • Na naljepnici uređaja (MAC adresa)
  • U web-sučelju Shelly: Settings → Device Info
  • Preko API-ja: GET http://<device-ip>/settings → polje mqtt.id
Postavljanje predloška

Nakon uvoza predloška u TapHome:

  1. Otvorite modul Shelly H&T MQTT
  2. Postavite MQTT Broker IP i Port (zadano 1883)
  3. Korisničku varijablu deviceId postavite samo na heksadecimalni dio Device ID-a (npr. 112233 za shellyht-112233, zadnjih 6 heksadecimalnih znakova MAC adrese)

Modul se pretplaćuje na shellies/#, a skripta za primanje poruka filtrira poruke prema postavljenom Device ID-u.

Na uređajima Shelly Gen1 uključivanje MQTT-a isključuje Shelly Cloud: to dvoje ne može raditi istodobno. MQTT uključite u web-sučelju Shelly pod Internet & Security → Advanced - Developer Settings.

Zadano razdoblje spavanja je 60 sekundi. Za češća ažuriranja dostupan je dodatni USB adapter: uz vanjsko napajanje način spavanja se isključuje i senzor javlja neprekidno.

Mogućnosti uređaja

Praćenje temperature i vlažnosti

Predložak nudi jedan uređaj Senzor temperature koji čita temperaturu okoline iz MQTT teme shellies/shellyht-{deviceId}/sensor/temperature. Vrijednosti se objavljuju kao decimalni broj u Celzijevim stupnjevima.

Servisni atribut Vlažnost čita relativnu vlažnost iz teme shellies/shellyht-{deviceId}/sensor/humidity. MQTT payload objavljuje se kao 0–100 %, ali ga predložak interno pretvara u raspon 0–1 (npr. MQTT vrijednost 45.2 sprema se u sustavu TapHome kao 0.452).

Oba se očitanja ažuriraju kad god se senzor probudi iz načina spavanja: prema zadanim postavkama svakih 60 sekundi, a uz USB napajanje neprekidno.

Dodatne mogućnosti

Shelly H&T objavljuje i razinu baterije (0–100 %, CR123A), stanje online/offline preko MQTT Last Will and Testament te poruku najave uređaja koja sadrži model, MAC adresu, IP adresu i verziju firmvera (firmver >=1.6.0). Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

Rješavanje problema

Senzor ne šalje podatke
  1. Provjerite je li Shelly H&T spojen na Wi-Fi i je li MQTT uključen u postavkama uređaja (Internet & Security → Advanced - Developer Settings)
  2. Provjerite jesu li adresa i port MQTT brokera ispravni i u web-sučelju Shelly i u postavkama modula TapHome
  3. Provjerite odgovara li korisnička varijabla deviceId točno Device ID-u (zadnjih 6 heksadecimalnih znakova MAC adrese, npr. 112233)
  4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na shellies/# i provjerite objavljuje li senzor poruke pod shellies/shellyht-<deviceId>/ kada se probudi
Očitanje vlažnosti izgleda pogrešno

Predložak dijeli MQTT vrijednost vlažnosti sa 100: vlažnost od 45,2 % sprema se u sustavu TapHome kao 0,452. To je očekivano ponašanje, jer TapHome za vrijednosti vlažnosti koristi raspon 0–1. Sučelje TapHome vrijednost ispravno prikazuje u postocima.

Baterija se brzo prazni
  1. Shelly H&T predviđen je za trajanje baterije do 18 mjeseci uz zadano razdoblje spavanja od 60 sekundi
  2. Česta ponovna spajanja na Wi-Fi (slab signal, preskakanje kanala) znatno povećavaju potrošnju energije
  3. Osigurajte jak Wi-Fi signal na mjestu senzora: uređaj u zatvorenom ima domet od otprilike 30 m

Uređaji Shelly Gen1 ne podržavaju MQTT preko TLS-a. Komunikacija između senzora i MQTT brokera nije šifrirana (obični MQTT, port 1883). Pobrinite se da je MQTT broker u pouzdanoj lokalnoj mreži.

Kako ga instalirati u TapHome

Preduvjeti

  • Uređaj Shelly spojen na Wi-Fi (2,4 GHz), npr. putem aplikacije Shelly ili vlastite pristupne točke uređaja
  • MQTT broker koji radi u vašoj lokalnoj mreži (npr. Mosquitto, Home Assistant ili ugrađeni broker TapHome)
  • TapHome CCU u istoj mreži kao broker

Na uređajima Gen1 uključivanje MQTT-a isključuje Shelly Cloud. MQTT i Shelly Cloud ne mogu raditi istodobno. Na uređajima Gen2/Plus to ograničenje ne vrijedi.

Korak 1 — Uključite MQTT na uređaju Shelly

Uređaji Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

  1. Otvorite web-sučelje Shelly: http://<device-ip>/
  2. Idite na Internet & Security → Advanced — MQTT
  3. Uključite MQTT
  4. Postavite MQTT Server: <broker-ip>:<port> (npr. 192.168.1.10:1883)
  5. Ako vaš broker zahtijeva autentifikaciju, postavite MQTT User i MQTT Password
  6. Kliknite Save — uređaj će se ponovno pokrenuti i spojiti na broker

Uređaji Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

  1. Otvorite web-sučelje Shelly: http://<device-ip>/
  2. Idite na Settings → MQTT
  3. Uključite MQTT
  4. Postavite Server: <broker-ip>:<port> (npr. 192.168.1.10:1883)
  5. Client ID je unaprijed popunjen ID-jem uređaja (npr. shellyplus1pm-AABBCCDDEE) — ostavite ga takvim, osim ako ga iz određenog razloga trebate promijeniti
  6. Kliknite Save i ponovno pokrenite uređaj

Za provjeru rada MQTT-a koristite MQTT klijent (npr. MQTT Explorer) i pretplatite se na shellies/# (Gen1) ili <device-id>/# (Gen2). Trebali biste vidjeti statusne poruke uređaja.

Korak 2 — Pronađite Device ID / MQTT Client ID

Neki predlošci zahtijevaju parametar Device ID ili MQTT Client ID. To je jedinstveni identifikator koji se koristi u MQTT temama (topics).

  • Gen1: nalazi se na naljepnici kao MAC adresa (npr. AABBCCDDEE). Device ID = shelly<model>-<mac>, npr. shelly1pm-AABBCCDDEE
  • Gen2/Plus: nalazi se u web-sučelju Shelly pod Settings → Device Info → Device ID ili na naljepnici uređaja

Korak 3 — Konfiguracija u sustavu TapHome

  1. U sustavu TapHome dodajte novi modul Packet Parser (MQTT)
  2. IP adresa: unesite IP adresu MQTT brokera (npr. 192.168.1.10)
  3. Port: 1883 (zadano; za TLS koristite 8883)
  4. Device ID / MQTT Client ID: unesite vrijednost iz koraka 2 (ako je predložak zahtijeva)
  5. Uvezite predložak — TapHome će se automatski pretplatiti na teme uređaja

Dostupni uređaji

Shelly H&T MQTT Modul
Prilagođene varijable
deviceId (string)MQTT Device ID uređaja Shelly H&T — zadnjih 6 heksadecimalnih znakova MAC adrese (npr. 112233)
Senzor temperature Senzor temperature Samo za čitanje

Temperatura i vlažnost okoline — čita °C iz MQTT-a, vlažnost se pretvara iz 0–100 % u raspon 0–1

float Jedinica: °C

Senzor temperature

Čitanje vlažnosti
# 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");
Čitanje temperature
# 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
# 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
Povezivanje: Packet Parser → MQTT • Naziv računala (hostname): shellyht-{MAC}.local
Moguća poboljšanja (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).

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu