---
title: "Shelly H\u0026T"
description: "Citiți temperatura și umiditatea de la senzorul Shelly H\u0026T Gen1 prin MQTT. Senzor Wi-Fi cu baterie, cu alimentare USB opțională pentru raportare continuă."
url: "https://taphome.com/ro/compatibility/shelly-hm/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","battery-powered","temperature","humidity"]
  questions: ["Cum integrez Shelly H\u0026T cu TapHome prin MQTT?","Ce măsoară șablonul TapHome Shelly H\u0026T?","Cum găsesc ID-ul de dispozitiv MQTT al Shelly H\u0026T?","De ce Shelly H\u0026T nu raportează date în TapHome?","Poate Shelly H\u0026T să raporteze continuu, fără să intre în modul de repaus?","Cum convertește TapHome valoarea umidității de la Shelly H\u0026T?"]
---

# Shelly H&T

Comunicație: Packet Parser → MQTT

- [Pagina produsului Shelly H&T](https://www.shelly.com/en/products/shop/shelly-humidity-temperature)

> Adresa în rețea
> 
> Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este `127.0.0.1` (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Shelly H&T este un senzor Wi-Fi de temperatură și umiditate alimentat cu baterie (CR123A), din gama de produse Shelly Gen1. TapHome comunică cu dispozitivul prin MQTT — protocolul recomandat pentru senzorii Shelly cu baterii, deoarece dispozitivul se află în repaus între citiri și publică date doar la trezire.

Șablonul creează un singur dispozitiv Senzor de temperatură cu atributul de service Umiditate, care urmărește atât temperatura ambientală, cât și umiditatea relativă de la o unitate Shelly H&T.

## Configurare

### ID-ul dispozitivului

Shelly H&T folosește un ID de dispozitiv MQTT în formatul `shellyht-<MAC6>`, unde `<MAC6>` reprezintă ultimele 6 caractere ale adresei MAC, în hexazecimal cu litere mici (de ex. `shellyht-112233`).

ID-ul dispozitivului se găsește:

- Pe eticheta dispozitivului (adresa MAC)
- În interfața web Shelly: **Settings** → **Device Info**
- Prin API: `GET http://<device-ip>/settings` → câmpul `mqtt.id`

### Configurarea șablonului

După importul șablonului în TapHome:

1. Deschideți modulul **Shelly H&T MQTT**
2. Setați **MQTT Broker IP** și **Port** (implicit `1883`)
3. Setați variabila personalizată `deviceId` doar la partea hexazecimală a ID-ului dispozitivului (de ex. `112233` pentru `shellyht-112233` — ultimele 6 caractere hexazecimale ale adresei MAC)

Modulul se abonează la `shellies/#`, iar scriptul de ascultare filtrează mesajele după ID-ul dispozitivului configurat.

> [!WARNING]
> Pe dispozitivele Shelly Gen1, activarea MQTT dezactivează Shelly Cloud — cele două nu pot funcționa simultan. Activați MQTT în interfața web Shelly, la **Internet & Security** → **Advanced - Developer Settings**.

> [!TIP]
> Perioada de repaus implicită este de 60 de secunde. Pentru actualizări mai frecvente este disponibil un adaptor USB opțional — când senzorul este alimentat extern, modul de repaus este dezactivat și senzorul raportează continuu.

## Funcțiile dispozitivului

### Monitorizarea temperaturii și a umidității

Șablonul oferă un singur dispozitiv **Senzor de temperatură**, care citește temperatura ambientală din topicul MQTT `shellies/shellyht-{deviceId}/sensor/temperature`. Valorile sunt publicate ca numere zecimale (float), în grade Celsius.

Atributul de service **Umiditate** citește umiditatea relativă din `shellies/shellyht-{deviceId}/sensor/humidity`. Payloadul MQTT este publicat în intervalul 0–100 %, dar șablonul îl convertește intern în intervalul 0–1 (de ex. valoarea MQTT `45.2` este stocată în TapHome ca `0.452`).

Ambele citiri se actualizează ori de câte ori senzorul se trezește din modul de repaus — implicit la fiecare 60 de secunde sau continuu când este alimentat prin USB.

### Funcții suplimentare

Shelly H&T publică și nivelul bateriei (0–100 %, CR123A), starea online/offline prin MQTT Last Will and Testament și un mesaj de anunț al dispozitivului cu modelul, adresa MAC, adresa IP și versiunea de firmware (firmware >=1.6.0). Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Senzorul nu raportează date

1. Verificați dacă Shelly H&T este conectat la Wi-Fi și dacă MQTT este activat în setările dispozitivului (**Internet & Security** → **Advanced - Developer Settings**)
2. Verificați dacă adresa și portul brokerului MQTT sunt corecte atât în interfața web Shelly, cât și în setările modulului TapHome
3. Verificați dacă variabila personalizată `deviceId` corespunde exact ID-ului dispozitivului (ultimele 6 caractere hexazecimale ale adresei MAC, de ex. `112233`)
4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `shellies/#` și verificați dacă senzorul publică mesaje sub `shellies/shellyht-<deviceId>/` la trezire

### Valoarea umidității pare greșită

Șablonul împarte valoarea MQTT a umidității la 100 — o umiditate de 45,2 % este stocată în TapHome ca 0,452. Acesta este comportamentul așteptat, deoarece TapHome folosește intervalul 0–1 pentru valorile umidității. Interfața TapHome afișează corect valoarea în procente.

### Bateria se descarcă rapid

1. Shelly H&T este proiectat pentru o durată de viață a bateriei de până la 18 luni, cu perioada de repaus implicită de 60 de secunde
2. Reconectările Wi-Fi frecvente (semnal slab, schimbarea canalului) cresc semnificativ consumul de energie
3. Asigurați un semnal Wi-Fi puternic în locul în care este montat senzorul — dispozitivul are o rază de acțiune de aproximativ 30 m în interior

> [!WARNING]
> Dispozitivele Shelly Gen1 **nu** acceptă MQTT prin TLS. Comunicația dintre senzor și brokerul MQTT nu este criptată (MQTT simplu, portul 1883). Asigurați-vă că brokerul MQTT se află într-o rețea locală de încredere.

## Cum se instalează în TapHome

### Cerințe preliminare

- Dispozitiv Shelly conectat la Wi-Fi (2,4 GHz), de ex. prin aplicația Shelly sau prin punctul de acces propriu al dispozitivului
- Broker MQTT care rulează în rețeaua dvs. locală (de ex. Mosquitto, Home Assistant sau brokerul integrat TapHome)
- TapHome CCU în aceeași rețea cu brokerul

> [!WARNING]
> La dispozitivele **Gen1**, activarea MQTT **dezactivează Shelly Cloud**. Cele două nu pot funcționa simultan. La dispozitivele Gen2/Plus această limitare nu se aplică.

### Pasul 1 — Activați MQTT pe dispozitivul Shelly

#### Dispozitive Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Deschideți interfața web Shelly: `http://<device-ip>/`
2. Accesați **Internet & Security** → **Advanced — MQTT**
3. Activați **MQTT**
4. Setați **MQTT Server**: `<broker-ip>:<port>` (de ex. `192.168.1.10:1883`)
5. Opțional, setați **MQTT User** și **MQTT Password**, dacă brokerul dvs. necesită autentificare
6. Faceți clic pe **Save** — dispozitivul repornește și se conectează la broker

#### Dispozitive Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Deschideți interfața web Shelly: `http://<device-ip>/`
2. Accesați **Settings** → **MQTT**
3. Activați **MQTT**
4. Setați **Server**: `<broker-ip>:<port>` (de ex. `192.168.1.10:1883`)
5. Câmpul **Client ID** este precompletat cu ID-ul dispozitivului (de ex. `shellyplus1pm-AABBCCDDEE`) — lăsați-l neschimbat, dacă nu aveți un motiv anume să îl modificați
6. Faceți clic pe **Save** și reporniți dispozitivul

La brokerul integrat TapHome, `<broker-ip>` este adresa IP a unității TapHome Core. Atribuiți unității Core o rezervare IP în router; altfel dispozitivul pierde brokerul atunci când routerul schimbă adresa → [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/).

> [!TIP]
> Pentru a verifica funcționarea MQTT, folosiți un client MQTT (de ex. MQTT Explorer) și abonați-vă la `shellies/#` (Gen1) sau `<device-id>/#` (Gen2). Ar trebui să vedeți mesajele de stare trimise de dispozitiv.

### Pasul 2 — Aflați Device ID / MQTT Client ID

Unele șabloane necesită parametrul **Device ID** sau **MQTT Client ID**. Acesta este identificatorul unic folosit în topicurile MQTT.

- **Gen1:** se găsește pe etichetă, ca adresă MAC (de ex. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, de ex. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** se găsește în interfața web Shelly, la **Settings** → **Device Info** → **Device ID**, sau pe eticheta dispozitivului

### Pasul 3 — Configurați dispozitivul în TapHome

1. În TapHome adăugați un nou modul **Packet Parser (MQTT)**
2. **IP Address:** pentru brokerul integrat TapHome `127.0.0.1` (unitatea de control se conectează la ea însăși, adresa nu se schimbă niciodată); pentru un broker extern, adresa sa IP (de ex. `192.168.1.10`)
3. **Port:** `1883` (implicit; pentru TLS folosiți `8883`)
4. **Device ID / MQTT Client ID:** introduceți valoarea de la pasul 2 (dacă șablonul o necesită)
5. Importați șablonul — TapHome se abonează automat la topicurile dispozitivului

## Dispozitive disponibile 1

Aceste dispozitive apar în TapHome după import.

Shelly H&T MQTT Modul

Variabile personalizate

|                     |                                                                                                            |
|---------------------|------------------------------------------------------------------------------------------------------------|
| `deviceId` (string) | ID-ul de dispozitiv MQTT al Shelly H&T — ultimele 6 caractere hexazecimale ale adresei MAC (de ex. 112233) |

Senzor de temperatură Senzor de temperatură Doar citire

Temperatura ambientală și umiditatea — citește °C din MQTT, umiditatea este convertită din intervalul 0–100 % în intervalul 0–1

float Unitate: °C

Citirea umidității

```taphome
# 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");
```

Citirea temperaturii

```taphome
# 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");
```

Ascultător

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

**Conexiune:** Packet Parser → MQTT • Nume gazdă: `shellyht-{MAC}.local`

Îmbunătățiri posibile (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 de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit       |
|------------------------|----------------|
| Mqtt Broker Adresă IP  | `192.168.0.1`  |
| Mqtt Broker port       | `1883`         |
| Device ID              | `yourDeviceId` |

## Surse

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly H&T — Device-Specific API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-h-amp-t) 2026-03-31
- Shelly H&T — Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-h-t) 2026-03-31

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)

