ShellyPlusPlugS goes Homematic - mit der Originalfirmware

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

Getestet auf ShellyPlus PlugS-Firmware:

0.14.1

Hallo liebe Homematic-Freunde.

Heute geht es um die Einbindung des ShellyPlus PlugS.

Das Ganze funktioniert natürlich wie immer ohne Fremdfirmware.

Die Kopplung hat folgende Möglichkeiten:

• Ein- und Ausschalten des Schaltkanals inkl. Rückmeldung, wenn über die App oder per sonstigem System (z.B. ioBroker) geschaltet wird

• Überwachung des Onlinestatus, kein CUxD-Ping-Device nötig, optional

• Alle notwendigen Systemvariablen werden automatisiert erstellt und dem passenden Schaltkanal zugeordnet, daher sehr leicht einzurichten

• Anzeige der Leistung pro Kanal, optional

• zykl. Aktualisierung, optional

Das Ganze sieht dann im maximalen Endausbau so aus:

techn. Voraussetzungen:

• kompatibel mit den Homematic-Systemen CCU2, CCU3, Charly, sowie allen Ablegern wie RaspberryMatic und piVCCU.

• installiertes Addon CUxD in aktueller Version

  (Das Wissen um den Umgang CUxD, wie z.B. Geräte anlegen, setze ich an dieser Stelle voraus, sonst "explodiert" diese Anleitung. Danke für's Verständnis.)

Ich möchte Euch an dieser Stelle empfehlen, vor der Umsetzung mal einen Blick in diesen Thread zu werfen:

• Wichtige Hinweise zu den Shelly-Kopplungen an Homematic

(Auch die übrigen angepinnten Themen sind übrigens zum Lesen empfohlen, gerade auch für Neueinsteiger )

Und nun geht's los.

__________________________________________________________________________________

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

Falls noch nicht vorhanden, bitte ein Gerät (28) System Exec anlegen! Darüber werden die Befehle abgesetzt.

Hier gibt es bei Bedarf eine Anleitung zum Anlegen des CuxD-Exec-Gerätes.

(Im CUxD-Exec selbst werden keine Eintragungen gemacht!) 

Das CUxD-Gerät für den ShellyPlus PlugS anlegen:

Den "virtuellen" ShellyPlus PlugSlegen wir in CUxD gemäß dem nachfolgenden Bild an:

Mit 1 angelegter Universalsteuerung können max. 16 ShellyPlus PlugS abgebildet werden, denn je 1 ShellyPlus PlugS benötigen wir 1 Kanal der Universalsteuerung.

(Natürlich kann auch 1 Kanal eines bestehenden, passenden CuxD-Device genutzt werden.)

Ein- und Ausschalten:

Um den Kanal des ShellyPlus PlugS via unserem gerade angelegt CUxD-Device zu schalten müssen nun noch 1 Haken gesetzt und 2 Eintragungen gemacht werden:

1.) Haken setzen bei "SWITCH|CMD_EXEC"

2.) Eintrag für "SWITCHCMD_SHORT":

wget -q -O - 'http://192.168.1.197/rpc/Switch.Set?id~3d0~26on~3dfalse'

3.) Eintrag für "SWITCHCMD_LONG":

wget -q -O - 'http://192.168.1.197/rpc/Switch.Set?id~3d0~26on~3dtrue'

Das Ganze sollte also jetzt so aussehen:

Damit funktioniert schon mal das EIN- und AUS-Schalten .

_________________________________________________________________________________

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

Rückmeldung des Schaltzustandes:

Damit der Status des Schaltkanals auch stimmt, wenn am Shelly oder per App, Web-UI oder sonstigem System (z.B. ioBroker) geschaltet wird, bedienen wir uns der ACTIONS im Shelly.

Diese müssen (am Besten über das Web-UI) im Shelly eingerichtet werden:

Nach "Klick" auf „Actions“ im UI könnt Ihr die Webhooks erstellen.

2 werden benötigt, einer für AUS und einer für EIN:

Action für EIN:

der Code:

http://192.168.1.95:8181/66er.exe?Antwort=dom.GetObject(%22CUxD.CUX4000001:1.SET_STATE%22).State(1)

IP der CCU und CUxD-Kanaladresse anpassen!

Action für AUS:

der Code:

http://192.168.1.95:8181/66er.exe?Antwort=dom.GetObject(%22CUxD.CUX4000001:1.SET_STATE%22).State(0)

IP der CCU und CUxD-Kanaladresse anpassen!

Nun wird auch schon der Status aktualisiert, wenn von außerhalb der CCU geschaltet wird.

__________________________________________________________________________________

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

Werte-Aktualisierung:

1. optionale Aktualisierung des Online-Status

Um den Onlinestatus anzuzeigen muß nur im Setup des unten folgenden Skript die Option auf „J“ gesetzt sein. Dadurch wird die Variable autom. erstellt und dem Kanal zugeordnet. „N“ deaktiviert diese Option.

2. Programm

Um nun zum guten Schluß noch die Werte (Leistung und optional den Onlinestatus) in die entsprechenden Systemvariablen / Kanäle zu bekommen, muß ein Programm angelegt werden, das die Werte zyklisch vom Shelly abfragt.

Zusätzlich kann durch Aktivieren der Schaltstatusaktualisierung im Skript ergänzend im Programmablauf auch der aktuelle Schaltstatus abgefragt und dadurch in Homematic ggf. korrigiert werden.

Ob man im WENN die interne Zeitsteuerung nutzt oder einen CUxD-Timerkanal als Trigger nutzt, kann man dabei frei entscheiden.

(In meinem Beispiel wurde das interne Zeitmodul genutzt.)

(Die Verzögerung im DANN ist wichtig, damit der Shelly einen plausiblen Messwert nach dem Schaltvorgang zurückliefert. Durch die 2. und 3. WENN Zeile erfolgt eine direkte Aktualisierung des Leistungswertes nach einem Schaltvorgang, auch bei langem Intervall )

Einstellungen im Zeitmodul:

Das Aktualisierungsintervall kann natürlich angepasst werden, wobei zu beachten ist:

Je kürzer das Intervall desto höher die Systembelastung für die Homematic-Zentrale. Hier muß / kann man testen. Ab wann die Performance leidet hängt natürlich zum Einen von der eingesetzten Hardware und zum Anderen vom Umfang der Installation ab.

Da ich auch den Schaltzustand als Trigger im Programm hinzugefügt habe wird auch bei länger eingestelltem Intervall direkt aktualisiert.

__________________________________________________________________________________

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

©2023 Stefan K. (alias 66er) - ausführlicher Hinweis dazu am Ende der Anleitung

Alle Rechte vorbehalten!

2. Das Skript

Bitte den Bereich "Setup" anpassen und Hinweise beachten!

Ausserhalb des Setup sind keine Änderungen oder Eintragungen nötig!

! Skript V1.0.1 zur Statusaktualisierung ShellyPlusPlugS mit Originalfirmware (c)2023-2024 by 66er (alias Stefan K.)
! Publiziert und Updates auf https://shelly-forum.com/forum/index.php?board/145-homematic/
! entwickelt und getestet auf ShellyPlusPlugS-Firmware  0.14.1
! Versionsdatum:01.04.2024  : 
! automatische Homematic-SV-Erstellung inkl Kanalzuordnung, Onlinestatus-Prüfung integriert (optional)


! BITTE BEACHTEN:
! Dieses Skript legt ggf. selbstständig zusätzliche Systemvariablen auf Deiner Homematic-Zentrale an!
! Das vermeidet Inkonsistenzen und eine temporäre Blockade der CCU durch das Skript.
! Ausserdem erspart es Dir das manuelle Anlegen benötigter Systemvariablen.
! Wer das nicht möchte, kann dieses Skript leider nicht nutzen!

! Die Nutzung des Skriptes erfolgt auf eigenes Risiko.
! Aus der Nutzung entsteht kein Rechtsanspruch auf Suppport oder Fehlerbeseitigung durch den Autor.
! Der Autor haftet nicht für eventuelle Folgen der Nutzung auf der Homematic-Zentrale des Nutzers.

! Das Skript ist ausführlich getestet und sollte problemlos funktionieren.



!Raumbezeichnung: Test-BT  (kann angepasst werden)


!**** SETUP ******** SETUP ******** SETUP ******** SETUP ***

! ACHTUNG: Beim Anpassen der Adressen keine "" löschen!

! Setup ShellyPlus PlugS
var shp1ip = "192.168.1.197"      ;           ! IP des ShellyPlus1PM anpassen
var shp1name = "PlusPlugS_BT-Test" ;         ! CUxD-Gerätenamen anpassen (daraus werden ggf. automatisch weitere Variablennamen erzeugt

! Setup der CUxD-GERÄTE
var execshp1 = "CUxD.CUX2801001:1";          ! Adresse und Kanal des CUxD-Exec-Device angeben
var shp1cuxd =  "CUxD.CUX4000010:2" ;        ! Adresse des CUxD-Device für den ShellyPlusPlugS anpassen


! Setup Online-Status
var shp1onl = "J"                 ;           ! Variable für Onlinezustandsüberwachung, falls nicht gewünscht, auf "N" setzen""


! Setup Aktualisierungs- und Anzeigeumfang
var shp1a = "J"                ;              ! Schaltstatus aktualisieren, wenn nicht gewünscht auf "N" setzen
var shpl1p = "J"               ;              ! Verbrauch aktualisieren, wenn nicht gewünscht auf "N" setzen

!****ENDE SETUP ********ENDE SETUP ********ENDE SETUP ******

!*****Ab hier NICHTS MEHR ÄNDERN *****



!  *** Variable für Leistung prüfen, ggf. anlegen

if (shpl1p == "J" ) {

var shpl1pk1 =  shp1name + "_Leistung" ;
!WriteLine(shpl1pk1) ;

 string sName= ""#shpl1pk1#"";
if (!dom.GetObject (ID_SYSTEM_VARIABLES).Get (sName)) {
  object svObj = dom.CreateObject(OT_VARDP,sName);
  svObj.DPInfo("autom. angelegt durch Skript ShellyPlus1PM");
  svObj.ValueUnit("W");
  dom.GetObject (ID_SYSTEM_VARIABLES).Add(svObj);
  svObj.ValueType(ivtFloat);
  svObj.ValueSubType(istGeneric);
  svObj.ValueMin(0);
  svObj.ValueMax(3800);
  svObj.State (0);!SCNR = SHPPS10066R
  dom.RTUpdate(0);


object oChan= channels.Get (""#shp1name#"");
object oSys=dom.GetObject (ID_SYSTEM_VARIABLES).Get (""#shpl1pk1#"");
oChan.DPs().Add (oSys);
oSys.Channel (oChan.ID() );
}
}


! Variable für Onlinestatus prüfen,ggf.anlegen

if (shp1onl == "J")  {

var shp1onln = "Online-Status_" + shp1name ;
!WriteLine(shp1onln) ;

string sName= ""#shp1onln#"";  ! Onlinestatus
if (!dom.GetObject (ID_SYSTEM_VARIABLES).Get (sName)) {
  object svObj = dom.CreateObject(OT_VARDP,sName);
  svObj.DPInfo("autom. angelegt durch Skript ShellyPlus1PM");
  svObj.ValueUnit("");
  dom.GetObject (ID_SYSTEM_VARIABLES).Add(svObj);
  svObj.ValueType(ivtBinary);
  svObj.ValueSubType(istBool);
  svObj.ValueName0("Offline");
  svObj.ValueName1("Online");
  svObj.State(true);!SCR = SHPPS10166R
  dom.RTUpdate(0);


object oChan= channels.Get (""#shp1name#"");
object oSys=dom.GetObject (ID_SYSTEM_VARIABLES).Get (""#shp1onln#"");
oChan.DPs().Add (oSys);
oSys.Channel (oChan.ID() );
}
}


! Onlineabfrage und setzen des Status
string stderr;
string stdout;
integer Status;
system.Exec("ping -c 1 '"#shp1ip#"'", &stdout, &stderr);
Status = stdout.Find("ms");
WriteLine(Status);


if (((shp1onl ) == "J" ) && ((Status) == -1)) {
WriteLine("ShellyPlus1PM ist offline");
dom.GetObject (""#shp1onln#"").State(0);
quit; ! Programmabbruch bei Shelly offline
                                              }

if ((shp1onl ) == "J" ) {
dom.GetObject (""#shp1onln#"").State(1);
WriteLine("ShellyPlus1PM ist online"); 
                 }


! Statusabfrage

var url = shp1ip + "/rpc/switch.GetStatus?id=0";
WriteLine(url);

                          

!****Abfrage des ShellyPlusPlugS *****
WriteLine("Abfrage startet");
dom.GetObject(""#execshp1#".CMD_SETS").State("wget -q -O - '"#url#"'");
dom.GetObject(""#execshp1#".CMD_QUERY_RET").State(1);
string Antwort = dom.GetObject(""#execshp1#".CMD_RETS").State();
dom.GetObject(""#execshp1 #".CMD_SETS").State("0");
WriteLine(Antwort);

string output = Antwort;

string part; string code;string slist;integer collect = -1;
foreach (part,output.Split("switch:0")){
collect = part.Find("output");
if (collect>-1){
code = ((part.StrValueByIndex(",",1)).StrValueByIndex(":",1));
code = code.Substr(0, code.Length()-0);
slist = slist#code#"/";
}}

!WriteLine(slist);

var out = slist.StrValueByIndex("/", 0);
!WriteLine(out);

if (out == "true") {
dom.GetObject(""#shp1cuxd#".SET_STATE").State(1);
WriteLine("Zustand EIN festgestellt");
                            }

if (out != "true") {
WriteLine("Zustand AUS festgestellt");
dom.GetObject(""#shp1cuxd#".SET_STATE").State(0);
dom.GetObject(""#shpl1pk1#"").State(0);
WriteLine("Programm beendet, Shelly ist ausgeschaltet!");
quit;
        }


! ***Auswertung Leistung
string output = Antwort;


!Testantwort ! FOLGEZEILE MUSS auskommentiert sein, wenn String vorhanden


string part; string code;string slist;integer collect = -1;
foreach (part, output.Split("switch0")){
collect = part.Find("apower");
if (collect>-1){
code = ((part.StrValueByIndex(",",2)).StrValueByIndex(":",1));
code = code.Substr(0, code.Length()-0);
slist = slist#code#"/";
}}

WriteLine(slist);

var lpk1 = slist.StrValueByIndex("/", 0);

if (shpl1p == "J")  {
dom.GetObject(""#shpl1pk1#"").State(lpk1);
}

WriteLine("Skript ShellyPlusPlugS V1.0.0 beendet");

!ENDE SKRIPT

Bitte beachten:

Der unter "shp1name" eingetragene Name und der Name des Schaltkanals in der CUxD-Universalsteurung müssen identisch sein!

Viel Spass damit.

Changelog:

V1.0.0 | 18.03.2023

Erstveröffentlichung

____________________________________________________________

Die Anleitung inkl. der Skripte und Bilder unterliegt dem Urheberrecht. Wer gegen das Urheberrecht verstößt (z.B. Bilder oder Texte unerlaubt kopiert und auf anderen Webseiten publiziert), macht sich gem. §§ 106 ff UrhG strafbar, kann zudem kostenpflichtig abgemahnt werden und muss Schadensersatz leisten (§ 97 UrhG).

© 2023 Stefan K. (alias 66er)

Alle Rechte vorbehalten

________ ____________________________________________________