Updated August 2025
Shelly Aktoren mag ich sehr. In meinem Haus habe ich ca. 8 "Shelly 1" Schalter (erste Generation = Legacy) und inzwischen einige der neueren Generationen verbaut. Das tolle an den Shellies ist, dass man sie ohne Cloud betreiben kann und kein teures Hub dafür braucht, weil sie direkt ins WLAN zuhause eingebunden werden. Ferner kann ich sie mit MQTT ansteuern.

Die neuen Generationen der Shelly Aktoren haben leider einige Herausforderungen parat, auf die ich hier eingehen möchte. Der Unterschied zwischen den einzelnen Generationen der verschiednenen Generationen der Shelly Aktoren ist bei Shelly selbst gut beschrieben.

In Bezug auf MQTT und Node Red besteht aber kein wesentlicher Unterschied zwischen Gen2, Gen3 und Gen4.

Alte Shelly Legacy Welt

Bis vor einiger Zeit  habe ich mit den sogenannten Legacy Geräten gearbeitet. Wenn man sie einmal ins WLAN integriert hat, ist die Einrichtung über den in den Shellies eingebauten Webserver intuitiv und einfach. Kurzum, Shelly Legacy Produkte können alles, was ich brauche. Im Device eingebautes Skripting, RPC, Key Value Storage und all das brauche ich nicht. Ich will lediglich über meine Node-Red Logik via MQTT einen Schalter bedienen. Insofern sind die neuen Shelly Generationen ein technologischer Overkill – aber preiswert.

Neue Shelly Welt

Zur Fernsteuerung eines Luftentfeuchters brauche ich einen Steckdosenschalter. Gab es bei Shelly als "Shelly Plug S". Inzwischen aber nicht mehr. Dafür aber einen "Shelly Plus Plug S", also zweite Generation.

Anstatt eines ESP8266 Microcontrollers wird ein ESP32 und ab Gen3 ein Shelly-eigener Microcontroller verbaut. Der ist schneller, hat mehr Speicher und bietet somit auch mehr Platz für allerlei zusätzliche Spielereien. Zusätzlich wird auch noch Bluetooth angeboten.

Die mitgelieferte Dokumentation genügt gerade einmal den gesetzlichen Anforderungen. Den Rest muss man sich mehr oder weniger mühsam im Web zusammensuchen.

Diese Anleitung hier gilt sinngemäß für alle neueren Generationen der Shelly Schalter, Shelly1Plus, PRO Serie, Shelly 1 MIni etc.

Integration ins WLAN

Das Teil wie üblich über die iPhone Shelly App zu integrieren, hat irgendwie nicht funktioniert. Als Workaround habe ich mein iPhone (Android oder PC geht natürlich auch) mit dem lokal aufgespannten WLAN des Shelly Plugs verbunden. Dann im Browser die IP Adresse des lokalen Shelly Webservers eingegeben: 192.168.33.1

Es erscheint eine nüchterne Konfigurationsseite und netterweise wird man auch gleich aufgefordert, die WLAN Credentials des Heimnnetzwerks einzugeben.

Es können sogar zwei verschiedene Netzwerkkonfigurationen eingegeben werden. Ich vermute, das dient dazu, das Shelly Plus Teil als WiFi Repeater (Range Extender) zu verwenden. Die Zweite Adresse wäre dann die Accesspoint Adresse, über die sich andere Geräte via  "Shelly WiFi Repeater" ins WLAN einloggen. Muss ich mal ausprobieren…

Nachdem die Credentials eingegeben und gespeichert wurden, sollte das Shelly Device neu gestartet werden. Hat alles geklappt, kann man  jetzt über das Home Network darauf zugreifen. Die zugewiesene Adresse kann über den Router abgefragt werden.

Shelly Konfiguration

Gegenüber der ziemlich intuitiv zu bedienenden Adminoberfläche der Legacy Geräte, ist die neue Oberfläche ein Rückschritt. Jede Menge Menüeinträge mit mehrdimensionaler Navigation – eher unübersichtlich. Zudem schraubt Shelly laufend am Userinterface herum. Look & Feel der Benutzeroberfläche haben sich seit der ersten Version dieses Beitrags erheblich verbessert. Während die erste Version des UI noch sehr holprig war, kann man inzwischen ganz gut damit arbeiten – wenn man sich nicht von der Fülle an Funktionen überwältigen lässt.

