Im letzten Beitrag „Shelly MQTT einrichten und erste Befehle nutzen“ habe ich dir gezeigt, wie du MQTT auf einem Shelly aktivierst und den Ausgang mit einfachen MQTT-Kommandos steuerst. Für einen ersten Test eignet sich der MQTT Explorer sehr gut. Möchtest du den Shelly jedoch dauerhaft in eigene Automatisierungen einbinden, ist eine Lösung wie Node-RED deutlich komfortabler.
In diesem Beitrag zeige ich dir, wie du deinen Shelly über MQTT mit Node-RED verbindest. Mithilfe des Low-Code-/No-Code-Ansatzes erstellen wir einen einfachen Flow, mit dem sich der Ausgang des Shellys ein-, ausschalten und umschalten lässt. Außerdem empfangen wir die automatisch veröffentlichten Statusmeldungen und bereiten die enthaltenen JSON-Daten so auf, dass einzelne Werte gezielt weiterverarbeitet werden können.
Damit schaffen wir die Grundlage für spätere Automatisierungen, Visualisierungen und die Speicherung von Messwerten – ganz ohne umfangreiche Programmierung.
Shelly + Node-RED: MQTT-Status auswerten und Dashboard erstellen
In diesem Projekt zeige ich dir praxisnah, wie du deinen Shelly mit Node-RED über MQTT steuerst und Statusmeldungen auswertest – vollständig lokal und ohne Shelly Cloud.
Mit Node-RED kannst du dir mit etwas Aufwand ein eigenes Smart-Home-System mit Automatisierungen, Messwerten und einer Bedienoberfläche aufbauen. Die Dashboard-Nodes bieten dafür bereits viele Möglichkeiten, die ich in einem separaten Beitrag vorgestellt habe.
Der Schalter im Node-RED Dashboard befindet sich im Zustand „AUS“. Der Shelly 1PM hat die angeschlossene Lampe ausgeschaltet.Der Schalter im Node-RED Dashboard befindet sich im Zustand „EIN“. Der Shelly 1PM hat die angeschlossene Lampe eingeschaltet.
Messwerte des Shelly 1PM empfangen
Da ich für dieses Projekt einen Shelly 1PM verwende, kann ich den angeschlossenen Verbraucher nicht nur schalten, sondern auch dessen Energieverbrauch erfassen. Der Shelly misst die Stromaufnahme kontinuierlich und veröffentlicht die aktualisierten Energiewerte automatisch über MQTT.
Bei meinem Gerät wird ungefähr einmal pro Minute eine neue Statusmeldung an den MQTT-Broker gesendet. Diese Nachricht enthält unter anderem den bisherigen Gesamtverbrauch sowie die Verbrauchswerte der letzten Minuten. In Node-RED können wir das entsprechende Topic abonnieren, die empfangene JSON-Nachricht auswerten und die einzelnen Messwerte anschließend weiterverarbeiten.
Der MQTT Explorer zeigt eine automatisch vom Shelly veröffentlichte Statusmeldung im Topic events/rpc.
Voraussetzungen
Wenn du das Projekt nachbauen möchtest, benötigst du folgende Komponenten und Programme:
In meinem Fall laufen Node-RED und der MQTT-Broker auf einem Dell OptiPlex 3050. Du kannst dafür aber ebenso einen Raspberry Pi, Orange Pi oder einen anderen kleinen Server verwenden.
Hinweis von mir: Die mit einem Sternchen (*) markierten Links sind Affiliate-Links. Wenn du über diese Links einkaufst, erhalte ich eine kleine Provision, die dazu beiträgt, diesen Blog zu unterstützen. Der Preis für dich bleibt dabei unverändert. Vielen Dank für deine Unterstützung!
⚠️ Wichtiger Sicherheitshinweis
Der Shelly 1PM wird mit 230 V Netzspannung betrieben. Arbeiten an Netzspannung sind lebensgefährlich und dürfen ausschließlich von entsprechend qualifiziertem Fachpersonal durchgeführt werden.
Beachte dabei immer die fünf Sicherheitsregeln:
Freischalten
Gegen Wiedereinschalten sichern
Spannungsfreiheit feststellen
Erden und kurzschließen
Benachbarte, unter Spannung stehende Teile abdecken oder abschranken
Die Spannungsfreiheit muss mit einem geeigneten zweipoligen Spannungsprüfer, beispielsweise einem Duspol, festgestellt werden. Ein einpoliger Phasenprüfer, umgangssprachlich auch „Lügenstift“ genannt, ist dafür nicht geeignet.
Im Zweifel solltest du die Installation von einer Elektrofachkraft durchführen lassen.
Schaltung des Shelly 1PM
Die Verdrahtung ist recht einfach aufgebaut:
An der Schraubklemme O wird der geschaltete Außenleiter zur Lampe angeschlossen.
Der Neutralleiter der Lampe wird direkt mit dem Neutralleiter der Zuleitung verbunden. Dafür eignet sich beispielsweise eine dreifache WAGO-Klemme.
Der Außenleiter der Zuleitung wird an der Klemme L des Shelly angeschlossen.
Der Neutralleiter der Zuleitung wird mit der Klemme N verbunden.
Die Klemme O ist der geschaltete Ausgang des Shelly. Wird das Relais aktiviert, liegt dort die Netzspannung für die angeschlossene Lampe an. Die Klemme SW wird in diesem Aufbau nicht benötigt, da die Steuerung ausschließlich über MQTT und Node-RED erfolgt.
MQTT-Broker in Node-RED einrichten
Damit Node-RED mit dem Shelly kommunizieren kann, benötigen wir eine Verbindung zu einem MQTT-Broker. In meinem Fall läuft Eclipse Mosquitto in einem Docker-Container auf einem Dell OptiPlex 3050.
Wie du einen MQTT-Broker mit Docker einrichtest, zeige ich dir ausführlich in meinem Beitrag „MQTT einfach erklärt: Was ist MQTT und warum ist es perfekt für IoT?“. Die dort gezeigte Einrichtung funktioniert genauso gut auf einem Raspberry Pi oder einem anderen kleinen Linux-Server.
Ziehe anschließend eine MQTT-Out-Node in den Arbeitsbereich und öffne ihre Einstellungen. Über das Stiftsymbol neben dem Feld „Server“ legst du eine neue Broker-Verbindung an.
Trage dort die IP-Adresse oder den Hostnamen deines MQTT-Brokers sowie den verwendeten Port ein. In meinem Fall verwende ich 192.168.178.186:1883
Falls dein MQTT-Broker durch einen Benutzernamen und ein Passwort geschützt ist, hinterlegst du die Zugangsdaten ebenfalls in der Konfiguration.
Nach dem Speichern und Bereitstellen des Flows sollte unter der MQTT-Node der Status „Verbunden“ erscheinen.
Aufbau des MQTT-Topics
Damit der Shelly weiß, welcher Ausgang geschaltet werden soll, müssen wir in der MQTT-Out-Node das passende Topic eintragen. Dieses setzt sich aus dem Topic-Präfix des Shellys und dem gewünschten Befehl zusammen:
<Topic-Präfix>/command/switch:0
Bei meinem Shelly 1PM Gen3 lautet das Topic beispielsweise: shelly1pmg3-3030f9e95140/command/switch:0
Der erste Teil ist der MQTT-Topic-Präfix des Geräts. Standardmäßig entspricht dieser meist der Geräte-ID des Shellys, kann in den MQTT-Einstellungen jedoch individuell angepasst werden.
Der Abschnitt command/switch:0 legt fest, dass ein Befehl an den ersten Schaltausgang gesendet wird. Die Zahl hinter dem Doppelpunkt steht für den jeweiligen Kanal:
switch:0 = erster Ausgang
switch:1 = zweiter Ausgang
Beim Shelly 1PM ist nur ein Ausgang vorhanden, weshalb wir switch:0 verwenden. Ein Shelly 2PM besitzt dagegen zwei getrennte Relais. Dort werden die beiden Ausgänge mit switch:0 und switch:1 angesprochen.
Payload für den Schaltbefehl
Neben dem MQTT-Topic wird auch eine passende Payload benötigt. Sie enthält den eigentlichen Befehl für den Shelly-Ausgang.
Für die einfache Steuerung stehen unter anderem folgende Werte zur Verfügung:
Payload
Funktion
on
Ausgang einschalten
off
Ausgang ausschalten
toggle
Aktuellen Zustand umschalten
on,3
Ausgang einschalten und nach 3 Sekunden wieder ausschalten
off,3
Ausgang ausschalten und nach 3 Sekunden wieder einschalten
Mit der Payload on,3 wird der Ausgang also eingeschaltet und nach drei Sekunden automatisch wieder ausgeschaltet.
In der Inject-Node wird die gewünschte Payload wie on, off oder toggle für den Shelly-Ausgang eingetragen.
Für die Steuerung mit Node-RED tragen wir diese Werte später beispielsweise in Inject-Nodes oder direkt in einem Dashboard-Schalter ein.
Shelly mit Inject-Nodes über MQTT steuern
Nachdem die Verbindung zum MQTT-Broker eingerichtet sowie Topic und Payload bekannt sind, können wir den ersten einfachen Flow erstellen.
Dafür benötigen wir mehrere Inject-Nodes und eine MQTT-Out-Node. Jede Inject-Node erhält eine andere Payload, beispielsweise on, off oder toggle. Alle Inject-Nodes werden anschließend mit derselben MQTT-Out-Node verbunden.
In der MQTT-Out-Node tragen wir das Topic des Shelly-Ausgangs ein:
shelly1pmg3-3030f9e95140/command/switch:0
Der vollständige Flow ist damit sehr einfach aufgebaut:
Die Inject-Nodes senden die MQTT-Payloads on, off und toggle über eine MQTT-Out-Node an den Shelly 1PM.
Nachdem du den Flow über die Schaltfläche „Übernehmen“ bereitgestellt hast, kannst du die Inject-Nodes einzeln auslösen. Der Shelly sollte den jeweiligen Befehl unmittelbar empfangen und die angeschlossene Lampe entsprechend ein-, ausschalten oder umschalten.
Unterhalb der MQTT-Out-Node sollte außerdem der Status „Verbunden“ angezeigt werden. Reagiert der Shelly nicht, solltest du zunächst die Verbindung zum MQTT-Broker, den Topic-Präfix und die eingetragene Payload überprüfen.
MQTT-Statusmeldungen in Node-RED empfangen
Nachdem wir den Shelly über eine MQTT-Out-Node steuern können, benötigen wir für den Rückweg eine MQTT-In-Node. Diese Node abonniert ein MQTT-Topic und gibt jede dort veröffentlichte Nachricht an den nachfolgenden Flow weiter.
Ziehe dazu eine MQTT-In-Node in den Arbeitsbereich und öffne ihre Einstellungen. Als Broker wählst du dieselbe Verbindung aus, die du bereits für die MQTT-Out-Node eingerichtet hast.
Topic der Statusmeldungen
Die automatischen Statusänderungen veröffentlicht der Shelly über folgendes Topic:
<Topic-Präfix>/events/rpc
Bei meinem Shelly 1PM Gen3 lautet es:
shelly1pmg3-3030f9e95140/events/rpc
Trage dieses Topic in die MQTT-In-Node ein. Die Node abonniert damit alle automatisch veröffentlichten NotifyStatus– und NotifyEvent-Nachrichten dieses Shellys.
Für einen ersten Test verbindest du die MQTT-In-Node direkt mit einer Debug-Node:
Die MQTT-In-Node empfängt die Statusmeldungen des Shelly und gibt sie zur Kontrolle an eine Debug-Node weiter.
Nachdem du den Flow deployed hast, sollten die vom Shelly gesendeten Nachrichten im Debug-Fenster erscheinen.
Bei meinem Test folgte rund eine Minute später eine weitere Statusmeldung mit den Energiewerten der letzten drei Minuten. Diese Meldung wurde anschließend regelmäßig aktualisiert.
Warum mehrere MQTT-Nachrichten zusammengeführt werden müssen
Beim Ein- oder Ausschalten des Shelly werden die verfügbaren Statuswerte nicht gemeinsam in einer einzigen MQTT-Nachricht übertragen. Stattdessen veröffentlicht das Gerät mehrere NotifyStatus-Meldungen, die jeweils nur die Werte enthalten, die sich gerade geändert haben.
Beim Einschalten meines Shelly 1PM wurde zunächst der neue Schaltzustand übertragen:
{
"output": true
}
Kurz danach folgte eine weitere Nachricht mit der aktuellen Leistung:
{
"apower": 5.8
}
Anschließend wurde die gemessene Stromstärke separat veröffentlicht:
{
"current": 0.055
}
Die Energiewerte unter aenergy wurden erst knapp eine Minute später übertragen. Diese Nachricht enthielt unter anderem den Gesamtverbrauch sowie die Energieverbräuche der letzten drei Minuten.
Eine einzelne MQTT-Nachricht enthält daher nicht alle Werte, die wir später gemeinsam im Dashboard anzeigen möchten. Aus diesem Grund verwenden wir eine Function-Node und den Flow-Context.
Die Function-Node prüft jede eintreffende Nachricht und aktualisiert nur die darin enthaltenen Eigenschaften. Bereits empfangene Werte bleiben im Flow-Context gespeichert, bis sie durch neue Werte ersetzt werden.
Auf diese Weise entsteht nach und nach ein gemeinsamer Datensatz mit:
Schaltzustand,
aktueller Leistung,
Stromstärke,
Gesamtverbrauch,
Energiewerten der letzten drei Minuten,
Zeitstempel der letzten Nachricht.
Die Werte werden nicht innerhalb eines festen Zeitfensters gesammelt. Stattdessen bleiben sie im Flow-Context erhalten und werden bei jeder neuen NotifyStatus-Meldung ergänzt oder aktualisiert.
MQTT-Werte im Flow-Context zusammenführen
Nachdem wir gesehen haben, dass der Shelly seine Werte in mehreren getrennten NotifyStatus-Nachrichten sendet, müssen wir diese Informationen in Node-RED zu einem gemeinsamen Datensatz zusammenführen.
Dafür verwenden wir eine Function-Node und den Flow-Context. Der Flow-Context dient als Zwischenspeicher innerhalb des aktuellen Node-RED-Flows. Bereits empfangene Werte bleiben dort erhalten und können bei jeder neuen MQTT-Nachricht ergänzt oder aktualisiert werden.
Welche Nachrichten werden verarbeitet?
Zunächst prüfen wir, ob es sich überhaupt um eine Statusmeldung handelt. Die für dieses Projekt relevanten Nachrichten enthalten:
{
"method": "NotifyStatus"
}
Zusätzlich muss der Bereich switch:0 vorhanden sein, da sich dort die Werte des ersten Schaltausgangs befinden.
Eine eingehende Nachricht kann beispielsweise nur den Schaltzustand enthalten:
{
"output": true
}
Eine andere Nachricht liefert lediglich die aktuelle Leistung:
{
"apower": 5.8
}
Weitere Nachrichten können unter anderem current oder aenergy enthalten.
Die Function-Node muss daher immer prüfen, welche Eigenschaften in der aktuellen Nachricht tatsächlich vorhanden sind.
Vorhandene Werte laden
Zu Beginn laden wir die bereits gespeicherten Daten aus dem Flow-Context:
const values = flow.get("shellyValues") || {};
Existiert noch kein Datensatz, wird ein neues leeres Objekt angelegt.
Treffen später weitere Nachrichten ein, enthält values bereits die zuvor gespeicherten Informationen. So bleiben beispielsweise Schaltzustand und Leistung erhalten, auch wenn die aktuelle MQTT-Nachricht nur neue Energiewerte enthält.
Werte gezielt aktualisieren
Für jede mögliche Eigenschaft prüfen wir, ob sie in der aktuellen Nachricht vorhanden ist.
Beim Schaltzustand verwenden wir:
if (typeof switchData.output === "boolean") {
values.output = switchData.output;
}
Die Prüfung mit typeof ist wichtig, weil auch false ein gültiger Wert ist.
Für Leistung, Spannung und Stromstärke gehen wir ähnlich vor:
if (typeof switchData.apower === "number") {
values.powerW = switchData.apower;
}
if (typeof switchData.current === "number") {
values.currentA = switchData.current;
}
Auch der Wert 0 wird dadurch korrekt übernommen.
Energiewerte übernehmen
Enthält die Nachricht den Bereich aenergy, können wir den Gesamtverbrauch und die Werte der letzten drei Minuten speichern:
Nachdem wir die MQTT-Statusmeldungen des Shelly ausgewertet und die einzelnen Messwerte im Flow-Context zusammengeführt haben, können wir die Daten in einem übersichtlichen Dashboard darstellen. Dafür verwende ich die Nodes aus dem Paket @flowfuse/node-red-dashboard.
Das Dashboard zeigt oben drei farbige Kacheln mit den aktuell erfassten Messwerten:
Spannung in Volt,
Stromstärke in Ampere,
aktuelle Leistung in Watt.
Darunter befindet sich ein Schalter, über den der angeschlossene Verbraucher ein- und ausgeschaltet werden kann. Beim Betätigen des Schalters sendet Node-RED die Payload on beziehungsweise off über die bereits eingerichtete MQTT-Out-Node an den Shelly.
Messwerte im Dashboard anzeigen
Die zuvor im Flow-Context gespeicherten Werte werden an das Dashboard übergeben. Dabei werden unter anderem folgende Eigenschaften verwendet:
Die Werte für Spannung, Strom und Leistung werden in den drei oberen Kacheln dargestellt. Ändert sich einer der Werte durch eine neue MQTT-Statusmeldung, wird die Anzeige automatisch aktualisiert.
Verbraucher über das Dashboard schalten
Der Schaltzustand des Verbrauchers wird über einen eigenen Schalter dargestellt. Ist der Ausgang des Shelly eingeschaltet, zeigt das Dashboard den Zustand EIN. Beim Ausschalten wechselt die Anzeige entsprechend auf AUS.
Der Schalter sendet abhängig vom gewählten Zustand eine der beiden Payloads: on oder: off
Die MQTT-Out-Node veröffentlicht den Befehl anschließend unter dem bekannten Topic:
shelly1pmg3-3030f9e95140/command/switch:0
Damit der angezeigte Zustand mit dem tatsächlichen Ausgang des Shelly übereinstimmt, wird auch der Wert output aus den empfangenen Statusmeldungen berücksichtigt.
Energieverbrauch der letzten drei Minuten
Unterhalb der Steuerung werden die drei Werte aus dem Array aenergy.by_minute angezeigt. Der Shelly liefert damit die Energieverbräuche der letzten drei vollständig abgeschlossenen Minuten.
Die Werte werden in Milliwattstunden dargestellt:
Letzte Minute
Vor zwei Minuten
Vor drei Minuten
Dadurch lässt sich bereits ohne zusätzliche Datenbank erkennen, wie sich der Verbrauch in den letzten Minuten entwickelt hat.
Zeitpunkt der letzten MQTT-Nachricht
Zusätzlich zeigt das Dashboard an, wann zuletzt eine Statusmeldung des Shelly empfangen wurde. Dafür wird der Unix-Zeitstempel aus der MQTT-Nachricht in ein lesbares Datum umgewandelt.
Das verwendete Format lautet: Stunde:Minute:Sekunde Tag.Monat.Jahr
Eine mögliche Ausgabe sieht beispielsweise so aus: 18:42:15 27.06.2026
Der Zeitstempel ist besonders hilfreich, um zu erkennen, ob weiterhin aktuelle Daten vom Shelly eintreffen. Bleibt die Anzeige über einen längeren Zeitraum unverändert, kann dies auf eine unterbrochene MQTT-Verbindung oder ein nicht erreichbares Gerät hinweisen.
Helles und dunkles Theme
Das Dashboard verfügt außerdem über einen Schalter für ein helles und ein dunkles Theme. Im hellen Modus werden die Messwerte auf einem freundlichen, kontrastreichen Hintergrund angezeigt. Das Dark Theme eignet sich besonders für dauerhaft geöffnete Anzeigen oder Wanddisplays.
Das Node-RED Dashboard zeigt den eingeschalteten Verbraucher sowie aktuelle Messwerte für Spannung, Strom und Leistung im hellen Theme.Das Shelly-Dashboard mit eingeschaltetem Verbraucher und aktuellen Messwerten im aktivierten Dark Theme.
Die ausgewählte Darstellung wird im Browser gespeichert. Dadurch bleibt das zuletzt verwendete Theme auch nach dem erneuten Laden des Dashboards erhalten.
Die farbigen Kacheln, Schatten und unterschiedlichen Hervorhebungen sorgen dafür, dass sich die Messwerte schnell voneinander unterscheiden lassen. Spannung, Strom und Leistung erhalten jeweils eine eigene Farbe, während der Schaltzustand und die Minutenwerte in separaten Bereichen dargestellt werden.
Das vollständige Dashboard vereint damit Steuerung und Überwachung auf einer Oberfläche: Der Verbraucher lässt sich lokal über MQTT schalten, während Node-RED gleichzeitig die aktuellen Mess- und Energiewerte des Shelly anzeigt.
Fazit und Ausblick
Mit Node-RED und MQTT lässt sich der Shelly vollständig lokal steuern und überwachen. Die einzelnen NotifyStatus-Nachrichten werden dabei im Flow-Context zu einem gemeinsamen Datensatz zusammengeführt und anschließend im Dashboard dargestellt.
Im nächsten Beitrag zeige ich dir, wie du mit einem eigenen Shelly Script individuelle MQTT-Nachrichten an deinen Broker senden kannst. Der folgende Screenshot gibt bereits einen kleinen Vorgeschmack darauf.
Im nächsten Beitrag zeige ich, wie sich mit einem Shelly Script eigene MQTT-Nachrichten erzeugen und an einen Broker senden lassen.
Wir verwenden Technologien wie Cookies, um Geräteinformationen zu speichern und/oder darauf zuzugreifen. Wir tun dies, um das Surferlebnis zu verbessern und um personalisierte Werbung anzuzeigen. Wenn Sie diesen Technologien zustimmen, können wir Daten wie das Surfverhalten oder eindeutige IDs auf dieser Website verarbeiten. Wenn Sie Ihre Zustimmung nicht erteilen oder zurückziehen, können bestimmte Funktionen beeinträchtigt werden.
Funktional
Immer aktiv
Die technische Speicherung oder der Zugang ist unbedingt erforderlich für den rechtmäßigen Zweck, die Nutzung eines bestimmten Dienstes zu ermöglichen, der vom Teilnehmer oder Nutzer ausdrücklich gewünscht wird, oder für den alleinigen Zweck, die Übertragung einer Nachricht über ein elektronisches Kommunikationsnetz durchzuführen.
Vorlieben
Die technische Speicherung oder der Zugriff ist für den rechtmäßigen Zweck der Speicherung von Präferenzen erforderlich, die nicht vom Abonnenten oder Benutzer angefordert wurden.
Statistiken
Die technische Speicherung oder der Zugriff, der ausschließlich zu statistischen Zwecken erfolgt.Die technische Speicherung oder der Zugriff, der ausschließlich zu anonymen statistischen Zwecken verwendet wird. Ohne eine Vorladung, die freiwillige Zustimmung deines Internetdienstanbieters oder zusätzliche Aufzeichnungen von Dritten können die zu diesem Zweck gespeicherten oder abgerufenen Informationen allein in der Regel nicht dazu verwendet werden, dich zu identifizieren.
Marketing
Die technische Speicherung oder der Zugriff ist erforderlich, um Nutzerprofile zu erstellen, um Werbung zu versenden oder um den Nutzer auf einer Website oder über mehrere Websites hinweg zu ähnlichen Marketingzwecken zu verfolgen.
