--- title: "Shelly Plug S" description: "Shelly Plug S WLAN-Smart-Steckdose mit Energiemessung. Überwachen Sie den Stromverbrauch und steuern Sie Geräte per HTTP aus TapHome ferngesteuert." url: "https://taphome.com/de/compatibility/shelly-plug-s/" language: de lastmod: 2026-10-08 generator: hugo ai: topics: ["http","smart-plug","electric-meter","wifi","relay","power-metering"] questions: ["Wie integriert man Shelly Plug S mit TapHome?","Was misst das Shelly Plug S Template in TapHome?","Wie verbindet man Shelly Plug S über HTTP mit TapHome?","Warum zeigt Shelly Plug S null Leistung an?","Kann TapHome die interne Temperatur des Shelly Plug S überwachen?","Was passiert, wenn sich der Shelly Plug S überhitzt?"] --- # Shelly Plug S Kommunikation: Packet Parser → HTTP - [Shelly Plug S Wissensdatenbank](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) Der Shelly Plug S ist eine kompakte WLAN-Smart-Steckdose mit integrierter Leistungsmessung. Sie wird direkt in eine Steckdose eingesteckt und schaltet Lasten bis zu 10 A (2300 W bei 230 V). TapHome kommuniziert mit dem Gerät über HTTP im lokalen Netzwerk — eine Cloud-Verbindung ist nicht erforderlich. Das Template bietet Ein-/Ausschalten des Relais, einen Energiezähler mit Echtzeit-Leistungsanzeige und kumuliertem Energieverbrauch sowie eine Überwachung der internen Temperatur. ## Gerätefunktionen ### Relaissteuerung Das Template stellt das Steckdosenrelais als Schalter bereit. Der Relaiszustand wird aus `/settings/relay/0` (Feld `ison`) gelesen und über den Endpoint `/relay/0` mit `turn=on` oder `turn=off` gesteuert. Das Abfrageintervall für den Schalter beträgt 1 Sekunde. > [!NOTE] > Das Template liest den Schaltzustand aus `/settings/relay/0` (persistente Konfiguration), nicht aus `/status` (Live-Zustand). Unter normalen Bedingungen liefern beide denselben Wert, aber `/settings` kann nach schnellem Umschalten leicht veraltete Daten enthalten. ### Leistungsmessung Der integrierte Energiezähler liest zwei Werte vom Endpoint `/meter/0`: - **Echtzeit-Leistung** — Feld `power` in Watt, wird vom Template in kW umgerechnet - **Gesamtverbrauch** — Feld `total` in Watt-Minuten, wird vom Template in kWh umgerechnet Der Zähler ist schreibgeschützt und wird alle 15 Sekunden aktualisiert (konfigurierbares Abfrageintervall). ### Temperaturüberwachung Das Schaltgerät enthält ein Serviceattribut, das die interne Temperatur der Steckdose vom Endpoint `/status` ausliest. Damit lässt sich die Gerätetemperatur direkt in TapHome überwachen, ohne zusätzliche Konfiguration. ## Nicht implementierte Funktionen Die Shelly Plug S API bietet weitere Funktionen, die im aktuellen Template nicht enthalten sind: - **Überhitzungs-Flag** — automatisches Abschalten des Relais bei ~95 °C (`overtemperature` in `/status`) - **LED-Steuerung** — Status-LED über `/settings` ein-/ausschalten - **Überlastschutz-Schwellwert** — konfigurierbares Leistungslimit (Standard 2300 W) - **Auto-Aus-Timer** — automatisches Abschalten des Relais nach einer festgelegten Zeitdauer - **WLAN-Signalstärke** — RSSI-Wert in dBm aus `/status` - **Neustart** — Geräteneustart über den Endpoint `/reboot` Diese Funktionen können in einer zukünftigen Template-Aktualisierung als Serviceattribute oder Serviceaktionen hinzugefügt werden. ## Fehlerbehebung ### Gerät antwortet nicht 1. Überprüfen Sie, ob der Shelly mit dem WLAN verbunden ist und eine gültige IP-Adresse hat 2. Öffnen Sie `http://{device-ip}/shelly` im Browser — antwortet er, ist das Gerät erreichbar 3. Stellen Sie sicher, dass TapHome CCU und Shelly im selben Netzwerk / VLAN sind ### Leistungsmessung zeigt null 1. Vergewissern Sie sich, dass das an den Shelly Plug S angeschlossene Gerät eingeschaltet ist 2. Prüfen Sie, ob das Relais eingeschaltet ist — der Zähler liest nur bei Stromfluss 3. Fragen Sie `/meter/0` manuell ab und prüfen Sie, ob das Feld `power` einen Wert ungleich null zurückgibt ### Abschaltung bei Überhitzung Der Shelly Plug S verfügt über einen internen Überhitzungsschutz. Überschreitet die Gerätetemperatur ~95 °C, schaltet das Relais automatisch ab. Sorgen Sie für ausreichende Belüftung um die Steckdose, insbesondere beim Schalten von Geräten mit hoher Leistungsaufnahme. > [!WARNING] > Shelly Gen1-Geräte unterstützen nur **2 gleichzeitige HTTP-Verbindungen**. Fragen TapHome und ein anderes System (z. B. Home Assistant) dasselbe Gerät gleichzeitig ab, kann die Kommunikation unzuverlässig werden. Wenn auch ein anderes System das Gerät abfragt, erhöhen Sie die Abfrageintervalle der Vorlage (standardmäßig 1 s für den Schalter, 15 s für den Zähler), um Verbindungskonflikte zu reduzieren. ## Installation in TapHome ### Voraussetzungen - Shelly-Gerät installiert und eingeschaltet - Lokales Wi-Fi-Netzwerk (2,4 GHz) - TapHome CCU im selben Netzwerk ### Schritt 1 — Shelly mit Wi-Fi verbinden **Option A — Shelly-App (empfohlen):** 1. Laden Sie die [Shelly-App](https://www.shelly.com/en/support/shelly-app) herunter (iOS / Android) 2. Tippen Sie auf **+** → **Add Device** und folgen Sie dem Bluetooth-Kopplungsassistenten 3. Geben Sie Ihre Wi-Fi-Zugangsdaten ein, wenn Sie dazu aufgefordert werden **Option B — AP-Modus (ohne App):** 1. Beim ersten Einschalten erstellt das Gerät einen Hotspot: `ShellyXXX-AABBCCDDEE` 2. Verbinden Sie Ihr Telefon/PC mit diesem Hotspot 3. Öffnen Sie `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Geben Sie SSID und Passwort ein → **Save** > [!NOTE] > Shelly unterstützt nur **2,4 GHz**-Netzwerke. 5 GHz-Netzwerke werden beim Scannen nicht angezeigt. ### Schritt 2 — IP-Adresse ermitteln Nach der Verbindung mit Wi-Fi ermitteln Sie die zugewiesene IP-Adresse auf eine der folgenden Arten: - **Shelly-App:** Gerätedetail → **Device info** → IP-Adresse - **Shelly-Weboberfläche:** Verbinden Sie sich mit dem Geräte-AP vor der Wi-Fi-Einrichtung — die IP wird nach dem Speichern angezeigt - **Router-DHCP-Tabelle:** Suchen Sie nach einem Hostnamen wie `shelly1pm-AABBCCDDEE` - **mDNS:** Pingen Sie `shelly-.local` (z. B. `shelly1pm-AABBCCDDEE.local`) aus dem selben Netzwerk > [!TIP] > Weisen Sie dem Shelly-Gerät eine **statische IP** (DHCP-Reservierung) in Ihrem Router zu, damit sich die Adresse nach einem Router-Neustart nicht ändert. ### Schritt 3 — Konfiguration in TapHome 1. Fügen Sie in TapHome ein neues Modul **Packet Parser (HTTP)** hinzu 2. **IP Address:** Geben Sie die IP aus Schritt 2 ein (z. B. `192.168.1.50`) 3. **Port:** `80` (Standard, keine Änderung erforderlich) 4. Importieren Sie die Vorlage — TapHome fragt regelmäßig `/status` ab, um den Gerätestatus zu lesen > [!NOTE] > Die HTTP-Authentifizierung ist auf Shelly-Geräten standardmäßig deaktiviert. Wenn Sie den Anmeldeschutz aktiviert haben, unterstützt TapHome derzeit kein HTTP Basic Auth — lassen Sie die Authentifizierung für die TapHome-Integration deaktiviert. ## Verfügbare Geräte Shelly Plug S Modul Benutzerdefinierte Variablen Stromzähler Stromzähler Nur lesen Leistungs- und Energiemessung — momentane Leistung (kW) und kumulierter Energieverbrauch (kWh) numeric Einheit: kW / kWh Schalter Schalter boolean Werte / Zustände: ON · OFF **Verbindung:** Packet Parser → HTTP • Hostname: `shellyplug-s-{MAC}.local` Mögliche Verbesserungen (7) - Live relay state — Template reads from /settings/relay/0 instead of /status — /status has real-time state - Overtemperature flag — Boolean flag in /status, triggers automatic relay shutdown at ~95°C - LED control — Enable/disable status LED via settings endpoint - Overpower protection threshold — Configurable maximum power limit (default 2300W), could be a service action - Auto-off timer — Auto-off timer in seconds, could be added as switch parameter - WiFi signal strength — WiFi RSSI in dBm, available in /status response - Reboot — Device reboot endpoint, could be added as service action ## Quellen - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Shelly Gen1 General Setup [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-devices-general-setup) 2026-03-12 - Shelly Gen1 HTTP Integration [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-http-integration) 2026-03-12 - Shelly Plug S Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) 2026-03-13 - Shelly Plug S API Endpoints [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-plug-plugs) 2026-03-13 ## Verwandte Dokumentation - [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-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/)