Auf dieser Seite werden die Aktoren des bulgarischen Herstellers Shelly beschrieben, sowie deren Ansteuerung mit FHEM und aufgetretene Probleme. Es handelt sich um IP-basierte Schaltaktoren, die angesteuert werden können

über die Web-Oberfläche des eingebauten Mikro-Webservers
über eine proprietäre App des Herstellers (Achtung, Cloud!)
über das FHEM-Modul 36_Shelly.pm
über MQTT

Ein Teil der Aktoren verfügt über eine eingebaute Leistungsmessung.

Geräteübersicht

Shelly
Zweck / Funktion
	Das Modul 36_Shelly.pm stellt ein Interface zum Schalten der Shelly-Aktoren zur Verfügung
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Sonstige Systeme
Modulname	36_Shelly.pm
Ersteller	Prof. Dr. Peter A. Henning
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Modell	Typ	Aktor-Kanäle	Mess-kanäle
ShellyPlug	Schalter	1
Shelly1	Schalter	1
Shelly2	Schalter/Rollladen	2/1	1
Shelly4Pro	Schalter	4	4

Einbindung in FHEM

Out-of-the Box

Schließen Sie den Aktor nach Vorschrift an
Suchen Sie mit einem WLAN-fähigen Gerät (Laptop oder Smartphone) nach dem internen Access Point, der durch den Aktor erzeugt wird. Typischerweise hat dieser eine SSID ähnlich wie

shelly1-..., shelly4pro-...,

Verbinden Sie Ihr Gerät mit diesem Access Point. Typischerweise bekommt Ihr Gerät dabei die IP-Adresse 192.168.33.2 zugewiesen.
Im Browser dieses Gerätes einfach die IP-Adresse 192.168.33.1 aufrufen - das ist der Shelly selbst, in dieser Web-Oberfläche kann man alles konfigurieren.
- Internen Access Point Abschalten
- Shelly ins häusliche WLAN anmelden. Mit fester IP-Adresse <shelly-ip> natürlich...
- Testen: Ihr Gerät wieder mit dem häuslichen WLAN verbinden, und im Browser die Adresse <shelly-ip> aufrufen
In FHEM definieren

define myShelly Shelly <shelly-ip>

Auf der Detailseite des Devices muss unbedingt noch das Attribut model gesetzt werden:

attr myShelly model shellyplug|shelly1|shelly2|shelly4

Falls es sich um einen Shelly2 handelt, muss ferner das Attribut mode auf "roller" oder "relay" gesetzt werden.

Zur Funktionsweise: Bei dem Betrieb mit diesem Modul ist der Aktor nicht im Stande, irgendwelche Zustandsänderungen von sich aus an FHEM zu melden. Deshalb pollt das Modul im per Attribut einstellbaren Zeitinterval interval den Aktor auf Statusänderungen (Wert 0 => kein Polling). Desweiteren meldet das Modul zwar, ob ein Firmware-Update nötig ist - ausgelöst werden muss dieses aber über die Web-Oberfläche des Aktors selber.

MQTT

Probleme

Im Spätsommer 2018 tauchten verschiedene Shelly-Aktoren mit Qualitätsmängeln auf

Modell	Revision	Batch Id	Problem/Abhilfe
Shelly1	prod-2018-08	2	Keine Probleme bekannt.
Shelly2	prod-2018-07c	4	Keine Probleme bekannt.
Shelly2	prod-2018-10c	5	Verschmutzte Lötstellen bei den Schalteingängen, Gefahr eines Überschlages.
Shelly4Pro	unipos-0717	1	Verdrehte Schalterklemme, funkioniert sonst ohne Probleme.

Auch bei problemfreien Shelly2-Aktoren wird dennoch prophylaktisch empfohlen, die Anschlüsse SW1 und SW2 auf der Platine mit einem zusätzlichen Isolationsmaterial (z.B. Epoxidharz-2-Komponentenkleber) abzusichern, siehe Forum