--- title: "Shelly Plus H\u0026T" description: "Batteriebetriebener Temperatur- und Feuchtigkeitssensor über MQTT mit Batteriestand, Spannung und Diagnose. TapHome-Vorlage für Shelly Plus H\u0026T." url: "https://taphome.com/de/compatibility/shelly-plus-ht-mqtt/" language: de lastmod: 2026-03-30 generator: hugo ai: topics: ["mqtt","sensor","wifi","battery-powered","temperature-humidity"] questions: ["Wie integriert man Shelly Plus H\u0026T mit TapHome über MQTT?","Was misst die Shelly Plus H\u0026T TapHome-Vorlage?","Welche Serviceattribute bietet die Shelly Plus H\u0026T Vorlage?","Warum meldet mein Shelly Plus H\u0026T keine Temperatur und Luftfeuchtigkeit?","Meldet Shelly Plus H\u0026T Batteriestand und Spannung in TapHome?","Was ist der Unterschied zwischen Shelly Plus H\u0026T und Shelly H\u0026T Gen3?"] --- # Shelly Plus H&T Kommunikation: Packet Parser → MQTT - [Shelly Plus H&T Produktseite](https://www.shelly.com/en/products/shop/shelly-plus-h-t) > Netzwerkadresse > > Beim in TapHome integrierten MQTT-Broker geben Sie in TapHome `127.0.0.1` als Broker-Adresse ein. Im Gerät geben Sie die IP-Adresse des TapHome Core ein und richten für den Core eine IP-Reservierung im Router ein. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Der Shelly Plus H&T (SNSN-0013A) ist ein batteriebetriebener (4x AA) Wi-Fi Temperatur- und Feuchtigkeitssensor mit einem E-Paper-Display. Es handelt sich um ein Gen2-Gerät (Plus-Serie), das inzwischen eingestellt und durch den Shelly H&T Gen3 ersetzt wurde, aber weiterhin weit verbreitet ist. TapHome kommuniziert mit dem Gerät über MQTT mittels individueller `/status/`-Topics für jede Komponente. Dies ist der Standardansatz für Gen2 Shelly-Geräte — das Listener-Skript abonniert `/#` und verarbeitet eingehende Statusnachrichten, wenn der Sensor aus dem Tiefschlaf aufwacht und Daten veröffentlicht. Die Vorlage erstellt ein einzelnes Gerät Temperatur- und Feuchtigkeitssensor mit 9 Serviceattributen auf Geräteebene für Batterie, Netzwerk und Konnektivitätsdiagnose. Im Gegensatz zur Gen3-Variante (die konsolidierte `events/rpc`-Benachrichtigungen verwendet), verarbeitet diese Gen2-Vorlage individuelle Topics `/status/temperature:0`, `/status/humidity:0`, `/status/devicepower:0` und weitere komponentenspezifische Topics. ## Konfiguration ### Device ID Jeder Shelly Plus H&T hat eine eindeutige Device ID im Format `shellyplusht-`, wobei `` die vollständige 12-stellige MAC-Adresse in hexadezimaler Großschreibung ist (z.B. `shellyplusht-A8032AB12CD3`). Diese ID dient auch als MQTT-Topic-Präfix. Die Device ID finden Sie: - Auf dem Gerätelabel (MAC-Adresse) - In der Shelly Web-UI: **Settings** → **Device Info** → **Device ID** - Über API: `GET http:///rpc/Mqtt.GetConfig` → Feld `client_id` ### Vorlageneinrichtung Nach dem Import der Vorlage in TapHome: 1. Öffnen Sie das Modul **Shelly Plus H&T MQTT** 2. Setzen Sie die **MQTT Broker IP** auf die Adresse des MQTT-Brokers 3. Setzen Sie den **Port** (Standard `1883`) 4. Setzen Sie den Import-Parameter **Device ID** auf die Device ID des Geräts (z.B. `shellyplusht-A8032AB12CD3`) Das Modul abonniert `/#` und das Listener-Skript parst individuelle `/status/` JSON-Nachrichten von den Topics jeder Komponente. > [!TIP] > Stellen Sie sicher, dass MQTT auf dem Shelly Plus H&T aktiviert ist und `status_ntf` (Statusbenachrichtigungen) auf `true` gesetzt ist. Die Vorlage basiert auf individuellen Status-Topics (`/status/temperature:0`, `/status/humidity:0` usw.), nicht auf dem konsolidierten Topic `events/rpc`. ### Mess- und Meldeverhalten Der Shelly Plus H&T arbeitet je nach Stromquelle unterschiedlich: - **Batteriemodus** — Aufwachen jede 1 Minute zur Messung. Meldet über MQTT, wenn sich die Temperatur um mehr als 0,5 °C oder die Luftfeuchtigkeit um mehr als 5 % ändert. Eine unbedingte Statusmeldung wird alle 2 Stunden gesendet, wenn keine schwellenwertbasierten Meldungen ausgelöst wurden. Eine 5-minütige Schutzperiode verhindert übermäßiges Aufwachen. - **USB-Betrieb** — Aufwachen alle 5 Minuten zur Messung, Display-Aktualisierung und unbedingter Meldung in jedem Zyklus. Das E-Paper-Display aktualisiert sich bei Temperaturänderungen über 0,2 °C oder Feuchtigkeitsänderungen über 3 %. > [!WARNING] > Das Gerät ist batteriebetrieben und verbringt die meiste Zeit im Tiefschlaf. TapHome kann den Sensor nicht aktiv abfragen — es verlässt sich darauf, dass das Gerät selbst den Status über MQTT beim Aufwachen sendet. Erwarten Sie Lücken zwischen den Messungen, insbesondere im Batteriemodus. USB Type-C Stromversorgung bietet häufigere Aktualisierungen, lädt aber nicht die internen Batterien auf. ## Gerätefähigkeiten ### Temperatur und Luftfeuchtigkeit Das Sensorgerät liest Temperatur und Luftfeuchtigkeit von individuellen MQTT-Status-Topics: - **Temperatur** — Umgebungstemperatur in Celsius, gelesen aus `tC` im Topic `/status/temperature:0` - **Luftfeuchtigkeit** — relative Luftfeuchtigkeit in Prozent, gelesen aus `rh` im Topic `/status/humidity:0` (das readhumidity-Skript teilt den Wert durch 100 zur Umrechnung in den von TapHome erwarteten Bereich 0–1) Beide Werte sind schreibgeschützt und aktualisieren sich bei jedem Aufwachen des Sensors und Veröffentlichen von Daten. Der Temperaturschwellenwert ist am Gerät konfigurierbar (Standard 0,5 °C, Bereich 0,5–5,0 °C). Der Feuchtigkeitsschwellenwert beträgt standardmäßig 5 % (Bereich 1–20 %). Diese Schwellenwerte können über die Shelly Web-UI oder API angepasst werden, um die Meldefrequenz gegen die Batterielebensdauer abzuwägen. ### Serviceattribute Die Vorlage stellt 9 Serviceattribute auf Geräteebene bereit, die den Batteriestatus und die Gerätediagnose abdecken: **Batterieüberwachung:** - **Battery** — prozentualer Ladestand der Batterie aus `battery.percent` in `/status/devicepower:0` - **Battery voltage** — Batteriespannung in Volt aus `battery.V` in `/status/devicepower:0` - **External power** — ob USB Type-C externe Stromversorgung angeschlossen ist, aus `external.present` in `/status/devicepower:0` **Netzwerkdiagnose:** - **WiFi** — SSID des verbundenen WiFi-Netzwerks aus `/status/wifi` - **IP Address** — IP-Adresse des Geräts aus `/status/wifi` - **MAC Address** — MAC-Adresse des Geräts aus `/status/sys` **Konnektivitätsstatus:** - **Cloud connected** — Shelly Cloud Verbindungsstatus aus `/status/cloud` - **MQTT connected** — MQTT-Broker Verbindungsstatus aus `/status/mqtt` - **BLE enabled** — Bluetooth Low Energy Status aus `/status/ble` Alle Serviceattribute zeigen `"-"` an, wenn noch keine Daten empfangen wurden (Anfangszustand nach dem Vorlagenimport, vor dem ersten Aufwachen des Sensors). ### Weitere Fähigkeiten Der Shelly Plus H&T veröffentlicht auch die Temperatur in Fahrenheit (Feld `tF` in `/status/temperature:0`), WiFi-Signalstärke (RSSI in dBm) und unterstützt die HT_UI-Komponente zur Konfiguration der Temperatureinheit auf dem E-Paper-Display (°C/°F). Das Gerät bietet auch einen Online/Offline-Status über das MQTT Last Will and Testament (LWT) Topic. Diese Fähigkeiten können in einer zukünftigen Vorlagenaktualisierung hinzugefügt werden. ## Fehlerbehebung ### Sensor meldet keine Daten 1. Überprüfen Sie, dass der Shelly Plus H&T mit Wi-Fi verbunden ist und MQTT in den Geräteeinstellungen aktiviert ist (**Settings** → **MQTT** → **Enable**) 2. Prüfen Sie, dass `status_ntf` auf `true` gesetzt ist — die Vorlage erfordert individuelle Statusbenachrichtigungen auf `/status/`-Topics 3. Bestätigen Sie, dass der Import-Parameter **Device ID** exakt mit der Device ID des Geräts übereinstimmt (z.B. `shellyplusht-A8032AB12CD3`) 4. Verwenden Sie einen MQTT-Client (z.B. MQTT Explorer) zum Abonnieren von `/#` und überprüfen Sie, ob der Sensor Statusnachrichten beim Aufwachen veröffentlicht 5. Prüfen Sie den Batteriestand des Geräts — leere Batterien verhindern, dass sich der Sensor mit Wi-Fi verbindet ### Feuchtigkeitsmessung erscheint falsch 1. Die TapHome-Vorlage teilt den Rohwert der Luftfeuchtigkeit durch 100 (z.B. `rh: 55.3` wird zu `0.553` in TapHome). Dies ist erwartetes Verhalten — TapHome verwendet intern einen Bereich von 0–1 2. Der Sensor hat einen konfigurierbaren Feuchtigkeitsoffset (`Humidity.SetConfig` → `offset`) — überprüfen Sie, dass er nicht auf einen falschen Wert eingestellt ist 3. Der Betriebsbereich des Sensors für Luftfeuchtigkeit beträgt 30–70 % RH. Messungen außerhalb dieses Bereichs können weniger genau sein ### Serviceattribute zeigen "-" 1. Serviceattribute zeigen `"-"` an, bis der Sensor aufwacht und Daten auf dem entsprechenden Status-Topic veröffentlicht 2. Im Batteriebetrieb kann es bis zu 2 Stunden dauern, bis das Gerät seinen ersten unbedingten Bericht sendet — drücken Sie die Reset-Taste (hinter der Rückabdeckung) für eine sofortige Messung und Meldung 3. Überprüfen Sie, ob der MQTT-Broker Nachrichten auf allen erwarteten Topics empfängt (`/status/sys`, `/status/wifi`, `/status/cloud`, `/status/mqtt`, `/status/ble`) ### Unterschiede zum Shelly H&T Gen3 Der Shelly Plus H&T (Gen2) und der Shelly H&T Gen3 haben ähnliche Sensorfähigkeiten, unterscheiden sich aber in der MQTT-Kommunikation: - **Gen2 (Plus H&T)** verwendet individuelle `/status/`-Topics pro Komponente — erfordert `status_ntf: true` - **Gen3 (H&T Gen3)** verwendet das konsolidierte Topic `events/rpc` mit `NotifyStatus` JSON-RPC-Ereignissen — erfordert `rpc_ntf: true` - Die Gen3-Vorlage enthält zudem eine zeitstempelbasierte Offline-Erkennung (>12h Warnung, >24h Fehler), die die Gen2-Vorlage nicht implementiert ## Installation in TapHome ### Voraussetzungen - Shelly-Gerät mit Wi-Fi (2,4 GHz) verbunden, z. B. über die Shelly App oder den eigenen Access Point des Geräts - MQTT-Broker in Ihrem lokalen Netzwerk aktiv (z. B. Mosquitto, Home Assistant oder der integrierte TapHome-Broker) - TapHome CCU im selben Netzwerk wie der Broker > [!WARNING] > Auf **Gen1**-Geräten **deaktiviert** das Aktivieren von MQTT die **Shelly Cloud**. Beides kann nicht gleichzeitig betrieben werden. Auf Gen2/Plus-Geräten gilt diese Einschränkung nicht. ### Schritt 1 — MQTT auf dem Shelly-Gerät aktivieren #### Gen1-Geräte (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…) 1. Öffnen Sie die Shelly-Weboberfläche: `http:///` 2. Navigieren Sie zu **Internet & Security** → **Advanced — MQTT** 3. Aktivieren Sie **MQTT** 4. Setzen Sie **MQTT Server**: `:` (z. B. `192.168.1.10:1883`) 5. Optional setzen Sie **MQTT User** und **MQTT Password**, falls Ihr Broker eine Authentifizierung erfordert 6. Klicken Sie auf **Save** — das Gerät startet neu und verbindet sich mit dem Broker #### Gen2 / Plus-Geräte (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…) 1. Öffnen Sie die Shelly-Weboberfläche: `http:///` 2. Navigieren Sie zu **Settings** → **MQTT** 3. Aktivieren Sie **MQTT** 4. Setzen Sie **Server**: `:` (z. B. `192.168.1.10:1883`) 5. Die **Client ID** ist mit der Geräte-ID vorausgefüllt (z. B. `shellyplus1pm-AABBCCDDEE`) — belassen Sie sie so, es sei denn, Sie haben einen bestimmten Grund zur Änderung 6. Klicken Sie auf **Save** und starten Sie das Gerät neu Beim integrierten TapHome-Broker ist `` die IP-Adresse des TapHome Core. Geben Sie dem Core eine IP-Reservierung im Router, sonst verliert das Gerät den Broker, wenn der Router die Adresse ändert → [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/). > [!TIP] > Um zu überprüfen, ob MQTT funktioniert, verwenden Sie einen MQTT-Client (z. B. MQTT Explorer) und abonnieren Sie `shellies/#` (Gen1) oder `/#` (Gen2). Sie sollten Statusnachrichten vom Gerät sehen. ### Schritt 2 — Device ID / MQTT Client ID ermitteln Einige Vorlagen erfordern einen Parameter **Device ID** oder **MQTT Client ID**. Dies ist die eindeutige Kennung, die in MQTT-Topics verwendet wird. - **Gen1:** auf dem Etikett als MAC-Adresse zu finden (z. B. `AABBCCDDEE`). Device ID = `shelly-`, z. B. `shelly1pm-AABBCCDDEE` - **Gen2/Plus:** in der Shelly-Weboberfläche unter **Settings** → **Device Info** → **Device ID** zu finden, oder auf dem Geräteetikett ### Schritt 3 — Konfiguration in TapHome 1. Fügen Sie in TapHome ein neues Modul **Packet Parser (MQTT)** hinzu 2. **IP Address:** `127.0.0.1` für den integrierten TapHome-Broker (die Steuereinheit verbindet sich mit sich selbst, die Adresse ändert sich nie); für einen externen Broker dessen IP-Adresse (z. B. `192.168.1.10`) 3. **Port:** `1883` (Standard; verwenden Sie `8883` für TLS) 4. **Device ID / MQTT Client ID:** Geben Sie den Wert aus Schritt 2 ein (falls von der Vorlage benötigt) 5. Importieren Sie die Vorlage — TapHome abonniert automatisch die Geräte-Topics ## Verfügbare Geräte 1 Diese Geräte erscheinen nach dem Import in TapHome. Shelly Plus H&T MQTT Modul Benutzerdefinierte Variablen `deviceId` (string) MQTT-Geräte-ID als Topic-Präfix — Format: shellyplusht-{MACADDRESS} (in der Shelly Web-UI → Settings → Device Info) Open http://shellyIpAddress → Settings → Device info → copy Device ID (e.g. shellyplusht-A8032AB12CD3) Temperatur- und Feuchtigkeitssensor Temperatursensor Nur lesen Umgebungstemperatur (°C) und relative Luftfeuchtigkeit aus individuellen /status/ MQTT-Topics — Feuchtigkeit auf Bereich 0–1 für TapHome konvertiert json Einheit: °C / %RH json\_path Serviceattribute | | | |-------------------------|-----------------------------------------------------------------------------| | Batterie | Prozentualer Ladestand — zeigt '-' bis zum ersten Aufwachen des Sensors | | Batteriespannung | Batteriespannung in Volt — nützlich zur Überwachung der Batteriedegradation | | Externe Stromversorgung | Ob USB Type-C externe Stromversorgung angeschlossen ist (true/false) | | WiFi | SSID des verbundenen WiFi-Netzwerks | | IP-Adresse | | | MAC-Adresse | | | Cloud verbunden | Shelly Cloud Verbindungsstatus (true/false) | | MQTT verbunden | MQTT-Broker Verbindungsstatus (true/false) | | BLE aktiviert | Bluetooth Low Energy Status (true/false) | Luftfeuchtigkeit lesen ```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 ``` Serviceattribute 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); ``` **Verbindung:** Packet Parser → MQTT • Hostname: `shellyplusht-{MAC}.local` Mögliche Verbesserungen (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. ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |------------------------|-----------------------------| | Mqtt Broker IP-Adresse | `192.168.0.1` | | Mqtt Broker port | `1883` | | Device ID | `shellyplusht-yourDeviceId` | ## Quellen - 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 ## Verwandte Dokumentation - [MQTT Integration](https://taphome.com/de/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/) - [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/) - [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/) - [MQTT-Broker](https://taphome.com/de/docs/integration/packet-parser/mqtt-broker/) - [Listener-Skripte](https://taphome.com/de/docs/script/listener-scripts/)