Einführung LUA Programmierung

Transkript

1 Einführung LUA Programmierung Unterschied Homecenter 2 Homecenter Lite Die Unterschiede zwischen dem Homecenter 2 und Homecenter Lite sind für den Endverbraucher auf den ersten Blick nicht sichtbar. Die Oberfläche, die App und die Bedienelemente sind bei beiden Gateways optisch gleich. Mit beiden Gateways lässt sich zum Beispiel das Licht, die Heizung und Jalousien steuern. Beide Gateways sprechen den Funkstandard Z-Wave und können mit den meisten europäischen Geräten dieses Standards kommunizieren. Einige Ausnahmen wie das Türschloss sind vorhanden, werden aber mit dem Release der Version 4.0 steuerbar sein. Der größte Unterschied zwischen dem Homecenter 2 und Homecenter Lite besteht im Bereich der Automatisierung und Szenensteuerung. Das Homecenter 2 bietet die Möglichkeit Szenen über die offene Programierungsprache LUA durchzuführen. Währ im Homecenter Lite nur die grafisch basierte Szenenerstellung implementiert ist. Abbildung 1: Grafische Szenenerstellung Abbildung 2: Codebasierte Szenenerstellung In den beiden Abbildungen ist eine Szene erstellt, die beim Öffnen des Dachfensters alle Lichter im Raum Büro ausschaltet und eine Nachricht als Mail schickt, die die Information über ein offenes Fenster enthält.

2 In der Abbildung 1 ist die grafische Implementation dieser Anwung abgebildet. Die grafische Szenenerstellung baut sich in Blöcken auf, die einzeln NACHEINANDER hinzugefügt werden können. Verschiedene Module haben verschiedene Funktionen. Jede Funktion eines Modul ist in seinem Block im grünen Bereich auswählbar. Bei Aktoren ist die Funktion, die auszuwählen ist AUS schalten oder EIN schalten. Über das Plus -Symbol können einzelne Module aus den Bereichen und Räumen ausgewählt und hinzugefügt werden. Darüber werden auch die Konnektoren hinzugefügt. Diese beschränken sich in der grafischen Erstellung auf dann, oder und und. Wie schon erwähnt erfolgt die Erstellung einer Szene im grafischen Modul Schritt für Schritt. Das bedeutet, dass nachträgliche Änderungen in schon erstellten Blöcken nicht möglich sind. Es lassen sich über das Hinzufügensymbol zwar weitere Module über Konnektoren einfügen. Allerdings wird das Modul nur in der grafischen Oberfläche hinzugefügt, erhält aber im Programmiercode keine Funktion. In der Abbildung 2 ist dieselbe Szene, wie in der grafischen Szenenerstellung zu erkennen. Allerdings wurde hier die Szene im LUA-Code visualisiert und erstellt. Der LUA Code baut auf einer Syntax von Befehlen an die Module und Operatoren auf. Die Hauptoperatoren sind if else, while, repeat und for. Für die Anwung der Operatoren wird eine gewisse Kenntnis über die Logik dieser Operatoren vorausgesetzt.

3 Im Folgen einige Codebeispiele zu den Operatoren: - if a<0 then a = 0 - if (fibaro.getvalue(111, value ) == 1) then fibaro:call(111, turnoff ) - local i = 1 while (i<250) do fibaro:call(i, turnoff ) i = i repeat line = os.read() until line ~= "" print(line) - for var=exp1,exp2,exp3 do something Für weitere Codebeispiele und Tutorials zum LUA-Code: Das Nutzen dieser Operatoren ermöglicht es, komplexere auf einen ganz bestimmten Anwungsfall zugeschnittene Szenen zu programmieren. Die Möglichkeiten der manuellen Programmierung über den LUA-Code übersteigt die Möglichkeiten der grafischen Programmierung um ein Weites. Ein kurzes Beispiel, soll die Funktionaliät und die Komplexität der LUA Programmierung veranschaulichen. Wir betrachten folgen Anwungsfall: Ein Endverbraucher installiert ein Z-Wave System in seinem Haus und hat das Dachgeschoss komplett ausgestattet. In seinem Dachgeschoss befindet sich sein Arbeitszimmer mit vielen technischen Komponenten. Über die Wetterdaten von Yahoo hält er sich auf dem laufen über die Wettervorhersagen. Bei angekündigtem Regen überprüft er den Status seiner Dachfenster über eine App. Beim Verlassen des Hauses vergisst er manchmal die Dachfenster zu schließen. Wenn Regenwetter bevorsteht, besteht so die Gefahr auf einen enormen Schaden. Lösung: Beim Verlassen des Hauses UND einer Wettervorhersage mit Regen überprüft das Z- Wave System den Status des Dachfensters und warnt den Verbraucher, falls ein Dachfenster offen ist. Falls nur schlechtes Wetter vorhergesagt ist, weißt das Haus den Nutzer per Push-Nachricht oder daraufhin einen Schirm oder regengerechte Kleidung zu tragen.

4 --[[ %% properties 122 value %% globals ]] local FrontDoor = fibaro:getvalue(122, "value") local openwindows = 0; -- wenn Haustüre sich öffnet if (FrontDoor == "1") and (fibaro:getvalue(3, "WeatherConditionConverted") == "rain") then -- wenn Wetter regnerisch ist local Run = 1; -- Schleife für max 259 Geräte while (Run < 260) and (openwindows == 0) do -- wenn Bereich ID des Gerätes Run Dachgeschoss ist if (fibaro:getroomid(run) == 7) and (fibaro:gettype(run) == "door_sensor") then -- wenn Gerät Run Türsensor ist local value = fibaro:getvalue(run, "value") -- wenn Gerät Run offen ist if( value == "1") then openwindows = openwindows + 1; -- welcher Text geschrieben wird local text = "Achtung die Fenster im Dachgeschoss sind nicht alle geschlossen"; fibaro:call(2, "s ", "Fibaro Meldung", text) Run = Run + 1; -- wenn keine Fenster offen sind if(openwindows == 0)then -- se aus panel fibaro:call(2, "sdefined notification", "5"); Folge Funktionen für bestimmte Modulgruppen sind für das erstellen von Szenen wichtig. Über die Funktionen können entweder Statis von Geräten abgefragt werden oder die Geräte zu einer ausführbaren Aktion bestimmt werden. Für Aktoren gibt es folge Aktionen: An oder Ausschalten eines Aktors (z.b. Unterputzrelay) fibaro:call (DeviceID, TurnOFF/ON ) Dimmen oder einstellen einer Jalousie auf gewisse Höhe fibaro:call (DeviceID, SetValue, Value zwischen )

5 Temperatur eines Thermostats einstellen fibaro:call(deviceid, "settargetlevel", Gradzahl ) Gerät aufwecken fibaro:call(1, "wakeupdeaddevice", Geräte-ID) Für Z-Wave Geräte gibt es folge Abfragen: Aktorenstatus (An = 1, Aus = 0) fibaro:getvalue(deviceid, "value") Aktor aktiv im Netz = 0 oder inaktiv = 1 fibaro:getvalue(deviceid, "dead") Parent des Aktors (Welches Gateway dem Aktor angehört) fibaro:getvalue(deviceid, "parentid") Auslesen der Raum-ID eines bestimmten Geräts fibaro:getroomid(deviceid) Auslesen des Gerätetyps (z.b. door_sensor, binary_switch) fibaro:gettype(deviceid) Auslesen des Hersteller eines Geräts (gibt vollständigen Herstellername zurück) Fibaro:getValue(DeviceID, zwavecompany ) Für Sensoren gibt es folge weitere Abfragen: Status ob Sensor scharf geschalten ist nicht scharf = 0, scharf = 1 fibaro:getvalue(deviceid, "armed") Batteriestatus des Sensors in Prozent fibaro:getvalue(deviceid, "batterylevel")

6 Bei Multisensoren die Temperatur abfragen fibaro:getvalue(deviceid, "valuesensor") Einheit der Value (valuesensor) fibaro:getvalue(deviceid, "unitsensor") Aufwachzeit in Sekunden des batteriebetriebenen Geräts fibaro:getvalue(deviceid, "wakeuptime")

7 Beispielliste mit allen Werten, die aus einem Z-Wave Gerät ausgelesen werden können "UIMessageSTime": "0", "batterylownotification": "1", "classconfigure": "0,0,2,0,0,2,0", "classgeneric": "37", "classsupport": "37,39,114,117,130,134,135", "classversion": "1,1,1,1,1,1,1", "dead": "1", "devicecontroltype": "20", "deviceicon": "2", "disabled": "0", " notificationid": "0", " notificationtype": "0", "Point": "0", "isbatteryoperated": "0", "islight": "0", "lilioffcommand": "", "lilioncommand": "", "log": "", "logtemp": "TxtBlue", "needconfigure": "5", "nodeid": "60", "parameterstemplate": "0", "parentid": "1", "pollingretryerror": "0", "pollingtime": "", "pollingtimenext": "", "pollingtimesec": "0", "productinfo": "0,100,48,2,0,0,1,0", "protectionlocal": "0", "protectionlocalsupport": "0", "protectionrf": "0", "protectionrfsupport": "0", "pushnotificationid": "0", "pushnotificationtype": "0", "requestnodeneighborstate": "0", "requestnodeneighborstatetimestemp": "0", "savelogs": "1", "showchildren": "1", "smsnotificationid": "0", "smsnotificationtype": "0", "sortorder": "999", "unit": "", "usetemplate": "1", "userdescription": "", "value": "0", "zwavecompany": "Duwi", "zwaveinfo": "6,2,51", "zwaveversion": "1,0", "parameters": [], "associationview": [], "associationset": [] Um die Eigenschaften/Werte aus der obigen Liste von einem Gerät auslesen zu können muss folge bekannte Funktion in LUA verwet werden: fibaro:getvalue(device-id, Eigenschaft aus obiger Liste ) BSP.: fibaro:getvalue(154, "associationset" )

8 Kontakt: Z Wave Europe GmbH Denis Pätz Goldbachstraße Hohenstein-Ernstthal