--- title: "Shelly PM Mini Gen3" description: "Shelly PM Mini Gen3 ohne Relais lokal per HTTP RPC API: Leistung, Spannung, Strom, Frequenz und Energie. Authentifizierung am Shelly muss aus sein." url: "https://taphome.com/de/compatibility/shelly-pm-mini-gen3/" language: de lastmod: 2026-03-29 generator: hugo ai: topics: ["http","electric-meter","wifi","power-metering","mdns"] questions: ["Wie integriert man den Shelly PM Mini Gen3 mit TapHome?","Was misst die Shelly-PM-Mini-Gen3-TapHome-Vorlage?","Wie verbindet man den Shelly PM Mini Gen3 über HTTP mit TapHome?","Was ist der Unterschied zwischen Shelly PM Mini Gen3 und 1PM Gen3 in TapHome?","Warum zeigt der Shelly PM Mini Gen3 Null-Leistungswerte an?","Kann der Shelly PM Mini Gen3 Lasten schalten oder ist er nur ein Monitor?"] --- # Shelly PM Mini Gen3 Kommunikation: Packet Parser → HTTP - [Shelly PM Mini Gen3 Produktseite](https://www.shelly.com/en/products/shop/shelly-pm-mini-gen3) > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Der Shelly PM Mini Gen3 ist ein ultrakompakter WLAN-Leistungsmonitor (29 × 34 × 16 mm), der passiv den elektrischen Verbrauch bis 16 A / 3840 W bei 240 VAC misst. Im Unterschied zum Shelly 1PM Gen3 hat der PM Mini Gen3 **kein Relais** — er kann keine Lasten schalten. Er wird in Reihe mit dem überwachten Stromkreis installiert und misst den durch seine Klemmen fließenden Strom. TapHome kommuniziert mit dem Gerät über HTTP mittels der Gen2+/Gen3 JSON-RPC 2.0 API im lokalen Netzwerk — keine Cloud-Verbindung erforderlich. Die Vorlage fragt den PM1-Komponenten-Endpunkt (`/rpc/pm1.GetStatus?id=0`) für alle Leistungsmessdaten ab. ## Konfiguration Der Shelly PM Mini Gen3 verbindet sich über WLAN. Während des TapHome-Vorlagenimports geben Sie die IP-Adresse des Geräts ein (Standard-Platzhalter `192.168.0.1`). > [!WARNING] > Die Authentifizierung muss am Shelly-Gerät **deaktiviert** sein für die TapHome-Integration. TapHome unterstützt nicht die HTTP Digest Auth, die von Gen2+/Gen3-Geräten verwendet wird. Öffnen Sie die Shelly-Weboberfläche (`http://{device-ip}`) → Settings → Authentication und stellen Sie sicher, dass sie deaktiviert ist. > [!NOTE] > Wenn der ECO-Modus am Shelly-Gerät aktiviert ist, kann dies zu Kommunikations-Timeouts aufgrund der schnellen Abfrageintervalle der Vorlage (1–1,5 Sekunden) führen. Deaktivieren Sie den ECO-Modus in der Shelly-Weboberfläche, wenn Sie intermittierende Konnektivitätsprobleme feststellen. ## Gerätefähigkeiten ### Leistungsmessung Der integrierte Stromzähler liest zwei Werte aus der Antwort von `/rpc/pm1.GetStatus?id=0`: - **Echtzeitleistung** — `apower` in Watt, von der Vorlage in kW umgerechnet - **Gesamtverbrauch** — `aenergy.total` in Wattstunden, von der Vorlage in kWh umgerechnet Der Stromzähler stellt auch zwei Service-Attribute bereit: - **Elektrischer Strom** — Laststrom in Ampere (Feld `current`) - **Elektrische Spannung** — Versorgungsspannung in Volt (Feld `voltage`) ### Einzelne Sensoren Die Vorlage stellt drei eigenständige Sensorgeräte bereit, die vom selben PM1-Endpunkt gelesen werden: - **Strom [A]** — Effektivstrom in Ampere - **Spannung [V]** — Effektivspannung in Volt - **Frequenz [Hz]** — AC-Netzfrequenz in Hertz Alle Sensoren sind schreibgeschützt und aktualisieren sich automatisch mit jedem Abfragezyklus (1,5-Sekunden-Intervall für einzelne Sensoren, 1 Sekunde für den Stromzähler). > [!NOTE] > Die PM1-Komponente stellt **keinen** Leistungsfaktor (`pf`) und keine interne Temperatur bereit — im Unterschied zur Switch-Komponente, die bei Relaismodellen wie dem Shelly 1PM Gen3 verwendet wird. ### Weitere Fähigkeiten Der Shelly PM Mini Gen3 stellt auch minutenweise Energiedaten (`aenergy.by_minute`), WLAN-Diagnose (SSID, IP, RSSI), MAC-Adresse des Geräts, Betriebszeit, RAM-Nutzung und Gerätezeit in seinen RPC-Antworten bereit. Firmware kann über `/rpc/Shelly.Update` aktualisiert und das Gerät über `/rpc/Shelly.Reboot` neu gestartet werden. Das Gerät fungiert auch als BLE-Gateway und verbindet Shelly BLU-Sensoren mit dem lokalen Netzwerk. Diese Fähigkeiten können in einem zukünftigen Vorlagenupdate 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. Versuchen Sie den mDNS-Hostnamen (`shellypmmig3-AABBCCDDEE.local`) statt der IP-Adresse — die IP kann sich nach einer DHCP-Erneuerung geändert haben 3. Öffnen Sie `http://{device-ip}/rpc/Shelly.GetDeviceInfo` im Browser — wenn es mit JSON antwortet, ist das Gerät erreichbar 4. Prüfen Sie, ob TapHome Core und Shelly im gleichen Netzwerk / VLAN sind 5. Bestätigen Sie, dass die Authentifizierung am Shelly-Gerät deaktiviert ist ### Leistungswerte zeigen Null 1. Bestätigen Sie, dass die Last durch den PM Mini Gen3 angeschlossen ist (Strom muss durch die Geräteklemmen fließen) 2. Überprüfen Sie, ob der Stromkreis unter Spannung steht — der PM Mini Gen3 hat kein Relais, er überwacht nur, was durch den Draht fließt 3. Fragen Sie `/rpc/pm1.GetStatus?id=0` manuell im Browser ab und überprüfen Sie, ob `apower` einen Nicht-Null-Wert zurückgibt 4. Prüfen Sie, ob die Last tatsächlich Strom verbraucht — ein Standby-Gerät kann nahezu Null-Werte anzeigen > [!WARNING] > Shelly Gen2+/Gen3-Geräte unterstützen bis zu **6 gleichzeitige HTTP-Verbindungen**. Obwohl dies eine deutliche Verbesserung gegenüber Gen1 (2 Verbindungen) ist, vermeiden Sie gleichzeitiges Abfragen von zu vielen Systemen (TapHome, Home Assistant, eigene Skripte), um eine Verbindungserschöpfung zu vermeiden. ## 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 4 Diese Geräte erscheinen nach dem Import in TapHome. Shelly PM Mini Gen3 Modul Benutzerdefinierte Variablen Strom Variable Nur lesen numeric Einheit: A Lesen ```taphome return(parsejson(status,"current")); ``` Stromzähler Stromzähler Nur lesen Leistungs- und Energiemessung — momentane Leistung (kW) und kumulierter Energieverbrauch (kWh) mit Strom- und Spannungsmessung numeric Einheit: kW / kWh Serviceattribute | | |----------------------| | Elektrischer Strom | | Elektrische Spannung | Gesamtverbrauch lesen ```taphome return(parsejson(parsejson(status,"aenergy"), "total")/1000); ``` Bedarf lesen ```taphome return(parsejson(status,"apower")/1000); ``` Lesen (Modul) ```taphome var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0")); status := x.Content; ``` Serviceattribute ${current} \[a] ```taphome return(parsejson(status,"current")); ``` ${electric\_voltage} \[v] ```taphome return(parsejson(status,"voltage")); ``` Frequenz Variable Nur lesen numeric Einheit: Hz Lesen ```taphome return(parsejson(status,"freq")); ``` Spannung Variable Nur lesen numeric Einheit: V Lesen ```taphome parsejson(status,"voltage") ``` **Verbindung:** Packet Parser → HTTP • Hostname: `shellypmmig3-{MAC}.local` Mögliche Verbesserungen (8) - Energy by Minute — Energy data array per minute, available in pm1.GetStatus response — useful for detailed consumption graphs - WiFi Status (SSID, IP, Signal) — WiFi connection info; template has no module-level service\_attributes — could be added for diagnostics - MAC Address — Device MAC address from Sys.GetStatus, not polled in current template - Uptime — Seconds since last reboot, available in Sys.GetStatus response - RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response - Device Time — Current device time in HH:MM format, available in Sys.GetStatus response - Update Firmware — Firmware update via RPC; template has no module-level service\_actions - Reboot — Device reboot via RPC; template has no module-level service\_actions ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|---------------| | IP-Adresse | `192.168.0.1` | ## Quellen - Shelly Gen2+/Gen3 RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27 - Shelly Gen2+ Switch Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 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 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27 - Shelly PM Mini Gen3 Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-pm-mini-gen3) 2026-03-29 ## 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/)