---
title: "Shelly Plus H\u0026T"
description: "Shelly Plus H\u0026T: senzor na baterije preko MQTT-a za TapHome. Temperatura okoline, vlažnost, razina i napon baterije te dijagnostika uređaja."
url: "https://taphome.com/hr/compatibility/shelly-plus-ht-mqtt/"
language: hr
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","battery-powered","temperature-humidity"]
  questions: ["Kako integrirati Shelly Plus H\u0026T sa sustavom TapHome preko MQTT-a?","Što mjeri predložak TapHome za Shelly Plus H\u0026T?","Koje servisne atribute daje predložak za Shelly Plus H\u0026T?","Zašto moj Shelly Plus H\u0026T ne javlja temperaturu i vlažnost?","Javlja li Shelly Plus H\u0026T razinu i napon baterije u sustavu TapHome?","Koja je razlika između Shelly Plus H\u0026T i Shelly H\u0026T Gen3?"]
---

# Shelly Plus H&T

Komunikacija: Packet Parser → MQTT

- [Stranica proizvoda Shelly Plus H&T](https://www.shelly.com/en/products/shop/shelly-plus-h-t)

> 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](https://taphome.com/hr/docs/setup/network-preparation/)

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

> [!TIP]
> 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 %.

> [!WARNING]
> 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

> [!WARNING]
> 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](https://taphome.com/hr/docs/setup/network-preparation/).

> [!TIP]
> 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

|                   |                                                                                   |
|-------------------|-----------------------------------------------------------------------------------|
| Baterija          | Postotak napunjenosti baterije — do prvog buđenja senzora prikazuje „-”           |
| Napon baterije    | Napon baterije u voltima — koristan za praćenje trošenja baterije tijekom vremena |
| Vanjsko napajanje | Je li spojeno vanjsko napajanje USB Type-C (true/false)                           |
| Wi-Fi             | SSID spojene Wi-Fi mreže                                                          |
| IP adresa         |                                                                                   |
| MAC adresa        |                                                                                   |
| Spojeno na oblak  | Stanje veze sa Shelly Cloudom (true/false)                                        |
| Spojeno na MQTT   | Stanje veze s MQTT brokerom (true/false)                                          |
| BLE omogućen      | Je li Bluetooth Low Energy omogućen (true/false)                                  |

Čitanje vlažnosti

```taphome
Hu := listenHum / 100.0;
```

Listener

```taphome
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

```taphome
IF (ISNAN(batteryPerc), "-", batteryPerc + "%");
```

Battery voltage

```taphome
IF (ISNAN(batteryV), "-", batteryV + "V");
```

External power

```taphome
IF (LENGTH(externalPower) = 0, "-", externalPower);
```

WiFi

```taphome
IF (LENGTH(wifi) = 0, "-", wifi);
```

IP Address

```taphome
IF (LENGTH(ipaddress) = 0, "-", ipaddress);
```

MAC Address

```taphome
IF (LENGTH(macAddress) = 0, "-", macAddress);
```

Cloud connected

```taphome
IF (LENGTH(cloudConnected) = 0, "-", cloudConnected);
```

MQTT connected

```taphome
IF (LENGTH(mqttConnected) = 0, "-", mqttConnected);
```

BLE enabled

```taphome
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 aplikaciji  | Zadano                      |
|-----------------------|-----------------------------|
| Mqtt Broker IP adresa | `192.168.0.1`               |
| Mqtt Broker port      | `1883`                      |
| Device ID             | `shellyplusht-yourDeviceId` |

## Izvori

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27
- Shelly Plus H&T Device API (Temperature, Humidity, DevicePower, HT\_UI)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/0.14/Devices/ShellyPlusHT/) 2026-03-30
- Shelly Plus H&T Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-h-t) 2026-03-30

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

