WifiLight

WifiLight
Zweck / Funktion
Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls
Allgemein
Typ	undefiniert
Details
Dokumentation	ModUndef
Modulname	32_WifiLight.pm
Ersteller	Jörg alias herrmannj
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

FHEM Modul zum steuern diverser LED Leuchtmittel über WLAN wie Mi-Light, Limitless, IVY, LW12, LED Streifen, 2,4GHz E27 RGB Lampen ...

Basic Syntax

Definition

define <name> WifiLight <Leuchtmitteltyp> <bridgetyp>:<IP|FQDN>

Für die Milight Typen die Gruppen unterstützen werden die Gruppen in der Reihenfolge der Definition automatisch erstellt.

on / off

set <name> on|off

"on" schaltet weißes Licht mit 100% ein. (Ausnahme Milight/RGB(old) da dort kein weiß unterstützt wird: 100% rot)

Erweiterte Parameter:

• ramp

dim

set <name> dim level

"dim" behält die aktuell gesetzte Farbe bei und so kann "dim 100" anstelle von "on" verwendet werden wenn die aktuelle Lichtfarbe beibehalten werden soll.

erweiterte Parameter:

• ramp
• queue

HSV

set <name> HSV H,S,V

Farbangaben im Farbraum "HSV" sind vollständig und in der Regel intuitiver als RGB. H (HUE: 0..360) gibt die Grundfarbe in einem Farbkreis (Regenbogen) an. Rot liegt bei 0°, Grün bei 120° und blau bei 240°. S (Saturation/Sättigung: 0..100) steht für die Sättigung der Farbe. Eine Sättigung von 100 bedeutet die Farbe ist "rein" oder komplett gesättigt. Blau zum Beispiel mit 100% Sättigung entspricht RGB #0000FF. V (Value: 0..100) gibt die Helligkeit an. Ein V von 50 heist: "halbe Helligkeit"

erweiterte Parameter:

• ramp
• queue
• direction
• event

RGB

set <name> RGB RRGGBB

RGB Angaben werden im 6 stelligen Hexadezimalen Format erwartet.

erweiterte Parameter:

• ramp
• queue
• direction
• event

Unterschiede von Farbangaben HSV zu RGB

Angenommen das Ziel ist ein Farbverlauf Rot (ganz dunkel, Helligkeit 0) auf Blau sowie ein Farbverlauf von Grün (ebenfalls 0) auf Blau. Im RGB Farbraum starten beide Farbverläufe bei #000000 auf gehen dann auf #0000FF. Damit lassen sie sich nicht unterscheiden und anders als erwartet beginnt der Farbverlauf in beiden Fällen mit einem neutralen "Grau" (RGB #010101). Die entsprechende Beschreibung im HSV Farbraumraum ist hingegen eindeutig (0,0,0 -> 240,100,100 für ROT 0% auf BLAU 100%) und funktioniert wie erwartet.

Erweiterte Funktionen / Transitions

Das Modul unterstützt komplexe programmierbare Farbverläufe. Da diese im Modul berechnet werden hängt die flüssige Wiedergabe von einer ganzen Reihe von Faktoren ab:

• FHEM Host Hardware
• FHEM Auslastung und "Kooperation" von anderen Modulen
• verwendete Leuchtmittel
• Auslastung der Bridge

Das Modul ist stark optimiert um die Farbverläufe flüssig wiedergeben zu können. Auf der anderen Seite reagiert das menschliche Auge sehr empfindlich. Deshalb sind gelegentliche "Sprünge" bei Farbverläufen unvermeidlich und sehr von der konkreten Umgebung abhängig.

Unterstützte Wifi-Leuchtmittel

RGB LED (Streifen) am LW12 Wifi LED Controller

LW12 LED stripe WiFi Controller

Der LW12 vereint die LED Steuereinheit und den Wifi Empfänger. Zum Betrieb ist noch der LED Streifen mit gemeinsamer Anode sowie ein in Spannung und Leistung zum LED Streifen passendes Netzteil erforderlich. Alle Anschlüsse am Controller sind als Schraubklemmen ausgeführt.

Alternative Bezeichnungen

• WF200 Controller

Der Controller erstellt im Werkszustand ein WLAN mit eigener SSID und wird über die vom Hersteller gelieferte Smartphone App in das eigene Netzwerk eingebunden.

• Android Version im Google PlayStore LED Magic Color Controller v2
• Apple Version im Apple App-Store LED Magic Color

Die Definition erfolgt im Modul wie folgt:

define <name> WifiLight RGB LW12:<IP|FQDN>

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils nur einen LED RGB Streifen.

Der LW12 erzeugt weißes Licht durch RGB Farbmischung und unterstützt beliebige Sättigungen sowie Helligkeiten. Deshalb und wegen seiner hohen Aktualisierungsrate, ist er für reine RGB Streifen die erste Wahl.

Zum Betrieb sind der LW12, ein RGB LED Streifen sowie passendes Netzteil (Klemmschrauben) erforderlich.

Bezug

• Zum Zeitpunkt der Erstellung dieses Artikels ist der LW12 bei eBay von diversen Händlern ab ca 30,- Euro erhältlich.
• LW12 RGB LED Stripecontroller Amazon

Milight Systeme für LED Streifen und E27 Leuchtmittel

Milight Leuchtmittel sind von diversen Herstellern unter diversen Handelsnamen erhältlich. Verfügbar sind preiswerte Ansteuerungen (RGB, RGB oder Weiß, RGB und Weiß, Warm- und Kaltweiß) für LED Streifen, Downlights sowie E27 Leuchtmittel. Die E27 Leuchtmittel haben den Empfänger integriert und können direkt in vorhandenen Fassungen eingesetzt werden.

Die Lampen / Controller sprechen ein proprietäres 2,4GHz Protokoll. Zur Ansteuerung mit fhem wird eine zusätzliche bridge benötigt.

Alternative Bezeichnungen

• Rocket LED
• Limitless LED
• Easybulb
• s`luce iLight
• iBulb
• Kreuzer
• ...

Milight WiFi bridge

aktuell sind vier bridge Versionen erschienen (v1 .. v4) wobei die v1 praktisch nicht mehr erhältlich ist und nicht unterstützt wird. Der bridge erstellen im Werkszustand ein WLAN mit eigener SSID und werden über eine Smartphone App in das eigene Netzwerk eingebunden. Zum Betrieb ist ein 5V USB Netzteil erforderlich. Ein Betrieb an den USB Ports des Host ist möglich, wegen eventueller Energiemanagement Funktionen des Host jedoch nicht empfohlen.

• 

  Milight v2 bridge

• 

  Milight v3 bridge mit Limitless Aufkleber

• 

  Milight v4 bridge

Milight bridge v2

Die v2 bridge hört auf UDP Port 50000 und ist typischerweise am blauen Etikett erkennbar. Eine v2 bridge kann ansteuern:

• ein RGB Leuchtmittel

ODER

• ein RGBW1 Leuchtmittel

UND

• vier Gruppen Warmwhite/Coldwhite (White)

Milight bridge v3

Die v3 bridge hört auf UDP Port 8899 und hat typischerweise ein dunkles Etikett. Eine v3 bridge kann ansteuern:

• ein RGB Leuchtmittel

ODER

• ein RGBW1 Leuchtmittel

UND

• 4 Gruppen Warmwhite/Coldwhite (White)

UND

• 4 Gruppen RGB + White (RGBW2)

Milight bridge v4

Die Funktionen der v4 entsprechen im wesentlichen der v3, allerdings ist das WLAN Modul ein anderes (Draft-N) und das Web Interface wurde entfernt.

Leuchtmittel

Milight Leuchtmitteltyp RGB

E27, LED Streifen Controller oder Downlight.

Dieser Typ RGB Leuchtmittel ist veraltet und von Neuanschaffungen wird abgeraten. Die Ansteuerung ist nur im Farbkreis möglich (keine volle RGB Mischung, keine Sättigung, kein Weiß). Das Protokoll zur Ansteuerung dieses Typ ist fehleranfällig und sehr langsam. Eine parallele Benutzung der FB oder der App verursacht ebenfalls Fehler.

Benötigt eine bridge ab v2.

• 

  Milight RGB LED stripe Controller mit FB

• 

  Milight RGB e27 mit FB

• 

  s'luce RGB Downlight

Milight Leuchtmitteltyp RGBW1

LED Streifen Controller. (RGB mit separatem Weiß Kanal)

Dieser Typ RGB Leuchtmittel ist veraltet.

FHEM kann mit diesem Controller Farbe, Helligkeit und Sättigung komplett steuern. Durch den extra Weißkanal sind sehr angenehme Farbmischungen möglich allerdings ist das verwendete Protokoll wie beim RGB langsam und fehleranfällig. Daher eignet sich der Controller nicht für häufige dynamische Farbwechsel und nur bedingt für unbeaufsichtigten / automatischen Betrieb.

Die Sättigung wird durch die Balance des Weiß- und des Farbkanals erreicht. Bei einer Sättigung von 50% werden Weiß und Farbe jeweils voll angesteuert.

Benötigt eine bridge ab v2.

• 

  Milight RGBW LED stripe Controller mit FB

Milight Leuchtmitteltyp White

E27, LED Streifen Controller oder Downlight.

Pur weiße LED Leuchtmittel mit Unterstützung der Farbtemperatur (Kaltweiß/Warmweiß).

FHEM steuert die Helligkeit der Leuchtmittel. Ein Unterstützung der Farbtemperatur (Weiß Kelvin) ist noch nicht implementiert. Die Farbtemperatur sollte initial über die app eingestellt werden und wird von den Leuchtmitteln beibehalten. Die e27 Lampen sind zum Zeitpunkt der Erstellung dieses Artikels (04/14) ab etwa 11,- Euro bei eBay verfügbar. Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel). Die Lichtausbeute ist sehr gut.

Benötigt eine bridge ab v2. Eine bridge kann vier getrennte Gruppen White ansteuern. Wenn mehr als vier Gruppen eingesetzt werden sollen können weitere bridge eingebunden werden.

• 

  Milght Warmweiß/kaltweiß LED Streifen controller mit FB

• 

  Milight Warmweiß/kaltweiß 6 Watt E27 OEM

• 

  Milight Warmweiß/kaltweiß 9 Watt E27

• 

  Milight Warmweiß/kaltweiß Downlight (IWY STAR 6 Watt)

Milight Leuchtmitteltyp RGBW2

E27, LED Streifen Controller oder Downlight.

Aktuelle Typen mit neuem und robusterem Protokoll.

Dieser Typ Leuchtmittel gibt farbiges oder weißes Licht. Die Sättigung ist nicht stufenlos sondern 0% oder 100%. Die E27 Typen sind dabei wahlweise mit Warm- oder Kaltweiß bestellbar.

Erhältlich in 9Watt (Alukühlkörper) und in 6Watt (OEM, Kunststoffsockel).

Benötigt eine bridge ab v3. Eine bridge kann vier getrennte Gruppen RGBW2 ansteuern. Mehr als vier Gruppen können mit zusätzlichen bridge verwendet werden.

Die Sättigung wird wie folgt umgesetzt: S: 0..20 => 0% / S: 21..100 => 100%.

Bei Farbverläufen (Sonnenaufgang) die bei einer Farbe beginnen und bei Weiß enden kann es sinnvoll sein in zwei Schritten zuerst auf 100% Gelb zu faden, dort auf 20%..40% Weiß (typenabhängig) umzuschalten und dann Weiß weiter auf 100% zu dimmen.

• 

  Milight RGB/Weiß LED Streifen Controller 4 Zonen

• 

  Milight RGB/Weiß 6 Watt E27 OEM

• 

  Milight RGB/Weiß 9 Watt E27 mit FB

Installation

Achtung: Dieses Modul befindet sich noch im Beta-Status (manuelle Installation erforderlich).

Das Modul muss mit Hilfe von Telnet/SSH/SFTP auf dem fhem-Server installiert werden, wie im Forum beschrieben.

Links

• Thread über das Modul im Fhem Forum
• LW12 Datasheet