TapHome
Službeni · TapHome Provjereno Senzori

Shelly H&T

Senzor temperature i vlažnosti Shelly H&T Gen1 na baterije, povezan sa sustavom TapHome preko MQTT-a. Očitava temperaturu okoline i relativnu vlažnost.

ShellyPacket Parser → MQTT1 uređajRevizija 1.1 Posljednje ažuriranje: 8. listopada 2026.
Radi na Coreu TapHome Next 2026.1.41766
iOvaj smo predložak u laboratoriju TapHome uvezli u ovaj Core i svi su njegovi uređaji dodani bez pogreške.
Shelly H&T

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

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.

Adresa u mreži

Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera 127.0.0.1 (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.

Priprema mreže

Upute za integraciju

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

Kod ugrađenog brokera TapHome <broker-ip> je IP adresa centralne jedinice TapHome Core. Centralnoj jedinici Core dodijelite rezervaciju IP adrese u usmjerivaču, inače uređaj gubi broker kada usmjerivač promijeni adresu → Priprema mreže.

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: za ugrađeni broker TapHome 127.0.0.1 (centralna jedinica spaja se sama na sebe, adresa se nikada ne mijenja); za vanjski broker njegova IP adresa (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 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

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).

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Device IDyourDeviceId

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.

Predložak · TapHome portal Shelly H&T 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. Packet Parser → MQTT Pogledaj u TapHome portalu