Twinkly (Smarte LED Lichterketten)
Ermöglicht die Kommunikation mit den Smart LED Lichterketten Twinkly.
Inhaltverzeichnis
- Funktionsumfang
- Voraussetzungen
- Installation
- Einrichten der Instanzen in IP-Symcon
- Statusvariablen und Profile
- WebFront
- PHP-Befehlsreferenz
- Versionshistorie
1. Funktionsumfang
- Suchen und Erstellen von Twinkly Geräten (Discovery Modul)
- Schalten des LED-Betriebsmodus
- Einstellen der Helligkeit
- Auslesen aller Geräteinformationen
- Auslesen der Firmware Version
2. Voraussetzungen
- IP-Symcon ab Version 5.2
3. Installation
- Über den Modul Store das Modul Twinkly installieren.
- Alternativ Über das Modul-Control folgende URL hinzufügen.
https://github.com/Wilkware/IPSymconTwinkly
odergit://github.com/Wilkware/IPSymconTwinkly.git
4. Einrichten der Instanzen in IP-Symcon
Twinkly Discovery
Die Gerätesuche ist über die Glocke oben rechts in der Konsole aufrufbar. Dort über "SYSTEM AUSWÄHLEN" kann das
‚Twinkly Discovery‚-Modul ausgewählt und installiert werden.
Twinkly Device
Unter "Instanz hinzufügen" ist das ‚Twinkly Device‘-Modul (Alias: Smart LED Lichterkette) unter dem Hersteller ‚Ledworks‘ aufgeführt.
Konfigurationsseite:
Wird das Gerät direkt über die Gerätesuche(Discovery) erstellt, sind keine weiteren Konfigurationen notwendig. Die IP-Adresse des Gerätes wird automatisch hinterlegt. Werden Twinkly Geräte manuell angelegt, ist die entsprechende IP-Adresse einzutragen.
Name | Beschreibung |
---|---|
Geräte IP | IP-Adresse der Lichterkette |
Zusätzlicher Lichtschalter | Zusätzlicher Schalter für einfaches An/Aus |
Über die Schaltflächen "HELLIGKEIT" kann die aktuelle Helligkeit syncronisiert werden (z.B. wenn von App eingestellt wurde). Über die Schaltflächen "FIRMWARE" kann die Version des Gerätes ausgelesen und angezeigt werden. Gleiches gilt für die Gerätedaten über die Schaltfläche "GERÄTEINFOS".
5. Statusvariablen und Profile
Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
Name | Typ | Beschreibung |
---|---|---|
Modus | Integer | LED-Betriebsmodus |
Brightness | Integer | Helligkeitswert |
(Switch) | Integer | Schalter (An/Aus) |
Folgendes Profil wird angelegt:
Name | Typ | Beschreibung |
---|---|---|
Twinkly.Mode | Integer | LED-Betriebsmodus (0=Aus, 1=An, 2=Demo, 3=Echtzeit) |
Twinkly.Switch | Integer | LED-Betriebsmodus (0=Aus, 1=An) |
Aus(off) – schaltet Licht aus
An(movie) – spielt vordefinierten oder hochgeladenen Effekt ab
Demo(demo) – startet eine vordefinierte Sequenz von Effekten, die nach wenigen Sekunden geändert werden
Echtzeit(rt) – Effekt in Echtzeit erhalten
6. WebFront
Die pro Twinkly Gerät erzeugten Variablen Modus, Helligkeit und Schalter können direkt ins Webfront verlingt werden.
7. PHP-Befehlsreferenz
void TWICKLY_Brightness(int $InstanzID);
Liest die aktuell am Gerät hinterlegten Helligkeitswert aus.
Die Funktion liefert als Rückgabewert einen String (Helligkeit: xy%).
Beispiel: TWICKLY_Brightness(12345);
Ausgabe "Helligkeit: 100%".
void TWICKLY_Gestalt(int $InstanzID);
Liest alle Geräteinformationen aus.
Die Funktion liefert als Rückgabewert einen (sprintf) formatierten String.
Beispiel: TWICKLY_Gestalt(12345);
Product name: Twinkly
Hardware Version: 100
Bytes per LED: 3
Hardware ID: ab01cd
Flash Size: 64
LED Type: 14
Product Code: TWS250STP-B
Firmware Family: F
Device Name: Weihnachtsbaum
Uptime: 239317051
MAC: 12:34:56:ba:dc:fe
UUID: 12345678-bacd-1234-abcd-1234567890ab
Max supported LED: 1020
Number of LED: 250
LED Profile: RGB
Frame Rate: 23,810000
Movie Capacity: 992
Copyright: LEDWORKS 2018
void TWICKLY_Version(int $InstanzID);
Liest die installierte Firmwareversion des Gerätes aus.
Die Funktion liefert als Rückgabewert einen String (Firmware: x.yy.zz).
Beispiel: TWICKLY_Version(12345);
Ausgabe "Firmware: 2.4.16".
8. Versionshistorie
v2.0.20201016
- NEU: Steuerung bzw. Einstellung der Helligkeit
- NEU: Vereinfachte Modusschaltung als normaler Lichtschalter
- NEU: Fehlerbehandlung wenn keine Verbindung zum Gerät hergestellt werden kann
- FIX: Debugausgabe überarbeitet
- FIX: API erweitert und überarbeitet
v1.0.20200501
- NEU: Initialversion
v1.1.20200510
- FIX: Bugfix Discovery Modul
v1.0.20200501
- NEU: Initialversion
Entwickler
- Heiko Wilknitz (@wilkware)
Spenden
Die Software ist für die nicht kommzerielle Nutzung kostenlos, Schenkungen als Unterstützung für den Entwickler bitte hier: