TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Eingereicht von
Zuletzt aktualisiert: 03. 2026
Shelly PM Mini Gen3

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).

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.

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).

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

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

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<model>-<mac>.local (z. B. shelly1pm-AABBCCDDEE.local) aus dem selben Netzwerk

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

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 PM Mini Gen3 Modul
Benutzerdefinierte Variablen
Strom Variable Nur lesen
numeric Einheit: A

Strom

Lesen
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

Stromzähler

Gesamtverbrauch lesen
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Bedarf lesen
return(parsejson(status,"apower")/1000);
Lesen (Modul)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Serviceattribute
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frequenz Variable Nur lesen
numeric Einheit: Hz

Frequenz

Lesen
return(parsejson(status,"freq"));
Spannung Variable Nur lesen
numeric Einheit: V

Spannung

Lesen
parsejson(status,"voltage")
Verbindung: Packet Parser → HTTP
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

Quellen