Twinkly

Twinkly
Zweck / Funktion
Steuern von Twinkly Lichtern
Allgemein
Typ	Inoffiziell
Details
Dokumentation	Thema
Support (Forum)	Sonstige Systeme
Modulname	31_Twinkly.pm
Ersteller	t1me2die (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Beschreibung

Das Modul Twinkly ermöglicht es, Lichter der Marke Twinkly zu steuern.

Die jeweils aktuelle Version des Moduls steht im ersten Beitrag des Forenthemas Modul 31_Twinkly.pm - Control Twinkly Lights und in Github unter https://github.com/t1me2die/31_Twinkly.pm/blob/main/31_Twinkly.pm zur Verfügung.

Nachdem ihr das Modul ins passende FHEM Verzeichnis (/opt/fhem/FHEM) gepackt habt, achtet auf eine korrekte Berechtigung und führt in FHEM ein

reload 31_Twinkly.pm

Unterstützte Geräte

• Strings GoldEdition (AWW auch genannt)
• Strings RGBW Edition
• Spritzer (RGB)
• Cluster (RGB)
• Festoon (RGB)

Voraussetzung zur Verwendung des Modules

Auf dem FHEM System werden folgende Perl Module benötigt, die per cpan im vorwege installiert werden müssen.

• HttpUtils
• Time::Piece
• Color
• List
• JSON

Definition

define <name> Twinkly <IP-Adresse / Hostname>

Beispiel:

define Weihnachtskaktus Twinkly 192.168.178.100oder define Weihnachtskaktus Twinkly Weihnachtskaktus.fritz.box

Diese Anweisung erstellt ein Twinkly Device mit dem Namen Weihnachtskaktus und der IP-Adresse 192.168.178.100 / Hostname Weihnachtskaktus.fritz.box.

Anschließend gebt dem Modul bitte 1-2 Minuten um die notwendigen Informationen auszulesen.

Zuerst wird ein TOKEN vom Twinkly Device angefordert, womit man sich authentifizieren muss (expire after ~4h).

Es werden interne Geräteinformationen in den Readings abgelegt.

Es wird versucht das Model automatisch zu ermitteln - optional kann das Model auch via

attr <name> model <type>

gesetzt werden.

Es wird versucht ein Icon und das passende webCmd für eine einfache Steuerung zu setzen.

Readings

• state - on / off
• div. Device Informationen wie z.B.
  • Farben (rgb)
  • brightness
  • saturation
  • movies (hochgeladene / gespeicherte Effekte)
• fullResponse - Fehlermeldung z.B. "Keine Route zum Zielrechner (113)"

Set

• brightness - set brightness to device
• ct - set Colortemperatur to device (must be an RGB+W oder AWW device)
• effect_id  - set a standard effect to device
• hue        - set hue color to device
• mode       - set different mode to device
• movie      - switch between uploaded /saved movies - use "get Device Movies" first!
• on         - switch device on in the movie mode
• off        - switch device off
• saturation - set saturation to device

Get

• Gestalt - main device informations
• Mode    - get actual mode of device
• Movies  - get all uploaded / saved movies from the device
• Name    - get internal informations of the device
• Network - get network informations of the device
• Token   - check if the token is valid or need to updated

Attribute

• interval - Aktualisierungsinterval verändern (min. 15 Sekunden)
• model - Auswahl eines unterstützten Gerätes
• disable - deaktiviert das Gerät
• disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitintervall (13:00-18:30 or 13:00-18:30 22:00-23:00)

Bekannte Probleme

Eine parallele Steuerung zwischen FHEM und der Twinkly App führt zu Aussetzern bei den Lampen (Effekte bleiben hängen oder reagieren nicht mehr!

Dies liegt daran, dass das 31_Twinkly.pm Modul und auch die Twinkly App jedes Mal den Token, der für die Steuerung benötigt wird prüft und ggf. einen neuen Token anfordert.

Durch das regelmäßige Interval (default: 60 Sekunden) zerschießt sich das Modul und die Twinkly App den Token.

Daher als Tipp:

Deaktiviert das jeweilige Gerät, bevor ihr eure Effekte in der Twinkly App konfiguriert..