--- title: "Shelly 1PM" description: "Shelly 1PM (Gen1) lokal per HTTP ohne Cloud: einen Stromkreis bis 16 A schalten und aktuellen Verbrauch sowie kumulierte Energie in TapHome messen." url: "https://taphome.com/de/compatibility/shelly-1pm/" language: de lastmod: 2026-03-12 generator: hugo ai: topics: ["http","electric-meter","wifi","relay","power-metering"] questions: ["Wie integriere ich den Shelly 1PM in TapHome?","Was misst die TapHome-Vorlage für den Shelly 1PM?","Wie verbinde ich den Shelly 1PM per HTTP mit TapHome?","Warum zeigt der Shelly 1PM 0 W an?","Wie stelle ich die Leistungsbegrenzung des Shelly 1PM über TapHome ein?","Welche Diagnosefunktionen sind für den Shelly 1PM in TapHome verfügbar?"] --- # Shelly 1PM Kommunikation: Packet Parser → HTTP - [Shelly 1PM Produktseite](https://www.shelly.com/en/products/shop/shelly-1pm) - [Shelly 1PM API-Dokumentation](https://shelly-api-docs.shelly.cloud/gen1/#shelly1-1pm) Der Shelly 1PM ist ein kompaktes WLAN-Relais mit integrierter Leistungsmessung. Es passt hinter einen Standard-Wandschalter und kann einen Stromkreis mit bis zu 16 A (3500 W bei 230 V) schalten. TapHome kommuniziert mit dem Gerät über HTTP im lokalen Netzwerk — eine Cloud-Verbindung ist nicht erforderlich. Das Template bietet Relaissteuerung und einen Energiezähler, der den Echtzeit-Stromverbrauch und den kumulierten Energieverbrauch ausliest. ## Konfiguration Der Shelly 1PM verbindet sich über WLAN. Beim Import des TapHome-Templates gib die IP-Adresse des Geräts ein (Standard-Platzhalter `192.168.0.1`). ## Gerätefunktionen ### Relaissteuerung Das Template stellt das Relais als Schaltergerät bereit. Der Relaiszustand wird aus der `/status`-Antwort ausgelesen (`relays[0].ison`) und über den Endpunkt `/relay/0` mit `turn=on` oder `turn=off` gesteuert. ### Leistungsmessung Der integrierte Energiezähler liest zwei Werte aus der `/status`-Antwort: - **Echtzeit-Leistung** — `meters[0].power` in Watt, vom Template in kW umgerechnet - **Gesamtverbrauch** — `meters[0].total` in Wattminuten, vom Template in kWh umgerechnet Der Zähler ist schreibgeschützt — er aktualisiert sich automatisch mit jedem Abfragezyklus. ### Service-Diagnose Das Template stellt 13 Service-Attribute zur Geräteüberwachung bereit: - **Geräteinformationen** — Hostname, MAC-Adresse, Gerätezeit, Betriebszeit, RAM-Auslastung - **Thermoschutz** — Innentemperatur (°C), Temperaturstatus (Normal / Hoch / Sehr hoch), Übertemperatur-Flag - **Konnektivität** — Cloud aktiviert/verbunden, MQTT verbunden, Firmware-Update verfügbar - **Leistungsschutz** — aktuelles maximales Leistungslimit (wird von `/settings` gelesen) ### Service-Aktionen Drei Service-Aktionen stehen zur Verfügung: - **Leistungsschutz setzen** — legt das maximale Leistungslimit fest (1–3500 W). Das Relais schaltet automatisch ab, wenn der Verbrauch diesen Wert überschreitet. - **Cloud aktivieren** — aktiviert oder deaktiviert die Shelly-Cloud-Verbindung - **Neustart** — löst einen Geräteneustart aus ### Weitere Funktionen Der Shelly 1PM stellt in seiner `/status`-Antwort auch die Leitungsspannung, Blindleistung, den physischen Eingangszustand und die WLAN-Signalstärke bereit. Ein Auto-Aus-Timer ist am Relais-Endpunkt verfügbar. Diese Funktionen können in einem zukünftigen Template-Update ergänzt werden. ## Fehlerbehebung ### Gerät antwortet nicht 1. Überprüfe, ob der Shelly mit dem WLAN verbunden ist und eine gültige IP-Adresse hat 2. Versuche, den mDNS-Hostnamen (`shelly1pm-AABBCCDDEE.local`) statt der IP-Adresse zu verwenden — die IP könnte sich nach einer DHCP-Erneuerung geändert haben 3. Öffne `http://{device-ip}/shelly` im Browser — wenn eine Antwort kommt, ist das Gerät erreichbar 4. Stelle sicher, dass TapHome CCU und Shelly im selben Netzwerk / VLAN sind ### Leistungswerte zeigen null 1. Bestätige, dass die Last durch das Shelly-Relais geschaltet ist (nicht umgangen) 2. Prüfe, ob das Relais eingeschaltet ist — der Zähler misst nur, wenn Strom durch das Relais fließt 3. Frage `/status` manuell ab und prüfe, ob `meters[0].power` einen Wert ungleich null zurückgibt ### Übertemperaturwarnung Der Shelly 1PM verfügt über einen internen Thermoschutz. Wenn die Gerätetemperatur sichere Grenzwerte überschreitet, wechselt `temperature_status` auf „Hoch" oder „Sehr hoch" und `overtemperature` wird `true`. Sorge für ausreichende Belüftung um das Gerät, besonders beim Schalten hoher Lasten. > [!WARNING] > Gen1-Shelly-Geräte unterstützen nur **2 gleichzeitige HTTP-Verbindungen**. Wenn TapHome und ein anderes System (z. B. Home Assistant) dasselbe Gerät gleichzeitig abfragen, kann die Kommunikation unzuverlässig werden. Verwende ein Abfrageintervall von 10–30 Sekunden. ## 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 1PM Modul Serviceattribute | | |--------------------------| | Leistungsschutz | | Hostname | | MAC-Adresse | | Gerätezeit | | Betriebszeit | | RAM | | Interne Gerätetemperatur | | Temperaturstatus | | FW-Aktualisierung | | Cloud aktiviert | | Cloud verbunden | | MQTT verbunden | | Überhitzt | Serviceaktionen | | |----------------------------| | Leistungsschutz einstellen | | Cloud aktivieren | | Neustart | Benutzerdefinierte Variablen Schalter Schalter boolean Werte / Zustände: ON · OFF Stromzähler Stromzähler Nur lesen Leistungs- und Energiemessung — momentane Leistung (kW) und kumulierter Energieverbrauch (kWh) numeric Einheit: W / kWh **Verbindung:** Packet Parser → HTTP • Hostname: `shelly1pm-{MAC}.local` Mögliche Verbesserungen (5) - Voltage — Line voltage in V, available in /status response - Reactive Power — Reactive power in VAR, available in /status response - Input State — Physical input state (0/1), available in /status response - WiFi Signal Strength — WiFi RSSI in dBm, available in /status response - Auto-off Timer — Auto-off timer in seconds, could be added as service action or switch parameter ## Quellen - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 ## 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/)