Hue

HUEDevice
Zweck / Funktion
	Ansteuerung Geräte des Phillips Hue Lighting System über HUEBridge
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Beleuchtung
Modulname	31_HUEDevice.pm
Ersteller	Andre (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

HUEBridge
Zweck / Funktion
	Anbindung Bridge des Phillips Hue Lighting System
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Beleuchtung
Modulname	30_HUEBridge.pm
Ersteller	Andre (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

HUE-Bridge

Einrichtung in fhem

Die Einrichtung ist wirklich einfach. Mit

define Wiesollesheißen HUEBridge eu.re.ip.1

wird die Bridge eingebunden. Dann einfach auf den runden Knopf in der Mitte der Bridge drücken und sie wird von Fhem erkannt. Die drei Lampen des Starterkits werden automatisch erkannt und sind ansteuerbar -> fertig!

WICHTIG: danach in Fhem ein mal die Konfiguration speichern damit der Pairing-Key gesichert wird. Sonst muss bei nächsten Fhem-Neustart das Paring erneut durchgefürt werden.

Eine ausführliche Anleitung mit Bildern zudem unter: http://www.meintechblog.de/2014/11/philips-hue-so-klappt-die-integration-in-fhem/

Nonblocking

Wenn man möchte, dass die Versuche, die HUEBridge zu kontaktieren, FHEM nicht blockieren, sollte man

attr <HUEBridge_Name> httpUtils 1

setzen.

HUE-Device

Als Gerät können alle Hue und LightLink kompatiblen Modelle verwendet werden. Dies sind zur Zeit (Anfang 2014):

HueBulbs (alle drei Modelle)
Friends of Hue LightStrips und LivingColors Bloom
LivingColors ab gen2
LivingColors Bloom und Iris
LivingWhites Energiesparlampen
LivingWhites Leuchtenadapter

Diese sind jeweils über eine Bridge (HueDevice) aus steuerbar. Die LivingColors und LivingWhites Geräte sind vorher mit Hilfe einer LivingColors oder LivingWhites Fernbedienung an der Bridge anzulernen.

Grundlagen - Farbmodelle

Ein HueDevice kann per set-Befehl über unterschiedliche Farbmodelle gesteuert werden. In der folgenden Tabelle ist dargestellt, welche Werte-Kombinationen sinnvoll sind:

Farbmodell	Bestandteile	Beispiel
xyY	x- und y-Koordinate im Farbraum, Y ist die Helligkeit	`set bulb1 xy 0.4595,0.4105 : bri 220`
hue,sat,bri	Farbwert, Sättigung und Helligkeit	`set bulb1 hue 14922 : sat 144 : bri 220`
ct	Farbwert über Farbtemperatur	`set bulb1 color 2600`
rgb	Farbbestandteile rot, grün und blau	`set bulb1 rgb FFC698`

Hinweis: Zur Regelung der Helligkeit sind die Befehle bri und pct gleichwertig. bri hat den Bereich 0..254, pct 0..100 .
Das Modul lässt die Mischung von Angaben aus unterschiedlichen Farbmodellen technisch zu, jedoch sind diese nicht immer sinnvoll.

Darstellung im Webfrontend

Wenn man die SVG Icons verwendet ist es sinnvoll, das Attribut color-icon zu setzen. Mit attr HUEDevice1 color-icon 2 werden z.B. die Farben und der Dimmzustand der Lampe als Icon dargestellt. Damit das ganze funktioniert, müsst ihr auch noch das attr WEB iconPath fhemSVG:openautomation:default setzen.

RaspBee

Das HUEBridge Modul unterstützt in einer beta version auch das RaspBee ZigBee Modul über die zugehörige deCONZ Software und die Wireless Light Control WebApp mit dem REST plugin. Die hierzu erhältlichen Funk-Vorschaltgeräte sind noch nicht getestet sollten aber auch funktionieren.

HUE auf der Fritzbox

Da auf der FB standardmäßig kein JSON installiert ist, muss dies nachinstalliert werden: Man lädt das JSON-Paket http://search.cpan.org/CPAN/authors/id/M/MA/MAKAMAKA/JSON-2.53.tar.gz, packt es aus und kopiert den Inhalt vom lib-Verzeichnis nach \fhem\lib\perl5\site_perl\5.12.2

HUE auf der Synology Diskstation

Da auf der DS standardmäßig kein JSON installiert ist, muss dies nachinstalliert werden, die Anleitung dazu hier