FHEMWiki - Benutzerbeiträge [de]

SVN Nutzungsregeln

2021-05-11T21:19:54Z

Herrmannj:

Um als Entwickler im SVN Beiträge einzuchecken und zu betreuen gibt es einige Regeln, die beachtet werden sollten (und tlw. müssen) um ein reibungsloses Miteinander zu gewährleisten. Diese Regeln werden hier dargestellt.

= Organisatorisches =
== Wie bekomme ich einen Schreibzugriff auf das SVN? ==

Einen Schreibzugriff erhalten User, welche dauerhaft ein Modul entwickeln möchten und dies innerhalb der FHEM Community auch betreuen möchten. Generell gelten folgende Vorrausetzungen für einen SVN Account:

* eigenständige Weiterentwicklung des Moduls (Bugfixing, neue Features, Anpassungen an neue Features/API's)
* Support von Usern im FHEM-Forum zu Fragen des Moduls

Sollte dies der Fall sein, bitte eine Email an [mailto:svn@fhem.de svn@fhem.de] schicken mit den folgenden Infos:

* kurze Modulerklärung
* Link zum aktuellen Modul (FHEM Forum-Thread, ...)
* FHEM Forum Username
* SSH Public-Key zur Authentifizierung (siehe https://svn.fhem.de/)

Sofern alles passt, wird dem Username der Schreibzugriff gewährt und man kann sein Modul einchecken.

== Welche Files darf ich bearbeiten, welche nicht? ==

Generell gilt, jeder bearbeitet nur Dateien, die er selber beigesteuert hat. Das Anpassen von fremdem Modulen ohne Einverständnis des Eigentümers ist strikt untersagt!

Im SVN gibt es die Datei [https://svn.fhem.de/trac/browser/trunk/fhem/MAINTAINER.txt MAINTAINER.txt] in der die Zuständigkeiten für alle Module, Dateien und Verzeichnisse festgehalten sind.

Folgende Dateien dürfen von allen Entwicklern bearbeitet werden:

* [https://svn.fhem.de/trac/browser/trunk/fhem/CHANGED CHANGED] - kurz und knappe Einträge von nutzerrelevanten Änderungen an FHEM
* [https://svn.fhem.de/trac/browser/trunk/fhem/MAINTAINER.txt MAINTAINER.txt] - Eintrag/Änderungen von EIGENEN!!! Modulen

== Vorgehensweisen ==
=== Neues Modul ===
Bei einem neuen Modul gilt es zwischen zwei Ausgangsszenarien zu unterscheiden. Hierbei ist entscheiden, ob man bereits einen schreibenden Zugriff auf das FHEM SVN-Repository, sowie Zugang zum FHEM Developer Bereich im Forum besitzt, oder nicht.

Sollte man noch keinen Zugriff auf das [https://svn.fhem.de FHEM SVN Repository] haben, so kann man diesen per Mail beantragen (siehe dazu: [[#Wie_bekomme_ich_einen_Schreibzugriff_auf_das_SVN.3F|Wie bekomme ich einen Schreibzugriff auf das SVN?]]). Dabei ist es hilfreich einen Link zu dem neuen Modul der Anmeldung beizufügen oder dem Forums-Beitrag in dem das Modul bereits durch einzelne User positiv getestet wurde. Genauere Hinweise welche Voraussetzungen für die Aufnahme als Modulentwickler gelten sind im {{Link2Forum|Topic=18962|LinkText=Developer-Bereich}} im Forum dokumentiert.

Wer bereits einen Schreibzugriff auf das FHEM SVN-Repository besitzt, kann ein neues Modul selbstständig einchecken. Auch hier gelten die Hinweise für Entwickler aus dem {{Link2Forum|Topic=18962|LinkText=Developer Bereich}}.

Eine Ausnahme bilden hier Module, die auf weitere Perl-Module/Dateien/Binaries angewiesen sind, welche demnach mit eingecheckt werden müssten. Da solche Konstellationen generell unerwünscht ist, sollte man entweder mit den Repository-Maintainern Kontakt aufnehmen um das weitere Vorgehen zu besprechen, oder besser ganz auf solche Abhängigkeiten verzichten.

Sobald man sein eigenes Modul erfolgreich eingecheckt hat, sollte man einen Beitrag im Forumsbereich [https://forum.fhem.de/index.php/board,40.0.html Ankündigungen] einstellen in denen man das neue Modul kurz vorstellt und evtl. eine kurze Einführung gibt. Eine Diskussion zu dem neuen Modul sollte jedoch in einem separaten Forumsbereich erfolgen.

=== Änderungen an fremden Modulen ===

Die Änderungen von fremden Modulen ist ohne Einverständnis des Maintainers (siehe MAINTAINER.txt) ausdrücklich '''NICHT GESTATTET'''! Wenn man eine Änderung vorschlagen möchte, bitte einen entsprechenden Diff (via <code>svn diff</code> zu der aktuellen Modul-Version aus dem SVN erstellen und im entsprechenden Forum-Board (siehe MAINTAINER.txt) als Patch-Vorschlag einreichen. Der entsprechende Maintainer wird den Vorschlag anschließend prüfen und ggf. einchecken.

=== Änderungen an eigenen Modulen ===

Änderungen an eigenen Module, für die man selbst Maintainer ist, kann man frei ins SVN einbringen. Eine Änderung sollte dabei vor einem Check-In in einer lokalen FHEM-Installation ausreichend auf Stabilität und Fehlerfreiheit geprüft sein. Ebenso sollte die commandref-Dokumentation entsprechend angepasst werden, damit der User ein neues Feature dort nachlesen kann.

Bei größeren bzw. umfangreichen Änderungen, sollte man einen Beitrag im Forumsbereich [https://forum.fhem.de/index.php/board,40.0.html Ankündigungen] einstellen in denen man die Änderungen kurz vorstellt und evtl. eine kurze Einführung gibt. Eine Diskussion zu den Änderungen sollte jedoch in einem separaten Forumsbereich erfolgen.

{{Randnotiz|RNTyp=g|RNText=Generell sollte man immer vor einem Commit zuerst mittels <code>svn diff</code> prüfen, welche Änderungen genau zum Commit vorliegen. Erst wenn nach dem Durchsehen keine ungewollten Änderungen enthalten sind und alles vollständig enthalten ist, kann man den Commit mittels <code>svn commit</code> oder <code>svn ci</code> vornehmen.

Dadurch sollen ungewollte Änderungen an Fremd-Modulen/-Dateien vermieden werden.

Weitere Informationen und Hilfe zu SVN gibt es bspw. [http://svnbook.red-bean.com/index.de.html hier].}}
= Technische Regeln =

Um Änderungen an Modulen, als auch neue Module einchecken zu können, müssen ein paar Regeln beachtet werden. Dies dient der Sicherstellung eines gewissen Mindeststandards bei der Dokumentation der Entwicklungshistorie, sowie wichtigen Anforderungen an eine gültige Commandref-Dokumentation.

Falls diese nicht eingehalten werden, wird ein Commit verweigert. Die folgenden Regeln werden durch einen sogenannten pre-commit Hook automatisch beim einchecken geprüft. Sofern alles in Ordnung ist, wird der Vorgang erfolgreich durchgeführt.

== Commit Message ==

Jeder Check-In im SVN muss eine Commit-Message enthalten in der eine kurz und knappe Beschreibung der durchgeführten Änderungen auf Englisch erfolgt. Dabei ist wichtig, dass zuerst das Modul angegeben wird, an dem die Änderung durchgeführt wurde. Anschließend erfolgt getrennt von einem Doppelpunkt die Kurzbeschreibung. Eine Commit-Message muss folgendem Format entsprechen:

<MODULNAME><font color="#ff0000"><u>''':'''</u></font><BESCHREIBUNG>

Bsp:

FB_CALLLIST: don't create html code in readings when create-readings attribute is activated and number-cmd attribute is set.
10_ZWave.pm: implement sequential callbackId (Forum #50090)

Sollte ein Check-In in direktem Zusammenhang mit einem Forums-Beitrag sein, so sollte man diesen in Kurzform (Bsp: Angabe der Thread-ID) in der Commit-Message vermerken. Somit können andere aus der Commit-Message sofort die Diskussion im Forum finden um die Hintergründe zu einer bestimmten Änderung nachvollziehen zu können.

Wenn eine Commit-Message nicht diesem Format entspricht, wird ein Commit verweigert.

== Nummernpräfix bei Modulen darf nicht "99" sein ==

Jedes FHEM-Modul muss im Dateinamen immer ein 2-stelliges Nummernpräfix enthalten. Diese Zahl war früher für die Reihenfolge der Prüfung der [[DevelopmentModuleIntro#Die_Client-Liste|Client-Liste]] in [[DevelopmentModuleIntro#Zweistufiges_Modell_für_Module|zweistufigen Modulen]] zuständig. Heute besitzen die Modulnummern diese Funktion nicht mehr.

Das Präfix "99" hat aber eine besondere Eigenschaft. Alle Module die mit dem Präfix "99" versehen sind, werden beim Start von FHEM automatisch geladen. Dieses ist historisch bedingt um z.B. die 99_myUtils.pm immer zu laden.

Das Präfix "99" ist jedoch zur weiteren Verwendung gesperrt um ein automatisches Laden von weiteren Modulen zu verhindern. Generell werden in FHEM Module bei der erstmaligen Verwendung automatisch geladen.

Neue Module, die das Nummernpräfix "99" tragen (z.B. "99_MyModule.pm") werden beim Check-In zurückgewiesen.

== CHANGED Eintrag ==

Ein Eintrag in der Datei CHANGED darf max. 80 Zeichen pro Zeile enthalten. Dies dient der Lesbarkeit der Änderungen in der FHEM-Oberfläche insbesondere auf kleinen Geräten. Sollten man Zeilen in CHANGED einzufügen, welche mehr als 80 Zeichen pro Zeile enthalten, wird ein Check-In verweigert.

Dies gilt aktuell nur für die Datei CHANGED. Als Zeichen dienen alle sichtbaren Zeichen, als auch jedes einzelne Leerzeichen. Tabulatoren sind hierbei verboten und werden beim Check-In ebenfalls zurückgewiesen.

== commandref-Regeln ==

Jedes Gerätemodul welches eingecheckt wird, muss einen commandref-Beitrag enthalten (mindestens in Englisch). Dieser Abschnitt muss bestimmte Regeln erfüllen, um in das SVN gelangen zu können:

# mindestens ein commandref-Beitrag auf Englisch (POD-Marker: <code>#begin html</code> sowie <code>#end html</code>). Ein Modul ohne einen commandref-Beitrag wird verweigert, da eine minimale Dokumentation Pflicht ist.
# Es dürfen keine Windows-Zeilenumbrüche in dem Beitrag enthalten sein (CR+LF). Es dürfen nur UNIX-Zeilenumbrüche verwendet werden (LF). Viele Editoren wie bspw. Notepad++ bieten entsprechende Einstellmöglichkeiten um das Zeilenende-Format zu konfigurieren.
# Nach dem einleitenden POD-Marker <code>#begin html</code> muss eine Leerzeile erfolgen. Dies gilt für alle weiteren Beiträge in anderen Sprachen (z.B. Deutsch: <code>#begin html_DE</code>).
# Ein Anker im Format <code><a name="'''''[Modulname]'''''"></code> muss am Anfang eines jeden commandref-Beitrag vorhanden sein. Dies dient als Sprungmarke in der fertig generierten commandref.html um vom Inhaltsmenü zum entsprechenden Beitrag springen zu können. Ohne einen solchen Anker, kann man den Beitrag vom Inhaltsverzeichnis aus nicht erreichen.
# Vor dem einchecken eines Moduls mit commandref sollten insbesondere bei Änderungen an der commandref dieses vorher mittels commandref_join.pl auf evtl. Fehler im Bezug auf das eigene Modul getestet werden. Sollten dort bei der Erstellung der commandref-HTML-Dateien eine Warnung erscheinen, so wird das Modul beim Commit verweigert werden, da die selben Prüf-Mechanismen beim Commit durchlaufen werden. Dies gilt insbesondere für HTML-Tag-Balance. Ein Modul, welches Fehler bei commandref_join.pl erzeugt, wird beim Commit verweigert.
# Es muss eine Kurzbeschreibung mit dem POD-Marker <code>=item summary</code> vorhanden sein. Die Beschreibung darf nicht länger als 80 Zeichen sein und soll eine kurze Beschreibung geben, was dieses Modul steuern kann, bzw. wofür es verwendet wird. Es geht hierbei darum dem Nutzer einen groben Eindruck zu vermitteln, wofür dieses Modul gedacht ist. Eine Kurzbeschreibung für weitere Sprachen (z.B Deutsch mit <code>=item summary_DE</code>) ist optional, darf aber nicht die 80 Zeichen überschreiten.

Weitere Informationen zur Commandref gibt es im Artikel: [[Guidelines zur Dokumentation]]

== SVN $Id$ Platzhalter ==

Jedes Geräte- oder Hilfsmodul was in /trunk/fhem/FHEM/ eingecheckt wird, muss einen gültigen $Id$ Platzhalter als Kommentar beinhalten. Dies dient der Versionsanzeige für den FHEM-Befehl <code>version</code>. Dieser Platzhalter wird durch SVN selbsttätig beim Check-In aktualisiert.

Dazu ist ein Kommentar im jeweiligen Modul als Kommentar notwendig. Am besten als Kopfzeile folgendes einfügen:
<syntaxhighlight lang="perl">
# $Id$

package main;

use strict;
use warnings;

...</syntaxhighlight>

Allerdings wird $Id$ jetzt noch nicht automatisch ersetzt. Dazu muss der Wert "Id" der SVN Property <code>svn:keywords</code> hinzugefügt werden. Dazu folgenden Befehl auf der Linux-Shell ausführen:

<code>svn propset svn:keywords Id '''''[Moduldatei]'''''</code>

Wenn man nun ein <code>svn diff</code> ausführt, sollte einem folgendes angezeigt werden:

Index: ''10_MODULE''.pm
===================================================================
--- ''10_MODULE''.pm (revision 10608)
+++ ''10_MODULE''.pm (working copy)

Property changes on: ''10_MODULE''.pm
___________________________________________________________________
Added: Id
## -0,0 +1 ##
+svn:keywords
\ No newline at end of property

Nun kann man das Modul einchecken. Beim Check-In wird dann der $Id$-Platzhalter durch beispielhaft folgende Zeile ersetzt:

<syntaxhighlight lang="perl">
# $Id: 10_MODULE.pm 10475 2016-01-12 18:51:31Z svn-username $

package main;

use strict;
use warnings;

...
</syntaxhighlight>

Diese $Id$-Zeile ist wichtig, denn sie dient dem FHEM-Kommando <code>version</code> als Grundlage um die Version aller Module zu ermitteln. Ein Modul welches entweder den Platzhalter als Kommentar nicht beinhaltet, oder die SVN-Property svn:keywords nicht angepasst hat, wird beim Check-In verweigert und abgelehnt.

== Commit Befehl im Terminal ==

Beispiel:
<syntaxhighlight lang="bash">
cd /opt/fhem
svn commit -m "XX_YYYYY.pm: was_wurde_geändert (Forum #12345)" FHEM/XX_YYYYY.pm
</syntaxhighlight>

[[Kategorie:Development]]

SVN Nutzungsregeln

2021-05-11T21:18:13Z

Herrmannj: svn terminal cmd add

Um als Entwickler im SVN Beiträge einzuchecken und zu betreuen gibt es einige Regeln, die beachtet werden sollten (und tlw. müssen) um ein reibungsloses Miteinander zu gewährleisten. Diese Regeln werden hier dargestellt.

= Organisatorisches =
== Wie bekomme ich einen Schreibzugriff auf das SVN? ==

Einen Schreibzugriff erhalten User, welche dauerhaft ein Modul entwickeln möchten und dies innerhalb der FHEM Community auch betreuen möchten. Generell gelten folgende Vorrausetzungen für einen SVN Account:

* eigenständige Weiterentwicklung des Moduls (Bugfixing, neue Features, Anpassungen an neue Features/API's)
* Support von Usern im FHEM-Forum zu Fragen des Moduls

Sollte dies der Fall sein, bitte eine Email an [mailto:svn@fhem.de svn@fhem.de] schicken mit den folgenden Infos:

* kurze Modulerklärung
* Link zum aktuellen Modul (FHEM Forum-Thread, ...)
* FHEM Forum Username
* SSH Public-Key zur Authentifizierung (siehe https://svn.fhem.de/)

Sofern alles passt, wird dem Username der Schreibzugriff gewährt und man kann sein Modul einchecken.

== Welche Files darf ich bearbeiten, welche nicht? ==

Generell gilt, jeder bearbeitet nur Dateien, die er selber beigesteuert hat. Das Anpassen von fremdem Modulen ohne Einverständnis des Eigentümers ist strikt untersagt!

Im SVN gibt es die Datei [https://svn.fhem.de/trac/browser/trunk/fhem/MAINTAINER.txt MAINTAINER.txt] in der die Zuständigkeiten für alle Module, Dateien und Verzeichnisse festgehalten sind.

Folgende Dateien dürfen von allen Entwicklern bearbeitet werden:

* [https://svn.fhem.de/trac/browser/trunk/fhem/CHANGED CHANGED] - kurz und knappe Einträge von nutzerrelevanten Änderungen an FHEM
* [https://svn.fhem.de/trac/browser/trunk/fhem/MAINTAINER.txt MAINTAINER.txt] - Eintrag/Änderungen von EIGENEN!!! Modulen

== Vorgehensweisen ==
=== Neues Modul ===
Bei einem neuen Modul gilt es zwischen zwei Ausgangsszenarien zu unterscheiden. Hierbei ist entscheiden, ob man bereits einen schreibenden Zugriff auf das FHEM SVN-Repository, sowie Zugang zum FHEM Developer Bereich im Forum besitzt, oder nicht.

Sollte man noch keinen Zugriff auf das [https://svn.fhem.de FHEM SVN Repository] haben, so kann man diesen per Mail beantragen (siehe dazu: [[#Wie_bekomme_ich_einen_Schreibzugriff_auf_das_SVN.3F|Wie bekomme ich einen Schreibzugriff auf das SVN?]]). Dabei ist es hilfreich einen Link zu dem neuen Modul der Anmeldung beizufügen oder dem Forums-Beitrag in dem das Modul bereits durch einzelne User positiv getestet wurde. Genauere Hinweise welche Voraussetzungen für die Aufnahme als Modulentwickler gelten sind im {{Link2Forum|Topic=18962|LinkText=Developer-Bereich}} im Forum dokumentiert.

Wer bereits einen Schreibzugriff auf das FHEM SVN-Repository besitzt, kann ein neues Modul selbstständig einchecken. Auch hier gelten die Hinweise für Entwickler aus dem {{Link2Forum|Topic=18962|LinkText=Developer Bereich}}.

Eine Ausnahme bilden hier Module, die auf weitere Perl-Module/Dateien/Binaries angewiesen sind, welche demnach mit eingecheckt werden müssten. Da solche Konstellationen generell unerwünscht ist, sollte man entweder mit den Repository-Maintainern Kontakt aufnehmen um das weitere Vorgehen zu besprechen, oder besser ganz auf solche Abhängigkeiten verzichten.

Sobald man sein eigenes Modul erfolgreich eingecheckt hat, sollte man einen Beitrag im Forumsbereich [https://forum.fhem.de/index.php/board,40.0.html Ankündigungen] einstellen in denen man das neue Modul kurz vorstellt und evtl. eine kurze Einführung gibt. Eine Diskussion zu dem neuen Modul sollte jedoch in einem separaten Forumsbereich erfolgen.

=== Änderungen an fremden Modulen ===

Die Änderungen von fremden Modulen ist ohne Einverständnis des Maintainers (siehe MAINTAINER.txt) ausdrücklich '''NICHT GESTATTET'''! Wenn man eine Änderung vorschlagen möchte, bitte einen entsprechenden Diff (via <code>svn diff</code> zu der aktuellen Modul-Version aus dem SVN erstellen und im entsprechenden Forum-Board (siehe MAINTAINER.txt) als Patch-Vorschlag einreichen. Der entsprechende Maintainer wird den Vorschlag anschließend prüfen und ggf. einchecken.

=== Änderungen an eigenen Modulen ===

Änderungen an eigenen Module, für die man selbst Maintainer ist, kann man frei ins SVN einbringen. Eine Änderung sollte dabei vor einem Check-In in einer lokalen FHEM-Installation ausreichend auf Stabilität und Fehlerfreiheit geprüft sein. Ebenso sollte die commandref-Dokumentation entsprechend angepasst werden, damit der User ein neues Feature dort nachlesen kann.

Bei größeren bzw. umfangreichen Änderungen, sollte man einen Beitrag im Forumsbereich [https://forum.fhem.de/index.php/board,40.0.html Ankündigungen] einstellen in denen man die Änderungen kurz vorstellt und evtl. eine kurze Einführung gibt. Eine Diskussion zu den Änderungen sollte jedoch in einem separaten Forumsbereich erfolgen.

{{Randnotiz|RNTyp=g|RNText=Generell sollte man immer vor einem Commit zuerst mittels <code>svn diff</code> prüfen, welche Änderungen genau zum Commit vorliegen. Erst wenn nach dem Durchsehen keine ungewollten Änderungen enthalten sind und alles vollständig enthalten ist, kann man den Commit mittels <code>svn commit</code> oder <code>svn ci</code> vornehmen.

Dadurch sollen ungewollte Änderungen an Fremd-Modulen/-Dateien vermieden werden.

Weitere Informationen und Hilfe zu SVN gibt es bspw. [http://svnbook.red-bean.com/index.de.html hier].}}
= Technische Regeln =

Um Änderungen an Modulen, als auch neue Module einchecken zu können, müssen ein paar Regeln beachtet werden. Dies dient der Sicherstellung eines gewissen Mindeststandards bei der Dokumentation der Entwicklungshistorie, sowie wichtigen Anforderungen an eine gültige Commandref-Dokumentation.

Falls diese nicht eingehalten werden, wird ein Commit verweigert. Die folgenden Regeln werden durch einen sogenannten pre-commit Hook automatisch beim einchecken geprüft. Sofern alles in Ordnung ist, wird der Vorgang erfolgreich durchgeführt.

== Commit Message ==

Jeder Check-In im SVN muss eine Commit-Message enthalten in der eine kurz und knappe Beschreibung der durchgeführten Änderungen auf Englisch erfolgt. Dabei ist wichtig, dass zuerst das Modul angegeben wird, an dem die Änderung durchgeführt wurde. Anschließend erfolgt getrennt von einem Doppelpunkt die Kurzbeschreibung. Eine Commit-Message muss folgendem Format entsprechen:

<MODULNAME><font color="#ff0000"><u>''':'''</u></font><BESCHREIBUNG>

Bsp:

FB_CALLLIST: don't create html code in readings when create-readings attribute is activated and number-cmd attribute is set.
10_ZWave.pm: implement sequential callbackId (Forum #50090)

Sollte ein Check-In in direktem Zusammenhang mit einem Forums-Beitrag sein, so sollte man diesen in Kurzform (Bsp: Angabe der Thread-ID) in der Commit-Message vermerken. Somit können andere aus der Commit-Message sofort die Diskussion im Forum finden um die Hintergründe zu einer bestimmten Änderung nachvollziehen zu können.

Wenn eine Commit-Message nicht diesem Format entspricht, wird ein Commit verweigert.

== Nummernpräfix bei Modulen darf nicht "99" sein ==

Jedes FHEM-Modul muss im Dateinamen immer ein 2-stelliges Nummernpräfix enthalten. Diese Zahl war früher für die Reihenfolge der Prüfung der [[DevelopmentModuleIntro#Die_Client-Liste|Client-Liste]] in [[DevelopmentModuleIntro#Zweistufiges_Modell_für_Module|zweistufigen Modulen]] zuständig. Heute besitzen die Modulnummern diese Funktion nicht mehr.

Das Präfix "99" hat aber eine besondere Eigenschaft. Alle Module die mit dem Präfix "99" versehen sind, werden beim Start von FHEM automatisch geladen. Dieses ist historisch bedingt um z.B. die 99_myUtils.pm immer zu laden.

Das Präfix "99" ist jedoch zur weiteren Verwendung gesperrt um ein automatisches Laden von weiteren Modulen zu verhindern. Generell werden in FHEM Module bei der erstmaligen Verwendung automatisch geladen.

Neue Module, die das Nummernpräfix "99" tragen (z.B. "99_MyModule.pm") werden beim Check-In zurückgewiesen.

== CHANGED Eintrag ==

Ein Eintrag in der Datei CHANGED darf max. 80 Zeichen pro Zeile enthalten. Dies dient der Lesbarkeit der Änderungen in der FHEM-Oberfläche insbesondere auf kleinen Geräten. Sollten man Zeilen in CHANGED einzufügen, welche mehr als 80 Zeichen pro Zeile enthalten, wird ein Check-In verweigert.

Dies gilt aktuell nur für die Datei CHANGED. Als Zeichen dienen alle sichtbaren Zeichen, als auch jedes einzelne Leerzeichen. Tabulatoren sind hierbei verboten und werden beim Check-In ebenfalls zurückgewiesen.

== commandref-Regeln ==

Jedes Gerätemodul welches eingecheckt wird, muss einen commandref-Beitrag enthalten (mindestens in Englisch). Dieser Abschnitt muss bestimmte Regeln erfüllen, um in das SVN gelangen zu können:

# mindestens ein commandref-Beitrag auf Englisch (POD-Marker: <code>#begin html</code> sowie <code>#end html</code>). Ein Modul ohne einen commandref-Beitrag wird verweigert, da eine minimale Dokumentation Pflicht ist.
# Es dürfen keine Windows-Zeilenumbrüche in dem Beitrag enthalten sein (CR+LF). Es dürfen nur UNIX-Zeilenumbrüche verwendet werden (LF). Viele Editoren wie bspw. Notepad++ bieten entsprechende Einstellmöglichkeiten um das Zeilenende-Format zu konfigurieren.
# Nach dem einleitenden POD-Marker <code>#begin html</code> muss eine Leerzeile erfolgen. Dies gilt für alle weiteren Beiträge in anderen Sprachen (z.B. Deutsch: <code>#begin html_DE</code>).
# Ein Anker im Format <code><a name="'''''[Modulname]'''''"></code> muss am Anfang eines jeden commandref-Beitrag vorhanden sein. Dies dient als Sprungmarke in der fertig generierten commandref.html um vom Inhaltsmenü zum entsprechenden Beitrag springen zu können. Ohne einen solchen Anker, kann man den Beitrag vom Inhaltsverzeichnis aus nicht erreichen.
# Vor dem einchecken eines Moduls mit commandref sollten insbesondere bei Änderungen an der commandref dieses vorher mittels commandref_join.pl auf evtl. Fehler im Bezug auf das eigene Modul getestet werden. Sollten dort bei der Erstellung der commandref-HTML-Dateien eine Warnung erscheinen, so wird das Modul beim Commit verweigert werden, da die selben Prüf-Mechanismen beim Commit durchlaufen werden. Dies gilt insbesondere für HTML-Tag-Balance. Ein Modul, welches Fehler bei commandref_join.pl erzeugt, wird beim Commit verweigert.
# Es muss eine Kurzbeschreibung mit dem POD-Marker <code>=item summary</code> vorhanden sein. Die Beschreibung darf nicht länger als 80 Zeichen sein und soll eine kurze Beschreibung geben, was dieses Modul steuern kann, bzw. wofür es verwendet wird. Es geht hierbei darum dem Nutzer einen groben Eindruck zu vermitteln, wofür dieses Modul gedacht ist. Eine Kurzbeschreibung für weitere Sprachen (z.B Deutsch mit <code>=item summary_DE</code>) ist optional, darf aber nicht die 80 Zeichen überschreiten.

Weitere Informationen zur Commandref gibt es im Artikel: [[Guidelines zur Dokumentation]]

== SVN $Id$ Platzhalter ==

Jedes Geräte- oder Hilfsmodul was in /trunk/fhem/FHEM/ eingecheckt wird, muss einen gültigen $Id$ Platzhalter als Kommentar beinhalten. Dies dient der Versionsanzeige für den FHEM-Befehl <code>version</code>. Dieser Platzhalter wird durch SVN selbsttätig beim Check-In aktualisiert.

Dazu ist ein Kommentar im jeweiligen Modul als Kommentar notwendig. Am besten als Kopfzeile folgendes einfügen:
<syntaxhighlight lang="perl">
# $Id$

package main;

use strict;
use warnings;

...</syntaxhighlight>

Allerdings wird $Id$ jetzt noch nicht automatisch ersetzt. Dazu muss der Wert "Id" der SVN Property <code>svn:keywords</code> hinzugefügt werden. Dazu folgenden Befehl auf der Linux-Shell ausführen:

<code>svn propset svn:keywords Id '''''[Moduldatei]'''''</code>

Wenn man nun ein <code>svn diff</code> ausführt, sollte einem folgendes angezeigt werden:

Index: ''10_MODULE''.pm
===================================================================
--- ''10_MODULE''.pm (revision 10608)
+++ ''10_MODULE''.pm (working copy)

Property changes on: ''10_MODULE''.pm
___________________________________________________________________
Added: Id
## -0,0 +1 ##
+svn:keywords
\ No newline at end of property

Nun kann man das Modul einchecken. Beim Check-In wird dann der $Id$-Platzhalter durch beispielhaft folgende Zeile ersetzt:

<syntaxhighlight lang="perl">
# $Id: 10_MODULE.pm 10475 2016-01-12 18:51:31Z svn-username $

package main;

use strict;
use warnings;

...
</syntaxhighlight>

Diese $Id$-Zeile ist wichtig, denn sie dient dem FHEM-Kommando <code>version</code> als Grundlage um die Version aller Module zu ermitteln. Ein Modul welches entweder den Platzhalter als Kommentar nicht beinhaltet, oder die SVN-Property svn:keywords nicht angepasst hat, wird beim Check-In verweigert und abgelehnt.

== Commit Befehl im Terminal ==

Beispiel:

cd /opt/fhem
svn commit -m "XX_YYYYY.pm: was_wurde_geändert (Forum #12345)" FHEM/XX_YYYYY.pm

[[Kategorie:Development]]

Hauptseite

2016-06-16T21:36:53Z

Herrmannj:

{{DISPLAYTITLE:FHEMWiki - Informationsportal zum FHEM Hausautomationsserver}}
{| width="100%"


| colspan="2" style="padding: 0;" |
|-
| style="width: 60%; background-color: red; border: 1px solid maroon; border-radius: 8px; padding: 0 1em 1em 1em;" colspan="2" |
<div style="font-size: bigger; text-align: center;">
'''Das fhem forum befindet sich im Augenblick im Wartungsmodus. Die Ursache ist ein Hardwaredefekt und wir arbeiten mit Hochdruck daran das Forum wieder zur Verfügung zu stellen.'''

'''Wir bitten um etwas Geduld.'''
</div>


|-
|style="vertical-align:top" |

<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; border-radius: 8px; padding: 0 1em 1em 1em; background-color:#cce5ff;">

'''Was ist FHEM?'''

'''FHEM''' ist ein Hausautomations-Server von Rudolf Koenig et al. in Perl geschrieben, um diverse per Funk und Kabel angebundene [[:Kategorie:Hardware|Komponenten]] aus dem Bereich der Hausautomation zu steuern. Er ist lizensiert unter der GPL v2. Das FHEMWiki stellt neben dem [http://forum.fhem.de/ Forum] und der [http://www.fhem.de FHEM] Seite die zentrale Informationsquelle rund um FHEM dar.

{{NUMBEROFUSERS}} [[Special:Listusers|Benutzer]] haben sich seit Mai 2013 registriert und {{NUMBEROFARTICLES}} Artikel geschrieben. ({{NUMBEROFEDITS}} Seitenänderungen bislang).

Bitte [[FHEMWiki:Support | unterstütze uns]] und hilf, [[:Kategorie:NeedsEditing| das Wiki zu erweitern]]. Vielen Dank!

<div align="right"><small>'''Mehr [[FHEMWiki:Über_FHEMWiki|über FHEMWiki]]'''</small></div>
</div>

<div style="margin: 0; margin-top:10px; margin-right:10px; border: 1px solid #dfdfdf; border-radius: 8px; padding: 0em 1em 1em 1em; background-color:#efefef;">
'''Wie fange ich an?'''
* [[Datei:Info_green.png|20px]][http://fhem.de/Heimautomatisierung-mit-fhem.pdf FHEM-Übersicht für Anfänger][[Datei:Info_green.png|20px]]<br />DER Startpunkt. '''Pflichtlektüre!'''<br />
* Ein kleiner FHEM-Kurs, benötigt keine Hardware: [[Erste_Schritte_in_fhem|Erste Schritte in FHEM]]
* [[Systemübersicht]]
* Phasen eines FHEM-Projekts:
** [[Planung]]
** [[Umsetzung]] (Implementierung)
** [[Betrieb]] ("Produktion")
* [[:Kategorie:Glossary|Glossar]] (Erklärung für bestimmte Begriffe)<br />
* [[:Kategorie:HOWTOS|Verschiedene HowTos]]<br />
* [[:Kategorie:FAQ|Frequently asked Questions - Häufig gestellte Fragen mit Antworten]]<br />

</div>

<div style="margin: 0; margin-top:10px; margin-right:10px; border: 1px solid #dfdfdf; border-radius: 8px; padding: 0 1em 1em 1em; background-color:#fff0e0;">
'''Unterstützte Hardware'''

* [[:Kategorie:Hardware Typen|Hardware Typen]] - Funktionsbezogene Übersicht (z.B. [[:Kategorie:Unterhaltungselektronik|Unterhaltungselektronik / Multimedia]], [[:Kategorie:Heizungssteuerung|Heizungssteuerung]], [[:Kategorie:Energieverbrauchsmessung|Energieverbrauchsmessung]], etc.)
* [[:Kategorie:Server Hardware|Server Hardware]] - Hardware, auf der FHEM installiert werden kann
* [[:Kategorie:FS20 Components|FS20 Komponenten]]
* [[:Kategorie:panStamp|panStamp Komponenten]]
* [[:Kategorie:HMS Components|HMS Komponenten]]
* [[:Kategorie:EMS Components|EMS Komponenten]]
* [[:Kategorie:FHT Components|FHT Komponenten]]
* [[:Kategorie:1-Wire|1-Wire System]]
* [[:Kategorie:EIB/KNX|EIB/KNX Komponenten]]
* [[:Kategorie:EnOcean Components|EnOcean Komponenten]]
* [[:Kategorie:HomeMatic Components|HomeMatic Komponenten]]
* [[:Kategorie:MAX|MAX! Komponenten]]
* [[:Kategorie:Z-Wave Components|Z-Wave Komponenten]]
* [[:Kategorie:IP Components|Geräte mit Webinterface ("IP")]]
* [[:Kategorie:Other Components|Andere Komponenten / Sonstige Systeme]]

<div align="right"><small>'''[[:Kategorie:Hardware|Alle Hardware-Kategorien]]'''</small></div>
</div>

<div style="margin:0; margin-top:10px; margin-right:10px; border:1px solid #dfdfdf; border-radius: 8px; padding:0 1em 1em 1em; background-color:#F8F8FF;">
'''Ideen und Lösungen'''

* [[:Kategorie:Code_Snippets|Verschiedene kommentierte Lösungen und Code-Schnippsel]]
* [[:Kategorie:Examples|Beispielanwendungen - Hardwarelösungen - Fremdsystemanbindungen]]
* [[Anwendungsszenarien]]
* [[Trick der Woche|Tipp der Woche]]
* [[Wie kann ich...]]?

<div align="right"><small>'''[[:Kategorie:FHEM|FHEM-Haupt-Kategorien]]'''</small></div>
</div>

<div style="margin:0; margin-top:10px; margin-right:10px; border:1px solid #dfdfdf; border-radius: 8px; padding:0 1em 1em 1em; background-color:#FFFFE7;">
'''Developers Corner'''

* [[:DevelopmentModuleIntro|Development Module Introduction]]
* [[:DevelopmentGuidelinesAV|Development Guidelines AV-Module]]
* [[:How_to_write_a_patch|How to write a patch]]

<div align="right"><small>'''[[:Kategorie:Development|Alle Artikel zu Development]]'''</small></div>
</div>

| width="55%" style="vertical-align:top" |
<div style="margin:0; border:1px solid #888888; border-radius: 8px; padding: 0em 1em 1em 1em; background-color:#d7ffff;height:14em;">
'''FHEMWiki News'''
<div style="font-size:small;height:10em;overflow:scroll;overflow-x:hidden;"><small>{{FHEMWiki_News}}</small></div>
<div align="right"><small>'''Mehr [[FHEMWiki:News|News]]'''</small></div>
</div>

<div style="margin:0; margin-top:10px; border:1px solid #dfdfdf; border-radius: 8px; padding:0 1em 1em 1em; background-color:#F8F8FF;">
'''Letzte Änderungen'''
<div style="font-size:small;color:black;"><small>{{Special:Recentchanges/5}}</small></div>
<div align="right"><small>'''Mehr [[Special:Recentchanges|Änderungen]]'''</small></div>
</div>


<div style="margin:0; margin-top:10px; border:1px solid #dfdfdf; border-radius: 8px; padding:0 1em 1em 1em; background-color:#FFFFAA;">
'''Die letzten fünf neuen Seiten'''
<small>{{Special:NewPages/5}}</small>
<div align="right"><small>'''Mehr [[Special:NewPages|Neue Seiten]]'''</small></div>
</div>


<div style="margin:0; margin-top:10px; border:1px solid #dfdfdf; border-radius: 8px; padding:0 1em 1em 1em; background-color:#DDD68F;">
'''Administratives zum Wiki'''

''Allgemeine Aktivitäten:''
* Registrierung zur Mitarbeit: wende Dich bitte an einen [[FHEMWiki:Administratoren|Administrator]]
* Basiswissen über die Mitarbeit an einem Wiki erarbeiten ([http://de.wikipedia.org/wiki/Wikipedia:Beteiligen z.B. Wikipedia])
* Erweiterung und Korrektur von Artikeln, wo immer nötig
* Ein(ig)e der [[Spezial:Gewünschte Seiten|gewünschten Seiten]] erstellen
* Ideen aus dem [http://forum.fhem.de Forum] in bestehende oder neue Artikel einarbeiten
* [[Spezial:Verwaiste Seiten|verwaiste Seiten]] in sinnvoller Weise verlinken
* [[Spezial:Sackgassenseiten|Sackgassenseiten]] wikifizieren (Links auf andere Seiten einfügen)
* [[Datei:Info_red.png|20px]] '''Tips / Regeln / Hinweise auf "[[FHEMWiki:Über FHEMWiki|Über FHEMWiki]]" beachten!''' [[Datei:Info_red.png|20px]]


''Aktivitäten für Administratoren:''
* Sichten / Löschen von [[:Kategorie:Löschkandidaten|Löschkandidaten]]
* Vorschlag: Einrichten einer Seite, auf der Anfragen an Benutzer mit Admin-Rechten eingetragen werden können
* Beobachten der "Letzten Änderungen"

''Sonstiges:''
* Zum Ausprobieren bitte die [[FHEMWiki:Sandbox]] benutzen
* [//meta.wikimedia.org/wiki/Help:Contents Wiki Benutzerhandbuch].
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Liste der Wiki-Konfigurationsvariablen]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [[FHEMWiki:Interna|Internes zu diesem Wiki]]
</div>

|}

[[Kategorie:FHEM]]

WifiLight

2016-01-11T21:34:12Z

Herrmannj:

{{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 ====
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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

WMBUS

2015-10-18T20:42:47Z

Herrmannj: Link zu Techem Heizkostenverteiler hinzugefügt

{{Infobox Modul
|ModPurpose=Dekodierung von Wireless M-Bus Nachrichten
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=36_WMBUS.pm
|ModOwner=kaihs
}}
[[WMBUS]] ist ein Modul zur Dekodierung von Wireless M-Bus Nachrichten. Solche Nachrichten werden z. B. von Zählern für Wasser, Wärme, Gas und Elektrizität ausgestrahlt.
Wireless M-Bus ist ein Standardprotokoll das von unterschiedlichen Herstellern unterstützt wird.
Das Protokoll unterstützt unterschiedliche Kodierungen des Funksignals, im wesentlichen den sogenannten S-Mode und den T-Mode. Der Empfänger (z. B. ein CUL) muss den selben Modus nutzen wie der Sender (der Zähler).
Wireless M-Bus unterstützt optional die Verschlüsselung der Daten per AES.
Die von einem Zähler gesendeten Daten können sehr unterschiedlich sein und hängen u. a. vom Zählertyp und dessen Hersteller ab.

== Voraussetzungen ==
Das Modul interpretiert nur die Nachrichten die von einen geeigneten Empfänger empfangen werden. Im Moment sind ein [[CUL]] und verwandte Geräte die die culfw[http://culfw.de/culfw.html] verwenden dazu in der Lage. In der culfw muss die Unterstützung des WMBUS-Protokolls aktiviert sein (#define HAS_MBUS). Bei einem CUL mit der Hardwareversion V4 ist das nicht der Fall.

Der CUL muss in fhem mittels Attribut rfmode=WMBus_S oder WMBus_T in den zum Zähler passenden Empfangsmodus versetzt werden.

== Anwendung ==
Die Erzeugung des passenden Devices in fhem geschieht automatisch beim Empfang des ersten Datenpakets eines Zählers. Voraussetzung dafür ist, dass [[autocreate]] aktiv ist.
Alternativ kann ein Device manuell angelegt werden. Dazu wird der Hersteller, die Seriennummer, die Version und der Typ (Wasser, Gas, ...) des Zählers benötigt.
Sind die Daten verschlüsselt wird auch noch der passende Schlüssel benötigt um die Daten entschlüsseln zu können.

== Anwendungsbeispiele ==
Ein per [[EnergyCam]] abgelesener Elektrizitätszähler sieht in fhem z. B. so aus:
<pre>
Internals:
CUL_MBUS_MSGCNT 29
CUL_MBUS_RAWMSG b1944C4189985051701028A7D7A540000A00405FAD4080002FD08222C1295B8::-67.5
CUL_MBUS_RSSI -67.5
CUL_MBUS_TIME 2014-10-24 22:57:53
DEF FFD 17058599 1 2
DeviceMedium Electricity
DeviceType 2
IODev CUL_MBUS
IdentNumber 17058599
LASTInputDev CUL_MBUS
MSGCNT 29
Manufacturer FFD
NAME WMBUS_FFD_17058599_1_2
NR 49
STATE no errors
TYPE WMBUS
Version 1
addr FFD_17058599_1_2
Readings:
2014-10-24 22:57:53 1_storage_no 0
2014-10-24 22:57:53 1_type VIF_ENERGY_WATT
2014-10-24 22:57:53 1_unit Wh
2014-10-24 22:57:53 1_value 57881000
2014-10-24 22:57:53 2_storage_no 0
2014-10-24 22:57:53 2_type VIF_ACCESS_NO
2014-10-24 22:57:53 2_unit
2014-10-24 22:57:53 2_value 11298
2014-10-24 22:57:53 LQI 184
2014-10-24 22:57:53 RSSI -67.5
2014-10-24 22:57:53 battery ok
2014-10-24 22:57:53 decryption_ok 1
2014-10-24 22:57:53 energy 57881
2014-10-24 22:57:53 is_encrypted 0
2014-10-24 22:57:53 state no errors
2014-10-24 22:57:53 unit kWh
Attributes:
IODev CUL_MBUS
room WMBUS
</pre>

== Bekannte Probleme ==
Obwohl Wireless M-Bus ein standardisiertes Protokoll ist, scheint sich kaum ein Hersteller vollständig daran zu halten bzw. verwendet sog. herstellerspezifische Felder um wichtige Daten zu verpacken.
Aus den bisher beobachteten Datenpaketen ergibt sich
* Qundis (Herstellerkürzel LSE) verwendet herstellerspezifische Datenblöcke für den eigentlichen Zählerstand
* Techem und Hydrometer verwenden ein undokumentiertes Datenformat (CI-Field A2)
:''(Techem Heizkostenverteiler (CI-Field A0) können über das Modul [[TechemHKV]] ausgewertet werden)''
* RWE SmartHome Powercontrol[http://www.rwe-smarthome.de/web/cms/de/1776202/smarthome/informieren/geraete/power-control/] sendet verschlüsselt und der Hersteller gibt nicht den vollständigen Schlüssel an[http://forum.fhem.de/index.php/topic,24517.msg315949.html#msg315949]

Daher werden bisher erst die [[EnergyCam]] der Fast Forward AG und Zähler von Easymeter vollständig unterstützt.

== Links ==
* Forumsthread [http://forum.fhem.de/index.php/topic,24517.0.html]
* Protokoll Beschreibung [http://oms-group.org/download4all/]
* Beschreibung des M-BUS Protokolls [http://www.m-bus.com/files/MBDOC48.PDF]
[[Kategorie:Energieverbrauchsmessung]]

TechemHKV

2015-10-18T20:33:06Z

Herrmannj: Die Seite wurde neu angelegt: „{{Infobox Modul |ModPurpose=Anzeige der Daten eines Techem data Heizkostenverteiler |ModType=d |ModForumArea=Sonstige Systeme |ModTechName=32_TechemHKV.pm |Mod…“

{{Infobox Modul
|ModPurpose=Anzeige der Daten eines Techem data Heizkostenverteiler
|ModType=d
|ModForumArea=Sonstige Systeme
|ModTechName=32_TechemHKV.pm
|ModOwner=herrmannj
}}
[[TechemHKV]]
Das modul empfängt Daten eines Techem Heizkostenverteilers.

Empfangen werden

* Wert des aktuellen Abrechnungszeitraumes
* Wert des vorhergehenden Abrechnungszeitraumes einschließlich des Ablesedatums
* Beide Temperatur Sensoren

Zum Empfang wird ein CUL im WMBUS_T mode benötigt. Dabei ist es ausreichend ihn vorrübergehend in diesen Modus zu schalten. Das Modul überwacht den rfmode aller verfügbaren CUL

==Define==
<code>define <name> TechemHKV <4|8 digit ID> [<speaking name>]</code>

* ID: 4 Ziffern wie auf dem Heizkostenverteiler angezeigt oder 8 Ziffern aus der Abrechnung
* speaking name: (optional) Bezeichnung

==Readings==

===current_period===
''Wert des aktuellen Abrechnungszeitraumes''
Der kumulierte (einheitenlose) Verbrauch seid dem Start des aktuellen Abrechnungszeitraumes. Das reading wird einmal am Tag aktualisiert. Die Zeit kennzeichnet den Stand der Daten. (und nicht den Empfangszeitpunkt der Daten)
===previous_period===
''Summe des letzten Abrechnungszeitraum''
Die (einheitenlose) Summe der Verbauchs im gesamten letzten Abrechnungszeitraum. Das reading wird jeweils zu Beginn eines neuen Abrechnungszeitraumes aktualisiert. Die Zeit kennzeichnet das Ablesedatum also das Ende des vorherigen Abrechnugszeitraumes. (und nicht den Empfangszeitpunkt der Daten)
===temp1===
Umgebungstemperatur
===temp2===
Oberflächentemperatur des Heizkörpers

==Internals==

===friendly===
die beim define übergebene, zusätzliche Bezeichnung

===longID===
8 Ziffern ID des Heizkostenverteilers

[[Kategorie:Energieverbrauchsmessung]]

WifiLight

2015-02-24T21:06:01Z

Herrmannj: /* Installation */

{{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, 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

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

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

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert:
<code>update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt</code>

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

WifiLight

2015-02-24T21:05:29Z

Herrmannj:

{{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, 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

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

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

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert: <code>update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt</code>

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

WifiLight

2015-02-24T21:04:03Z

Herrmannj:

{{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, 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

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

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

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=Achtung: Das modul ist nicht Bestandteil der fhem Standardinstallation weil der dev lieber die Unterstützung neuer Controller einbaut anstelle die Doku zu schreiben :)}}
Das Modul wird bequem so installiert: update force https://raw.githubusercontent.com/herrmannj/wifilight/master/controls_wifilight.txt.

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

SmartVISU/lichtSzene

2014-12-22T02:12:11Z

Herrmannj:

mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen.

So soll es aussehen:

[[Datei:Smartvisu_Lichtszene_radio_buttons.png|600px|thumb|left|Screenshot Frontend smartVISU]]

Die Radio Buttons sollen dabei in einem Raum folgende Lichtszenen steuern:

* automatische Beleuchtung
* Fernsehen
* Arbeitsbeleuchtung
* Essen
* Party
* volle Beleuchtung
* Weihnachtsbeleuchtung
* alles Aus

Die gewünschte Funktionalität ist dabei das sich die Lichtszenen umschalten lassen. Wenn eine bereits aktivierte Funktion nochmal betätigt wird entspricht das "aus". Die Weihnachtsbeleuchtung soll sich unabhängig von den anderen Beleuchtungs Szenen aktivieren oder deaktivieren lassen.

Als Referenz ein Link auf die Online Hilfe von sv zu den hierfür eingesetzten button (typ dual)
[http://www.smartvisu.de/docu/2.7/index.php?page=basic/widget_basic.dual]

Der Screenshot oben wird mit diesem code in sv erzeugt:
<nowiki>
<div class="cells">
<div class="cell4 ui-btn-up-a">Lichtszene</div>
<div class="cell6 ui-btn-up-a">
<span data-role="controlgroup" data-type="horizontal">
{{ basic.dual('light.a', 'wz.light.szene.auto', icon1~'time_automatic.png', icon0~'time_automatic.png', 'auto', 'off', 'midi') }}
{{ basic.dual('light.b', 'wz.light.szene.tv', icon1~'it_television.png', icon0~'it_television.png', 'tv', 'off', 'midi') }}
{{ basic.dual('light.c', 'wz.light.szene.work', icon1~'light_ceiling_light.png', icon0~'light_ceiling_light.png', 'work', 'off', 'midi') }}
{{ basic.dual('light.d', 'wz.light.szene.eat', icon1~'light_dinner_table.png', icon0~'light_dinner_table.png', 'eat', 'off', 'midi') }}
{{ basic.dual('light.e', 'wz.light.szene.party', icon1~'light_party.png', icon0~'light_party.png', 'party', 'off', 'midi') }}
{{ basic.dual('light.f', 'wz.light.szene.full', icon1~'light_light_dim_100.png', icon0~'light_light_dim_100.png', 'full', 'off', 'midi') }}
{{ basic.dual('light.g', 'wz.light.szene.xmas', icon1~'scene_x-mas.png', icon0~'scene_x-mas.png', 'on', 'off', 'midi') }}
{{ basic.dual('light.h', 'wz.light.szene.off', icon1~'control_on_off.png', icon0~'control_on_off.png', 'off', 'off', 'midi') }}
</span>
</div>
</div>
</nowiki>

In diesem Beispiel wird in fhem dazu ein dummy erzeugt über den die Lichtszenen gesteuert werden. Natürlich gäbe es auch alternative Umsetzungen, bspw mit lightscene)

Der dummy (name wz.licht.scene) bekommt diese setlist
<nowiki>
define wz.licht.scene dummy
attr wz.licht.scene setList off auto tv eat work party full
</nowiki>

[[Datei:fronthem_gadeditor_lichtszene.png|600px|thumb|right|ronthem Editor]]

Nach einem reload der sv Seite werden die oben definierten GADs vom fronthemDevice in fhem angezeigt (hier mit bereits definierten GAD). Jetzt müssen die buttons (über ihr GAD) mit der fhem Funktionalität verbunden werden. Hier soll jeder button mit seinem Value den dummy setzen.

Mit den folgenden Einstellungen, die für jedes GAD der Button Group durchgefühert werden müssen, wird das erwünschte Verhalten erreicht. Jeder Button der Group setzt das dummy jetzt auf den den seinen "ON-VALUE" (dritt - vorletzter Wert in der definition oben). Ein weiterer Click (oder der rechte Button) setzt alles aus.

Für die Weihanchtsbeleuchtung wird unabhängig ein Steckdose geschaltet, das ist hier nicht dargestellt.

SmartVISU/lichtSzene

2014-12-22T02:10:03Z

Herrmannj:

mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen.

So soll es aussehen:

[[Datei:Smartvisu_Lichtszene_radio_buttons.png|600px|thumb|left|Screenshot Frontend smartVISU]]

Die Radio Buttons sollen dabei in einem Raum folgende Lichtszenen steuern:

* automatische Beleuchtung
* Fernsehen
* Arbeitsbeleuchtung
* Essen
* Party
* volle Beleuchtung
* Weihnachtsbeleuchtung
* alles Aus

Die gewünschte Funktionalität ist dabei das sich die Lichtszenen umschalten lassen. Wenn eine bereits aktivierte Funktion nochmal betätigt wird entspricht das "aus". Die Weihnachtsbeleuchtung soll sich unabhängig von den anderen Beleuchtungs Szenen aktivieren oder deaktivieren lassen.

Als Referenz ein Link auf die Online Hilfe von sv zu den hierfür eingesetzten button (typ dual)
[http://www.smartvisu.de/docu/2.7/index.php?page=basic/widget_basic.dual]

Der Screenshot oben wird mit diesem code in sv erzeugt:
<nowiki>
<div class="cells">
<div class="cell4 ui-btn-up-a">Lichtszene</div>
<div class="cell6 ui-btn-up-a">
<span data-role="controlgroup" data-type="horizontal">
{{ basic.dual('light.a', 'wz.light.szene.auto', icon1~'time_automatic.png', icon0~'time_automatic.png', 'auto', 'off', 'midi') }}
{{ basic.dual('light.b', 'wz.light.szene.tv', icon1~'it_television.png', icon0~'it_television.png', 'tv', 'off', 'midi') }}
{{ basic.dual('light.c', 'wz.light.szene.work', icon1~'light_ceiling_light.png', icon0~'light_ceiling_light.png', 'work', 'off', 'midi') }}
{{ basic.dual('light.d', 'wz.light.szene.eat', icon1~'light_dinner_table.png', icon0~'light_dinner_table.png', 'eat', 'off', 'midi') }}
{{ basic.dual('light.e', 'wz.light.szene.party', icon1~'light_party.png', icon0~'light_party.png', 'party', 'off', 'midi') }}
{{ basic.dual('light.f', 'wz.light.szene.full', icon1~'light_light_dim_100.png', icon0~'light_light_dim_100.png', 'full', 'off', 'midi') }}
{{ basic.dual('light.g', 'wz.light.szene.xmas', icon1~'scene_x-mas.png', icon0~'scene_x-mas.png', 'xmas', 'off', 'midi') }}
{{ basic.dual('light.h', 'wz.light.szene.off', icon1~'control_on_off.png', icon0~'control_on_off.png', 'off', 'off', 'midi') }}
</span>
</div>
</div>
</nowiki>

In diesem Beispiel wird in fhem dazu ein dummy erzeugt über den die Lichtszenen gesteuert werden. Natürlich gäbe es auch alternative Umsetzungen, bspw mit lightscene)

Der dummy (name wz.licht.scene) bekommt diese setlist
<nowiki>
define wz.licht.scene dummy
attr wz.licht.scene setList off auto tv eat work party full
</nowiki>

[[Datei:fronthem_gadeditor_lichtszene.png|600px|thumb|right|ronthem Editor]]

Nach einem reload der sv Seite werden die oben definierten GADs vom fronthemDevice in fhem angezeigt (hier mit bereits definierten GAD). Jetzt müssen die buttons (über ihr GAD) mit der fhem Funktionalität verbunden werden. Hier soll jeder button mit seinem Value den dummy setzen.

Mit den folgenden Einstellungen, die für jedes GAD der Button Group durchgefühert werden müssen, wird das erwünschte Verhalten erreicht. Jeder Button der Group setzt das dummy jetzt auf den den seinen "ON-VALUE" (dritt - vorletzter Wert in der definition oben). Ein weiterer Click (oder der rechte Button) setzt alles aus.

Für die Weihanchtsbeleuchtung wird unabhängig ein Steckdose geschaltet, das ist hier nicht dargestellt.

Datei:Fronthem gadeditor lichtszene.png

2014-12-22T01:52:37Z

Herrmannj:

SmartVISU/lichtSzene

2014-12-22T01:51:53Z

Herrmannj:

mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen.

So soll es aussehen:

[[Datei:Smartvisu_Lichtszene_radio_buttons.png|600px|thumb|left|Screenshot Frontend smartVISU]]

Die Radio Buttons sollen dabei in einem Raum folgende Lichtszenen steuern:

* automatische Beleuchtung
* Fernsehen
* Arbeitsbeleuchtung
* Essen
* Party
* volle Beleuchtung
* Weihnachtsbeleuchtung
* alles Aus

Die gewünschte Funktionalität ist dabei das sich die Lichtszenen umschalten lassen. Wenn eine bereits aktivierte Funktion nochmal betätigt wird entspricht das "aus". Die Weihnachtsbeleuchtung soll sich unabhängig von den anderen Beleuchtungs Szenen aktivieren oder deaktivieren lassen.

Der Screenshot oben wird mit diesem code in sv erzeugt:
<nowiki>
<div class="cells">
<div class="cell4 ui-btn-up-a">Lichtszene</div>
<div class="cell6 ui-btn-up-a">
<span data-role="controlgroup" data-type="horizontal">
{{ basic.dual('light.a', 'wz.light.szene.auto', icon1~'time_automatic.png', icon0~'time_automatic.png', 'auto', 'off', 'midi') }}
{{ basic.dual('light.b', 'wz.light.szene.tv', icon1~'it_television.png', icon0~'it_television.png', 'tv', 'off', 'midi') }}
{{ basic.dual('light.c', 'wz.light.szene.work', icon1~'light_ceiling_light.png', icon0~'light_ceiling_light.png', 'work', 'off', 'midi') }}
{{ basic.dual('light.d', 'wz.light.szene.eat', icon1~'light_dinner_table.png', icon0~'light_dinner_table.png', 'eat', 'off', 'midi') }}
{{ basic.dual('light.e', 'wz.light.szene.party', icon1~'light_party.png', icon0~'light_party.png', 'party', 'off', 'midi') }}
{{ basic.dual('light.f', 'wz.light.szene.full', icon1~'light_light_dim_100.png', icon0~'light_light_dim_100.png', 'full', 'off', 'midi') }}
{{ basic.dual('light.g', 'wz.light.szene.xmas', icon1~'scene_x-mas.png', icon0~'scene_x-mas.png', 'xmas', 'off', 'midi') }}
{{ basic.dual('light.h', 'wz.light.szene.off', icon1~'control_on_off.png', icon0~'control_on_off.png', 'off', 'off', 'midi') }}
</span>
</div>
</div>
</nowiki>

In diesem Beispiel wird in fhem dazu ein dummy erzeugt über den die Lichtszenen gesteuert werden. Natürlich gäbe es auch alternative Umsetzungen, bspw mit lightscene)

Der dummy (name wz.licht.scene) bekommt diese setlist
<nowiki>
define wz.licht.scene dummy
attr wz.licht.scene setList off auto tv eat work party full
</nowiki>

Nach einem reload der sv Seite werden die oben definierten GADs vom fronthemDevice in fhem angezeigt: (hier mit bereits definierten GAD)

[[Datei:fronthem_gadeditor_lichtszene.png|400px]]

SmartVISU/lichtSzene

2014-12-22T01:33:43Z

Herrmannj:

SmartVISU/lichtSzene

2014-12-22T01:33:12Z

Herrmannj:

mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen.

So soll es aussehen:

[[Datei:Smartvisu_Lichtszene_radio_buttons.png|200px|thumb|left|Alternativer Text]]

SmartVISU/lichtSzene

2014-12-22T01:32:56Z

Herrmannj: Die Seite wurde neu angelegt: „mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen. So soll es aussehen: [[Datei:Smartvisu_Lichtszene_radio_butto…“

mit dem folgenden Code lässt sich eine Auswahl für Lichtszenen in smartVisu / fhem erstellen.

So soll es aussehen:

[[Datei:Smartvisu_Lichtszene_radio_buttons.png200px|thumb|left|Alternativer Text]]

Datei:Smartvisu Lichtszene radio buttons.png

2014-12-22T01:31:59Z

Herrmannj:

SmartVISU/IconHighlights in Menus

2014-12-21T17:01:27Z

Herrmannj: Die Seite wurde neu angelegt: „Mit dem folgenden Code lassen sich, zum Beispiel innerhalb vom Hauptmenu oder in der Raumübersicht die Icons farbig kennzeichnen. <nowiki> <a href="index.ph…“

Mit dem folgenden Code lassen sich, zum Beispiel innerhalb vom Hauptmenu oder in der Raumübersicht die Icons farbig kennzeichnen.

<nowiki>
<a href="index.php?page=room_living">
<img class="icon" src="{{ page == 'room_living' ? icon1 : icon0 }}scene_livingroom.png"/><h3>Wohnzimmer</h3>
</nowiki>

Diskussion:WifiLight

2014-12-12T12:50:01Z

Herrmannj: Neuer Abschnitt /* Bezugsquellen */

Wäre es unverschämt zu bitten, genauere Bezugsquellen anzugeben?

Wenn man sich mit der Materie noch nie auseinandergesetzt hat, ist es quasi unmöglich RGBW1 und RGBW2 zu unterscheiden :( [[Benutzer:Rince|Rince]] ([[Benutzer Diskussion:Rince|Diskussion]]) 17:56, 14. Jul. 2014 (UTC)

== Bezugsquellen ==

Die Frage betrifft Milight und sie ist verständlich, nur reden wir hier von "China Ware". Es gibt dutzende Online Shops (die kommen und gehen), jeweils eigene Bezeichnungen "erfinden" und unterschiedliche Label und Verpackungen verwenden. Im Zweifel unter Angabe eines Link im Forum anfragen - es wird geholfen. Das Wiki gibt zur Unterscheidung von RGBW1 und RGBW2 im übrigen den wichtigen Hinweis auf den Aufdruck "4 Zonen" zu achten.

WifiLight

2014-12-11T15:52:44Z

Herrmannj: /* Alternative Bezeichnungen */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

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

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-12-11T15:52:27Z

Herrmannj: /* RGB LED (Streifen) am LW12 Wifi LED Controller */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

==== 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 wie folgt:

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>

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-12-11T15:51:36Z

Herrmannj: /* RGB LED (Streifen) am LW12 Wifi LED Controller */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

==== 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 wie folgt:

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 wie folgt:

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>

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-12-09T21:55:27Z

Herrmannj: /* Alternative Bezeichnungen */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

==== 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 wie folgt:

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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-12-09T14:00:19Z

Herrmannj: /* RGB LED (Streifen) am LW12 Wifi LED Controller */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

==== 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 wie folgt:

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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-12-09T13:58:52Z

Herrmannj: /* Unterstützte Wifi-Leuchtmittel */

{{Infobox Modul
|ModPurpose=Steuern von LEDs / Stripes mit Hilfe eines WLAN LED Moduls (noch im Beta-Status!)
|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, 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

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

[[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.

{{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}}

==== 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 wie folgt:

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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

Fronthem

2014-12-02T01:11:50Z

Herrmannj: /* RGBCombined */

{{Infobox Modul
|ModPurpose=Anbindung von externen Frontends an FHEM (befindet sich in der Alpha-Phase)
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=01_fronthem.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}
Fronthem ist ein Projekt von herrmannj und wurde im fhem-Forum erstmalig angekündigt: http://forum.fhem.de/index.php/topic,27291.0.html

Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. smartVISU http://smartvisu.de) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.
Dazu besteht fronthem aus vier Bausteinen:

==Bausteine==
=== websocket ===
Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.

Der Websocket wird durch ein fhem-Modul 01_fronthem.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird.

Der Websocket ist auf Port 2121 fest eingestellt, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.

=== device connector ===
Die Device-Connectoren dienen dazu, Endgeräte des Benutzers (PCs, Tablets, Smartphones usw.) als Clients zuzulassen und deren Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die lieben Kinder zwar das Licht und die eigene Heizung steuern, aber nicht die Heizung umprogrammieren oder den Alarm ausschalten. Auch ein PIN-Schutz ist vorgesehen, im Moment aber noch nicht umgesetzt.

Die Device-Connectoren werden durch das fhem-Modul 31_fronthemDevice.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird und mit folgendem Befehl definiert:
<code>define meinHandy fronthemDevice 192.168.178.45</code>

An den einzelnen Device-Connectoren werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet und können dort einerseits mit fhem devices und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.

=== readings converter ===
Die Readings von fhem müssen in die Form der möglichen Werte des Frontends umgewandelt werden. Im umgekehrten Fall müssen Befehle des Frontends in fhem kompatible Befehle umgesetzt werden.
Diese Aufgabe übernehmen die Readings Converter. Sie werden durch die Datei fhconverter.pm realisiert, die im Ordner .../fhem/FHEM/ abgelegt wird.
Bisher gibt es folgende Converter:
* [[#Direct]] für Übertragung ohne Konvertierung
* [[#NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
* [[#NumDisplay]] für Zahlenwerte aus fhem Readings, nur lesend
* [[#WordDisplay]] ist in Planung, für Übertragung von selbst definierbaren Wörtern/Sätze
* [[#OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0
* [[#RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert
Näheres zu denn Convertern unter [[#Converter]]

Weitere Readings Converter werden noch folgen.

=== fronthemEditor ===
Der Javascript Editor ist eine fhem WebIF Erweiterung, um die Bindung der fremden Frontend-Objekte an fhem devices/Readings vorzunehmen und die dazu notwendigen Konvertierungen zu wählen.
Er wird durch die Datei fronthemEditor.js repräsentiert, die in den Ordner .../fhem/www/frontend/pgm2/ kopiert wird.

==Basic Syntax==
===Definition===
====Websocket====
:<code>define <name> fronthem</code>

====Device Connector====
Man muss jedes Device, mit dem man zugreifen will definieren mit:
:<code>define <device> fronthemDevice <ip></code>
Derzeit orientiert sich das Modul noch über die IP, so das es bis jetzt nur im internen Netzwerk funktioniert.
Geplant ist jedoch eine Identifizierung, wo für jedes Device ein Zertifikat generiert wird.

==Converter==
Die Converter sind alle kompatibel mit dem oben erwähnten Frontend SmartVisu und werden auf Basis dieses Frontends erklärt.

Wenn jemand ein anderes Frontend verwenden will, muss er möglicherweise die Converter anpassen.
===Direct===
Die Werte werden ohne Konvertierung weitergegeben.

Gibt den Wert des von <reading> ohne weitere Wandlung an das Frontend weiter. In umgekehrter Richtung wird der vom Frontend geliefert Wert ohne Wandlung im hinterlegten <set> eingesetzt.

Beispiel:
Anzeige eines An- oder Abwesenheitszustandes im Frontend (Textanzeige, Icon, Button)

===NumDirect===
NumDirect arbeitet bidirektional. Die Werte werden genau wie bei Direct ohne Umwandlung weitergegeben.

Der feine Unterschied zu Direct ist jedoch, das nur Zahlenwerte übergeben werden können.

Desweiteren kann man einen minimalen und maximalen Wert mitangeben. Dies hat denn Sinn, das man keine Werte einstellen kann, die überhaupt nicht möglich wären.

In der SmartVisu kann man z.B. -100°C einstellen, das wäre in FHEM jedoch gar nicht möglich.

===NumDisplay===
NumDisplay arbeitet nur in eine Richting, FHEM zu Frontend. Die Werte werden ohne Umwandlung weitergegeben.

Es ist dazu gedacht Zahlenwerte zu übergeben, ohne etwas zu verändern.

z.B. für Temperaturwerte

===WordDisplay===
WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert.

WordDisplay soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen.

Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:

z.B. Geofancy: Home -> Zuhause, Underway -> Unterwegs, Work -> Arbeit

===OnOff===
Für einfache Ein/Aus-Funktionen.

FHEM interpretiert Ein/Aus-Funktionen mit on/off, SmartVisu jedoch mit 1/0.

Der OnOff-Converter wandelt diese bidirektional, damit sie richtig interpretiert werden.

===RGBCombined===
ein Converter zur Steuerung von RGB Leuchtmitteln über Farbauswahlfelder (zb. Farbkreis)

Bidirektional, wandelt, verwendet 3 Frontend Items

reading: Name eines reading mit HEX RGB Wert des Leuchtmittels
converter (mit Parameter): RGBCombined itemR, itemG, itemB
set: Name des set Befehls, bekommt HEX RGB Wert übergeben

Dieser converter muss gleichlautend für alle 3 RGB Kanäle des Frontends definiert werden.

===NumDelayed=== (TODO)

bidirektionaler numerischer converter mit einstellbarer Verzögerung.

Bietet bei der Ansteuerung mechanischer Aktoren (Markise, Jalousie) Vorteile gegenüber NumDirect. Als Beispiel sei die Steuerung einer Jalousie genannt über einen slider genannt. Da slider ihre Werte kontinuierlich an fhem übermitteln würde bei der Verwendung anderer converter dem entsprechenden Aktor (zB HM-BP), während der Benutzer den slider bedient, mehrfach der vermeindliche Sollwert übermittelt werden. Gleichzeitig beginnt der Aktor seine Fahrt und übermittelt dem slider seine aktuelle ist Position. Das führt zu einem springen des sliders und "unschöner" Bedienung.

NumDelayed nimmt daher die Signale des slider entgegen, wartet jedoch mit der Weitergabe solange bis sich der slider (xxx ms, konfigurierbar) nicht mehr bewegt. In Gegenrichtung wird ebenso verfahren, erst wenn der Aktor seine Endposition erreicht wird der slider im Frontend aktualisiert In diesem Beispiel würde das bedeuten das der slider im Normalfall ohnehin so steht (Soll) wie vom Aktor gemeldet (IST). Natürlich könnte der Benutzer oder ein Hindernis die Fahrt auch unterbrochen haben, dann würde der slider auf die gemeldete Position aktualisiert

==Device Connector==
Sobald ein Device definiert ist, kann man über denn device connector die GADs definieren und die Rechte verteilen.
===GAD definieren===
Eine GAD-Definierung besteht aus:
[[Datei:DeviceDefine.png|400px|thumb|right|GADs definieren]]
*mode
*device
*reading
*converter
*cmd set
====mode====
Es gibt 2 Modis:
*item
*plot
====device====
Hier wird der Name des FHEM-Devices eingetragen, an dem die Befehle geschickt werden.

Groß/Kleinschreibung muss beachtet werden!

====reading====
Für das Item zu verwendende reading des fhem Device, "state" der Status des Device und kein spezielles reading verwendet werden sollen. Wird vom converter weiterverarbeitet und die Art (der Inhalt) bestimmt den erforderlichen converter.

Readings werden, wenn das Frontend dies anfordert, aktiv von fronthem gelesen und (per push) proaktiv an das Frontend gesendet wenn fhem entsprechende events erzeugt.

====converter====
Hier gibt man denn Namen des Converters an, denn man verwenden möchte.
Es stehen unterschiedliche converter für verschiedene Aufgabenstellungen zur Verfügung. Über das Konzept der converter können fhem Device unterschiedlichster Typen und Funktionen über das Frontend bedient werden. So versorgt der gleiche converter der die Solltemperatur des virtuellen Heizungsthermostats (bidriektional) einstellt auch die Füllstandanzeige der Zisterne sowie den Dimmer. In all diesen Fällen handelt es sich um die Übertragung von numerischen Werten. Converter können dabei auch Spezialaufgaben wie die Begrenzung des Wertebereichs übernehmen. So lässt sich über NumDirect zum Beispiel die Solltemperatur Einstellung für virtuelle Heizungsregler auf Min und Max Werte begrenzen.

Oben ist eine Standardliste der Converter. Die meisten Devices können mit diesen Convertern angesteuert werden.

Groß/Kleinschreibung muss beachtet werden!

====cmd set====
Bei cmd set gibt den "set" des fhem Devices an der die Rückgabe des converters entgegen nimmt.

Bei Lampe z.B. state

===Devicerechte vergeben===
[[Datei:DeviceRechte.png|400px|thumb|right|Devicerechte vergeben]]
Devicerechte bestehen aus:
*read
*write
*PIN GAD
====read====
Das Device darf die Statuswerte auslesen, jedoch nicht verändern.

====write====
Das Device darf Statuswerte ändern.

====PIN GAD====
In Entwicklung...

Fronthem

2014-12-02T00:58:04Z

Herrmannj: Ich habe die converter etwas ausführlicher beschrieben sowie bei reading und set "attribute" entfernt weil die im fhem context eine andere Bedeutung haben

{{Infobox Modul
|ModPurpose=Anbindung von externen Frontends an FHEM (befindet sich in der Alpha-Phase)
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=01_fronthem.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}
Fronthem ist ein Projekt von herrmannj und wurde im fhem-Forum erstmalig angekündigt: http://forum.fhem.de/index.php/topic,27291.0.html

Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. smartVISU http://smartvisu.de) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.
Dazu besteht fronthem aus vier Bausteinen:

==Bausteine==
=== websocket ===
Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.

Der Websocket wird durch ein fhem-Modul 01_fronthem.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird.

Der Websocket ist auf Port 2121 fest eingestellt, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.

=== device connector ===
Die Device-Connectoren dienen dazu, Endgeräte des Benutzers (PCs, Tablets, Smartphones usw.) als Clients zuzulassen und deren Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die lieben Kinder zwar das Licht und die eigene Heizung steuern, aber nicht die Heizung umprogrammieren oder den Alarm ausschalten. Auch ein PIN-Schutz ist vorgesehen, im Moment aber noch nicht umgesetzt.

Die Device-Connectoren werden durch das fhem-Modul 31_fronthemDevice.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird und mit folgendem Befehl definiert:
<code>define meinHandy fronthemDevice 192.168.178.45</code>

An den einzelnen Device-Connectoren werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet und können dort einerseits mit fhem devices und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.

=== readings converter ===
Die Readings von fhem müssen in die Form der möglichen Werte des Frontends umgewandelt werden. Im umgekehrten Fall müssen Befehle des Frontends in fhem kompatible Befehle umgesetzt werden.
Diese Aufgabe übernehmen die Readings Converter. Sie werden durch die Datei fhconverter.pm realisiert, die im Ordner .../fhem/FHEM/ abgelegt wird.
Bisher gibt es folgende Converter:
* [[#Direct]] für Übertragung ohne Konvertierung
* [[#NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
* [[#NumDisplay]] für Zahlenwerte aus fhem Readings, nur lesend
* [[#WordDisplay]] ist in Planung, für Übertragung von selbst definierbaren Wörtern/Sätze
* [[#OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0
* [[#RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert
Näheres zu denn Convertern unter [[#Converter]]

Weitere Readings Converter werden noch folgen.

=== fronthemEditor ===
Der Javascript Editor ist eine fhem WebIF Erweiterung, um die Bindung der fremden Frontend-Objekte an fhem devices/Readings vorzunehmen und die dazu notwendigen Konvertierungen zu wählen.
Er wird durch die Datei fronthemEditor.js repräsentiert, die in den Ordner .../fhem/www/frontend/pgm2/ kopiert wird.

==Basic Syntax==
===Definition===
====Websocket====
:<code>define <name> fronthem</code>

====Device Connector====
Man muss jedes Device, mit dem man zugreifen will definieren mit:
:<code>define <device> fronthemDevice <ip></code>
Derzeit orientiert sich das Modul noch über die IP, so das es bis jetzt nur im internen Netzwerk funktioniert.
Geplant ist jedoch eine Identifizierung, wo für jedes Device ein Zertifikat generiert wird.

==Converter==
Die Converter sind alle kompatibel mit dem oben erwähnten Frontend SmartVisu und werden auf Basis dieses Frontends erklärt.

Wenn jemand ein anderes Frontend verwenden will, muss er möglicherweise die Converter anpassen.
===Direct===
Die Werte werden ohne Konvertierung weitergegeben.

Gibt den Wert des von <reading> ohne weitere Wandlung an das Frontend weiter. In umgekehrter Richtung wird der vom Frontend geliefert Wert ohne Wandlung im hinterlegten <set> eingesetzt.

Beispiel:
Anzeige eines An- oder Abwesenheitszustandes im Frontend (Textanzeige, Icon, Button)

===NumDirect===
NumDirect arbeitet bidirektional. Die Werte werden genau wie bei Direct ohne Umwandlung weitergegeben.

Der feine Unterschied zu Direct ist jedoch, das nur Zahlenwerte übergeben werden können.

Desweiteren kann man einen minimalen und maximalen Wert mitangeben. Dies hat denn Sinn, das man keine Werte einstellen kann, die überhaupt nicht möglich wären.

In der SmartVisu kann man z.B. -100°C einstellen, das wäre in FHEM jedoch gar nicht möglich.

===NumDisplay===
NumDisplay arbeitet nur in eine Richting, FHEM zu Frontend. Die Werte werden ohne Umwandlung weitergegeben.

Es ist dazu gedacht Zahlenwerte zu übergeben, ohne etwas zu verändern.

z.B. für Temperaturwerte

===WordDisplay===
WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert.

WordDisplay soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen.

Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:

z.B. Geofancy: Home -> Zuhause, Underway -> Unterwegs, Work -> Arbeit

===OnOff===
Für einfache Ein/Aus-Funktionen.

FHEM interpretiert Ein/Aus-Funktionen mit on/off, SmartVisu jedoch mit 1/0.

Der OnOff-Converter wandelt diese bidirektional, damit sie richtig interpretiert werden.

===RGBCombined===
Der RGB-Converter zur Steuerung von RGB Leuchtmitteln über Farbauswahlfelder (zb. Farbkreis)

Bidirektional, wandelt, verwendet 3 Frontend Items

reading: Name eines reading mit HEX RGB Wert des Leuchtmittels
converter (mit Parameter): RGBCombined itemR, itemG, itemB
set: Name des set Befehls, bekommt HEX RGB Wert übergeben

Dieser converter muss gleichlautend für alle 3 RGB Kanäle des Frontends definiert werden.

==Device Connector==
Sobald ein Device definiert ist, kann man über denn device connector die GADs definieren und die Rechte verteilen.
===GAD definieren===
Eine GAD-Definierung besteht aus:
[[Datei:DeviceDefine.png|400px|thumb|right|GADs definieren]]
*mode
*device
*reading
*converter
*cmd set
====mode====
Es gibt 2 Modis:
*item
*plot
====device====
Hier wird der Name des FHEM-Devices eingetragen, an dem die Befehle geschickt werden.

Groß/Kleinschreibung muss beachtet werden!

====reading====
Für das Item zu verwendende reading des fhem Device, "state" der Status des Device und kein spezielles reading verwendet werden sollen. Wird vom converter weiterverarbeitet und die Art (der Inhalt) bestimmt den erforderlichen converter.

Readings werden, wenn das Frontend dies anfordert, aktiv von fronthem gelesen und (per push) proaktiv an das Frontend gesendet wenn fhem entsprechende events erzeugt.

====converter====
Hier gibt man denn Namen des Converters an, denn man verwenden möchte.
Es stehen unterschiedliche converter für verschiedene Aufgabenstellungen zur Verfügung. Über das Konzept der converter können fhem Device unterschiedlichster Typen und Funktionen über das Frontend bedient werden. So versorgt der gleiche converter der die Solltemperatur des virtuellen Heizungsthermostats (bidriektional) einstellt auch die Füllstandanzeige der Zisterne sowie den Dimmer. In all diesen Fällen handelt es sich um die Übertragung von numerischen Werten. Converter können dabei auch Spezialaufgaben wie die Begrenzung des Wertebereichs übernehmen. So lässt sich über NumDirect zum Beispiel die Solltemperatur Einstellung für virtuelle Heizungsregler auf Min und Max Werte begrenzen.

Oben ist eine Standardliste der Converter. Die meisten Devices können mit diesen Convertern angesteuert werden.

Groß/Kleinschreibung muss beachtet werden!

====cmd set====
Bei cmd set gibt den "set" des fhem Devices an der die Rückgabe des converters entgegen nimmt.

Bei Lampe z.B. state

===Devicerechte vergeben===
[[Datei:DeviceRechte.png|400px|thumb|right|Devicerechte vergeben]]
Devicerechte bestehen aus:
*read
*write
*PIN GAD
====read====
Das Device darf die Statuswerte auslesen, jedoch nicht verändern.

====write====
Das Device darf Statuswerte ändern.

====PIN GAD====
In Entwicklung...

Fronthem

2014-12-02T00:39:27Z

Herrmannj: /* RGBCombined */

{{Infobox Modul
|ModPurpose=Anbindung von externen Frontends an FHEM (befindet sich in der Alpha-Phase)
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=01_fronthem.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}
Fronthem ist ein Projekt von herrmannj und wurde im fhem-Forum erstmalig angekündigt: http://forum.fhem.de/index.php/topic,27291.0.html

Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. smartVISU http://smartvisu.de) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.
Dazu besteht fronthem aus vier Bausteinen:

==Bausteine==
=== websocket ===
Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.

Der Websocket wird durch ein fhem-Modul 01_fronthem.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird.

Der Websocket ist auf Port 2121 fest eingestellt, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.

=== device connector ===
Die Device-Connectoren dienen dazu, Endgeräte des Benutzers (PCs, Tablets, Smartphones usw.) als Clients zuzulassen und deren Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die lieben Kinder zwar das Licht und die eigene Heizung steuern, aber nicht die Heizung umprogrammieren oder den Alarm ausschalten. Auch ein PIN-Schutz ist vorgesehen, im Moment aber noch nicht umgesetzt.

Die Device-Connectoren werden durch das fhem-Modul 31_fronthemDevice.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird und mit folgendem Befehl definiert:
<code>define meinHandy fronthemDevice 192.168.178.45</code>

An den einzelnen Device-Connectoren werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet und können dort einerseits mit fhem devices und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.

=== readings converter ===
Die Readings von fhem müssen in die Form der möglichen Werte des Frontends umgewandelt werden. Im umgekehrten Fall müssen Befehle des Frontends in fhem kompatible Befehle umgesetzt werden.
Diese Aufgabe übernehmen die Readings Converter. Sie werden durch die Datei fhconverter.pm realisiert, die im Ordner .../fhem/FHEM/ abgelegt wird.
Bisher gibt es folgende Converter:
* [[#Direct]] für Übertragung ohne Konvertierung
* [[#NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
* [[#NumDisplay]] für Zahlenwerte aus fhem Readings, nur lesend
* [[#WordDisplay]] ist in Planung, für Übertragung von selbst definierbaren Wörtern/Sätze
* [[#OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0
* [[#RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert
Näheres zu denn Convertern unter [[#Converter]]

Weitere Readings Converter werden noch folgen.

=== fronthemEditor ===
Der Javascript Editor ist eine fhem WebIF Erweiterung, um die Bindung der fremden Frontend-Objekte an fhem devices/Readings vorzunehmen und die dazu notwendigen Konvertierungen zu wählen.
Er wird durch die Datei fronthemEditor.js repräsentiert, die in den Ordner .../fhem/www/frontend/pgm2/ kopiert wird.

==Basic Syntax==
===Definition===
====Websocket====
:<code>define <name> fronthem</code>

====Device Connector====
Man muss jedes Device, mit dem man zugreifen will definieren mit:
:<code>define <device> fronthemDevice <ip></code>
Derzeit orientiert sich das Modul noch über die IP, so das es bis jetzt nur im internen Netzwerk funktioniert.
Geplant ist jedoch eine Identifizierung, wo für jedes Device ein Zertifikat generiert wird.

==Converter==
Die Converter sind alle kompatibel mit dem oben erwähnten Frontend SmartVisu und werden auf Basis dieses Frontends erklärt.

Wenn jemand ein anderes Frontend verwenden will, muss er möglicherweise die Converter anpassen.
===Direct===
Die Werte werden ohne Konvertierung weitergegeben.

Gibt den Wert des von <reading> ohne weitere Wandlung an das Frontend weiter. In umgekehrter Richtung wird der vom Frontend geliefert Wert ohne Wandlung im hinterlegten <set> eingesetzt.

Beispiel:
Anzeige eines An- oder Abwesenheitszustandes im Frontend (Textanzeige, Icon, Button)

===NumDirect===
NumDirect arbeitet bidirektional. Die Werte werden genau wie bei Direct ohne Umwandlung weitergegeben.

Der feine Unterschied zu Direct ist jedoch, das nur Zahlenwerte übergeben werden können.

Desweiteren kann man einen minimalen und maximalen Wert mitangeben. Dies hat denn Sinn, das man keine Werte einstellen kann, die überhaupt nicht möglich wären.

In der SmartVisu kann man z.B. -100°C einstellen, das wäre in FHEM jedoch gar nicht möglich.

===NumDisplay===
NumDisplay arbeitet nur in eine Richting, FHEM zu Frontend. Die Werte werden ohne Umwandlung weitergegeben.

Es ist dazu gedacht Zahlenwerte zu übergeben, ohne etwas zu verändern.

z.B. für Temperaturwerte

===WordDisplay===
WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert.

WordDisplay soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen.

Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:

z.B. Geofancy: Home -> Zuhause, Underway -> Unterwegs, Work -> Arbeit

===OnOff===
Für einfache Ein/Aus-Funktionen.

FHEM interpretiert Ein/Aus-Funktionen mit on/off, SmartVisu jedoch mit 1/0.

Der OnOff-Converter wandelt diese bidirektional, damit sie richtig interpretiert werden.

===RGBCombined===
Der RGB-Converter zur Steuerung von RGB Leuchtmitteln über Farbauswahlfelder (zb. Farbkreis)

Bidirektional, wandelt, verwendet 3 Frontend Items

reading: Name eines reading mit HEX RGB Wert des Leuchtmittels
converter (mit Parameter): RGBCombined itemR, itemG, itemB
set: Name des set Befehls, bekommt HEX RGB Wert übergeben

Dieser converter muss gleichlautend für alle 3 RGB Kanäle des Frontends definiert werden.

==Device Connector==
Sobald ein Device definiert ist, kann man über denn device connector die GADs definieren und die Rechte verteilen.
===GAD definieren===
Eine GAD-Definierung besteht aus:
[[Datei:DeviceDefine.png|400px|thumb|right|GADs definieren]]
*mode
*device
*reading
*converter
*cmd set
====mode====
Es gibt 2 Modis:
*item
*plot
====device====
Hier wird der Name des FHEM-Devices eingetragen, an dem die Befehle geschickt werden.

Groß/Kleinschreibung muss beachtet werden!

====reading====
Bei reading wird das Attribut des Devices angegeben, welches man auslesen möchte.

Bei Lampe z.B. state

====converter====
Hier gibt man denn Namen des Converters an, denn man verwenden möchte.

Oben ist eine Standardliste der Converter. Die meisten Devices können mit diesen Convertern angesteuert werden.

Groß/Kleinschreibung muss beachtet werden!

====cmd set====
Bei cmd set wird das Attribut des Devices angegeben, welches man ändern/einen Wert schreiben möchte.

Bei Lampe z.B. state

===Devicerechte vergeben===
[[Datei:DeviceRechte.png|400px|thumb|right|Devicerechte vergeben]]
Devicerechte bestehen aus:
*read
*write
*PIN GAD
====read====
Das Device darf die Statuswerte auslesen, jedoch nicht verändern.

====write====
Das Device darf Statuswerte ändern.

====PIN GAD====
In Entwicklung...

Fronthem

2014-12-02T00:33:27Z

Herrmannj: /* Direct */

{{Infobox Modul
|ModPurpose=Anbindung von externen Frontends an FHEM (befindet sich in der Alpha-Phase)
|ModType=x


|ModForumArea=Sonstige Systeme
|ModTechName=01_fronthem.pm
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=769 Jörg alias herrmannj]
}}
Fronthem ist ein Projekt von herrmannj und wurde im fhem-Forum erstmalig angekündigt: http://forum.fhem.de/index.php/topic,27291.0.html

Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. smartVISU http://smartvisu.de) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.
Dazu besteht fronthem aus vier Bausteinen:

==Bausteine==
=== websocket ===
Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.

Der Websocket wird durch ein fhem-Modul 01_fronthem.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird.

Der Websocket ist auf Port 2121 fest eingestellt, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.

=== device connector ===
Die Device-Connectoren dienen dazu, Endgeräte des Benutzers (PCs, Tablets, Smartphones usw.) als Clients zuzulassen und deren Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die lieben Kinder zwar das Licht und die eigene Heizung steuern, aber nicht die Heizung umprogrammieren oder den Alarm ausschalten. Auch ein PIN-Schutz ist vorgesehen, im Moment aber noch nicht umgesetzt.

Die Device-Connectoren werden durch das fhem-Modul 31_fronthemDevice.pm realisiert, das im Ordner .../fhem/FHEM/ abgelegt wird und mit folgendem Befehl definiert:
<code>define meinHandy fronthemDevice 192.168.178.45</code>

An den einzelnen Device-Connectoren werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet und können dort einerseits mit fhem devices und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.

=== readings converter ===
Die Readings von fhem müssen in die Form der möglichen Werte des Frontends umgewandelt werden. Im umgekehrten Fall müssen Befehle des Frontends in fhem kompatible Befehle umgesetzt werden.
Diese Aufgabe übernehmen die Readings Converter. Sie werden durch die Datei fhconverter.pm realisiert, die im Ordner .../fhem/FHEM/ abgelegt wird.
Bisher gibt es folgende Converter:
* [[#Direct]] für Übertragung ohne Konvertierung
* [[#NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
* [[#NumDisplay]] für Zahlenwerte aus fhem Readings, nur lesend
* [[#WordDisplay]] ist in Planung, für Übertragung von selbst definierbaren Wörtern/Sätze
* [[#OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0
* [[#RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert
Näheres zu denn Convertern unter [[#Converter]]

Weitere Readings Converter werden noch folgen.

=== fronthemEditor ===
Der Javascript Editor ist eine fhem WebIF Erweiterung, um die Bindung der fremden Frontend-Objekte an fhem devices/Readings vorzunehmen und die dazu notwendigen Konvertierungen zu wählen.
Er wird durch die Datei fronthemEditor.js repräsentiert, die in den Ordner .../fhem/www/frontend/pgm2/ kopiert wird.

==Basic Syntax==
===Definition===
====Websocket====
:<code>define <name> fronthem</code>

====Device Connector====
Man muss jedes Device, mit dem man zugreifen will definieren mit:
:<code>define <device> fronthemDevice <ip></code>
Derzeit orientiert sich das Modul noch über die IP, so das es bis jetzt nur im internen Netzwerk funktioniert.
Geplant ist jedoch eine Identifizierung, wo für jedes Device ein Zertifikat generiert wird.

==Converter==
Die Converter sind alle kompatibel mit dem oben erwähnten Frontend SmartVisu und werden auf Basis dieses Frontends erklärt.

Wenn jemand ein anderes Frontend verwenden will, muss er möglicherweise die Converter anpassen.
===Direct===
Die Werte werden ohne Konvertierung weitergegeben.

Gibt den Wert des von <reading> ohne weitere Wandlung an das Frontend weiter. In umgekehrter Richtung wird der vom Frontend geliefert Wert ohne Wandlung im hinterlegten <set> eingesetzt.

Beispiel:
Anzeige eines An- oder Abwesenheitszustandes im Frontend (Textanzeige, Icon, Button)

===NumDirect===
NumDirect arbeitet bidirektional. Die Werte werden genau wie bei Direct ohne Umwandlung weitergegeben.

Der feine Unterschied zu Direct ist jedoch, das nur Zahlenwerte übergeben werden können.

Desweiteren kann man einen minimalen und maximalen Wert mitangeben. Dies hat denn Sinn, das man keine Werte einstellen kann, die überhaupt nicht möglich wären.

In der SmartVisu kann man z.B. -100°C einstellen, das wäre in FHEM jedoch gar nicht möglich.

===NumDisplay===
NumDisplay arbeitet nur in eine Richting, FHEM zu Frontend. Die Werte werden ohne Umwandlung weitergegeben.

Es ist dazu gedacht Zahlenwerte zu übergeben, ohne etwas zu verändern.

z.B. für Temperaturwerte

===WordDisplay===
WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert.

WordDisplay soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen.

Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:

z.B. Geofancy: Home -> Zuhause, Underway -> Unterwegs, Work -> Arbeit

===OnOff===
Für einfache Ein/Aus-Funktionen.

FHEM interpretiert Ein/Aus-Funktionen mit on/off, SmartVisu jedoch mit 1/0.

Der OnOff-Converter wandelt diese bidirektional, damit sie richtig interpretiert werden.

===RGBCombined===
Der RGB-Converter ist der aufwendigste von allen, da sich mehr Logik dahinter verbirgt.

FHEM interpretiert RGB-Werte als eine HEX-Zahl. SmartVisu hingegen übergibt die Werte für Rot, Gelb und Blau getrennt.

Die drei einzelnen Werte werden vom Converter in eine HEX-Zahl umgewandelt und dann als set-Befehl an FHEM übergeben.

Das wichtige dabei ist, das der Converter erst denn set-Befehl abgibt, wenn er alle drei Farbwerte erhalten hat.

z.B. verwendbar mit http://www.fhemwiki.de/wiki/WifiLight

==Device Connector==
Sobald ein Device definiert ist, kann man über denn device connector die GADs definieren und die Rechte verteilen.
===GAD definieren===
Eine GAD-Definierung besteht aus:
[[Datei:DeviceDefine.png|400px|thumb|right|GADs definieren]]
*mode
*device
*reading
*converter
*cmd set
====mode====
Es gibt 2 Modis:
*item
*plot
====device====
Hier wird der Name des FHEM-Devices eingetragen, an dem die Befehle geschickt werden.

Groß/Kleinschreibung muss beachtet werden!

====reading====
Bei reading wird das Attribut des Devices angegeben, welches man auslesen möchte.

Bei Lampe z.B. state

====converter====
Hier gibt man denn Namen des Converters an, denn man verwenden möchte.

Oben ist eine Standardliste der Converter. Die meisten Devices können mit diesen Convertern angesteuert werden.

Groß/Kleinschreibung muss beachtet werden!

====cmd set====
Bei cmd set wird das Attribut des Devices angegeben, welches man ändern/einen Wert schreiben möchte.

Bei Lampe z.B. state

===Devicerechte vergeben===
[[Datei:DeviceRechte.png|400px|thumb|right|Devicerechte vergeben]]
Devicerechte bestehen aus:
*read
*write
*PIN GAD
====read====
Das Device darf die Statuswerte auslesen, jedoch nicht verändern.

====write====
Das Device darf Statuswerte ändern.

====PIN GAD====
In Entwicklung...

DevelopmentReadingsAPI

2014-11-21T23:04:37Z

Herrmannj: /* Erste Überlegungen */ Kunden geändert. Der Kunde sollte nach Typ, nicht nach Transportweg (ie ws) Klassifiziert werden

[[Kategorie:Development]]

== Abstract ==

Diese Seite beschreibt ein Konzept für ein API für Readings in FHEM. Diese Seite dokumentiert den aktuellen Stand der Diskussion.

Ausgangspunkt ist [http://forum.fhem.de/index.php/topic,21247.0.html dieser Thread].

== Ausgangssituation ==

In FHEM besitzen Geräte sogenannte Readings (Anzeigewerte). Diese bestehen aus einem Zeitstempel und einem Wert. Die Änderung eines Readings wird in der Regel durch einen Event daran interessierten Geräten über die NotifyFn mitgeteilt. Die Werte von Readings sind Zeichenketten. Sie können beim Herunterfahren in einer eigenen Datei (fhem.save) gesichert und beim Neustarten von FHEM wiederhergestellt werden. Readings sind von der Natur her schnellveränderlich.

Geräte können Attribute besitzen. Attribute besitzen nur einen Werte ohne Zeitstempel. Sie sind in der Regel un- bzw. langsamveränderlich und dienen typischerweise zur Konfiguration. Attribute werden persistent in der Konfiguration abgelegt. Änderungen an Attributen werden auch analog zu Reading-änderungen durch Events distributiert. Auch Attribute sind Zeichenketten.

Geräte besitzen interne Werte (sog. Internals). Auch diese besitzen nur einen Werte ohne Zeitstempel. Internals können perl-skalare oder Referenztypen (z.B. hashes oder Arrays) sein. Änderungen an Internals werden nicht per Event weitergegeben, die Werte werden nicht persistiert.

Readings, Attribute und Internals genügen keiner festgelegten Syntax: es gibt bezüglich der Werte keine Vorgaben zur Standardisierung. Diese können z. B. Zahlenwerte, Kombinationen aus Zahlen und physikalischen Einheiten oder Texte enthalten. Beispielsweise können Readings, die Temperaturen darstellen, die Temperatur in Celsius-Graden oder Kelvin-Graden mit oder ohne Einheitensymbol enthalten. Das erschwert die Weiterverarbeitung. Soll beispielsweise eine Temperatur in einer graphischen Benutzeroberfläche mit einem Thermometer-Widget dargestellt werden, müssen für jede Geräteklasse individuelle Transformationsregeln von der Darstellung im Reading auf den Eingangsparameter im Widget transformiert werden.

Keine Semantik: Es gibt kein API, anhand dessen eine Funktion erkennen kann, was das Reading inhaltlich darstellt. Eine graphische Benutzeroberfläche kann beispielsweise nicht ermitteln, ob für ein bestimmtes Reading ein Thermometer-Widget oder eine Lampe dargestellt werden soll.

== Zielsetzung ==

Es soll ein API eingeführt werden, das einen bzgl. Syntax und Semantik standardisierten Zugriff auf Readings, Attribute und Internals erlaubt.

Gehören Attribute und Internals wirklich hierher?
* Internals sind device-intern und normalerweise nicht für Dritte gedacht. Wenn etwas 'öffentlich' und auswertebar sein soll gehört es womöglich in ein Reading oder Attribut.
* manche Devices legen aus der Definition abgeleitete Werte in Internals ab. Auch diese sollten externen Schnittstellen einheitlich zugänglich gemacht werden können.
* Attribute sind für den Endanwender gedacht. Was gibt es hier zu Standardisieren ausser den möglichen Werten?
* Eine externe Schnittstelle kennt die FHEM-interne Struktur nicht, soll aber ggf. trotzdem vereinheitlichen Zugriff auf die Konfiguration (= die Attribute) bekommen können.

Frühere Ansätze sind [[DevelopmentInterfaces|Interfaces]] und [[DevelopmentGuidelines|Guidelines]] und [https://groups.google.com/forum/#!searchin/fhem-users/fhem$20standards/fhem-users/fGUMddl2Br0/w99_8GHMxEMJ diese Diskussion].

== Anforderungen an das API ==

# Funktionale Anforderungen
#* Es soll möglich sein einen aus den Werten von Readings, Attributen und Internals abgeleiteten Wert abzufragen
#* die Zugrunde liegenden Werte (Readings, Attribute und Internals) sollen beliebigen Devices zuordenbar sein. Es soll z.B. ermöglicht werden mehrere getrennte Analoge Ausgabedevices zu einem einzigen RGB-Wert zu aggregieren.
#* Sofern die Abbildevorschrift bidirektional eineindeutig ist, soll es möglich sein durch Setzen des abgeleiteten Wertes die zugrunde liegenden Größen zu verändern.
#* Es soll möglich sein eine Benachrichtigung zu erhalten, wenn sich dieser abgeleitete Wert ändert (ggf. mit Verzicht auf Änderungen von Internals die ja keine Events auslösen).
#* Es soll sich die Bedeutung eines abgeleiteten Wertes ermitteln lassen (Temperatur, Schaltzustand, Länge, Füllmenge, ...).
#* Es sollen sich bei physikalischen Größen Wert und Einheit ermitteln lassen.
#* Es soll möglich sein, physikalische Größen in andere Einheitensysteme umrechnen zu können (z.B. K in °C, °C in °F, l im cbm, ...).
#* Es sollen Formatierungen unterstützt werden (globaler Default, Default je physikalischer Größe, individuell je Geräteklasse, individuell je Gerät), z.B. Temperaturen grundsätzlich in °C mit einer Nachkommastelle, Uhrzeiten grundsätzlich in 24-Stunden-Notation oder in AM/PM-Schreibweise.
#* Es wurde die Anforderung genannt, dass sich der Wertebereich ermitteln lassen sollte. Mir ist nicht klar, ob dies für Readings erforderlich ist (es wäre für Settings erforderlich) -> ein Wertebereich könnte zur sinnvollen Skalierung analoger Werte (z.B. Slider) benutzt werden.
#* Es soll möglich sein mehre Sets von Abildungsvorschrifen konfigurativ hinterlegen zu können. Damit können unterschiedliche Schnittstellen oder Frontends parallel nutzbar gemacht werden. Unterschiedliche Frontends benötigen z.B. RGB-Werte in unterschiedlichen Formaten auf ggf. auf einen oder mehrere Kanäle abgebildet.
# Nichtfunktionale Anforderungen
#* Kein Modul soll das API unterstützen müssen, damit althergebrachte Module ohne Anpassungen weiterfunktionieren.
#* das API soll abwärtskompatibel sein und einen (bidirektionalen) Zugriff auf bestehende Module ermöglichen.
#* Das API soll nur unwesentlichen Overhead bzgl. Speicherverbrauch und Verarbeitungszeiten erzeugen.
#* Es soll keine Vereinheitlichung von Readings-Namen erfolgen (temp, temperature) (das war früher einmal eine Forderung).

== Erste Überlegungen ==

* Einheiten alleine genügen nicht, es sollte die physikalische Größe bekannt sein, die von dem Reading repräsentiert wird (Temperatur, Druck, ...).
* Dazu eine Regel, in welcher Einheit diese physikalische Größe vorliegt.
* Es bringt keinen Zusatznutzen, die physikalische Größe am Reading verfügbar zu haben.
* Stattdessen meldet das Device, dass es einem Standard gehorcht (ein Interface implementiert, z.B "temperature").
* Ein GUI weiß dadurch, was es anzuzeigen hat.
* KEINE Einheiten im {readings}{VAL}. Das muß bei wirklich jeder anderen Verwendung außer "Anzeige für Mensch mit selben Locale wie Entwickler." gestrippt werden.
* An jedes Reading werden Metainformationen geklebt. Welche?
* Die Metainformationen könnten Zeiger in eine hierarchische Liste standardisierter Beschreibungen sein. Sind die [[DevelopmentInterfaces|Interfaces]] modellhaft?
* Es ist klar, dass die Bedeutung eine Vereinbarung darstellt, die außerhalb des Systems liegt. GGf. kann man die Implementierung aber ihre eigene Dokumentation enthalten lassen.
* Wir brauchen für die Formatierungen einen Speicher für die globalen Defaults und die Geräteklassen- und Geräte- und Readings-spezifischen Überschreibungen.
* Die allgemeinen Zugriffsmethoden können in RTypes.pm eingefügt werden. So was wie RUnit($hash, "desired-temp").
* Wir müssen darüber nachdenken, welche Kunden das API hat und was es denen nutzen soll. FHEMWEB, DBLog, MQTT, smartVisu, mobile Clients sind Kunden.
* Zum Frontend: man kann sich ja viel fürs Backend ausdenken. Aber das richtige Gespür dafür, ob das Design auch wirklich was taugt, bekomme ich erst, wenn ich es einsetze und sehe, wie es sich für den Verwender anfühlt. Daher die Idee für einen Durchstich, ein Proof-of-Concept eben.

WifiLight

2014-04-06T11:24:37Z

Herrmannj: /* Unterschiede von Farbangaben HSV zu RGB */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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 wie folgt:

:<code>define <name> WifiLight RGB LW12:<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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T11:21:16Z

Herrmannj: /* Milight bridge v3 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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 wie folgt:

:<code>define <name> WifiLight RGB LW12:<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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T11:20:58Z

Herrmannj: /* Milight bridge v2 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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 wie folgt:

:<code>define <name> WifiLight RGB LW12:<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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T11:20:36Z

Herrmannj: /* Milight bridge v2 */ white ergänzt

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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 wie folgt:

:<code>define <name> WifiLight RGB LW12:<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. 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T10:48:57Z

Herrmannj: /* Milight Leuchtmitteltyp White */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T01:23:27Z

Herrmannj: /* Milight Leuchtmitteltyp RGBW2 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

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

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T01:21:54Z

Herrmannj: /* Milight Leuchtmitteltyp RGBW2 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 v3. 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T01:04:04Z

Herrmannj: /* Definition */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T01:01:52Z

Herrmannj: /* Milight Leuchtmitteltyp White */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T01:00:09Z

Herrmannj: /* Milight Leuchtmitteltyp RGBW1 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T00:59:20Z

Herrmannj: /* Milight Leuchtmitteltyp RGBW1 */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T00:57:06Z

Herrmannj: /* Milight Systeme für LED Streifen und E27 Leuchtmittel */

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 weder für dynamische Farbwechsel noch 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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T00:35:27Z

Herrmannj:

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 weder für dynamische Farbwechsel noch 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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

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

WifiLight

2014-04-06T00:34:00Z

Herrmannj:

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



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

==== 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 #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%).

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

[[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.

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

=== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== 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.
<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 weder für dynamische Farbwechsel noch 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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. 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 bei Farbverläufen 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 ist es sinnvoll 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>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

== 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-E27-RGBW2-9Watt.JPG

2014-04-05T22:55:37Z

Herrmannj:

Datei:Milight-E27-RGBW2-OEM.JPG

2014-04-05T22:51:44Z

Herrmannj:

Datei:Milight-Downlight-WWCW.JPG

2014-04-05T22:46:47Z

Herrmannj:

Datei:Milight-rgbw2-LED.jpg

2014-04-05T22:41:50Z

Herrmannj:

WifiLight

2014-04-05T22:25:59Z

Herrmannj:

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


|ModTechName=32_WifiLight.pm
|ModOwner=Jörg alias herrmannj
}}



[[WifiLight]] dient zur Steuerung verschiedener LED Leuchtmittel über WLAN. (Mi-Light, Limitless, IVY, LW12, LED Streifen, 2,4GHz E27 RGB Lampen ...)

Um die Verbindung von Fhem zu den LED Leuchtmitteln zu ermöglichen wird ein sogenanntes Wifi-LED Modul benötigt. Das WifiLight Modul verwendet für Farbangaben einheitlich den [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum], weil sich diese Angaben viel besser mit unserem Verständnis decken als RGB (siehe auch [http://www.colorizer.org/ colorizer.org]). Weiterhin wird aber auch die Angabe der Farbwerte im RGB Format
(<code>#ffffff</code>) unterstützt.

Sowohl das Lampen-Icon (Farbe und Dim Level), als auch Slider werden in Echtzeit aktualisiert (longpoll). Dabei verhalten sich die Browser unterschiedlich

== Unterstützte Wifi-Leuchtmittel ==

=== RGB LED (Streifen) am LW12 Wifi LED Controller ===

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

==== Technische Daten ====
* Eingangsspannung: DC 12 V - DC 24 V
* Ausgangsspannung: DC 12 V - DC 24 V
* Stromleistung: max 4A pro Kanal (12A ->3 Kanäle)

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

Die Definition erfolgt im Modul als

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

Es können eine beliebige Anzahl LW12 definiert werden. Ein LW12 steuert jeweils 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.
* [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]

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

==== 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.
<gallery>
BridgeV2.JPG|Milight v2 bridge
BridgeV3.JPG|Milight v3 bridge mit Limitless Aufkleber
BridgeV4.JPG|Milight v4 bridge
</gallery>

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

===== Milight bridge v3 =====

Die v3 bridge hört auf UDP Port 8899 und hat typischerweise ein dunkles Etikett erkennbar. 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 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 weder für dynamische Farbwechsel noch für unbeaufsichtigten / automatischen Betrieb.

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 Licht-ausbeute ist sehr gut.

Benötigt eine bridge ab v3. Eine bridge kann 4 getrennte Gruppen White ansteuern. Wenn mehr Gruppen eingesetzt werden sollen können weitere bridge eingesetzt 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
</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 4 getrennte Gruppen RGBW2 ansteuern. Wenn mehr Gruppen eingesetzt werden sollen können weitere bridge eingesetzt werden.

<gallery>

</gallery>

== Installation ==
{{Randnotiz|RNTyp=r|RNText=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
[http://forum.fhem.de/index.php?action=dlattach;topic=18958.0;attach=12558 Forum] beschrieben.

== 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-WWCW-FB.JPG

2014-04-05T22:16:08Z

Herrmannj: