OSRAM Lightify 4.40 [master]
Das Modul ermöglicht das Ansteuern von OSRAM Lightly Geräten über das interne Netz.
Manche Informationen (eg. Geräte Typ, Software version, …) sowie das Steuern von Szenen sind nur über die OSRAM REST API möglich.
WICHTIG:
Das Modul erfordert Symcon 5.0. Für einen Zugriff auf die REST API ist auch Symcon Connect erforderlich.
Im Modul Control den Zweig auf „master“ stellen.
Für Symcon 4.x den Zweig auf „master-4,0“ stellen. Diese Version wird nicht mehr weiterentwickelt und gewartet.
GitHub - xconsult/SymconLightify: Symcon module for OSRAM lightify products
Hinweis: Standardmäßig wird der Timer zum Abfragen der Daten vom Gateway auf 10s gesetzt. Alle Werte unter 10 erhöhen die Last am Gateway. Minimum ist mit 3s festgelegt.
Gateway configuration
Aktiv: Schnittstelle ein-/aus
Verbindung: Lokal oder Lokal und Cloud
Gateway IP: ip des Ligthtify Gateway
Seriennummer: 11 stellige S/N des OSRAM Gateway (optional und wird nur bei Cloud benötigt)
Aktualisierung [s]: Zeitintervall für den Abgleich mit dem Gateway (default: 10s)
Kategorien: Auswahl der jeweiligen Kategorien in denen die Instanzen erstellt werden. Sync (ja/nein), ob die Daten auch synchronisiert werden sollen.
Registrieren: Registriert den Client und ermöglicht den Zugriff auf die REST API - Symcon Connect erforderlich!
Mit den Lightify Zugangsdaten anmelden und approven.
Erstellen | Aktualisieren: Die am Gateway registrierten Geräte, Gruppen und Szenen werden automatisch angelegt.
Hinweis: Es werden alle aktuellen Geräte unterstützt (Tuneable White, RGBW und Clear, Motion Sensor, Gartenspots, Stripes, Steckdosen), Gruppe und Szenen. Schalter werden nur synchronisiert, können jedoch nicht bedient werden.
Device Instanz
Abhängig von den Fähigkeiten der Geräte werden die entsprechenden Variablen erstellt.
Group Instanz
Unter Geräte werden die Geräte die der Gruppe zugeordnet sind, angezeigt inklusive ein paar Zusatzinformationen.
Die Farbkodierierung (Geräteabhängig) gibt den Status der Geräte an:
Lampen
Weiss: Online
Gelb: eingeschalten (Tuneable White und RBGW)
Hellgelb: eingeschalten (Clear)
Grau: Offline
Steckdosen:
Rot: Online und ausgeschalten
Grün: eingeschalten
Grau: Offline
Funktionen
bool OSR_SetValue(int $InstanceID, string $key, int $value) --> depreciated
bool OSR_WriteValue(int $InstanceID, string $key, int $value)
id: id der Instanz
key: folgende Werte sind zulässig
ALL_DEVICES: Alle Geräte schalten (Value: 1 - ein, 0 - aus)
SAVE: Speichert die aktuellen Werte permanent in der Lampe (Value: 1)
SCENE: Szene schalten (Value: Szenen id)
DEFAULT: Setzt auf Standwerte zurück
SOFT_ON: Fading beim Einschalten (in ms) (Value: 0 - 8000)
SOFT_OFF: Fading beim Ausschalten (in ms) (Value: 0 - 8000)
RELAX: Vordefinierte Szene aus der App (Value: 1)
ACTIVE: Vordefinierte Szene aus der App (Value: 1)
PLANT_LIGHT: Vordefinierte Szene aus der App (Value: 1)
LIGHTIFY_LOOP: Vordefinierte Szene aus der App (Value: 1)
STATE: Gerät schalten (Value: 1 - ein, 0 - aus)
COLOR: Lampen Farbe (Value: HEX Wert als integer eingeben)
COLOR_TEMPERATURE: Farbtemperatur (Value: Werte abhängig vom Lampentyp: 2000 - 6500 in Kelvin)
BRIGHTNESS: Helligkeit (Value: 0 - 100 - 0 schaltet die Lampe aus in Prozent)
LEVEL: siehe BRIGHTNESS
SATURATION: Farbsättigung (Value: 0 - 100 in Prozent)
Rückgabe: true/false
Hinweise:
- ist die Lampe am Netz und ausgeschalten, wird sie beim Verändern eines Wertes automatisch eingeschaltet
- die Variable Hue wird automatisch berechnet.