FHEMWiki - Benutzerbeiträge [de]

HomeMatic HMInfo TempList/Weekplan

2017-01-26T20:55:08Z

HelixOWL: /* Der File Inhalt - Syntax */

{{Todo|Dieser Artikel überschneidet sich inhaltlich mit [[HomeMatic Type Thermostat#Templates]].}}
{{Infobox Modul
|ModPurpose=Behandlung von Wochenplänen für Thermostate
|ModType=d
|ModCmdRef=HMinfo Weekplan
|ModForumArea=HomeMatic
|ModTechName=98_HMinfo.pm
|ModOwner=martinp876 ({{Link2FU|251|martinp876}} / [[Benutzer Diskussion:Martinp876|Wiki]])
}}

'''HMInfo TempList''' ist eine Funktion des Moduls [[Homematic_HMInfo|HMInfo]] das es erlaubt Temperaturlisten (Wochenpläne) von [[HomeMatic Type Thermostat|Thermostaten]] zu Verwalten.

== Einleitung==
Homematic bietet eine Reihe von Heizkörperthermostaten welche mit einem Wochenplan eigenständig einen Automatikmode unterstützen. Die Erstellung und Verwaltung dieser Pläne ist im Device zumindest umständlich.
Wochenpläne werden in den Devices gespeichert und können über FHEM abgefragt werden.
== Begriffe==
Wir müssen strikt 3 Wochenpläne unterscheiden:
* ''activeList'' Wochenplan im Device. Dieser, und nur dieser ist '''wirksam'''. Er kann nicht direkt in FHEM dargestellt werden. FHEM muss die Daten auslesen um sie verarbeiten zu können. Siehe hierzu kommandos und attribute des Device:getConfig und autoReagReg.
* ''referenceList'' Wochenplan in FHEM. Für jedes Device wird ein Wochenplan (bei einigen Devices können es sogar mehrere sein) dargestellt. Dies ist die aus dem Device gelesene activeList. Es liegt in der Verantwortung des User, die Liste aktuell zu halten.
* ''tempTemplates'' Vorlagen für Wochenpläne. Diese werden in Files erstellt. Man kann Devices eines der tempTemplates zuweisen um es zu prüfen oder einzuspielen.

== Wochenplan Files==
=== Mögliche Files===
tempListTemplates werden immer in Files verwaltet. Man kann Templates in mehreren Files verwalten. Ferner gibt es unterschiedliche Methoden, ein File zu spezifizieren.
* '''attr tempListTmpl im Device''': hier spezifiziert man das Template. Will man sich von tempaltes entkoppeln sollte man '''tempListTmpl none''' unbedingt setzen.
** '''Wohnzimmer''': das template '''Wohnzimmer''' wird im default File gesucht
** '''myWeekplan.cfg:Wohnzimmer''': das template '''Wohnzimmer''' wird im File ''myWeekplan.cfg'' mit relativen Pfad von FHEM home gesucht
** '''./setup/myWeekplan.cfg:Wohnzimmer''': das template '''Wohnzimmer''' wird im File ''myWeekplan.cfg'' mit relativen Pfad ''./setup'' gesucht
** '''/opt/fhem/myWeekplan.cfg:Wohnzimmer''': das template '''Wohnzimmer''' wird im File ''myWeekplan.cfg'' mit absoluten Pfad ''/opt/fhem/'' gesucht
* '''attr configTempFile in HMInfo''': spezifiziert weekplan configurationsfiles. Es ist eine Liste Wochenplan Files welche genutzt werden. Ist das Attribut nicht gesetzt wird als ''default tempList.cfg'' genutzt.
** '''attr hm configTempFile myWeekPlan.cfg''': FHEM kennt ein File mit Wochenplan. Dies ist auch das Default für alle tempListTmpl in denen kein File spezifiziert.
** '''attr hm configTempFile mySummerPlan.cfg,myWinterPlan.cfg,myPartyPlan.cfg''': FHEM sind 3 Files bekannt. Der erste Eintrag ''mySummerPlan.cfg'' ist der Default für tempListTmpl .
* '''attr configDir in HMInfo''': spezifiziert einen Pfad, der ''auch'' für configTemplFile genutzt wird. Es erleichtert Konfigurations-Dateien in einem separaten Verzeichnis anzulegen. ''attr hm configDir setup'' wäre ein sinnvoller Eintrag. Das Verzeichnis ''setup'' unter fhem sollte erstellt werden. Ist das Attribut nicht gesetzt ist fhemHome der default.

=== Der File Inhalt - Syntax ===
entities:HK1,HK2
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
R_1_tempListSun>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
R_2_tempListMon>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_3_tempListTue>07:00 14.0 13:00 16.0 16:00 18.0 21:00 19.0 24:00 15.0
R_4_tempListWed>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_5_tempListThu>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_6_tempListFri>07:00 14.0 13:00 16.0 16:00 18.0 21:00 19.0 24:00 14.0
entities:HK3
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
R_1_tempListSun>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
R_2_tempListMon>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_3_tempListTue>07:00 14.0 13:00 16.0 16:00 18.0 21:00 19.0 24:00 15.0
R_4_tempListWed>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_5_tempListThu>07:00 14.0 16:00 18.0 21:00 19.0 24:00 14.0
R_6_tempListFri>07:00 14.0 13:00 16.0 16:00 18.0 21:00 19.0 24:00 14.0

* '''entities''': ist der Name des Wochenplans. Eine Liste kann mehrere Namen haben, welche mit Komma separiert werden.
** ein Name darf in einem File '''nicht''' doppelt vorkommen.
** der gleiche Name darf in unterschiedlichen File genutzt werden.
* '''R_0_tempListSat>''': sind die Einträge je Wochentag. Es muss ein Eintrag je Wochentag vorhanden sein.
* '''08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0''': gemäß Homematic Syntax fängt der Plan immer um 00:00 Uhr an. Das erste Paar 08:00 14.0 bedeutet, dass von 00:00 bis 08:00 eine Temperatur von 14.0 eingestellt werden soll. 15:00 18.0 bedeutet das von 08:00 bis 15:00 18.0 Grad einzustellen sind
**Übersetzt könnte man sagen '(00:00) bis '''08:00''' '''14.0'''° | (08:00) bis '''15:00''' '''18.0'''° | (15:00) bis '''21:30''' '''19.0'''° | (21:30) bis '''24:00''' '''14.0'''°'
** es sind immer Paare einzutragen
** der Beginn um 00:00 ist nicht einzutragen
** der Letzte Eintrag '''muss''' 24:00 an jeden Tag sein
** Uhrzeiten sind auf halbe Stunden beschränkt. Einträge 08:00 und 08:30 sind gültig. 08:20 ist ungültig.
==== Erstellen des ersten Files====

Um nicht auf der grünen Wiese beginnen zu müssen empfiehlt es sich den aktuellen Ist-Zustand ''(referenceList)'' mit <code>save</code> in eine Datei zu schreiben. Vorab sollten die HMInfo-Attribute <code>configDir</code> und <code>configTempFile</code> gesetzt sein.

attr <HMInfo> configDir setup
attr <HMInfo> configTempFile myWeekplan.cfg
set <HMInfo> tempList save

Der letzte Befehl speichert die ''referenceList'' jedes Gerätz in der Datei <code>setup/myWeekplan.cfg</code>. Als ''Entity'' wird der Name des Thermostats verwendet – das Attribut ''tempListTmpl'' wird nicht beachtet.

Die Datei kann anschließend mit einem Text-Editor bearbeitet werden. Wochenpläne können zusammengefasst und verändert werden.

=== HMInfo Kommandos ===

Die HMInfo-Befehle, die Temperaturlisten verwalten, folgen dem Schema:

set <HMInfo> tempList <Befehl>

Die verfügbaren Befehle sind:

; <code>save</code>
: Speichert den aktuellen Zustand der Thermostate (''referenceList'') in der ''tempList''-Datei ab.
; <code>verify</code>
: Vergleicht den Ist-Zustand (''referenceList'') mit dem Soll-Zustand (dem Wochenplan aus dem ''tempListTmpl''-Attribut). Abweichungen werden angezeigt aber nicht behoben. Diese Prüfung ist auch Teil von HMInfos <code>configCheck</code>.
; <code>restore</code>
: Stellt den Soll-Zustand wieder her. Funktioniert im Prinzip wie <code>verify</code>, jedoch werden alle Abweichungen vom Soll-Zustand korrigiert. Zu beachten ist die Verzögerung beim Schreiben (siehe [[HomeMatic HMInfo#protoEvents|HMInfo protoEvents]], Device Status und Beschreibung des Device) und dass nach dem Schreiben die ''referenceList'' neu geladen werden muss. Wir empfehlen <code>autoReadReg</code> auf Level 5 zu setzen. Ein Restore kann jederzeit ausgeführt werden. Sind alle Daten aktuell wird ''keine'' Temperaturliste geschrieben; es erfolgt keinerlei Funkverkehr.
; <code>status</code>
: Gibt eine Übersicht über die genutzten Templates aus.

Das Web-Frontend verwendet den nahezu identischen Befehl <code>tempListG</code>. Da dieser Befehl keine weiteren Argumente zulässt kann das Frontend ein Pulldown-Menü anzeigen. Das "G" steht für "Global" – da keine Filter unterstützt werden wirken alle Befehle auf alle HomeMatic-Geräte.

==Nutzungsbeispiele==
=== Mehrere Heizkörper in einem Raum===
Wenn sich in einem Raum mehrere Heizkörperthermostate befinden, sollten diese – wie in [[HM-CC-RT-DN]] beschrieben – gepeert werden.
HomeMatic geht davon aus, dass alle HM-CC-RT-DNs den selben Wochenplan haben (gilt ggf. auch für einen zugehörigen [[HM-TC-IT-WM-W-EU]]).

Um dies zu erreichen definiert man einen Wochenplan für das Zimmer, beispielsweise <code>Wohnzimmer.cfg</code>. Anschließend wird dieser Wochenplan allen Teammitgliedern zugewiesen:

attr <HM-CC-RT-DN#1>_Clima tempListTmpl Wohnzimmer
attr <HM-CC-RT-DN#2>_Clima tempListTmpl Wohnzimmer
attr <HM-CC-RT-DN#3>_Clima tempListTmpl Wohnzimmer
attr <HM-TC-IT-WM-W-EU>_Climate tempListTmpl Wohnzimmer
set hm tempListG restore

=== Mehrere Heizkörper mit gleichen Profil===
Will man Wohnräume identisch behandeln im Hinblick auf den Wochenplan weisst man den Thermostaten identische Profile zu.

attr RTSusi_Clima tempListTmpl Kinderzimmer
attr RTjonas_Clima tempListTmpl Kinderzimmer
attr RTwohnzimmer_Clima tempListTmpl Kinderzimmer
set hm tempListG restore
=== Wohnungsnutzung umschalten===
Das Heizprofil kann man Zentral umstellen. Verlässt man die Wohnung zum Urlaub, der Sommer naht, man macht die üblich 3-Woche Party... . Alle Thermostate sollen umgestellt werden, zentral mit wenigen Kommandos, einfach zu prüfen. Sinnvoll ist es mehrere tempList.cfg Files anzulegen. Nehmen wir 4 Files an, Winter, Urlaub zu hause UrlaubIn, Urlaub nicht zu hause UrlaubOut sowie Sommer. Ferner hat man (der Einfachheit halber) 3 RTs: RTwohn, RTschlaf, RTkueche.
Die RTs haben jeweils ihr attr tempListTmpl gesetzt entsprechend ihrem Namen.
Man legt also die 4 Files an mit entities die man zusammenfassen kann (templisten muss man natürlich befüllen:
File Winter.cfg
entity: RTwohn
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...
entity: RTschlaf
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...
entity: RTkueche
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...

File UrlaubIn.cfg
entity: RTwohn,RTkueche
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...
entity: RTschlaf
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...

File UrlaubOut.cfg
entity: RTwohn,RTschlaf,RTkueche
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...

File Sommer.cfg
entity: RTwohn,RTschlaf,RTkueche
R_0_tempListSat>08:00 14.0 15:00 18.0 21:30 19.0 24:00 14.0
...

In HMInfo sollte man nun verwalten:
attr RTwohn_Clima tempListTmpl RTwohn
attr RTkueche_Clima tempListTmpl RTkueche
attr RTschlaf_Clima tempListTmpl RTschlaf
attr hm configTempFile Winter.cfg,Sommer.cfg,UrlaubIn.cfg,UrlaubOut.cfg

Winter.cfg ist nun default. Mit set hm tempListG verify kann man prüfen, dass es entsprechend genutzt ist. Nun will man in Urlaub fahren. Man schaltet das Default durch umstellen der Reihenfolge um und aktiviert es durch ein restore:
attr hm configTempFile UrlaubOut.cfg,Winter.cfg,Sommer.cfg,UrlaubIn.cfg
set hm tempListG restore

UrlaubOut.cfg ist default. Alle notwendigen Änderungen werden in die RTs programmiert.
Unberührt bleibt Opas Zimmer, der nicht das default file sondern ein dediziertes nutzt.

attr RTopa_Clima tempListTmpl Winter.cfg:RTopa

Das template RTopa muss also nur im File Winter.cfg vorhanden sein:

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

WifiLight

2017-01-08T17:53:41Z

HelixOWL: /* Milight WiFi bridge */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=32_WifiLight.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}



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

=== Basic Syntax ===
==== Definition ====
:<code>define <name> WifiLight <Leuchtmitteltyp> <bridgetyp>:<IP|FQDN></code>
''Für die Milight Typen die Gruppen unterstützen werden die Gruppen in der Reihenfolge der Definition automatisch erstellt.''

==== on / off ====
:<code>set <name> on|off</code>
''"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 ====
:<code>set <name> dim level</code>
''"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 ====
:<code>set <name> HSV H,S,V</code>
''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

<code>ramp</code>
Dieser Parameter steuert einen weichen Übergang zwischen zwei Zuständen und wird in Sekunden angegeben.

Beispiel:

<code>set <name> on</code> : schaltet die LED sofort an.

<code>set <name> on 20</code> : Die LED wird über einen Zeitraum von 20 Sekunden weich hoch-gedimmt.

<code>queue</code>
Angenommen das Modul arbeitet gerade intern eine Transition, also dem weichen Übergang zu einem anderen Zustand (siehe ramp), ab. Der user setzt während der Transition einen weiteren Befehl für die LED ab.

Ohne den Parameter "q" wird die laufende Transition sofort unterbrochen und der neue Befehl wird ausgeführt.
Mit dem Parameter "q" wird der neue Befehl in eine interne Queue geschrieben und erst bearbeitet nachdem die laufende Transition, und alle vorher in die Queue geschriebenen Befehle, abgearbeitet wurden.

Dadurch wird es möglich das mit einem Befehl mehrere ganz unterschiedliche Farb- oder Helligkeitswechsel an das modul übergibt die dann nacheinander abgearbeitet werden.

<code>direction</code>
Im HSV Farbraum entsprechen die Farben einem Winkel (0° Rot, 120° Grün, 240° Blau). Der weiche Übergang von einer Farbe zu einer anderen wird Standardmäßig auf dem "kürzesten Weg" durchlaufen. Der Wechsel von Grün auf Rot sieht also so aus: 120°, 119°, 118°, ... 2°, 1°, 0°. Das entspricht der default direction "s" für "short" - dem kürzesten Weg.

Mit dem Flag "l" für "long" (langer Weg) wird die gleiche Transition jetzt mit dem "Umweg" über Blau ausgeführt, also so: 120°, 121°, 122°, ... 358°, 359°, 360° ( = 0°).

==== RGB ====
:<code>set <name> RGB RRGGBB</code>
''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 (120,100,0 -> 240,100,100 für GRÜN 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 ===

{{Randnotiz|RNTyp=Info|RNText=Achtung: Vom LW12 existieren mindestens zwei Ausführungen. Unterscheidbar am "eigenen" WLAN. LW12 spannt ein Netz mit der Bezeichnung "LEDNET..." auf. LW12 - HX001 spannt ein Netz mit der Bezeichnung "HX..." auf. Beide Typen werden unterstützt, müssen jedoch mit anderer Signatur definiert werden}}
[[Datei:LW12.JPG|mini|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 [https://play.google.com/store/apps/details?id=com.Zengge.LEDWifiMagicColor&hl=de LED Magic Color Controller v2]
* Apple Version im Apple App-Store [https://itunes.apple.com/de/app/led-magic-color/id595148649?mt=8 LED Magic Color]

Die Definition erfolgt im Modul so:

LW12 (eigene SSID "LEDNET..."):
:<code>define <name> WifiLight RGB LW12:<IP|FQDN></code>
LW12 (eigene SSID "HX..."):
:<code>define <name> WifiLight RGB LW12HX:<IP|FQDN></code>

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. <strike>Deshalb und wegen seiner hohen Aktualisierungsrate, ist er für reine RGB Streifen die erste Wahl.</strike> Mittlerweile ist der (bessere) LD382 vom gleichen Hersteller verfügbar.

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.
* [http://www.amazon.de/NEUER-STRIPS-CONTROLLER-iPhone-Android/dp/B00G55329A/ref=sr_1_1?ie=UTF8&qid=1390006342&sr=8-1&keywords=lw12+led LW12 RGB LED Stripecontroller Amazon]

=== RGB und RGBW LED (Streifen) am LD382 Wifi LED Controller ===

Der LD382 vereint die LED Steuereinheit und den Wifi Empfänger. Am LD382 können reine RGB Streifen, RGBW Streifen oder eine Kombination beider angeschlossen werden. 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, das Netzteil verfügt zusätzlich über einen Steckeranschluss.

Der LD382 verfügt über einen WPS Button, kann also per "one-click" ins Netzwerk genommen werden.

==== Alternative Bezeichnungen ====
* LED Magic UFO (XCSOURCE)

Die Definition erfolgt im Modul so:

LD382 mit RGB Streifen (Weiß wird gemischt)
:<code>define <name> WifiLight RGB LD382:<IP|FQDN></code>
LD382 mit RGBW Streifen (oder Kombination aus RGB und separatem Weiß)
:<code>define <name> WifiLight RGBW LD382:<IP|FQDN></code>

Für neuere Modelle ist als Typ LD382A anzugeben.

=== RGBW LD316 LED-Lampe Wifi ===

Der LD316 vereint LED-Lampe (Fassung E27), Steuereinheit und Wifi Empfänger. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App Magic Color(sh. LW12) kann LD316 gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen über den in LD316 vorhandenen Webserver möglich (Benutzer: admin, Kennwort: nimda).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight RGBW LD316:<IP|FQDN></code>

==== Alternative Bezeichnungen ====
* WIFI WLAN LED Lampe IWY MASTER Color (RGB)
* diverse wechselnde Bezeichnungen bei AliExpress

==== Bezug ====
* Amazon, ab und an vorhanden, Preis schwankt zwischen 40 und 55 €
* ebay, ab und an vorhanden, Preis meist um 45 €
* AliExpress, fast immer was zu finden, Preis zwischen 22 $ und 34 $, Coupon beim Angebot beachten, [http://de.aliexpress.com/item/Free-shipping-smartphone-controlled-lights-bulb-7w-e27-rgbw-colors/32437430102.html?adminSeq=223453226&shopNumber=1763377 Beispiel 1], [http://de.aliexpress.com/item/LED-Smart-bulb-7-5w-E27-RGB-LED-WIFI-Bulb-Light-Color-Temperature-Brightness-Adjustable-Light/32254107494.html?adminSeq=201473654&shopNumber=811614 Beispiel 2] '''ACHTUNG! Teilweise nicht kompatibel, sh. Abschnitt LD316A'''

=== RGBW LD316A LED-Lampe Wifi ===

Mittlerweile sind einige Lampen mit unterschiedlicher Firmware bei gleicher Verpackung im Handel. Diese werden mit der App. Magic Home eingestellt. Abhängig von der vom Hersteller eingesetzten Firmware ist ein Betrieb als LD316A möglich. Betrieb im eigenen WLAN ist möglich. Je nach Firmware ist die Einstellung über den Webserver nicht mehr möglich. Es erscheint zwar die Abfrage nach Benutzer und Kennwort, danach eine Fehlermeldung. Einzelheiten im Forum, Thread (sh. unten) oder Suchbegriff "Magic Home".

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight RGBW LD316A:<IP|FQDN></code>

=== sengled Boost LED-Lampe Wifi ===
<gallery>
Sengled Boost.JPG|sengled Boost
</gallery>
Die sengled Boost vereint eine Weiß-LED-Lampe (Fassung E27), Wifi Empfänger und Steuereinheit und bietet eine Wifi Repeater Funktion. Eine externe Steuereinheit ist nicht notwendig. Einfach gegen vorhandene Glühbirne auswechseln. Mittels App ("sengled Boost" unter [http://forum.fhem.de/index.php/topic,36811.0.html Android] oder [https://itunes.apple.com/de/app/sengled-boost/id848792893?mt=8 iOS]) kann die sengled Boost gesteuert und eingestellt werden. Betrieb im eigenen WLAN ist möglich. Weiterhin sind Einstellungen (besonders zur Wifi Repeater Funktion) über den in der sengled Boost vorhandenen Webserver möglich (Benutzer: admin, Kennwort: admin).

Die Definition erfolgt im Modul so:
:<code>define <name> WifiLight White SENGLED:<IP|FQDN></code>

Weitere Informationen können im entsprechenden {{Link2Forum|Topic=36811|LinkText=Forumsthema}} nachgelesen werden.

=== 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 ====
Es sind verschiedenen bridge Versionen erschienen, wobei die Versionen vor iBox2 nicht mehr hergestellt und praktisch nicht mehr erhältlich sind. 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
MiLight iBox2-small.jpg|Milight iBox2 bridge
</gallery>

===== Milight bridge v1 =====

Wird nicht unterstützt.

===== 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

* vier Gruppen Warmwhite/Coldwhite (White)
UND
* vier 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.

===== Milight bridge iBox2 =====

Diese Version lässt sich aktuell nicht mit WifiLight einbinden.

==== 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.
<gallery>
Milight-RGB-Stripe.jpg|Milight RGB LED stripe Controller mit FB
Milight-RGB-e27.JPG|Milight RGB e27 mit FB
Milight-RGB-downlight.JPG|s'luce RGB Downlight
</gallery>

===== 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.
<gallery>
Milight-RGBW1.JPG|Milight RGBW LED stripe Controller mit FB
</gallery>

===== 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.
<gallery>
Milight-WWCW-FB.JPG|Milght Warmweiß/kaltweiß LED Streifen controller mit FB
Milight-E27-WWCW-OEM.JPG|Milight Warmweiß/kaltweiß 6 Watt E27 OEM
Milight-E27-WWCW-9W.JPG|Milight Warmweiß/kaltweiß 9 Watt E27
Milight-Downlight-WWCW.JPG|Milight Warmweiß/kaltweiß Downlight (IWY STAR 6 Watt)
</gallery>

===== 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.''
<gallery>
Milight-rgbw2-LED.jpg|Milight RGB/Weiß LED Streifen Controller 4 Zonen
Milight-E27-RGBW2-OEM.JPG|Milight RGB/Weiß 6 Watt E27 OEM
Milight-E27-RGBW2-9Watt.JPG|Milight RGB/Weiß 9 Watt E27 mit FB
</gallery>

== Color-Picker aktivieren ==
Um den sog. "Color-Picker" zu aktivieren müssen die beiden folgenden Attribute gesetzt werden:
<pre>
attr <name> webCmd RGB
attr <name> widgetOverride RGB:colorpicker,RGB
</pre>
<gallery>
Wifiled_colorpicker.png|Colorpicker Beispiel
</gallery>

Weitere Informationen unter [http://www.fhemwiki.de/wiki/Color Color Wiki Artikel]

== Farbiges Icon ==
Weiterhin kann das Lampen-Icon auch farbig dargestellt werden. Dazu ist es erforderlich, das folgende Attribut zu setzen:
<pre>
attr <name> devStateIcon {Color_devStateIcon(ReadingsVal($name,"RGB","000000"))}
</pre>

== Links ==
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,18958.0.html Fhem Forum]
* [http://www.ledsee.com/datasheet_ledsee/LED%20WiFi%20controller%20for%20home%20use_Hontech-wins__-EN.pdf LW12 Datasheet]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Code Snippets]]

Datei:MiLight iBox2-small.jpg

2017-01-08T17:45:57Z

HelixOWL: