
Der Shelly 1PM ist ein kompakter Einkanal-WLAN-Relaisschalter mit integrierter Leistungsmessung. Er passt hinter einen Standard-Wandschalter und kann einen Stromkreis bis 16 A (3500 W bei 230 V) steuern. TapHome kommuniziert mit dem Gerät über MQTT — dies ist die MQTT-Variante der Shelly 1PM-Vorlage, geeignet wenn Sie lokale MQTT-Kommunikation gegenüber HTTP-Polling bevorzugen.
Die Vorlage unterstützt bis zu 5 Shelly 1PM-Einheiten pro Modul. Jede Einheit wird durch eine eigene Variable pulgNtopic unterschieden, die auf die MQTT Client ID des Geräts verweist. Jede Einheit stellt einen Relaisschalter und einen Stromzähler bereit.
Konfiguration
Device ID
Jeder Shelly 1PM hat eine eindeutige MQTT Device ID im Format shelly1pm-<MAC6>, wobei <MAC6> die letzten 6 Zeichen der MAC-Adresse in hexadezimaler Kleinschreibung sind (z. B. shelly1pm-112233).
Die Device ID finden Sie:
- Auf dem Geräteaufkleber (MAC-Adresse)
- In der Shelly-Weboberfläche: Settings → Device Info
- Über die API:
GET http://<device-ip>/settings→ Feldmqtt.id
Dieses Gerät unterstützt mDNS Discovery. Anstelle einer IP-Adresse können Sie bei der TapHome-Konfiguration den Hostnamen
shelly1pm-{MAC}.localverwenden. Ersetzen Sie{MAC}durch die letzten 6 Zeichen der MAC-Adresse des Geräts in hexadezimaler Kleinschreibung (z. B.shelly1pm-112233.local). Die Verwendung eines Hostnamens verhindert Verbindungsprobleme bei Änderung der IP-Adresse des Geräts.
Vorlage einrichten
Nach dem Import der Vorlage in TapHome:
- Öffnen Sie das Modul Shelly 1PM MQTT
- Stellen Sie die MQTT-Broker-IP und den Port ein (Standard
1883) - Setzen Sie für jede Shelly 1PM-Einheit die Variable
pulgNtopicauf die Device ID des entsprechenden Shelly 1PM (z. B.shelly1pm-112233)
Das Modul abonniert shellies/# und die Listener-Skripte filtern Nachrichten anhand des konfigurierten Topic-Präfixes.
Konfigurieren Sie nur die Slots, die Sie tatsächlich verwenden. Nicht konfigurierte Slots (mit dem Standardwert
shelly1pm-deviceidN) stimmen mit keinem realen Gerät überein und können ignoriert werden.
Gerätefunktionen
Relaissteuerung
Jede Einheit stellt in TapHome ein Schaltgerät bereit. Der Relaisstatus wird aus dem Topic shellies/<id>/relay/0 gelesen und durch Veröffentlichung von on oder off auf shellies/<id>/relay/0/command gesteuert.
Leistungsmessung
Jede Einheit enthält einen Stromzähler, der zwei Werte erfasst:
- Echtzeitleistung —
shellies/<id>/relay/0/powerin Watt gemeldet, von der Vorlage in kW umgerechnet - Gesamtverbrauch —
shellies/<id>/relay/0/energyin Watt-Minuten gemeldet, von der Vorlage in kWh umgerechnet
Der Stromzähler ist schreibgeschützt — er aktualisiert sich automatisch, wenn das Gerät neue Daten veröffentlicht.
Temperatur- und Überlastüberwachung
Jedes Schaltgerät stellt vier Serviceattribute bereit:
- Interne Temperatur — Gerätetemperatur in °C aus dem Topic
shellies/<id>/temperature - Temperaturstatus — Temperaturstufe: Normal, High oder Very High (
shellies/<id>/temperature_status) - Überhitzung — Übertemperatur-Alarmflag (
shellies/<id>/overtemperature) - Überlast — meldet die Lastleistung (W) bei erkannter Überlastung (
shellies/<id>/overpower_value)
Weitere Funktionen
Der Shelly 1PM veröffentlicht auch einen Online-/Offline-Status über das MQTT Last Will and Testament (LWT) Topic, eine vollständige JSON-Statusnachricht (Firmware ≥1.8.0), den Status des physischen Eingangs und Eingangsereignisse (Kurz-/Doppel-/Dreifach-/Langdruck). Diese Funktionen können in einem zukünftigen Vorlagen-Update hinzugefügt werden.
Fehlerbehebung
Gerät meldet keine Daten
- Überprüfen Sie, dass der Shelly 1PM mit dem WLAN verbunden ist und MQTT in den Geräteeinstellungen aktiviert ist
- Prüfen Sie, ob die Variable
pulgNtopicexakt der Device ID entspricht (z. B.shelly1pm-112233) - Bestätigen Sie die korrekte MQTT-Broker-IP und den Port in den Moduleinstellungen
- Verwenden Sie einen MQTT-Client (z. B. MQTT Explorer), um
shellies/#zu abonnieren und zu überprüfen, ob das Gerät Nachrichten veröffentlicht
Leistungsmessung zeigt Null
- Bestätigen Sie, dass die Last über das Shelly-Relais angeschlossen ist (nicht umgangen)
- Prüfen Sie, ob das Relais eingeschaltet ist — der Stromzähler misst nur, wenn Strom durch das Relais fließt
- Abonnieren Sie
shellies/<id>/relay/0/powermit einem MQTT-Client und überprüfen Sie, ob das Gerät einen Wert ungleich Null meldet
Übertemperaturwarnung
Der Shelly 1PM verfügt über einen integrierten Überhitzungsschutz. Wenn die Gerätetemperatur sichere Grenzwerte überschreitet, ändert sich temperature_status auf “High” oder “Very High” und overtemperature wird auf true gesetzt. Sorgen Sie für ausreichende Belüftung um das Gerät, besonders beim Schalten hoher Lasten.
Shelly Gen1-Geräte unterstützen kein MQTT über TLS. Die Kommunikation zwischen Gerät und MQTT-Broker ist unverschlüsselt (Plain MQTT, Port 1883). Stellen Sie sicher, dass sich der MQTT-Broker in einem vertrauenswürdigen lokalen Netzwerk befindet.