node-red-contrib-huemagic
Version:
Philips Hue node to control bridges, lights, groups, scenes, rules, taps, switches, buttons, motion sensors, temperature sensors and Lux sensors using Node-RED.
76 lines (48 loc) • 7.19 kB
HTML
<script type="text/markdown" data-help-name="hue-group">
Der „Hue Gruppe“-Node kann mehrere Lichter hinter einer Gruppe auf der Bridge gleichzeitig steuern.
### Einrichtung
Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Gruppen zu finden. Wenn Sie die ID von einer Gruppe bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Sie können intern entweder einen neuen Namen für die Gruppe vergeben oder den vordefinierten Namen wählen. Optional können Sie auch alle automatischen Statusmeldungen dieses Nodes deaktivieren, indem Sie die Einstellung „Ignoriere die Mitteilungen des Nodes“ anklicken. Der Node wird anschließend keine Updates mehr ausgeben. Alternativ können Sie auch auswählen, ob die Initialisierungsnachricht des Nodes beim Start von Node-RED nicht unterdrückt werden soll. Wenn Sie diese Einstellung aktivieren, erhalten Sie nach jedem Deploy eine Statusmeldung der aktuell ausgewählten Gruppe.
Wenn Sie keine Gruppe auswählen und die Node-Konfiguration so anwenden, arbeitet der Node im sogenannten „Universalmodus“. In diesem Modus empfängt der Node alle Statusmitteilungen desselben Typs und gibt diese aus. Sie können aber auch Einstellungen im Universalmodus auf eine bestimmte Gruppe anwenden, indem Sie die entsprechende Gruppen-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
### Status abrufen
Gibt den aktuellen Status der Gruppe aus, sobald ein `msg.payload`-Objekt mit folgendem Inhalt an den Node übergeben wurde. Sie können alternativ auch den Button in der Node-RED-Oberfläche betätigen, ohne vorher eine Nachricht an den Node übergeben zu müssen.
: status (boolean) : Gibt den aktuellen Status der Gruppe zurück
### Gruppe ein- / ausschalten (einfach)
Um eine gesamte Gruppe im einfachen Modus schnell ein- oder auszuschalten, übergeben Sie ein Objekt mit folgendem Inhalt an den Node. Bitte beachten Sie, dass der Befehl nur dann ausgeführt wird, wenn der aktuelle Status der Gruppe nicht mit Ihrem gewünschten Status übereinstimmt. Das heißt, dass alle Lichter vorher ausgeschaltet sein müssen, bevor Sie sie mit dem `true`-Befehl einschalten können.
: payload (boolean) : `true` schaltet die gesamte Gruppe ein, `false` schaltet sie aus
### Gruppensteuerung (erweitert)
Neben dem einfachen Ein- und Ausschalten, stehen Ihnen auch viele weitere Optionen zur Steuerung der Gruppe zur Verfügung. Alle Nodes in HueMagic können mit additiven Befehlen gesteuert werden. Das heißt, dass Sie zunächst eine Einstellung übergeben können und in einem späteren Befehl eine weitere Einstellung, ohne, dass die vorherige Einstellung damit verworfen wird. Übergeben Sie folgende Parameter in ein `msg.payload`-Objekt, um umfangreichere Einstellungen an der Gruppe vorzunehmen:
: on (boolean) : `true` schaltet die gesamte Gruppe ein, `false` schaltet sie aus (bitte Hinweis oben beachten)
: toggle (boolean | any) : Wechselt zwischen Ein- und Ausschalten, je nachdem, wie der vorherige Zustand der Gruppe war
: brightness (int | string) : Prozentualer Wert der Lichthelligkeit (0-100) oder ein String mit dem Wert `auto`, um die Lichthelligkeit automatisch auf Basis der aktuellen Uhrzeit einzustellen
: brightnessLevel (int) : Nummerischer Wert der Lichthelligkeit (0-254)
: color (string) : `random`, um eine zufällige Farbe einzustellen oder einen englischen Farbnamen (z. B. `red`)
: hex (string) : Farbwert in Hexadezimal in Form eines Strings
: rgb (array[0,0,0]) : Farbwert im RGB-Format in Form eines Arrays
: xyColor (object{x[float], y[float]}) : Farbwert im XY-Farbformat in Form eines Objekts
: image (string) : Pfad eines Bildes (lokal oder im Web), um die aktuelle Farbe der Gruppe auf die Durschschnittsfarbe des Bildes einzustellen
: colorTemp (int | string) : Wert zwischen 153 und 500, um die Farbtemperatur der Gruppe einzustellen oder die Werte `cold`, `normal`, `warm`, `hot` und `auto` – wobei `auto` die Farbtemperatur auf Basis der aktuellen Uhrzeit ausmacht
: transitionTime (float) : Übergangszeit der aktuellen Einstellung in Sekunden. Wenn `0` eingegeben wird, wechselt die Gruppe in die gewünschte Einstellung sofort. Wenn `3` eingegeben wird, wechselt die Gruppe mit einem leichten Übergang in den nächsten 3 Sekunden auf die gewünschte Einstellung
: colorloop (float) : Spielt eine „colorloop“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand der Gruppe
: alert (float) : Spielt eine „alert“-Animation für die gewählte Dauer in Sekunden ab und wechselt anschließend wieder zurück auf den ursprünglichen Zustand der Gruppe
### Statusnachrichten des Nodes
Wenn eine Änderung in der Gruppe festgestellt wurde, wird folgende Statusnachricht vom Node zurückgegeben. Bitte beachten Sie, dass die Gruppe nur dann Statusmeldungen ausgibt, wenn entweder das letzte Licht ausgeschaltet wird oder wenn das erste Licht eingeschaltet wird (wenn alle vorher ausgeschaltet waren).
Anders als beim „Hue Licht“-Node, stehen Ihnen hier viel weniger Statusinformationen zur Verfügung, da eine Gruppe viele unterschiedliche Gerätetypen mit unterschiedlichen Werten beinhalten kann, die nicht zusammengefasst werden können.
#### Statusobjekt unter `msg.payload`
: on (boolean) : Zustand der Gruppe, wobei `true` für an steht und `false` für aus
: updated (string) : Zeitpunkt der letzten Aktualisierung der Ressource von HueMagic (ISO 8601)
#### Informationen der Gruppe unter `msg.info`
: id (string) : Gibt die neue ID der Gruppe an
: idV1 (string | boolean) : Gibt die alte ID der Gruppe an
: name (string) : Der aktuell eingestellte Name des Gruppe
: resources (object) : Enthält alle Geräte/Ressourcen hinter der Gruppe
: type (string) : Der Typ des Gruppe (immer `group`)
#### Zustandsänderungen unter `msg.updated`
Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand der Gruppe geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
#### Letzter Stand des Lichts unter `msg.lastState`
Beinhaltet das komplette Statusobjekt (siehe Ausgabewerte oben) des letzten Zustands vor der letzten Änderung. Wenn der letzte Zustand von HueMagic noch nicht registriert wurde, wird `false` ausgegeben.
#### Letzter Befehl unter `msg.command` (optional)
Sofern der Status des Nodes sich über einen bestimmten Befehl geändert hat, wird der gesamte Befehl der ausgeführt wurde mit ausgegeben. Andernfalls wird dieses Objekt vom Node nicht ausgegeben.
### Beispiele von HueMagic
HueMagic stellt einige Beispielkonfigurationen zu diesem Node zur Verfügung. Um ein fertiges Beispiel in Ihrer Node-RED-Oberfläche zu importieren, klicken Sie auf das Menü-Icon von Node-RED, wählen Sie dann „Import“ und navigieren Sie in der Sidebar des Popups auf „Beispiele“. Wählen Sie anschließend den HueMagic-Ordner aus und Ihren gewünschten Node, um einen Beispielflow zu importieren.
</script>