TapHome
Službeni · TapHome Senzori

Shelly Plus H&T

Senzor temperature i vlažnosti Shelly Plus H&T na baterije, povezan sa sustavom TapHome preko MQTT-a. Javlja temperaturu okoline, relativnu vlažnost, razinu baterije i dijagnostiku uređaja.

ShellyPacket Parser → MQTT1 uređajRevizija 1.1 Posljednje ažuriranje: 30. ožujka 2026.
Shelly Plus 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:

shellyplusht-{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 Plus H&T (SNSN-0013A) je Wi-Fi senzor temperature i vlažnosti na baterije (4× AA) sa zaslonom e-paper. To je uređaj Gen2 (serija Plus) koji se više ne proizvodi i zamijenio ga je Shelly H&T Gen3, ali je još uvijek često u upotrebi. TapHome s uređajem komunicira preko MQTT-a pomoću pojedinačnih tema /status/ za svaku komponentu. To je standardni pristup za uređaje Shelly Gen2: skripta za primanje poruka pretplaćuje se na <device-id>/# i obrađuje pristigle poruke o stanju kada se senzor probudi iz dubokog sna i objavi podatke.

Predložak stvara jedan uređaj Senzor temperature i vlažnosti s 9 servisnih atributa na razini uređaja za dijagnostiku baterije, mreže i povezivosti. Za razliku od varijante Gen3 (koja koristi objedinjene obavijesti events/rpc), ovaj predložak Gen2 obrađuje pojedinačne teme /status/temperature:0, /status/humidity:0, /status/devicepower:0 i druge teme pojedinih komponenti.

Konfiguracija

Device ID

Svaki Shelly Plus H&T ima jedinstveni Device ID u obliku shellyplusht-<MACADDRESS>, gdje je <MACADDRESS> cijela MAC adresa od 12 znakova velikim slovima u heksadecimalnom zapisu (npr. shellyplusht-A8032AB12CD3). Taj ID ujedno služi kao prefiks MQTT teme.

Device ID možete pronaći:

  • Na naljepnici uređaja (MAC adresa)
  • U web-sučelju Shelly: Settings → Device Info → Device ID
  • Preko API-ja: GET http://<device-ip>/rpc/Mqtt.GetConfig → polje client_id

Postavljanje predloška

Nakon uvoza predloška u TapHome:

  1. Otvorite modul Shelly Plus H&T MQTT
  2. MQTT Broker IP postavite na adresu MQTT brokera
  3. Postavite Port (zadano 1883)
  4. Parametar pri uvozu Device ID postavite na Device ID uređaja (npr. shellyplusht-A8032AB12CD3)

Modul se pretplaćuje na <device-id>/#, a skripta za primanje poruka raščlanjuje pojedinačne JSON poruke /status/ iz teme svake komponente.

Provjerite je li na uređaju Shelly Plus H&T uključen MQTT i je li status_ntf (obavijesti o stanju) postavljen na true. Predložak se oslanja na pojedinačne teme stanja (/status/temperature:0, /status/humidity:0 itd.), a ne na objedinjenu temu events/rpc.

Mjerenje i javljanje

Shelly Plus H&T radi različito ovisno o izvoru napajanja:

  • Rad na baterije — budi se svake minute radi mjerenja. Šalje podatke putem MQTT-a ako se temperatura promijeni za više od 0,5 °C ili vlažnost za više od 5 %. Ako prekoračenje praga ne pokrene slanje podataka, bezuvjetno izvješće o stanju šalje se svaka 2 sata. Razdoblje mirovanja od 5 minuta sprječava prečesto buđenje.
  • Rad na USB napajanje — budi se svakih 5 minuta radi mjerenja, ažuriranja zaslona i bezuvjetnog javljanja u svakom ciklusu.

Zaslon e-paper ažurira se kada se temperatura promijeni za više od 0,2 °C ili vlažnost za više od 3 %.

Uređaj radi na baterije i većinu vremena provodi u dubokom snu. TapHome ne može sam očitavati senzor, nego se oslanja na stanje koje uređaj pri buđenju šalje preko MQTT-a. Očekujte razmake između očitanja, osobito pri radu na baterije. Napajanje preko USB Type-C omogućuje češća ažuriranja, ali ne puni unutarnje baterije.

Mogućnosti uređaja

Temperatura i vlažnost

Uređaj senzor čita temperaturu i vlažnost iz pojedinačnih MQTT tema stanja:

  • Temperatura — temperatura okoline u Celzijevim stupnjevima, čita se iz tC u temi /status/temperature:0
  • Vlažnost — relativna vlažnost u postocima, čita se iz rh u temi /status/humidity:0 (skripta readhumidity dijeli vrijednost sa 100 i pretvara je u raspon 0–1 koji TapHome očekuje)

Obje su vrijednosti samo za čitanje i ažuriraju se kad god se senzor probudi i objavi podatke.

Prag javljanja temperature može se podesiti na uređaju (zadano 0,5 °C, raspon 0,5–5,0 °C). Zadani prag javljanja vlažnosti je 5 % (raspon 1–20 %). Pragovi se mogu prilagoditi u web-sučelju Shelly ili preko API-ja kako bi se uskladili učestalost javljanja i trajanje baterije.

Servisni atributi

Predložak na razini uređaja daje 9 servisnih atributa sa stanjem baterije i dijagnostikom uređaja:

Praćenje baterije:

  • Baterija — postotak napunjenosti baterije iz battery.percent u /status/devicepower:0
  • Napon baterije — napon baterije u voltima iz battery.V u /status/devicepower:0
  • Vanjsko napajanje — je li spojeno vanjsko napajanje USB Type-C, iz external.present u /status/devicepower:0

Dijagnostika mreže:

  • Wi-Fi — SSID spojene Wi-Fi mreže iz /status/wifi
  • IP adresa — IP adresa uređaja iz /status/wifi
  • MAC adresa — MAC adresa uređaja iz /status/sys

Stanje povezivosti:

  • Spojeno na oblak — stanje veze sa Shelly Cloudom iz /status/cloud
  • Spojeno na MQTT — stanje veze s MQTT brokerom iz /status/mqtt
  • BLE omogućen — stanje Bluetooth Low Energy iz /status/ble

Svi servisni atributi prikazuju "-" dok još nisu primljeni podaci (početno stanje nakon uvoza predloška, prije prvog buđenja senzora).

Dodatne mogućnosti

Shelly Plus H&T objavljuje i temperaturu u stupnjevima Fahrenheita (polje tF u /status/temperature:0) i jačinu Wi-Fi signala (RSSI u dBm) te podržava komponentu HT_UI za postavljanje jedinice temperature na zaslonu e-paper (°C/°F). Uređaj daje i stanje online/offline preko teme MQTT Last Will and Testament (LWT). 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 Plus H&T spojen na Wi-Fi i je li MQTT uključen u postavkama uređaja (Settings → MQTT → Enable)
  2. Provjerite je li status_ntf postavljen na true: predložak zahtijeva pojedinačne obavijesti o stanju u temama /status/
  3. Provjerite odgovara li parametar pri uvozu Device ID točno Device ID-ju uređaja (npr. shellyplusht-A8032AB12CD3)
  4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na <device-id>/# i provjerite objavljuje li senzor poruke o stanju kada se probudi
  5. Provjerite razinu baterije uređaja: s ispražnjenim baterijama senzor se ne može spojiti na Wi-Fi

Očitanje vlažnosti izgleda netočno

  1. Predložak TapHome dijeli neobrađenu vrijednost vlažnosti sa 100 (npr. rh: 55.3 u sustavu TapHome postaje 0.553). To je očekivano ponašanje: TapHome interno koristi raspon 0–1
  2. Senzor ima podesivi pomak vlažnosti (Humidity.SetConfig → offset): provjerite da nije postavljen na pogrešnu vrijednost
  3. Radni raspon vlažnosti senzora je 30–70 % RH. Očitanja izvan tog raspona mogu biti manje točna

Servisni atributi prikazuju „-”

  1. Servisni atributi prikazuju "-" dok se senzor ne probudi i ne objavi podatke u odgovarajućoj temi stanja
  2. Pri radu na baterije uređaju može trebati do 2 sata da pošalje prvo bezuvjetno izvješće: pritisnite tipku za resetiranje (ispod stražnjeg poklopca) za trenutačno mjerenje i javljanje
  3. Provjerite prima li MQTT broker poruke u svim očekivanim temama (/status/sys, /status/wifi, /status/cloud, /status/mqtt, /status/ble)

Razlike u odnosu na Shelly H&T Gen3

Shelly Plus H&T (Gen2) i Shelly H&T Gen3 imaju slične mogućnosti senzora, ali se razlikuju u MQTT komunikaciji:

  • Gen2 (Plus H&T) koristi pojedinačne teme /status/ za svaku komponentu i zahtijeva status_ntf: true
  • Gen3 (H&T Gen3) koristi objedinjenu temu events/rpc s JSON-RPC događajima NotifyStatus i zahtijeva rpc_ntf: true
  • Predložak Gen3 ima i otkrivanje offline stanja prema vremenskoj oznaci (upozorenje nakon >12 h, pogreška nakon >24 h), koje predložak Gen2 nema

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 Plus H&T MQTT Modul
Prilagođene varijable
deviceId (string)MQTT Device ID koji se koristi kao prefiks teme — oblik: shellyplusht-{MACADDRESS} (pronađite ga u web-sučelju Shelly → Settings → Device Info)
Open http://shellyIpAddress → Settings → Device info → copy Device ID (e.g. shellyplusht-A8032AB12CD3)
Senzor temperature i vlažnosti Senzor temperature Samo za čitanje

Temperatura okoline (°C) i relativna vlažnost iz pojedinačnih MQTT tema /status/ — vlažnost se za TapHome pretvara u raspon 0–1

json Jedinica: °C / %RH json_path
Servisni atributi
BaterijaPostotak napunjenosti baterije — do prvog buđenja senzora prikazuje „-”
Napon baterijeNapon baterije u voltima — koristan za praćenje trošenja baterije tijekom vremena
Vanjsko napajanjeJe li spojeno vanjsko napajanje USB Type-C (true/false)
Wi-FiSSID spojene Wi-Fi mreže
IP adresa
MAC adresa
Spojeno na oblakStanje veze sa Shelly Cloudom (true/false)
Spojeno na MQTTStanje veze s MQTT brokerom (true/false)
BLE omogućenJe li Bluetooth Low Energy omogućen (true/false)

Senzor temperature i vlažnosti

Čitanje vlažnosti
Hu := listenHum / 100.0;
Listener
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
Servisni atributi
Battery
IF (ISNAN(batteryPerc), "-", batteryPerc + "%");
Battery voltage
IF (ISNAN(batteryV), "-", batteryV + "V");
External power
IF (LENGTH(externalPower) = 0, "-", externalPower);
WiFi
IF (LENGTH(wifi) = 0, "-", wifi);
IP Address
IF (LENGTH(ipaddress) = 0, "-", ipaddress);
MAC Address
IF (LENGTH(macAddress) = 0, "-", macAddress);
Cloud connected
IF (LENGTH(cloudConnected) = 0, "-", cloudConnected);
MQTT connected
IF (LENGTH(mqttConnected) = 0, "-", mqttConnected);
BLE enabled
IF (LENGTH(BLEenabled) = 0, "-", BLEenabled);
Povezivanje: Packet Parser → MQTT • Naziv računala (hostname): shellyplusht-{MAC}.local
Moguća poboljšanja (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.

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
Mqtt Broker IP adresa192.168.0.1
Mqtt Broker port1883
Device IDshellyplusht-yourDeviceId

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 Plus 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