node-red-contrib-huemagic 2.8.2 → 4.0.0

package/huemagic/locales/de/hue-magic.json

@@ -21,7 +21,8 @@
 			"animating": "animiere…",
 			"stopped": "gestoppt",
 			"input": "Starte Animation",
-			"output": "Licht oder Gruppe"
+			"output": "Licht oder Gruppe",
+			"playmsg": "Animation gestartet…"
 		}
 	}
 }

package/huemagic/locales/de/hue-motion.html

@@ -1,60 +1,64 @@
-<script type="text/x-red" data-help-name="hue-motion">
-    <p>Hue Bewegungssensor zur Steuerung des Bewegungssensors und zum Empfang von Bewegungsereignissen.</p>
+<script type="text/markdown" data-help-name="hue-motion">
+Der „Hue Bewegungssensor“-Node kann Bewegungen von einem geeigneten Sensor auf der Bridge registrieren und mitteilen.
 
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Bewegungssensoren zu finden. Geben Sie den Namen des Sensors manuell ein oder behalten Sie den Standardgerätenamen bei. Beachten Sie, dass Ereignisse nur gesendet werden, wenn eine Bewegung erkannt wird, wenn eine Bewegung stoppt oder wenn der Bewegungssensor den Befehl "Aktivieren / Deaktivieren" empfängt. Bei Bedarf können alle Statusaktualisierungen dieses Nodes durch Aktivieren der Option "Mitteilungen ignorieren" ignoriert werden.</p>
+### Einrichtung
 
-    <h3>Aktivieren / Deaktivieren</h3>
-    <p>Aktiviert oder deaktiviert den Bewegungssensor basierend auf den übergebenen <b>msg</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>true<span class="property-type">boolean</span></dt>
-        <dd>Aktiviert den Bewegungssensor</dd>
+Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Sensoren zu finden. Wenn Sie die ID des Sensors bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Sie können intern entweder einen neuen Namen für den Sensor vergeben oder den vordefinierten Namen des Sensors 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 Geräteupdates 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 des aktuell ausgewählten Sensors.
 
-        <dt>false<span class="property-type">boolean</span></dt>
-        <dd>Deaktiviert den Bewegungssensor</dd>
+Wenn Sie keinen Sensor 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 einen bestimmten Sensor anwenden, indem Sie die entsprechende Sensor-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
 
-        <dt class="optional">status<span class="property-type">any</span></dt>
-        <dd>Gibt den aktuellen Status des Nodes zurück, ohne eine Aktion durchzuführen</dd>
-    </dl>
+### Status abrufen
 
-    <h3>Bewegungsereignisse</h3>
-    <p>Die vom Bewegungssensor gesendete Ereignismeldung enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>active<span class="property-type">boolean</span></dt>
-        <dd>Aktueller Sensorzustand</dd>
+Gibt den aktuellen Status des Sensors 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.
 
-        <dt>motion<span class="property-type">boolean</span></dt>
-        <dd>Zeigt an, ob eine Bewegung erkannt wurde oder nicht</dd>
+: status (boolean) : Gibt den aktuellen Status des Sensors zurück
 
-        <dt>updated<span class="property-type">string</span></dt>
-        <dd>ISO 8601 Datum der zuletzt erkannten Bewegung</dd>
-    </dl>
+### Sensor ein- / ausschalten
 
-    <h3>Zusätzliche Sensorinformationen</h3>
-    <p>Zusätzliche Informationen zum Sensor werden an das Objekt <b>msg.info</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">int</span></dt>
-        <dd>Numerische ID des Sensors, wie auf der Bridge registriert</dd>
+Der Sensor kann im Bedarfsfall ferngesteuert ein- und ausgeschalten werden. Wenn der Sensor ausgeschaltet wurde, registriert er keine Bewegungen mehr und gibt diese entsprechend auch nicht mehr aus. Übergeben Sie dafür ein Objekt mit folgendem Inhalt:
 
-        <dt>uniqueId<span class="property-type">string</span></dt>
-        <dd>Eindeutige ID des Sensors (normalerweise Hardware-ID)</dd>
+: payload (boolean) : `true` schaltet den Sensor ein, `false` schaltet ihn aus
 
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Name des Sensors</dd>
+### Statusnachrichten des Nodes
 
-        <dt>type<span class="property-type">string</span></dt>
-        <dd>Sensor-Typ (z.B. Daylight, CLIPTemperature, ZGPSwitch)</dd>
+Sobald der Sensor eine Bewegung registriert hat, wird folgende Statusnachricht vom Node zurückgegeben:
 
-        <dt>softwareVersion<span class="property-type">float</span></dt>
-        <dd>Softwareversion des Sensors</dd>
+#### Statusobjekt unter `msg.payload`
 
-        <dt>battery<span class="property-type">int</span></dt>
-        <dd>Aktueller Batteriestand des Sensors in Prozent</dd>
+: active (boolean) : Gibt an, ob der Sensor ein- oder ausgeschaltet ist
+: reachable (boolean | string) : `true` wenn der Sensor mit der Bridge verbunden ist, `unknown` wenn der Verbindungsstatus abweicht
+: connectionStatus (string) : Der aktuelle Verbindugsstatus mit der Bridge in Form eines Strings. Kann `connected`, `disconnected`, `connectivity_issue` oder `unidirectional_incoming` als Wert beinhalten
+: motion (boolean) : Gibt an, ob eine Bewegung registriert wurde
+: updated (string) : Zeitpunkt der letzten Aktualisierung der Ressource von HueMagic (ISO 8601)
 
-        <dt>model<span class="property-type">object</span></dt>
-        <dd>Das Modellobjekt des Sensors enthält modellspezifische Informationen wie model.id, model.manufacturer, model.name und model.type</dd>
-    </dl>
+#### Informationen zum Sensor unter `msg.info`
 
-    <h3>Letzte Zustandsinformationen</h3>
-    <p>Dieser Node schickt auch die gesamten letzten Zustandsinformationen (vor dem Update) in das <b>msg.lastState</b>-Objekt. Dieses kann entweder false (Boolean) or die Objekte payload (msg.lastState.payload) und info (msg.lastState.info) beinhalten. Der Rückgabewert "false" wird nur dann gesendet, wenn es keinen letzten Zustand gab oder der Node neu erstellt oder gestartet wurde.</p>
+: id (string) : Gibt die neue ID des Sensors an
+: idV1 (string | boolean) : Gibt die alte ID des Sensors an
+: uniqueId (string) : Die eindeutige ID des Sensors
+: deviceId (string) : Die eindeutige ID des Geräts
+: name (string) : Der aktuell eingestellte Name des Sensors
+: type (string) : Der Typ des Sensors (immer `motion`)
+: softwareVersion (string) : Die aktuelle Firmware des Sensors
+: battery (float) : Der aktuelle Batteriestand des Sensors
+: batteryState (string) : Der aktuelle Status des Batteriestands. Kann `normal`, `low` oder `critical` als Wert beinhalten
+: model (object) : Beinhaltet die Modellinformationen des Sensors unter `id`, `manufacturer`, `name`, `type` und `certified`
+
+#### Zustandsänderungen unter `msg.updated`
+
+Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand des Sensors geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
+
+#### Letzter Stand des Sensors unter `msg.lastState`
+
+Beinhaltet das komplette Statusobjekt (siehe Ausgabewerte oben) des letzten Zustands vor der zuletzt registrierten Ä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.
+
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

package/huemagic/locales/de/hue-motion.json

@@ -5,8 +5,8 @@
 		{
 			"name": "Name",
 			"input-name": "Name des Sensors",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"searching": "Suche nach Bewegungssensoren…",
 			"none-found": "Keine Bewegungssensoren gefunden!",
 			"unknown-error": "Etwas ist schief gelaufen. Bitte versuchen Sie es erneut.",
@@ -21,8 +21,11 @@
 			"no-motion": "keine Bewegung",
 			"activated": "aktiviert",
 			"deactivated": "deaktiviert",
-			"input": "aktivieren / deaktivieren",
-			"output": "erkannte Bewegung"
+			"input": "aktivieren / deaktivieren / Statusabfrage",
+			"output": "erkannte Bewegung",
+			"universal": "Universalmodus",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Status erfolgreich abgefragt…"
 		}
 	}
 }

package/huemagic/locales/de/hue-rules.html

@@ -1,74 +1,69 @@
-<script type="text/x-red" data-help-name="hue-rules">
-    <p>Hue Regel Node zum Empfangen von Regelereignissen oder zum Aktivieren / Deaktivieren von Regeln.</p>
-
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge aus und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Regeln auf der Bridge zu finden. Geben Sie den Namen der Regel manuell ein oder behalten Sie den Standardnamen bei. Beachten Sie, dass Ereignisse nur bei der Bereitstellung (einmalig) gesendet werden und wenn die Regel auf der Bridge ausgelöst wird. Bei Bedarf können alle Statusaktualisierungen dieses Nodes durch Aktivieren der Option "Mitteilungen ignorieren" ignoriert werden.</p>
-
-    <h3>Aktivieren / Deaktivieren</h3>
-    <p>Aktiviert oder deaktiviert die Regel basierend auf den übergebenen <b>msg.payload</b>-Werten von:</p>
-    <dl class="message-properties">
-        <dt>true<span class="property-type">boolean</span></dt>
-        <dd>Aktiviert die Regel</dd>
-
-        <dt>false<span class="property-type">boolean</span></dt>
-        <dd>Deaktiviert die Regel</dd>
-    </dl>
-
-    <h3>Regel-Mitteilungen</h3>
-    <p>Die vom Regel-Node gesendete Ereignismeldung enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>triggered<span class="property-type">string</span></dt>
-        <dd>ISO 8601 Datum der letzten Aktivierung</dd>
-    </dl>
-
-    <h3>Zusätzliche Regelinformationen</h3>
-    <p>Zusätzliche Informationen zu der Regel werden an das Objekt <b>msg.info</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">int</span></dt>
-        <dd>Numerische ID der Regel, wie auf der Bridge registriert</dd>
-
-        <dt>created<span class="property-type">string</span></dt>
-        <dd>ISO 8601 Datum des Erstellungsdatums der Regel</dd>
-
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Name der Regel</dd>
-
-        <dt>timesTriggered<span class="property-type">int</span></dt>
-        <dd>Anzahl die angibt wie oft die Regel bereits aktiviert wurde</dd>
-
-        <dt>owner<span class="property-type">string</span></dt>
-        <dd>Nutzer, der die Regel erstellte</dd>
-
-        <dt>status<span class="property-type">string</span></dt>
-        <dd>aktiviert oder deaktiviert, Regel ist auslösbar bei aktiviert</dd>
-    </dl>
-
-    <h3>Regelbedingungen</h3>
-    <p>Ein Array von Objekten, die die Regelbedingungen darstellen, wird an das Array <b>msg.conditions</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>address<span class="property-type">string</span></dt>
-        <dd>Die Sensorressource / der Statusstandort für die Bedingung</dd>
-
-        <dt>operator<span class="property-type">string</span></dt>
-        <dd>Der Operator für die Bedingung</dd>
-
-        <dt>value<span class="property-type">string</span></dt>
-        <dd>Der Wert, der in Verbindung mit dem Operator verwendet wird</dd>
-    </dl>
-
-    <h3>Regelaktionen</h3>
-    <p>Ein Array von Objekten, die die Regelaktionen darstellen, wird an das Array <b>msg.actions</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>address<span class="property-type">string</span></dt>
-        <dd>Der Ort der umsetzbaren Ressource</dd>
-
-        <dt>method<span class="property-type">string</span></dt>
-        <dd>Art der Methode für die Aktion (z.B. GET, PUT)</dd>
-
-        <dt>body<span class="property-type">object</span></dt>
-        <dd>Das Body / Inhalt der Aktion</dd>
-    </dl>
-
-    <h3>Letzte Zustandsinformationen</h3>
-    <p>Dieser Node schickt auch die gesamten letzten Zustandsinformationen (vor dem Update) in das <b>msg.lastState</b>-Objekt. Dieses kann entweder false (Boolean) or die Objekte payload (msg.lastState.payload) und info (msg.lastState.info) beinhalten. Der Rückgabewert "false" wird nur dann gesendet, wenn es keinen letzten Zustand gab oder der Node neu erstellt oder gestartet wurde.</p>
+<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.
+
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

package/huemagic/locales/de/hue-rules.json

@@ -5,8 +5,8 @@
 		{
 			"name": "Name",
 			"input-name": "Name der Regel",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"searching": "Suche nach Regeln…",
 			"none-found": "Keine Regeln gefunden!",
 			"unknown-error": "Etwas ist schief gelaufen. Bitte versuchen Sie es erneut.",
@@ -20,7 +20,10 @@
 			"enabled": "aktiviert",
 			"disabled": "deaktiviert",
 			"output": "Regel (aktiviert)",
-			"input": "aktivieren / deaktivieren"
+			"input": "aktivieren / deaktivieren",
+			"universal": "Universalmodus",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Status erfolgreich abgefragt…"
 		}
 	}
 }

package/huemagic/locales/de/hue-scene.html

@@ -1,44 +1,35 @@
-<script type="text/x-red" data-help-name="hue-scene">
-    <p>Hue Szene zum Aufrufen (Aktivieren) von Farbszenen.</p>
+<script type="text/markdown" data-help-name="hue-scene">
+Der „Hue Szene“-Node kann in der Bridge gespeicherte Szenen wiederaufnehmen und auf bestimmte Gruppen anwenden.
 
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Szenen zu finden. Geben Sie den Namen der Szene manuell ein oder behalten Sie den Standardnamen der Szene bei. Beachten Sie, dass Ereignisse nur gesendet werden, wenn der Szenen-Node einen Befehl empfängt. Bei Bedarf können alle Statusaktualisierungen dieses Nodes durch Aktivieren der Option "Miteilungen ignorieren" ignoriert werden.</p>
+### Einrichtung
 
-    <h3>Aktivieren (vorkonfiguriert)</h3>
-    <p>Wenn eine Szene konfiguriert ist, wird die vorkonfigurierte Szene durch einen übergebenen Wert auf dem Szenen-Node aktiviert.</p>
+Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Szenen zu finden. Wenn Sie die ID der Szene bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Alternativ können Sie auch einen internen Namen für die Szene vergeben oder den vordefinierten Namen der Szene wählen.
 
-    <h3>Aktivieren (dynamisch)</h3>
-    <p>Wenn keine Szene konfiguriert ist, muss ein Szenenname oder eine Szenen-ID übergeben werden, um diese Szene zu aktivieren. Es ist auch möglich, eine Gruppen-ID dynamisch zu übergeben, um eine Szene nur für eine bestimmte Gruppe abzurufen. Die folgenden Parameter können manuell in <b>msg.payload</b> übergeben werden.</p>
-    <dl class="message-properties">
-        <dt>scene<span class="property-type">string</span></dt>
-        <dd>Aktiviert die Szene anhand ihres Namens oder ihrer ID.</dd>
+### Szene aktivieren
 
-        <dt>group<span class="property-type">int</span></dt>
-        <dd>Ruft eine Szene einer bestimmten Gruppe anhand ihrer ID auf.</dd>
-    </dl>
+Sie können eine vordefinierte Szene aktivieren, indem Sie ein Objekt mit folgendem Inhalt übergeben:
 
-    <h3>Szenenereignisse</h3>
-    <p>Die Ereignismeldung, die der Szenen-Node sendet, enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">string</span></dt>
-        <dd>Die eindeutige Szenen-ID</dd>
+: payload (boolean) : Aktiviert eine vorkonfigurierte Szene
 
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Szenen-Name</dd>
+### Szene im Universalmodus aktivieren
 
-        <dt>lightIds<span class="property-type">array[int…]</span></dt>
-        <dd>Array von zugeordneten Lichter-IDs in der Szene</dd>
+Wenn Sie diesen Node im sogenannten „Universalmodus“ betreiben und keine Szene in der Node-Konfiguration eingestellt haben, können Sie Ihre gewünschte Szene auch als Befehl an den Node übergeben. Übergeben Sie dafür ein `msg.payload`-Objekt mit folgendem Inhalt:
 
-        <dt>owner<span class="property-type">string</span></dt>
-        <dd>Nutzer, der die Szene erstellte</dd>
+: scene (string) : ID der zu aktivierenden Szene auf der Bridge
 
-        <dt>appData<span class="property-type">object</span></dt>
-        <dd>Objekt bestehend aus Versions- und Dateneigenschaften</dd>
+### Szene auf bestimmte Gruppen aktivieren
 
-        <dt>lastUpdated<span class="property-type">string</span></dt>
-        <dd>ISO 8601 Datum, als die Szene zuletzt aktualisiert wurde</dd>
+Verbinden Sie den Ausgangspunkt dieses Nodes mit eine oder mehreren Gruppen, um eine Szene auf bestimmte Gruppen anzuwenden. Alternativ haben Sie die Möglichkeit dies auch „dynamisch“ zu tun, indem Sie ein `msg.payload`-Objekt mit folgenden Inhalt an den Node übergeben:
 
-        <dt>version<span class="property-type">float</span></dt>
-        <dd>Versionsnummer der Szene</dd>
-    </dl>
+: group (string | array[string,…]) : ID der Gruppe oder ein Array mit den IDs mehrerer Gruppen, um die Szene auf diese Gruppen zu begrenzen
+
+### Weitere Informationen zum Node
+
+Dieser Node gibt keine Statusnachrichten aus. Bitte beachten Sie auch, dass Sie Szenen nur dann auf Gruppen anwenden können, wenn diese bereits auf der Bridge mit der jeweiligen Szene verknüpft sind. Andernfalls wird nichts angewendet.
+
+### 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.
+
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

package/huemagic/locales/de/hue-scene.json

@@ -5,11 +5,12 @@
 		{
 			"name": "Name",
 			"input-name": "Name der Szene",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"searching": "Suche nach Szenen…",
 			"none-found": "Keine Szenen gefunden!",
 			"unknown-error": "Etwas ist schief gelaufen. Bitte versuchen Sie es erneut.",
+			"scene": "Szene",
 			"group": "Gruppe",
 			"group-none-found": "Keine Gruppen gefunden!",
 			"group-searching": "Suche nach Gruppen…",
@@ -23,7 +24,9 @@
 			"recalled-on-group": "Szene auf Gruppe wiederhergestellt",
 			"no-id": "Keine Szenen-ID",
 			"input": "aktiviere Szene",
-			"output": "Szeneninformationen"
+			"output": "Zielgruppe(n)",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Szene wird wiederhergestellt…"
 		}
 	}
 }

package/huemagic/locales/de/hue-temperature.html

@@ -1,50 +1,67 @@
-<script type="text/x-red" data-help-name="hue-temperature">
-    <p>Hue Temperatur um die aktuelle (Raum-)Temperatur in Celsius und Fahrenheit zu erhalten.</p>
+<script type="text/markdown" data-help-name="hue-temperature">
+Der „Hue Temperatur“-Node kann die aktuelle Umgebungstemperatur von einem geeigneten Sensor auf der Bridge abrufen und mitteilen.
 
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie die vorkonfigurierte Hue Bridge aus und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Temperatursensoren zu finden. Geben Sie den Namen des Sensors manuell ein oder behalten Sie den Standardgerätenamen bei. Beachten Sie, dass Ereignisse nur bei der Bereitstellung (einmalig) und bei Temperaturänderungen gesendet werden. Bei Bedarf können alle Statusaktualisierungen dieses Nodes durch Aktivieren der Option "Mitteilungen" ignoriert werden.</p>
+### Einrichtung
 
-    <h3>Temperatur-Ereignisse</h3>
-    <p>Die vom Temperatursensor gesendete Ereignismeldung enthält die folgenden Daten im Objekt <b>msg.payload</b>:</p>
-    <dl class="message-properties">
-        <dt>celsius<span class="property-type">float</span></dt>
-        <dd>Temperatur in Celsius</dd>
+Wählen Sie die vorkonfigurierte Hue Bridge und klicken Sie auf die Suchschaltfläche, um alle verfügbaren Sensoren zu finden. Wenn Sie die ID des Sensors bereits kennen, können Sie sie auch manuell an dieser Stelle eintragen. Sie können intern entweder einen neuen Namen für den Sensor vergeben oder den vordefinierten Namen des Sensors 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 Geräteupdates 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 des aktuell ausgewählten Sensors.
 
-        <dt>fahrenheit<span class="property-type">float</span></dt>
-        <dd>Temperatur in Fahrenheit</dd>
+Wenn Sie keinen Sensor 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 einen bestimmten Sensor anwenden, indem Sie die entsprechende Sensor-ID als String in `msg.topic` zusammen mit Ihren Einstellungen übergeben.
 
-        <dt>deviceValue<span class="property-type">int</span></dt>
-        <dd>Temperaturwert des Sensors (Originalwert)</dd>
+### Status abrufen
 
-        <dt>updated<span class="property-type">string</span></dt>
-        <dd>ISO 8601 Datum der letzten Temperaturänderung</dd>
-    </dl>
+Gibt den aktuellen Status des Sensors 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.
 
-    <h3>Zusätzliche Sensorinformationen</h3>
-    <p>Zusätzliche Informationen zum Gerät werden an das Objekt <b>msg.info</b> gesendet:</p>
-    <dl class="message-properties">
-        <dt>id<span class="property-type">int</span></dt>
-        <dd>Numerische ID des Sensors, wie auf der Bridge registriert</dd>
+: status (boolean) : Gibt den aktuellen Status des Sensors zurück
 
-        <dt>uniqueId<span class="property-type">string</span></dt>
-        <dd>Eindeutige ID des Sensors (normalerweise Hardware-ID)</dd>
+### Sensor ein- / ausschalten
 
-        <dt>name<span class="property-type">string</span></dt>
-        <dd>Name des Sensors</dd>
+Der Sensor kann im Bedarfsfall ferngesteuert ein- und ausgeschalten werden. Wenn der Sensor ausgeschaltet wurde, registriert er keine Temperaturänderungen mehr und gibt diese entsprechend auch nicht mehr aus. Übergeben Sie dafür ein Objekt mit folgendem Inhalt:
 
-        <dt>type<span class="property-type">string</span></dt>
-        <dd>Sensor-Typ (z.B. Daylight, CLIPTemperature, ZGPSwitch)</dd>
+: payload (boolean) : `true` schaltet den Sensor ein, `false` schaltet ihn aus
 
-        <dt>softwareVersion<span class="property-type">float</span></dt>
-        <dd>Softwareversion des Sensors</dd>
+### Statusnachrichten des Nodes
 
-        <dt>battery<span class="property-type">int</span></dt>
-        <dd>Aktueller Batteriestand des Sensors in Prozent</dd>
+Sobald der Sensor eine Temperaturänderung registriert hat, wird folgende Statusnachricht vom Node zurückgegeben:
 
-        <dt>model<span class="property-type">object</span></dt>
-        <dd>Das Modellobjekt des Sensors enthält modellspezifische Informationen wie model.id, model.manufacturer, model.name und model.type</dd>
-    </dl>
+#### Statusobjekt unter `msg.payload`
 
-    <h3>Letzte Zustandsinformationen</h3>
-    <p>Dieser Node schickt auch die gesamten letzten Zustandsinformationen (vor dem Update) in das <b>msg.lastState</b>-Objekt. Dieses kann entweder false (Boolean) or die Objekte payload (msg.lastState.payload) und info (msg.lastState.info) beinhalten. Der Rückgabewert "false" wird nur dann gesendet, wenn es keinen letzten Zustand gab oder der Node neu erstellt oder gestartet wurde.</p>
+: active (boolean) : Gibt an, ob der Sensor ein- oder ausgeschaltet ist
+: reachable (boolean | string) : `true` wenn der Sensor mit der Bridge verbunden ist, `unknown` wenn der Verbindungsstatus abweicht
+: connectionStatus (string) : Der aktuelle Verbindugsstatus mit der Bridge in Form eines Strings. Kann `connected`, `disconnected`, `connectivity_issue` oder `unidirectional_incoming` als Wert beinhalten
+: celsius (float) : Gibt die aktuelle Umgebungstemperatur in °C (Grad Celsius) an
+: fahrenheit (float) : Gibt die aktuelle Umgebungstemperatur in °F (Grad Fahrenheit) an
+: temperatureIs (string) : Beschreibt die aktuelle Temperatur mit den Werten ´very cold´, ´cold´, ´slightly cold´, ´comfortable´, ´slightly warm´, ´warm´, ´hot´ oder ´very hot´
+: deviceValue (float) : Der Originalwert der Temperatur vom Sensor
+: updated (string) : Zeitpunkt der letzten Aktualisierung der Ressource von HueMagic (ISO 8601)
+
+#### Informationen zum Sensor unter `msg.info`
+
+: id (string) : Gibt die neue ID des Sensors an
+: idV1 (string | boolean) : Gibt die alte ID des Sensors an
+: uniqueId (string) : Die eindeutige ID des Sensors
+: deviceId (string) : Die eindeutige ID des Geräts
+: name (string) : Der aktuell eingestellte Name des Sensors
+: type (string) : Der Typ des Sensors (immer `temperature`)
+: softwareVersion (string) : Die aktuelle Firmware des Sensors
+: battery (float) : Der aktuelle Batteriestand des Sensors
+: batteryState (string) : Der aktuelle Status des Batteriestands. Kann `normal`, `low` oder `critical` als Wert beinhalten
+: model (object) : Beinhaltet die Modellinformationen des Sensors unter `id`, `manufacturer`, `name`, `type` und `certified`
+
+#### Zustandsänderungen unter `msg.updated`
+
+Listet einzelne Parameter in Form eines Objekts auf, die sich im Vergleich zum letzten Zustand des Sensors geändert haben. Wenn keine Änderungen registriert wurden, ist dieses Objekt leer.
+
+#### Letzter Stand des Sensors unter `msg.lastState`
+
+Beinhaltet das komplette Statusobjekt (siehe Ausgabewerte oben) des letzten Zustands vor der zuletzt registrierten Ä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.
+
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

package/huemagic/locales/de/hue-temperature.json

@@ -5,8 +5,8 @@
 		{
 			"name": "Name",
 			"sensor": "Sensor",
-			"skipevents": "Mitteilungen ignorieren",
 			"skipevents-node": "Ignoriere die Mitteilungen des Nodes",
+			"sendinitevents-node": "Initialisierungsnachricht nicht unterdrücken",
 			"input-name": "Name des Temperatursensors",
 			"searching": "Suche nach Temperatursensoren…",
 			"none-found": "keine Temperatursensoren gefunden!",
@@ -18,7 +18,12 @@
 			"not-configured": "nicht konfiguriert",
 			"init": "initialisiere…",
 			"not-reachable": "nicht erreichbar",
-			"output": "Temperatur (aktualisiert)"
+			"input": "Statusabfrage",
+			"output": "Temperatur (aktualisiert)",
+			"universal": "Universalmodus",
+			"deactivated": "deaktiviert",
+			"command": "führt Befehl aus…",
+			"statusmsg": "Status erfolgreich abgefragt…"
 		}
 	}
 }

package/huemagic/locales/en-US/hue-bridge-config.html

@@ -1,18 +1,23 @@
-<script type="text/x-red" data-help-name="hue-bridge">
-	<p>Philips Hue Bridge configuration with the following parameters:</p>
+<script type="text/markdown" data-help-name="hue-bridge">
+Connects to a Philips Hue bridge.
 
-	<h3>Name</h3>
-    <p>Type in the name of the Hue Bridge manually or keep the default device name</p>
+### Name
 
-    <h3>Bridge IP & Port</h3>
-    <p>Type in the Hue Bridge IP address manually or press the button to retrieve all locally available bridges (static IP configuration on the Hue Bridge recommended). Optionally, you can define an alternate port to the bridge instead of the default port (80) by appending it with a colon</p>
+You can either assign an alternative, internal name for the bridge or keep the default name.
 
-    <h3>API Key</h3>
-    <p>Type in the Hue Bridge authorization key manually or press the button to retrieve key from bridge</p>
+### Bridge IP & Port
 
-    <h3>Poll interval</h3>
-    <p>Interval that is used to poll active nodes for changes (min 500ms / recommended between 1000ms and 5000ms)</p>
+Enter the Hue Bridge IP address manually or press the button to call up all locally available bridges (static IP configuration on the Hue Bridge recommended). You can also optionally define an alternative port for the bridge by adding a colon to the IP address.
 
-    <h3>Disable events</h3>
-    <p>If this setting is activated, the current status of Light, Group & Rule nodes will not be polled from the bridge. Hue Motion and Tap sensors are unaffected by this setting.</p>
+### API key
+
+Enter the Hue Bridge API key manually or press the button to create a new key. If you want to create a new key, you have to press the physical button of the bridge within the time window of 20 seconds to complete the process.
+
+### Automatic firmware updates
+
+HueMagic periodically checks for available Philips Hue firmware updates and automatically installs them when they are available. You can deactivate this behavior by clicking the corresponding checkbox.
+
+### Deactivate notifications
+
+If you activate this setting, all nodes behind this bridge will no longer receive automatic status messages.
 </script>

package/huemagic/locales/en-US/hue-bridge-config.json

@@ -6,7 +6,6 @@
 			"name": "Name",
 			"apikey": "API Key",
 			"missing-ip": "Missing Hue Bridge IP…",
-			"poll": "Poll Interval",
 			"disable-events": "Disable events",
 			"disable-events-info": "Disable events on all nodes",
 			"searching": "Searching for Hue Bridges…",
@@ -17,11 +16,14 @@
 			"waiting": "waiting 20 seconds…",
 			"new-user-press": "Please press your Hue Bridge button within the next 20 seconds to create a new user!",
 			"retry": "Please retry within 20 seconds…",
-			"success": "User created successfully!"
+			"success": "User created successfully!",
+			"connecting": "Connecting with the bridge…",
+			"autoupdates": "Activate automatic firmware updates"
 		},
 		"node":
 		{
-			"title": "Hue Bridge"
+			"title": "Hue Bridge",
+			"statusmsg": "Status queried successfully…"
 		}
 	}
 }