Shelly Door/Window in Homematic einbinden - mit der Originalfirmware ab V1.6.3

©2020 Stefan K. (alias 66er) - alle Rechte vorbehalten

ausführlicher Hinweis dazu am Ende der Anleitung

#1 Vorwort und Einleitung

#2 Geräte und Variablen anlegen

#3 Datenübernahme in Homematic

Vorwort:

Hallo zusammen.

wie Ihr ja aus dem Hinweis-Thread bereits wisst, ist die ursprüngliche Homematic-Kopplung des Shells D/W ab der Firmware 1.6.3 nicht mehr lauffähig.

Die neue Kopplung ist noch nicht komplett fertiggestellt. Ich publiziere sie aber schon jetzt, um Usern, die den D/W nutzen und das Update schon gemacht haben, die Grundfunktion wieder zur Verfügung steht.

An bestehenden Kopplungen bedarf es nur wenige Änderungen, auf die ich in dieser Anleitung expliziet hinweisen werde.(Achtet bitte auf die Textfarbe) Ihr müßt beim Umstieg nicht alles neu machen.

Unterschied und Auswirkung(en):

Die in der Ursprungskopplung genutze Einstellung "Report Sensor Values" steht in der Version 1.6.3 nicht mehr zur Verfügung.

Somit fehlt der Trigger, der zum Aktualisieren aller Werte genutzt wurde.

Die Werteabfrage wir nun mittels der vorhandenen Actions getriggert. Das hat aber zur Folge, das aktuell eine Änderung der Helligkeit (Lux) nicht mehr als Trigger zur Verfügung steht und somit eine Beschattungsfunktion zum Beispiel nicht mehr mit dem D/W und der aktuellen Firmware in Homematic zu realisieren ist.

Wer die Lux-Werte als Trigger benötigt sollte aktuell nicht updaten, sondern mit der alten Kopplung und Firmware weiterarbeiten.

Und jetzt geht es los:

Um den Shelly Door/Window in Homematic einzubinden, braucht es keine Fremdfirmware, die man flashen muß.

Nachfolgend meine Lösung mit der Originalfirmware:

techn. Voraussetzungen:

• kompatibel mit den Homematic-Systemen CCU2, CCU3, Charly, sowie allen Ablegern wie RaspberryMatic und piVCCU. (Nicht kompatibel zu Homematic-Accesspoint!)

• 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.)

DIe Vorteile aus meiner Sicht:

• günstigerer Preis als das Homematic-Original
• mehr Eigenschaften nutzbar
• alle Shelly Door/Window-Eigenschaften bleiben erhalten, da ich die Aktoren mit der originalen Herstellerfirmware betreibe
• alle zukünftigen Shelly Door/Window -Aktualisierungen/ -updates werden nutzbar sein
• Volle Shelly-App-Bedienbarkeit parallel zur Homematic-Automatisierung
• Betrieb als lokale Lösung oder über Shelly-Cloud, zusätzlich Homematic

Folgende Funktionen habe ich bis jetzt auf der Homematic-Seite umgesetzt:

• Zustandsanzeige des Magnetkontaktes (Auf / Zu)
• Aktualisierung der integrierten Werte bei jeder Übertragung (Batteriezustand, Helligkeit) (Neue Werte wie Neigung und Vibration sind aktuell noch nicht auf Homematic umgesetzt!)
• Optionale Ausfallüberwachung und bei Ausfall z.B. eMailversand. (Anmerkung: Da nur noch auf Ereignisse getriggert werden kann, macht die Überwachung des Kontaktes nur Sinn, wenn das zu überwachende Element regelmäßig geöffnet und geschlossen wird.)

Die Ansicht der Anbindung:

(Welche Variablen Ihr nutzt, wird ab Skriptversion 3.1.3 im Skript frei parametriert)

Ich möchte Euch, insbesondere Einsteigern, an dieser Stelle empfehlen, vor der Umsetzung mal einen Blick in diese Threads zu werfen:

• Wichtige Hinweise zu den Shelly-Kopplungen an Homematic
  
• Präventiv-Hinweis für Homematic-User mit Firmware >=3.47.15
• Shelly mit aktiviertem Restrict-Login & Homematic-Kopplung

Bitte arbeitet beim Nachbauen die Anleitung sorgfältig von oben nach unten ab.

Es gilt ansonsten wie immer:
Falls noch nicht vorhanden, bitte ein Gerät (28) System Exec anlegen! Darüber werden die Befehle abgesetzt. (Im CUxD-Exec werden keine Eintragungen gemacht!)

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

Viel Spass und viel Erfolg damit.

____________________________________________________________

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).

© 2019-2020 Stefan K. (alias 66er)

Alle Rechte vorbehalten

#1 Vorwort und Einleitung

#2 Geräte und Variablen anlegen

#3 Datenübernahme in Homematic

Geräte und Variablen anlegen:

Wir legen in CUxD eine 16-Kanal Universalsteuerung an:

Damit können maximal 16 Shelly Door/Window in Homematic abgebildet werden. Je Shelly Door/Window brauchen wir 1 Kanal.

Mit dem Kanal werden die in der Ansicht gewünschten Systemvariablen verknüpft (siehe Bild in #1) damit sie im Kanal sichtbar werden.

Diese Systemvariablen werden angelegt:

Die Variablennamen können natürlich frei und individuell angepasst werden. Sie dürfen keine Umlaute und keine Leerzeichen enthalten!

(Für die neuen Funktionen des Shelly D/W werden später weitere benötigt)

Optionale Überwachung des Shelly:

Für die Überwachung benötigen wir noch einen CUxD-Timer-Kanal eines vorhandenen oder neu anzulegenden CUxD-Timers:

SYSTEM|CMD_EXEC:

Code

extra/timer.tcl Shelly-MK_Ausfall_Wefi 0

Name der Systemvariablen anpassen! (hier: Shelly-MK_Ausfall_Wefi)

Die Zeitangabe ist variabel und muß an die zu erwartenden Schaltintervalle angepasst werden.

Die Variable könnt Ihr nun nutzen, um z.B. eine Info-Mail anzustossen, Läuft der Timer ab weil sich der Shelly nicht meldet, wird die Variable gesetzt.

____________________________________________________________

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).

© 2019-2020 Stefan K. (alias 66er)

Alle Rechte vorbehalten

#1 Vorwort und Einleitung

#2 Geräte und Variablen anlegen

#3 Datenübernahme in Homematic

Datenübernahme:

Da auch der Shelly Door/Window batteriebetrieben ist, ist er nur beim Senden online.

Damit Homematic den Sendezeitpunkt mitbekommt und entsprechend die Daten aktualisieren kann, arbeiten wir in der neuen Version mit den Actions als Trigger für die Aktualisierung.

Die Einträge:

In den folgenden Einträgen die IP der CCU und die Adresse des CUxD-Gerätekanals für den Shelly D/W anpassen!

OPEN WHEN DARK

http://192.168.1.93:8181/66er.exe?Antwort=dom.GetObject("CUxD.CUX4000012:1.SET_STATE").State(1)

OPEN WHEN TWILIGHT

http://192.168.1.93:8181/66er.exe?Antwort=dom.GetObject("CUxD.CUX4000012:1.SET_STATE").State(1)

CLOSE

http://192.168.1.93:8181/66er.exe?Antwort=dom.GetObject("CUxD.CUX4000012:1.SET_STATE").State(0)

Damit wir der CUxD-Schalter für OFFEN und GESCHLOSSEN des Kontaktes aktualisiert.

Damit nun auch die Werte für Batterie, Lux und ggf. die Überwachung des Shelly aktualisiert werden, benötigen wir 1 Programm:

(Umsteiger der alten Kopplung müssen Ihr Programm anpassen:)

Hinweis:

Wer auf die Überwachung des Shelly D/W verzichtet braucht nur die 2. DANN-Zeile! Zeile 1 und 3 entfallen.

Nun fehlt noch das Skript der 2. DANN-Zeile:

(Ab Version V3.1.3 bitte Hinweise zum Skript in Beitrag # 5 beachten!)

!Skript V3.1.5 zur Statusaktualisierung ShellyDoor Window mit Originalfirmware (c) 2020 by 66er  (alias Stefan.K)
! Publiziert und Updates auf https://shelly-forum.com/forum/index.php?board/145-homematic/
!Versionsdatum: 09.12.21
! für Shelly D/W ab Firmware 1.6.x mit Kippwinkel und Vibrationsalarm, NEZ: Variablen einzeln aktivierbar, ob vorhanden
!Raumbezeichnung WZ    Raum  (kann angepasst werden)


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

! Setup der CUxD-GERÄTE
var url = "http://192.168.1.148/status"; !  IP-Adresse des Shelly Door Window anpassen 
var exec = "CUxD.CUX2801001:13";   ! Adresse und Kanal des CUxD-Exec-Device angeben
var shelly =  "CUxD.CUX4000012:1" ;  ! Adresse und Kanal des CUxD-Device für den Shelly D/W anpassen


!Setup der SYSTEMVARIABLEN
var mkbat = "Shelly-MK_Batt_WeFi";  ! Name der Systemvariablen anpassen, "" bleiben stehen
var mklux = "Shelly-MK_Helligkeit_WeFi"; !Name der Systemvariablen anpassen, "" bleiben stehen
var mktil = "Shelly-MK_Kippwinkel_WeFi"; !Name der Systemvariablen anpassen, "" bleiben stehen
var mkvib = "Shelly-MK_Vib_WeFi"; !Name der Systemvariablen anpassen, "" bleiben stehen

!Setup der aktiven Variablen
!Wer nicht alle Variablen umsetzt, muß diese hier auf "0" setzen
var amktilt = "1"; ! Kippwinkel auswerten, mögliche Werte: 0 für Nein oder 1 für Ja
var amkvib = "1"; ! Vibrationsalarm auswerten, mögliche Werte: 0 für Nein oder 1 für Ja
var amklux = "1"; ! Helligkeit auswerten, mögliche Werte: 0 für Nein oder 1 für Ja
var amkbat = "1"; ! Batterie auswerten, mögliche Werte: 0 für Nein oder 1 für Ja

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


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

dom.GetObject(""#exec#".CMD_SETS").State("wget -q -O - '"#url#"'");
dom.GetObject(""#exec#".CMD_QUERY_RET").State(1);
string Antwort = dom.GetObject(""#exec#".CMD_RETS").State();
dom.GetObject(""#exec#".CMD_SETS").State("0");  
!WriteLine(Antwort);
string t = (Antwort);
!WriteLine(t)


!***Auswertung MK ****
string word = "state";
integer word_laenge = word.Length();
integer word_position = Antwort.Find(word);
string daten = Antwort.Substr((word_position + word_laenge +3), 4);
integer word_position = daten.Find(word);
daten = daten.Substr(0, (word_position -3));
Antwort = "true";
!WriteLine(daten);


!Auswertung MK
var zustand = dom.GetObject(""#shelly#".STATE").State();
!WriteLine(zustand);
if ((daten == "clos") && (zustand != false) )
{dom.GetObject(""#shelly#".SET_STATE").State(0);
!WriteLine("if ON");
}
if ((daten == "open") && (zustand != true))
{dom.GetObject(""#shelly#".SET_STATE").State(1);
!WriteLine("if off");
}


!****Auswertung des Antwortstrings für Batt  ****
string s;
foreach (s,t.Split (",")) {
   if (s.LTrim ("{").StartsWith ('"bat"')) {
   string bat =  (s.StrValueByIndex (":",2).RTrim ("}"));
!  WriteLine(bat);
   }
}  


!**** Variable setzen****
if ((amkbat) == 1 ) {dom.GetObject(""#mkbat#"").State(bat);}



!****Auswertung des Antwortstrings für Lux  ****

string s;
foreach (s,t.Split (",")) {
   if (s.LTrim ("{").StartsWith ('"lux"')) {
   string lux =  (s.StrValueByIndex (":",2).RTrim ("}"));
!  WriteLine(lux);
   }
}  



!**** Variable setzen****
if ((amklux) == 1 ) {dom.GetObject(""#mklux#"").State(lux);}


!****Auswertung des Antwortstrings für Kippwinkel ****
string output = t;
!WriteLine(output);
string part; string code;string slist;integer collect = -1;
foreach (part, output.Split(",")){
collect = part.Find("accel");
if (collect>-1){
code = ((part.StrValueByIndex(",",0)).StrValueByIndex(":",2));
code = code.Substr(0, code.Length());
slist = slist#code#"/";
}}

!WriteLine(slist);
var tilt = slist.StrValueByIndex("/", 0);
!WriteLine(tilt);
real tr = tilt.ToFloat();
!WriteLine(tr);


!**** Variable setzen****
if ((amktilt) == 1 ) {dom.GetObject(""#mktil#"").State(tr);}


!Auswertung Virbrationsalarm
string word = "vibration";
integer word_laenge = word.Length();
integer word_position = t.Find(word);
string daten = t.Substr((word_position + word_laenge +2), 1);
integer word_position = daten.Find(word);
vib = daten.Substr(0, (word_position -3));
!Antwort = "true";
WriteLine(daten);

!Variable setzen
if ((amkvib) == 1 ) {dom.GetObject(""#mkvib#"").State(vib);}


daten = "0";


!Ende Skript

Nun führt jedes Öffnen oder Schließen des Kontaktes zur einer Aktualisierung aller (bisher vorhandenen) Werte.

____________________________________________________________

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).

©2020 Stefan K. (alias 66er)

Alle Rechte vorbehalten

Neigung und Vibration:

Um die neuen Feature an 1.6.3 nutzen zu können, benötigen wir zusätzliche Systemvariablen:

In den Shelly-Einstellungen wird die bisher nicht genutzte Action aktiviert:

Code:

http://192.168.1.93:8181/x.exe?Antwort=dom.GetObject("Shelly-MK_Vib_WeFi").State(1)

IP-Adresse der CCU und Name der Systemvariablen anpassen!

Durch diesen Action-Eintrag wird die zugehörige Variable bei Erschütterung auf Alarm gesetzt.

Nun haben wir die neuen Features bzw. die Werte in der Homematic verfügbar, sobald Ihr noch das neue Skript (ab Version 3.1.3) aus Beitrag #3 übernommen und eingerichtet habt.

Viel Spass damit.

Bitte beachtet auch die Hinweise im Beitrag # 5

____________________________________________________________

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).

© 2019-2020 Stefan K. (alias 66er)

Alle Rechte vorbehalten

____________________________________________________________

Dir gefällt die Anleitung? Du möchtest den dahinterstehenden Aufwand mit einem kleinen "Danke" honorieren?

Ich freue mich über jedes Danke  Paypal (Geld an einen Freund senden): der-66er@web.de

Vielen Dank.

Neue Skriptversion V3.1.3 veröffentlicht.

In der neuen Skriptversion sind auch die Werte für Neigungswinkel und Vibrationsalarm enthalten.

Ferner kann jetzt für jede einzelne Variable festgelegt werden, ob man sie nutzt oder nicht. Nichtgenutzte Feature (=Variable) müssen dann nicht als Variable in Homematic angelegt werden.

Zur Erinnerung: Lux kann leider kein Programm triggern.

Viel Spass damit.