node-red-contrib-huemagic 3.0.0 → 4.0.0

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

@@ -1,60 +1,68 @@
-<script type="text/x-red" data-help-name="hue-magic">
-    <p>Hue Magic Node für Animationen</p>
-
-    <h3>Einrichtung</h3>
-    <p>Wählen Sie aus, ob die Animation auf unbestimmte Zeit wiederholt werden soll und / oder ob der vorherige Zustand wiederhergestellt werden soll, nachdem die Animation beendet / gestoppt wurde. Wählen Sie eine der mitgelieferten Animationen aus und verbinden Sie den Knoten mit einer Gruppe oder einem Licht.</p>
-
-    <h3>Starten / Stoppen</h3>
-    <p>Startet oder stoppt eine Animation 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>Startet die Animation</dd>
-
-        <dt>false<span class="property-type">boolean</span></dt>
-        <dd>Stoppt die Animation</dd>
-    </dl>
-
-    <h3>Eigene Animationen</h3>
-    <p>Alternativ können Sie eigene Animationen erstellen und anwenden. Dazu erstellen Sie ein Array und übergeben es mit den folgenden Parametern an <b>msg.payload.steps</b>.</p>
-    <dl class="message-properties">
-        <dt>delay<span class="property-type">int</span></dt>
-        <dd>Führe diesen Frame nach der Verzögerung aus (in Millisekunden)</dd>
-
-        <dt>animation<span class="property-type">object</span></dt>
-        <dd>Fügen Sie hier alle Parameter ein, die animiert werden sollen. Unterstützt alle Werte des Nodes "Hue Licht" und "Hue Gruppe".</dd>
-    </dl>
-
-    <h3>Spezielle Kommandos</h3>
-    <p>Manchmal ist es sinnvoll, Animationen ungeordnet abzuspielen. Zum Beispiel, um Feuer realistischer zu imitieren. Dazu erstellen Sie ein Objekt und übergeben es mit den folgenden Parametern an <b>msg.payload.specials</b>.</p>
-    <dl class="message-properties">
-        <dt>randomOrder<span class="property-type">boolean</span></dt>
-        <dd>Führt die Schritte in zufälliger Reihenfolge aus</dd>
-    </dl>
-
-    <h4>Beispiel (eigene Animation)</h4>
-<code>
-<pre>
-{
-    "animate": true,
-    "steps": [
-        {
-            "delay": 500,
-            "animation": {
-                "hex": "#FF0000",
-                "transitionTime": 1
-            }
-        },
-        {
-            "delay": 500,
-            "animation": {
-                "hex": "#0000FF",
-                "transitionTime": 1
+<script type="text/markdown" data-help-name="hue-magic">
+Der „Hue Magic“-Node kann komplexe und benutzerdefinierte Animationen auf Lichtern und Gruppen anwenden.
+
+### Einrichtung
+
+Vergeben Sie zunächst dem Node einen Namen, um Ihre Animation in der Node-RED-Oberfläche klar einzuordnen. Anschließend haben Sie die Wahl zwischen den Optionen „Wiederholen“ und „Wiederherstellen“. Wählen Sie die Option „Wiederholen“, wenn Sie Ihre Animation auf einem Licht oder einer Gruppe endlos abspielen möchten, bis Sie sie manuell stoppen. Wenn Sie den vorherigen Zustand der Zielressource (Licht / Gruppe) nach Beendigung der Animation wiederherstellen möchten, setzen Sie den Haken auf „Wiederherstellen“. Andernfalls bleibt der letzte Frame der Animation auf der jeweiligen Ressource stehen.
+
+Weiter unten haben Sie die Wahl aus vorgefertigten Animationen von HueMagic. Klicken Sie Ihre gewünschte Animation an, um Sie einzustellen.
+
+### Animation starten / stoppen
+
+Um eine Animation abzuspielen oder zu stoppen, übergeben Sie ein Objekt mit folgenden Inhalt an den Node:
+
+: payload (boolean) : `true`, startet die Animation, `false`, stoppt die Animation
+
+### Eigene Animationen
+
+Wenn Sie dem Node eine eigene Animation übergeben, wird die vorausgewählte, vorgefertigte Animation (wenn eingestellt) vorübergehend durch Ihre ersetzt. Eigene HueMagic-Animationen sind eine Folge von Befehlen, die in einem Array zusammengefasst wurden. Jedes Array-Element bildet einen Schritt – wobei ein Schritt auch aus mehreren Frames bestehen kann (Übergangseffekte).
+
+Erstellen Sie ein `Array` mit den jeweiligen Animationsschritten in Form eines Objekts und übergeben Sie es unter `msg.payload.steps` an den HueMagic-Node.
+
+: delay (int) : Anzahl der Millisekunden die gewartet werden soll, bis dieser Schritt ausgeführt wird
+: animation (object) : Das Objekt beinhaltet die Aktion(en), die in diesem Schritt durchgeführt werden sollen. Identische Parameter wie bei den „Hue Licht“- & „Hue Gruppe“-Nodes
+
+### Beispiel einer eigenen Animation
+
+Dieses Beispiel zeigt, wie eine einfache Animation aussehen könnte. Im ersten Schritt wird der Delay von 500 Millisekunden abgewartet. Anschließend wird über eine Zeitspanne von einer Sekunde langsam die Farbe des Lichts auf rot umgestellt. Sobald das Licht vollständig zu rot übergegangen ist, wird der zweite Schritt ausgeführt, der auch einen Delay von 500 Millisekunden hat. Abschließend wechselt die Farbe zu blau.
+
+Wenn Sie eingestellt haben, dass die Animation unendlich abgespielt werden soll, wird dieser Prozess endlos wiederholt, bis Sie die Animation manuell stoppen oder den Node neu deployen.
+
+Übergeben Sie das folgende Objekt in `msg.payload` um die Beispielanimation abzuspielen.
+
+    {
+        "animate": true,
+        "steps": [
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#FF0000",
+                    "transitionTime": 1
+                }
+            },
+            {
+                "delay": 500,
+                "animation": {
+                    "hex": "#0000FF",
+                    "transitionTime": 1
+                }
             }
-        }
-    ]
-}</pre>
-</code>
+        ]
+    }
+
+### Spezielle Kommandos
+
+Manchmal macht es Sinn eine Animation ungeordnet abzuspielen – z. B. wenn Feuer realistischer imitiert werden soll. Um die einzelnen Schritte ungeordnet und zufällig abzuspielen, können Sie folgenden Befehl an `msg.payload.specials` übergeben:
+
+: randomOrder (boolean | any) : `true`, aktiviert die zufällige Wiedergabe der einzelnen Animationsschritte
+
+### Tipps und Hinweise
+
+Dieser Node gibt keine Statusnachrichten aus. Bitte verbinden Sie den Ausgangspunkt des Nodes mit einer Gruppe statt einzelnen Lichtern, wenn Sie mehrere Lichter gleichzeitig mit derselben Animation animieren möchten. Die Vorschauen der vorgefertigten Animationen sind eine Simulation und können von der tatsächlichen Animation auf einer Ressource geringfügig (Timing, Farben) abweichen.
+
+### 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.
 
