TapHome

Shelly Plus H&T

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

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.

Shelly Plus H&T

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

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

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