---
title: "Shelly H\u0026T"
description: "Čtení teploty a vlhkosti ze senzoru Shelly H\u0026T Gen1 přes MQTT. Bateriový Wi-Fi senzor s volitelným USB napájením pro kontinuální měření."
url: "https://taphome.com/cs/compatibility/shelly-hm/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","battery-powered","temperature","humidity"]
  questions: ["Jak integrovat Shelly H\u0026T s TapHome přes MQTT?","Co měří šablona Shelly H\u0026T v TapHome?","Jak najít MQTT Device ID pro Shelly H\u0026T?","Proč můj Shelly H\u0026T nehlásí data v TapHome?","Může Shelly H\u0026T měřit kontinuálně bez uspávání baterie?","Jak TapHome zpracovává konverzi hodnoty vlhkosti Shelly H\u0026T?"]
---

# Shelly H&T

Komunikace: Packet Parser → MQTT

- [Produktová stránka Shelly H&T](https://www.shelly.com/en/products/shop/shelly-humidity-temperature)

> Adresa v síti
> 
> U MQTT brokeru vestavěného v TapHome zadejte v TapHome jako adresu brokeru `127.0.0.1`. V zařízení zadejte IP adresu TapHome Core a jednotce Core dejte rezervaci IP v routeru.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Shelly H&T je bateriový (CR123A) Wi-Fi senzor teploty a vlhkosti z produktové řady Shelly Gen1. TapHome komunikuje se zařízením přes MQTT — doporučený protokol pro bateriové Shelly senzory, protože zařízení mezi měřeními spí a data odesílá pouze při probuzení.

Šablona vytvoří jedno zařízení Teplotní senzor se servisním atributem Vlhkost, které sleduje okolní teplotu i relativní vlhkost z jedné jednotky Shelly H&T.

## Konfigurace

### Device ID

Shelly H&T používá MQTT Device ID ve formátu `shellyht-<MAC6>`, kde `<MAC6>` je posledních 6 znaků MAC adresy v hexadecimálním tvaru malými písmeny (např. `shellyht-112233`).

Device ID najdete:

- Na štítku zařízení (MAC adresa)
- Ve webovém rozhraní Shelly: **Settings** → **Device Info**
- Přes API: `GET http://<device-ip>/settings` → pole `mqtt.id`

### Nastavení šablony

Po importu šablony v TapHome:

1. Otevřete modul **Shelly H&T MQTT**
2. Nastavte **MQTT Broker IP** a **Port** (výchozí `1883`)
3. Nastavte proměnnou `deviceId` pouze na hex část Device ID (např. `112233` pro `shellyht-112233` — posledních 6 hex znaků MAC adresy)

Modul se přihlásí k odběru `shellies/#` a listener skript filtruje zprávy podle nakonfigurovaného Device ID.

> [!WARNING]
> Na zařízeních Shelly Gen1 zapnutí MQTT vypne Shelly Cloud — obojí nemůže fungovat současně. MQTT zapnete ve webovém rozhraní Shelly v části **Internet & Security** → **Advanced - Developer Settings**.

> [!TIP]
> Výchozí doba spánku je 60 sekund. Pro častější aktualizace je k dispozici volitelný USB adaptér — při externím napájení se režim spánku vypne a senzor měří kontinuálně.

## Možnosti zařízení

### Monitorování teploty a vlhkosti

Šablona poskytuje jedno zařízení **Teplotní senzor**, které čte okolní teplotu z MQTT topicu `shellies/shellyht-{deviceId}/sensor/temperature`. Hodnoty se publikují jako desetinné číslo ve stupních Celsia.

Servisní atribut **Vlhkost** čte relativní vlhkost z `shellies/shellyht-{deviceId}/sensor/humidity`. MQTT payload se publikuje v rozsahu 0–100 %, ale šablona ho interně konvertuje na rozsah 0–1 (např. MQTT hodnota `45.2` se v TapHome uloží jako `0.452`).

Obě měření se aktualizují při každém probuzení senzoru z režimu spánku — výchozích 60 sekund, nebo kontinuálně při USB napájení.

### Další možnosti

Shelly H&T také publikuje úroveň baterie (0–100 %, CR123A), stav online/offline přes MQTT Last Will and Testament a zprávu o oznámení zařízení s modelem, MAC, IP a verzí firmwaru (firmware >=1.6.0). Tyto možnosti mohou být přidány v budoucí aktualizaci šablony.

## Řešení problémů

### Senzor nehlásí data

1. Ověřte, že Shelly H&T je připojen k Wi-Fi a MQTT je zapnutý v nastavení zařízení (**Internet & Security** → **Advanced - Developer Settings**)
2. Zkontrolujte, zda je adresa a port MQTT brokeru správně nastavený ve webovém rozhraní Shelly i v nastavení modulu TapHome
3. Potvrďte, že proměnná `deviceId` přesně odpovídá Device ID (posledních 6 hex znaků MAC, např. `112233`)
4. Použijte MQTT klienta (např. MQTT Explorer) k odběru `shellies/#` a ověřte, že senzor publikuje zprávy pod `shellies/shellyht-<deviceId>/` při probuzení

### Hodnota vlhkosti se zdá nesprávná

Šablona dělí hodnotu vlhkosti z MQTT stem — vlhkost 45,2 % se v TapHome uloží jako 0,452. Toto je očekávané chování, protože TapHome používá rozsah 0–1 pro hodnoty vlhkosti. Rozhraní TapHome zobrazí hodnotu správně jako procenta.

### Baterie se rychle vybíjí

1. Shelly H&T je navržen na výdrž baterie až 18 měsíců při výchozí 60sekundové době spánku
2. Časté opětovné připojování k Wi-Fi (slabý signál, změna kanálů) výrazně zvyšuje spotřebu energie
3. Zajistěte silný Wi-Fi signál v místě senzoru — zařízení má přibližně 30 m dosah v interiéru

> [!WARNING]
> Zařízení Shelly Gen1 **nepodporují** MQTT přes TLS. Komunikace mezi senzorem a MQTT brokerem není šifrovaná (plain MQTT, port 1883). Zajistěte, aby byl MQTT broker v důvěryhodné lokální síti.

## Jak nainstalovat v TapHome

### Předpoklady

- Zařízení Shelly připojené k Wi-Fi (2,4 GHz), např. přes aplikaci Shelly nebo vlastní přístupový bod zařízení
- MQTT broker běžící ve vaší lokální síti (např. Mosquitto, Home Assistant nebo vestavěný broker TapHome)
- TapHome CCU ve stejné síti jako broker

> [!WARNING]
> Na zařízeních **Gen1** povolení MQTT **vypne Shelly Cloud**. Obojí nemůže běžet současně. Na zařízeních Gen2/Plus toto omezení neplatí.

### Krok 1 — Povolte MQTT na zařízení Shelly

#### Zařízení Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otevřete webové rozhraní Shelly: `http://<device-ip>/`
2. Přejděte na **Internet & Security** → **Advanced — MQTT**
3. Povolte **MQTT**
4. Nastavte **MQTT Server**: `<broker-ip>:<port>` (např. `192.168.1.10:1883`)
5. Volitelně nastavte **MQTT User** a **MQTT Password**, pokud váš broker vyžaduje autentifikaci
6. Klikněte na **Save** — zařízení se restartuje a připojí k brokeru

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

1. Otevřete webové rozhraní Shelly: `http://<device-ip>/`
2. Přejděte na **Settings** → **MQTT**
3. Povolte **MQTT**
4. Nastavte **Server**: `<broker-ip>:<port>` (např. `192.168.1.10:1883`)
5. **Client ID** je předvyplněné ID zařízení (např. `shellyplus1pm-AABBCCDDEE`) — ponechte tak, pokud nemáte konkrétní důvod ke změně
6. Klikněte na **Save** a restartujte zařízení

U vestavěného brokeru TapHome je `<broker-ip>` IP adresa TapHome Core. Dejte jednotce Core rezervaci IP v routeru, jinak zařízení ztratí broker, když router adresu změní → [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/).

> [!TIP]
> Pro ověření funkčnosti MQTT použijte MQTT klienta (např. MQTT Explorer) a přihlaste se k odběru `shellies/#` (Gen1) nebo `<device-id>/#` (Gen2). Měli byste vidět stavové zprávy ze zařízení.

### Krok 2 — Zjistěte Device ID / MQTT Client ID

Některé šablony vyžadují parametr **Device ID** nebo **MQTT Client ID**. Jde o jedinečný identifikátor používaný v MQTT topicích.

- **Gen1:** nachází se na štítku jako MAC adresa (např. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, např. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nachází se ve webovém rozhraní Shelly v části **Settings** → **Device Info** → **Device ID**, nebo na štítku zařízení

### Krok 3 — Konfigurace v TapHome

1. V TapHome přidejte nový modul **Packet Parser (MQTT)**
2. **IP Address:** pro vestavěný broker TapHome `127.0.0.1` (jednotka se připojuje sama k sobě, adresa se nikdy nezmění); pro externí broker jeho IP adresa (např. `192.168.1.10`)
3. **Port:** `1883` (výchozí; pro TLS použijte `8883`)
4. **Device ID / MQTT Client ID:** zadejte hodnotu z kroku 2 (pokud to šablona vyžaduje)
5. Importujte šablonu — TapHome se automaticky přihlásí k odběru topiců zařízení

## Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Shelly H&T MQTT Modul

Vlastní proměnné

|                     |                                                                                       |
|---------------------|---------------------------------------------------------------------------------------|
| `deviceId` (string) | MQTT Device ID zařízení Shelly H&T — posledních 6 hex znaků MAC adresy (např. 112233) |

Teplotní senzor Teplotní senzor Pouze ke čtení

Okolní teplota a vlhkost — čte °C z MQTT, vlhkost konvertovaná z 0–100 % na rozsah 0–1

float Jednotka: °C

Čtení vlhkosti

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

Čtení teploty

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

Listener

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

**Připojení:** Packet Parser → MQTT • Hostname: `shellyht-{MAC}.local`

Možná vylepšení (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).

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci     | Výchozí        |
|-----------------------|----------------|
| Mqtt Broker IP adresa | `192.168.0.1`  |
| Mqtt Broker port      | `1883`         |
| Device ID             | `yourDeviceId` |

## Zdroje

- 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

## Související dokumentace

- [MQTT Integration](https://taphome.com/cs/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/cs/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripty](https://taphome.com/cs/docs/script/listener-scripts/)