-    <h3>Tipps und Hinweise</h3>
-    <p>Verbinden Sie den Hue Magic Node mit nur einem Licht- oder einem gesamten Gruppen-Node, um API-Requests auf der Hue Bridge zu sparen. Die Animationsvorschau kann geringfügig vom tatsächlichen Ergebnis auf einer Lampe / Gruppe abweichen.</p>
+![examples](https://user-images.githubusercontent.com/5302050/148681840-2275c15a-7c0c-4a37-b817-199608e571d2.gif)
 </script>

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,67 +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. Wenn Sie diesen Node im Universalmodus betreiben, können Sie optional auch auswählen, ob dieser Node alle Mitteilungen von anderen Nodes desselben Typs empfangen und ausgeben soll.</p>
+### Einrichtung
 
-    <h3>Aktivieren / Deaktivieren</h3>
-    <p>Aktiviert oder deaktiviert den Bewegungssensor oder ruft den Status ab 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>Universalmodus (optional)</h3>
-    <p>Definiert die Sensor-ID auf der Hue Bridge manuell, wenn sie nicht in den Node-Eigenschaften konfiguriert ist:</p>
-    <dl class="message-properties">
-        <dt>msg.topic<span class="property-type">int</span></dt>
-        <dd>Manuelle Definition der Sensor-ID</dd>
-    </dl>
+: 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`
 
-    <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>
+#### 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,14 +5,12 @@
 		{
 			"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.",
-			"sensor": "Sensor",
-			"universalevents": "Universelle Mitteilungen",
-			"universalevents-node": "Empfängt alle Mitteilungen anderer Nodes desselben Typs (nur im Universalmodus)"
+			"sensor": "Sensor"
 		},
 		"node":
 		{
@@ -25,7 +23,9 @@
 			"deactivated": "deaktiviert",
 			"input": "aktivieren / deaktivieren / Statusabfrage",
 			"output": "erkannte Bewegung",
-			"universal": "Universalmodus"
+			"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…"
 		}
 	}
 }