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.
69 lines (41 loc) • 4.12 kB
HTML
<script type="text/markdown" data-help-name="hue-rules">
Der „Hue Regel“-Node kann in der Bridge gespeicherte Regeln aktivieren oder deaktivieren und ihre Einstellung abrufen.
### Einrichtung
Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Regeln zu finden. Wenn Sie die ID der Regel bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Alternativ können Sie auch einen neuen Namen vergeben oder den vordefinierten Namen der Regel wählen.
Wenn Sie keine Regel 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 Regel anwenden, indem Sie die entsprechende Regel-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
### Eigenschaften / Einstellungen abrufen
Gibt die aktuellen Eigenschaften der Regel 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 Regel zurück
### Regel aktivieren / deaktivieren
Die Regel kann im Bedarfsfall aktiviert und deaktiviert werden. Wenn die Regel deaktiviert wurde, wird sie in der Bridge nicht mehr ausgeführt, bis Sie sie wieder reaktivieren. Übergeben Sie dafür ein Objekt mit folgendem Inhalt:
: payload (boolean) : `true` aktiviert die Regel, `false` deaktiviert sie
### Statusnachrichten des Nodes
Sobald sich der Status (aktiviert / deaktiviert) einer Regel ändert, wird folgende Statusnachricht vom Node zurückgegeben:
#### Statusobjekt unter `msg.payload`
: enabled (boolean) : Gibt an, ob die Regel aktiviert oder deaktiviert ist
: triggered (string) : Zeitpunkt der letzten Ausführung (ISO 8601)
#### Informationen der Regel unter `msg.info`
: id (string) : Die eindeutige ID der Regel
: created (string) : Erstellungsdatum der Regel (ISO 8601)
: name (string) : Name der Regel auf der Bridge
: timesTriggered (int) : Anzahl der Ausführungen der Regel auf der Bridge
: owner (string) : ID des Besitzers / der Besitzerin dieser Regel
: status (string) : Status der Regel in Form eines Strings
#### Regelkonditionen unter `msg.conditions` (array)
: address (string) : Pfad zu einem Attribut eines Sensors
: operator (string) : Operator
: value (string) : Der zu prüfende Wert
#### Regelaktionen unter `msg.actions` (array)
: address (string) : Die Zieladresse der Ressource
: method (string) : Die Anfragemethode
: body (object) : Die Aktion, die ausgeführt werden soll
#### Zustandsänderungen unter `msg.updated`
Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand der Regel geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
#### Letzter Stand der Regel unter `msg.lastState`
Beinhaltet das komplette Objekt (siehe Ausgabewerte oben) des letzten Zustands vor der zuletzt registrierten Änderung der Regel. 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>