Wichtig ist es, erst einmal einen Firmware Update zu machen. Über Settings auf der linken Seite und dann beim Punkt Firmware. War vorher eine sehr alte Firmware aufgespielt, wird danach das Menü leider noch unübersichtlicher.

Die Symbole oben rechts sind Schellzugriffsbuttons für die verschiedenen Protokolle bzw. Zugriffsmöglichkeiten – doppelt gemoppelt.

Die wesentliche Navigation befindet sich vertikal  auf der linken Seite.

Über Settings auf der linken Seite, kommen wir zu den Einstellungen. Ich habe folgende Einstellungen vorgenommen um ein möglichst simples Setup zu erhalten:

Network Settings

• Access Point settings: Enable Access Point spätestens dann ausschalten, wenn alles eingestellt und verbaut ist – Sicherheitsrisiko. Save Settings nicht vergessen.
• Wi-Fi: Enable Wifi1, SSID und WiFi Passwort eintragen. Statische Adresse nur setzen, wenn der Router das nicht selbst festlegen kann. Save Settings.
  WiFi2 wird nur benötigt, wenn der Shelly Switch auch als Repeater arbeiten soll. Roaming so lassen. Und bei jedem Abschnitt save Settings nicht vergessen, wenn etwas verändert wurde.
• Bluetooth: Enable Haken wegnehmen. Je weniger Zugangsmöglichkeiten, desto weniger Blödsinn machen andere damit – ist aber Geschmackssache.

Connectivity

• Cloud: Enable aus
• MQTT: Siehe Detaillierung unten
• RPC over UDP: Alles leer lassen
• Outbound websocket: disable – Haken weglassen
• Range Extender: Haken weglassen es sei denn, man will den Switch als Repeater ensetzen. Hab ich noch nie gebraucht bzw. probiert.

Device settings

• Device name: Hier kann man einen menschenlesbaren Namen vergeben, der aber lediglich auf der Admin Oberfläche angezeigt wird.
• Reboot device: Selbsterklärend
• Factory reset device: Selbsterklärend
• Location and time: Nach Belieben Zeitzone, Geolocation und SNTP Server eintragen oder alles so lassen.
• Authentication: Wer unautorisierten Zugriff vermeiden möchte, kann hier ein Passwort vergeben
• Firmware: Zumindest einmal ein Update machen. Es besteht auch die Möglichkeit eine Custom Firmware zu installieren (Tasmota o.ä.)
• Debug: Nichts markieren
• Temperature Unit: °C oder °Fahrenheit
• TLS Configuration: Für noch höhere Sicherheitsansprüche kann ein SSL Zertifikat hochgeladen werden.
• Eco Mode: Wenn alles funktioniert kann der sowieso schon niedrige Stromverbrauch von <1W noch weiter reduziert werden.

Detaillierung MQTT

Hier sind etwas mehr Daten einzugeben als bei der Legacy Version:

• Enable MQTT Network: Ja – logisch!
• Connection Type: No TLS – Es sei denn ihr habt ein Zertifikat installiert.
• MQTT Prefix: Sehr schön: Hier können wir ein beliebiges, eindeutiges MQTT Topic  Prefix vorgeben. Bei Legacy fing das Topic immer mit Shellies an. Hier also etwas flexibler; zum Beispiel Keller/Hobbyraum/Entfeuchter
• Enable MQTT Control: Haken setzen
• Enable RPC over MQTT: kein Haken – ich fand die Erklärungen zu RPC (Remote Procedure Call) äußerst verwirrend und ich weiß immer noch nicht wofür das gut sein soll
• RPC status notification: kein Haken
• Generic status update over MQTT: Haken setzen. Das ist der Rückkanal, der die Ausführung eines Kommandos bestätigt.
• Server: Hier die IP oder den Netzwerknamen des MQTTbrokers incl. der Portnummer (meist 1883) eintragen
• Client ID: so lassen
• MQTTbroker Username und Passwort eintragen

Dann speichern und fertig. Der Schaltaktor ist jetzt so konfiguriert, dass wir ohne größere Umstände mit Node-Red über MQTT darauf zugreifen können. Weitere Einstellungen – vor allem im Menü Home-Settings – selbst ausprobieren.

Da ich kein Informatiker bin und auch keine Installationen im industriellen Maßstab vorhabe, verschiebe ich den Know How Aufbau bzgl. der ganzen neuen Funktionen auf später. Ich will doch nur ein Gerät mit MQTT ein- und ausschalten können.

Schalt-Charakteristik

Nachdem bei den ersten Firmware Versionen zusätzlich eine sehr verwirrende horizontale Navigationsleiste existierte, ist diese jetzt im Home Menü auf der Fläche des virtuellen Schaltknopfes gelandet. Hier können Zeitgesteuerte und andere Aktionen eingestellt werden. Wer mag, kann gerne damit herum experimentieren. Sehr wichtig ist die Einstellung Input/Output Settings die durch einen Klick auf Output oder Input (wieder doppelt gemoppelt) im Homemenü erreicht wird.. Hier kann u.a. die Schaltcharakteristik eingestellt werden. Also z.B. nach dem Einstecken AUS oder AN oder der letzte bekannte Zustand.

Je nachdem, was bei Input Mode (Switch/Button) eingestellt wird, ändert sich auch die Ausgabe des MQTT Rückkanals. Wichtig für die Auswertung des Auslösers für den Schaltausgangs über msg.payload.source  z.b. durch pysischen Druckknopf oder per MQTT geschaltet.

Für die in der Verteilerdose zu verbauenden Shelly Plus 1 Schalter können hier zusätzlich die Schalterarten (Momentan, Toggle etc.) und Aktivierungsmethoden eingestellt werden. Bei Verwendung mit Node-Red erledigt das in der Regel die von mir programmierte Node-Red Logik.

Ansteuerung mit Node-Red

Die wesentliche Information zu den MQTT Steuer- und Abfrage-Topics befindet sich gut versteckt unter jeder Menge schwer verdaulicher High-End Informatik Doku genau hier: MQTT Control. (Ich weiß wirklich nicht, wozu dieser RPC Kram eigentlich gut sein soll, der gefühlte 95% der Doku ausmacht…)

Sinngemäß steht in dem uns interessierenden Kapitel, dass der Shelly Schalter folgendes Topic abhört (subscribed): <topic_prefix>/command/switch:<ID>

Auf unser Schalter Beispiel bezogen also
Keller/Hobbyraum/Entfeuchter/command/switch:0  Beim Plug, der ja ein einkanaliges Gerät ist, ist die ID immer 0.

Wichtig: Ans Ende kommt kein Schrägstrich hin.

Andere Komponenten (z.B. Thermometer) haben eine andere Komponenbezeichnung als switch.

Als Kommandos verwenden wir on, off oder toggle, die als Payload an den MQTT out Node übergeben werden.

In Node Red sieht ein interaktiver Prozess so aus:

Verwendet werden die Standard MQTT Nodes. Die Inject Nodes und der Debug Node sind nur zum Testen erforderlich.

Der Rückkanal (Status) wird in unserem Beispiel wie folgt abgefragt:
Keller/Hobbyraum/Entfeuchter/status/switch:0

Warum auch immer und anders als bei den Legacy Shellies gibt der Schalter kein einfaches On oder Off zurück sondern einen kompletten Status als JSON String aus dem wir uns die Schalterstellung herausklamüsern müssen.

Im MQTT Ausgabe-Node entweder die Auto-Erkennung (parsed JSON-Objekt….) oder Ein analysiertes (parsed) JSON-Objekt auswählen. In beiden Fällen können wir den Output direkt mit einem Function Node auswerten. zum Beispiel so:

Der gesamte Flow (inkl. obigem Update) ist hier als JSON dargestellt: