node-red-contrib-ccu 4.4.4 → 4.5.0

package/nodes/ccu-get-value.html

@@ -12,7 +12,8 @@
                 datapoint: {value: ''},
                 datapointProperty: {value: 'value'},
                 setProp: {value: 'payload'},
-                setPropType: {value: 'msg'}
+                setPropType: {value: 'msg'},
+                topic: {value: ''}
             },
             inputs: 1,
             outputs: 1,
@@ -47,6 +48,7 @@
                 let ifacesLoaded = false;
                 let ifacesPending = false;
                 let ifaceLoadRetries = 5;
+                let channelLoadRetries = 30;
 
                 if (!this.setProp) {
                     this.setProp = 'payload';
@@ -135,7 +137,16 @@
 
                     const nodeId = $nodeInputCcuConfig.val();
                     const url = 'ccu?config=' + nodeId + '&type=channels&iface=' + $nodeInputIface.val();
-                    $.getJSON(url, d => {
+                    $.getJSON(url, (d, _status, xhr) => {
+                        // task 9: an empty list while the connection is still initialising is "not yet",
+                        // not "nothing" - keep what is configured, say so, and ask again
+                        if (Object.keys(d).length === 0 && xhr.getResponseHeader('X-CCU-Loading') && channelLoadRetries-- > 0) {
+                            $nodeInputChannel.attr('placeholder', 'loading device data ...');
+                            setTimeout(loadConfig, 2000);
+                            return;
+                        }
+
+                        $nodeInputChannel.removeAttr('placeholder');
                         data = d;
                         autocompleteChannel();
                         autocompleteDatapoint();
@@ -197,7 +208,7 @@
 
                     // ${ENV} placeholders are substituted by Node-RED before the node is
                     // constructed (subflow parameters, #158) - do not clear them
-                    if (!/^\$\{[^}]+\}$/.test($nodeInputChannel.val()) && !data[$nodeInputChannel.val().split(' ')[0]]) {
+                    if (Object.keys(data).length > 0 && !/^\$\{[^}]+\}$/.test($nodeInputChannel.val()) && !data[$nodeInputChannel.val().split(' ')[0]]) {
                         $nodeInputChannel.val('');
                         $nodeInputDatapoint.val('');
                     }
@@ -472,19 +483,11 @@
         <input type="text" id="node-input-setProp" placeholder="payload" style="width:250px;">
         <input type="hidden" id="node-input-setPropType">
     </div>
+    <div class="form-row">
+        <label for="node-input-topic"><i class="icon-tasks"></i> Topic</label>
+        <input type="text" id="node-input-topic" placeholder="empty: msg.topic stays as it came in">
+    </div>
     <div id="dialog-select-datapoint" title="Select Channel, Datapoint and Property">
         <div id="config-lookup-tree"></div>
     </div>
 </script>
-
-<script type="text/x-red" data-help-name="ccu-get-value" lang="en-US">
-    <p>This Node outputs the current state of a datapoint or a ccu variable on any incoming message.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-display" lang="de-DE">
-    <p>Dieser Node gibt bei jeder eingehenden Message den aktuellen zwischengespeicherten Zustand eines Datenpunktes oder einer CCU Systemvariable aus.</p>
-        <h3>Konfiguration</h3>
-        Um über die eingehende Message die Attribute <code>iface</code>, <code>channel</code>, <code>datapoint</code> und <code>sysvar</code> setzen zu können müssen die entsprechenden Konfigurationsoptionen leer gelassen werden.
-    <h3>Input</h3>
-    <h3>Output</h3>
-</script>

package/nodes/ccu-get-value.js

@@ -1,3 +1,5 @@
+const {topicReplace} = require('./lib/topic.js');
+
 module.exports = function (RED) {
     class CcuGetValue {
         constructor(config) {
@@ -6,6 +8,9 @@ module.exports = function (RED) {
             this.ccu = RED.nodes.getNode(config.ccuConfig);
             this.setProp = config.setProp || 'payload';
             this.setPropType = config.setPropType || 'msg';
+            // task 6 (#39): the same topic template as the other emitting nodes; empty
+            // (the default, and every flow from before) leaves msg.topic as it came in
+            this.topic = config.topic || '';
 
             if (!this.ccu) {
                 return;
@@ -39,8 +44,18 @@ module.exports = function (RED) {
                     }
                 }
 
+                // the cached object the topic placeholders are taken from (iface, channel,
+                // channelName, datapoint, ... for a datapoint; name, iface, ... for a variable)
+                const source = value;
+                const setTopic = () => {
+                    if (this.topic) {
+                        message.topic = topicReplace(this.topic, source);
+                    }
+                };
+
                 if (config.setPropType === 'cmsg') {
                     Object.assign(message, value);
+                    setTopic();
                     send(message);
                     this.status({fill: 'green', shape: 'ring', text: String(value.payload)});
                     done();
@@ -55,6 +70,7 @@ module.exports = function (RED) {
 
                     this.status({fill: 'green', shape: 'ring', text: String(value)});
 
+                    setTopic();
                     if (config.setPropType === 'msg') {
                         RED.util.setMessageProperty(message, config.setProp, value);
                         if (send) {

package/nodes/ccu-homeassistant.html

@@ -284,51 +284,3 @@
         </div>
     </div>
 </script>
-
-<script type="text/x-red" data-help-name="ccu-homeassistant" lang="de-DE">
-    <p>Veröffentlicht Home-Assistant-MQTT-Discovery-Konfigurationen für ausgewählte Geräte.</p>
-    <p>Der Node ist ein Begleiter zum <b>ccu-mqtt</b>-Node: er übernimmt dessen Topic-Vorlagen und
-    Payload-Format, so dass die Discovery-Konfigurationen auf die Topics zeigen, die ccu-mqtt bereits
-    veröffentlicht bzw. entgegennimmt. Status und Befehle laufen weiterhin über ccu-mqtt.</p>
-    <h3>Verkabelung</h3>
-    <p>Den Ausgang mit demselben <b>mqtt out</b>-Node verbinden wie den ccu-mqtt-Node. Der Node sendet
-    <code>msg.topic</code>, <code>msg.payload</code> und <code>msg.retain</code>.</p>
-    <h3>Geräteauswahl</h3>
-    <p>Nur angehakte Geräte werden an Home Assistant gemeldet (ein HA-Gerät pro Homematic-Gerät).
-    Wird ein zuvor angehaktes Gerät abgehakt, sendet der Node beim nächsten Deploy eine leere
-    Konfiguration, die das Gerät in Home Assistant entfernt.</p>
-    <h3>Entitäten</h3>
-    <p>Schalter, Dimmer (light), Rollladen/Jalousie (cover), Thermostate (climate), Kontakte/Bewegung/
-    Rauch/Wasser (binary_sensor), Tasten (event), KeyMatic (lock), Energie/Wetter (sensor). Mit der
-    Option <i>weitere Datenpunkte</i> werden alle übrigen Datenpunkte als standardmäßig deaktivierte
-    Entitäten mitgeliefert.</p>
-    <h3>Eingang</h3>
-    <p>Jede eingehende Nachricht veröffentlicht die Discovery-Konfigurationen erneut.</p>
-    <h3>Voraussetzungen</h3>
-    <p>Home Assistant ≥ 2024.11 (gerätebasierte Discovery). Die Verfügbarkeit der Geräte wird aus dem
-    UNREACH-Datenpunkt des Wartungskanals abgeleitet.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-homeassistant" lang="en-US">
-    <p>Publishes Home Assistant MQTT discovery configurations for selected devices.</p>
-    <p>The node is a companion to the <b>ccu-mqtt</b> node: it reuses that node's topic templates and
-    payload format, so the discovery configs point at the topics ccu-mqtt already publishes and
-    consumes. State and commands keep flowing through ccu-mqtt.</p>
-    <h3>Wiring</h3>
-    <p>Connect the output to the same <b>mqtt out</b> node as the ccu-mqtt node. The node sends
-    <code>msg.topic</code>, <code>msg.payload</code> and <code>msg.retain</code>.</p>
-    <h3>Device selection</h3>
-    <p>Only checked devices are announced to Home Assistant (one HA device per Homematic device).
-    Unchecking a previously checked device publishes an empty config on the next deploy, which
-    removes the device from Home Assistant.</p>
-    <h3>Entities</h3>
-    <p>Switches, dimmers (light), blinds/shutters (cover), thermostats (climate), contacts/motion/
-    smoke/water (binary_sensor), keys (event), KeyMatic (lock), energy/weather (sensor). With the
-    <i>other datapoints</i> option every remaining datapoint is included as an entity that is
-    disabled by default.</p>
-    <h3>Input</h3>
-    <p>Any incoming message republishes the discovery configs.</p>
-    <h3>Requirements</h3>
-    <p>Home Assistant ≥ 2024.11 (device-based discovery). Device availability is derived from the
-    UNREACH datapoint of the maintenance channel.</p>
-</script>

package/nodes/ccu-mqtt.html

@@ -155,11 +155,3 @@
         }
     </style>
 </script>
-
-<script type="text/x-red" data-help-name="ccu-mqtt" lang="de-DE">
-    <p>Vereinfacht die Anbindung einer CCU an MQTT.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-mqtt" lang="en-US">
-    <p>Ease the connection of a CCU to MQTT.</p>
-</script>

package/nodes/ccu-poll.html

@@ -33,20 +33,3 @@
     </div>
 
 </script>
-
-<script type="text/x-red" data-help-name="ccu-poll" lang="de-DE">
-    <p>Führt einen sofortigen Poll von ReGaHSS Systemvariablen durch.</p>
-    <p>Dieser Node ist dazu vorgesehen die Änderung von Systemvariablen mit möglichst geringer Verzögerung zu empfangen.
-      Hierzu kann man ein Programm auf der CCU anlegen dass bei Änderung von Variablen einen virtuellen Taster betätigt.
-      In Node-RED wird dann ein <i>rpc event</i> oder <i>value</i> Node so konfiguriert dass er diese
-      "Tastenbetätigungen" empfängt und über den <i>ccu poll</i> Node eine Aktualisierung der Variablenwerte auslöst.
-    </p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-poll" lang="en-US">
-    <p>Triggers an immediate polling of Sysvars from ReGaHSS.</p>
-    <p>This node is intended to receive changes of variables with lower latency. You can create a CCU Program that
-    reacts to variable changes by pressing a virtual button, this virtual button presses can then be received by a
-    <i>value</i> or <i>rpc event</i> node that triggers an update of the variables through the <i>ccu poll</i>
-    node.</p>
-</script>

package/nodes/ccu-program.html

@@ -85,56 +85,3 @@
     </div>
     <div class="form-tips" data-i18n="ccu-program.tip"></div>
 </script>
-
-<script type="text/x-red" data-help-name="ccu-program" lang="de-DE">
-    <p>Führt ein ReGaHSS Programm aus.</p>
-    <h3>Inputs</h3>
-    <dl class="message-properties">
-        <dt>payload
-            <span class="property-type">*</span>
-        </dt>
-        <dd>
-            Ist der Payload vom Typ boolean wird das Programm bei <code>true</code> aktiviert und ausgeführt und bei
-            <code>false</code> deaktiviert. In allen anderen Fällen (Payload ist z.B. ein leerer String) wird das
-            Programm ausgeführt.
-        </dd>
-    </dl>
-    <h3>Outputs</h3>
-     <ol class="node-ports">
-         <li>Output
-             <dl class="message-properties">
-                 <dt>payload <span class="property-type">string</span></dt>
-                 <dd>
-                   Im Payload ist der Zeitstempel der letzten Programmausführung (Attribut <code>ts</code>) sowie
-                   die Information ob ein Programm aktiv oder inaktiv ist (Attribut <code>active</code>) enthalten.
-                 </dd>
-             </dl>
-         </li>
-     </ol>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-program" lang="en-US">
-    <p>Executes a ReGaHSS program.</p>
-    <h3>Inputs</h3>
-    <dl class="message-properties">
-        <dt>payload
-            <span class="property-type">*</span>
-        </dt>
-        <dd>
-            If the payload is of type boolean the program gets (de)activated. On activation it is executed also. In all
-            other cases the program will be executed.
-        </dd>
-    </dl>
-    <h3>Outputs</h3>
-     <ol class="node-ports">
-         <li>Output
-             <dl class="message-properties">
-                 <dt>payload <span class="property-type">string</span></dt>
-                 <dd>
-                    The payload contains a timestamp of the last program run (property <code>ts</code> and the
-                    information if the program is activated (property <code>active</code>).
-                 </dd>
-             </dl>
-         </li>
-     </ol>
-</script>

package/nodes/ccu-rpc-event.html

@@ -159,7 +159,6 @@
                 data.nameChannels = {};
                 data.nameDevices = {};
 
-
                 Object.keys(data.channelRooms).forEach(channel => {
                     const room = data.channelRooms[channel];
                     const device = channel.split(':')[0];
@@ -298,7 +297,6 @@
                         }
                     }
 
-
                     function checkDatapoint(datapoint) {
                         let deviceCheck = false;
                         let channelCheck = false;
@@ -609,35 +607,3 @@
         <input type="text" id="node-input-name">
     </div>
 </script>
-
-<script type="text/x-red" data-help-name="ccu-rpc-event" lang="de-DE">
-    <p>Gibt RPC Events aus.</p>
-    <h3>Konfiguration</h3>
-    <ul>
-        <li><b>CCU</b>: Die zu verwendende CCU-Konfiguration.</li>
-        <li><b>topic</b>: <code>msg.topic</code> ausgehender Nachrichten. Kann mit Platzhaltern konfiguriert werden.</li>
-        <li><b>interface</b>: Die Schnittstelle über welche die gewüschten Geräte angebunden sind. <code>*</code> erlaubt Events aller verbundenen Schnittstellen.</li>
-        <li><b>room</b>: Raum Filter. Beispiel: <code>Wohnzimmer</code>.</li>
-        <li><b>function</b>: Gewerk Filter. Beispiel: <code>Taster</code></li>
-        <li><b>device</b>: Die Seriennummer der Homematic Komponente. Beispiel: <code>OEQ1662328</code></li>
-        <li><b>deviceName</b>: Der in der CCU vergebene Name der Homematic Komponente. Beispiel: <code>Rauchmelder Arbeitszimmer</code>; alle Rauchemelder über RegEx: <code>Rauchmelder.*</code></li>
-        <li><b>deviceType</b>: Die Typen-Bezeichnung der Homematic Komponente. Beispiel: <code>HM-Sec-SD-2</code></li>
-        <li><b>channel</b>: Die Kanaladresse bestehend aus Serien- und Kanalnummer. Beispiel: <code>OEQ1245312:4</code></li>
-        <li><b>channelName</b>: Der in der CCU vergebene Kanalname. Beispiel: <code>Bad Lichte Decke PIR</code></li>
-        <li><b>channelType</b>: Der Typ des Kanals. Beispiel: <code>VIRTUAL_KEY</code> oder <code>DIMMER</code></li>
-        <li><b>channelIndex</b>: Der Index des Kanals. Beispiel: <code>2</code>
-        <li><b>datapoint</b>: Der Datenpunkt des Kanals. Beispiel: <code>PRESS_SHORT</code> oder <code>ACTUAL_TEMPERATURE</code>.</li>
-        <li><b>Nur geänderte Werte ausgeben</b> - Ein Event wird nur dann erzeugt, wenn sich der Wert seit dem letztn Event verändert hat.</li>
-        <li><b>Während WORKING keine Werte ausgeben</b> - Es gibt Aktoren, z.B. Dimmer oder Rolladen, die während einer Rampe (Öffnen/Schließen eines Rollladen, Dimmen einer Lampe) fortwährend den aktuellen Zustand ausgeben. Um nur den End-Status auszugeben kann diese Option benutzt werden. Gebräuchlich auch bei Verwendung mit Dashboard-Nodes um "springende" Slider zu verhindern.</li>
-        <li><b>Beim Start letzten bekannten Wert ausgeben</b> - Wenn Node-RED gestartet wird, dann wird der letzte Wert (sofern in der ReGaHSS bekannt) ausgegeben. Z.B. um beim Start einen korrekten Wert an das Dashboard zu übergeben. <b>Achtung:</b> Wird durch die ausgegebene Nachricht im weiteren Verlauf des Flows ein Homematic Wert gesetzt wirkt sich jedes (Full-)Deployment negativ auf den DutyCycle aus.</li>
-    </ul>
-
-    <h3>Output</h3>
-    <!-- TODO -->
-
-    <!-- TODO Funktionsweise Filter erläutern -->
-</script>
-
-<script type="text/x-red" data-help-name="ccu-rpc-event" lang="en-US">
-    <p>Outputs RPC events.</p>
-</script>

package/nodes/ccu-rpc.html

@@ -171,67 +171,3 @@
         <span data-i18n="ccu-rpc.tip3"></span>
     </div>
 </script>
-
-
-<script type="text/x-red" data-help-name="ccu-rpc" lang="de-DE">
-    <p>Führt eine RPC Methode aus und gibt das Ergebnis zurück.</p>
-    <h3>Inputs</h3>
-    <dl class="message-properties">
-        <dt>topic
-            <span class="property-type">String</span>
-        </dt>
-        <dd>
-            Die Methode die aufgerufen werden soll. Siehe <a href="https://www.eq-3.de/Downloads/eq3/download%20bereich/hm_web_ui_doku/HM_XmlRpc_API.pdf">XMLRPC API Dokumentation</a>
-        </dd>
-        <dt>payload
-            <span class="property-type">Array|String</span>
-        </dt>
-        <dd>
-            Ein Array oder ein in einem JSON-string enthaltenes Array von Parametern die für den RPC Methodenaufruf
-            genutzt werden.
-        </dd>
-
-    </dl>
-    <h3>Outputs</h3>
-     <ol class="node-ports">
-         <li>Output
-             <dl class="message-properties">
-                 <dt>payload <span class="property-type">array</span></dt>
-                 <dd>
-                    Die Rückgabe des RPC Methodenaufrufs.
-                 </dd>
-             </dl>
-         </li>
-     </ol>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-rpc" lang="en-US">
-    <p>Executes a RPC method and outputs the return value.</p>
-    <h3>Inputs</h3>
-    <dl class="message-properties">
-        <dt>topic
-            <span class="property-type">String</span>
-        </dt>
-        <dd>
-            The method that should be called
-        </dd>
-        <dt>payload
-            <span class="property-type">Array|String</span>
-        </dt>
-        <dd>
-            An array or an JSON string containing an array of parameters for the rpc call.
-        </dd>
-
-    </dl>
-    <h3>Outputs</h3>
-     <ol class="node-ports">
-         <li>Output
-             <dl class="message-properties">
-                 <dt>payload <span class="property-type">array</span></dt>
-                 <dd>
-                    The return value of the rpc call.
-                 </dd>
-             </dl>
-         </li>
-     </ol>
-</script>

package/nodes/ccu-script.html

@@ -44,11 +44,3 @@
     <div class="form-tips"><span data-i18n="ccu-script.tip"></span></div>
 
 </script>
-
-<script type="text/x-red" data-help-name="ccu-script" lang="de-DE">
-    <p>Führt ein ReGaHSS Script auf der CCU aus und gibt die Rückgabe aus.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-script" lang="en-US">
-    <p>Executes a ReGaHSS Script on the CCU and returns the output.</p>
-</script>

package/nodes/ccu-set-value.html

@@ -158,7 +158,6 @@
                 data.nameChannels = {};
                 data.nameDevices = {};
 
-
                 Object.keys(data.channelRooms).forEach(channel => {
                     const room = data.channelRooms[channel];
                     const device = channel.split(':')[0];
@@ -298,7 +297,6 @@
                         }
                     }
 
-
                     function checkDatapoint(datapoint) {
                         let deviceCheck = false;
                         let channelCheck = false;
@@ -481,7 +479,6 @@
                     });
                 }
 
-
                 Object.keys(lists).forEach(key => {
                     if (key === 'channelIndex') {
                         lists[key].sort((a, b) => Number(a) > Number(b));
@@ -608,62 +605,3 @@
         </p>
     </div>
 </script>
-
-
-
-<script type="text/x-red" data-help-name="ccu-set-value" lang="de-DE">
-    <p>Ansteuerung von mehreren Geräten auf einmal.</p>
-    <h3>Konfiguration</h3>
-    <ul>
-        <li><b></b>: </li>
-        <li><b></b>: </li>
-        <li><b></b>: </li>
-        <li><b></b>: </li>
-        <li><b></b>: </li>
-    </ul>
-
-    <h3>Input</h3>
-
-
-    <h3>Dynamische Konfiguration</h3>
-    <p><code>msg.config</code> ist ein Objekt, dessen Eigenschaften die Konfiguration dieses Nodes für genau diese Nachricht überschreiben. Die gespeicherte Konfiguration bleibt unverändert.</p>
-    <ul>
-        <li><code>iface</code></li>
-        <li><code>rooms</code></li>
-        <li><code>functions</code></li>
-        <li><code>device</code></li>
-        <li><code>deviceType</code></li>
-        <li><code>deviceName</code></li>
-        <li><code>channel</code></li>
-        <li><code>channelType</code></li>
-        <li><code>channelIndex</code></li>
-        <li><code>channelName</code></li>
-        <li><code>datapoint</code></li>
-        <li><code>force</code></li>
-        <li><code>sowie die zugehörigen <code>...Rx</code>-Selektoren</code></li>
-    </ul>
-    <p>Zusätzlich füllen gleichnamige Eigenschaften der Nachricht selbst (<code>msg.rooms</code> usw.) leer gelassene Felder — so war es schon immer.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-set-value" lang="en-US">
-    <p>Control multiple devices at once.</p>
-
-    <h3>Dynamic configuration</h3>
-    <p><code>msg.config</code> is an object whose properties override this node's configuration for that one message. The stored configuration is never modified.</p>
-    <ul>
-        <li><code>iface</code></li>
-        <li><code>rooms</code></li>
-        <li><code>functions</code></li>
-        <li><code>device</code></li>
-        <li><code>deviceType</code></li>
-        <li><code>deviceName</code></li>
-        <li><code>channel</code></li>
-        <li><code>channelType</code></li>
-        <li><code>channelIndex</code></li>
-        <li><code>channelName</code></li>
-        <li><code>datapoint</code></li>
-        <li><code>force</code></li>
-        <li><code>and the matching <code>...Rx</code> selectors</code></li>
-    </ul>
-    <p>Properties of the message itself (<code>msg.rooms</code> and so on) also fill in fields left empty in the dialog, as they always did.</p>
-</script>

package/nodes/ccu-set-value.js

@@ -102,18 +102,13 @@ module.exports = function (RED) {
                     }
 
                     datapointsOf(this.ccu, iface, address, config).forEach((dp) => {
-                        const datapointName = iface + '.' + address + '.' + dp;
-                        const currentValue = this.ccu.values[datapointName] && this.ccu.values[datapointName].value;
                         count += 1;
-                        if (
-                            dp.startsWith('PRESS_') ||
-                            typeof currentValue === 'undefined' ||
-                            currentValue !== message.payload
-                        ) {
-                            this.ccu
-                                .setValueQueued(iface, address, dp, message.payload, false, config.force)
-                                .catch(() => {});
-                        }
+                        // the queue dedupes against the value cache itself (B-19: force and
+                        // the echo of our own write get through; the pre-check here used to
+                        // drop a forced write whenever the cache already held the value)
+                        this.ccu
+                            .setValueQueued(iface, address, dp, message.payload, false, config.force)
+                            .catch(() => {});
                     });
                 });
             });

package/nodes/ccu-signal.html

@@ -617,7 +617,6 @@
         <input id="node-input-dimmerLevelType" type="hidden">
     </div>
 
-
     <div class="form-row SUBMIT ACOUSTIC_SIGNAL_VIRTUAL_RECEIVER DIMMER_VIRTUAL_RECEIVER BSL_DIMMER_VIRTUAL_RECEIVER">
         <label for="node-input-rampTimeUnit"><i class=""></i> Rampenzeit </label>
         <select id="node-input-rampTimeUnit" style="width: calc(35% - 5px)">
@@ -629,7 +628,6 @@
         <input id="node-input-rampTimeValueType" type="hidden">
     </div>
 
-
     <div class="form-row SUBMIT ALARM_SWITCH_VIRTUAL_RECEIVER ACOUSTIC_SIGNAL_VIRTUAL_RECEIVER DIMMER_VIRTUAL_RECEIVER BSL_DIMMER_VIRTUAL_RECEIVER">
         <label for="node-input-durationUnit"><i class=""></i> Dauer </label>
         <select id="node-input-durationUnit" style="width: calc(35% - 5px)">
@@ -641,66 +639,4 @@
         <input id="node-input-durationValueType" type="hidden">
     </div>
 
-
-
-</script>
-
-<script type="text/x-red" data-help-name="ccu-signal" lang="de-DE">
-    <p>Senden von LED- und Tonsignalen an Displaytaster und Funk-Gongs.</p>
-
-    <h3>Dynamische Konfiguration</h3>
-    <p><code>msg.config</code> ist ein Objekt, dessen Eigenschaften die Konfiguration dieses Nodes für genau diese Nachricht überschreiben. Die gespeicherte Konfiguration bleibt unverändert.</p>
-    <ul>
-        <li><code>iface</code></li>
-        <li><code>channel</code></li>
-        <li><code>channelType</code></li>
-        <li><code>chime</code></li>
-        <li><code>led</code></li>
-        <li><code>signal</code></li>
-        <li><code>volume</code></li>
-        <li><code>repeat</code></li>
-        <li><code>repetitions</code></li>
-        <li><code>durationUnit</code></li>
-        <li><code>durationValue</code></li>
-        <li><code>rampTimeUnit</code></li>
-        <li><code>rampTimeValue</code></li>
-        <li><code>acousticAlarmSelection</code></li>
-        <li><code>opticalAlarmSelection</code></li>
-        <li><code>dimmerLevel</code></li>
-        <li><code>dimmerColor</code></li>
-        <li><code>dimmerList</code></li>
-        <li><code>soundLevel</code></li>
-        <li><code>soundList</code></li>
-    </ul>
-    <p><code>soundList</code> und <code>dimmerList</code> akzeptieren auch ein einfaches Array von Werten, z.B. <code>msg.config.soundList = [1, 2]</code>.</p>
-</script>
-
-<script type="text/x-red" data-help-name="ccu-signal" lang="en-US">
-    <p>Send LED- and Sound-Signals.</p>
-
-    <h3>Dynamic configuration</h3>
-    <p><code>msg.config</code> is an object whose properties override this node's configuration for that one message. The stored configuration is never modified.</p>
-    <ul>
-        <li><code>iface</code></li>
-        <li><code>channel</code></li>
-        <li><code>channelType</code></li>
-        <li><code>chime</code></li>
-        <li><code>led</code></li>
-        <li><code>signal</code></li>
-        <li><code>volume</code></li>
-        <li><code>repeat</code></li>
-        <li><code>repetitions</code></li>
-        <li><code>durationUnit</code></li>
-        <li><code>durationValue</code></li>
-        <li><code>rampTimeUnit</code></li>
-        <li><code>rampTimeValue</code></li>
-        <li><code>acousticAlarmSelection</code></li>
-        <li><code>opticalAlarmSelection</code></li>
-        <li><code>dimmerLevel</code></li>
-        <li><code>dimmerColor</code></li>
-        <li><code>dimmerList</code></li>
-        <li><code>soundLevel</code></li>
-        <li><code>soundList</code></li>
-    </ul>
-    <p><code>soundList</code> and <code>dimmerList</code> also accept a plain array of values, e.g. <code>msg.config.soundList = [1, 2]</code>.</p>
 </script>

package/nodes/ccu-switch.html

@@ -114,6 +114,7 @@
                 let ifacesLoaded = false;
                 let ifacesPending = false;
                 let ifaceLoadRetries = 5;
+                let channelLoadRetries = 30;
 
                 $('.form-row.datapoint').hide();
                 $('.form-row.sysvar').hide();
@@ -180,7 +181,16 @@
                     }
                     const nodeId = $nodeInputCcuConfig.val();
                     const url = 'ccu?config=' + nodeId + '&type=channels&iface=' + $nodeInputIface.val();
-                    $.getJSON(url, d => {
+                    $.getJSON(url, (d, _status, xhr) => {
+                        // task 9: an empty list while the connection is still initialising is "not yet",
+                        // not "nothing" - keep what is configured, say so, and ask again
+                        if (Object.keys(d).length === 0 && xhr.getResponseHeader('X-CCU-Loading') && channelLoadRetries-- > 0) {
+                            $nodeInputChannel.attr('placeholder', 'loading device data ...');
+                            setTimeout(loadConfig, 2000);
+                            return;
+                        }
+
+                        $nodeInputChannel.removeAttr('placeholder');
                         data = d;
                         autocompleteChannel();
                         autocompleteDatapoint();
@@ -241,7 +251,7 @@
 
                     // ${ENV} placeholders are substituted by Node-RED before the node is
                     // constructed (subflow parameters, #158) - do not clear them
-                    if (!/^\$\{[^}]+\}$/.test($nodeInputChannel.val()) && !data[$nodeInputChannel.val().split(' ')[0]]) {
+                    if (Object.keys(data).length > 0 && !/^\$\{[^}]+\}$/.test($nodeInputChannel.val()) && !data[$nodeInputChannel.val().split(' ')[0]]) {
                         $nodeInputChannel.val('');
                         $nodeInputDatapoint.val('');
                     }
@@ -733,7 +743,6 @@
     })();
 </script>
 
-
 <script type="text/x-red" data-template-name="ccu-switch" lang="en-US">
     <div class="form-row">
         <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="ccu-switch.label.name"></span></label>
@@ -796,24 +805,3 @@
     </div>
 
 </script>
-
-<script type="text/x-red" data-help-name="ccu-switch" lang="de-DE">
-    <p>Nachricht abhängig von einem Zustand eines Aktors oder einer Systemvariablen weiterleiten.</p>
-    <h3>Details</h3>
-    <p>Der ccu switch Node verhält sich ähnlich wie der switch Node von Node-RED. Er leitet eine Nachricht abhängig von einem Zustand eines Aktors oder einer Systemvariablen weiter, wahlweise auch je nach Zustand an unterschiedliche Ausgänge.</p>
-    <h4>Dokumentation</h4>
-    <a target="_blank" href="https://github.com/rdmtc/RedMatic/wiki/CCU-Nodes#ccu-switch-node">ccu switch node im RedMatic Wiki</a>
-
-    <h3>Dynamische Konfiguration</h3>
-    <p><code>msg.config</code> ist ein Objekt, dessen Eigenschaften die Konfiguration dieses Nodes für genau diese Nachricht überschreiben. Die gespeicherte Konfiguration bleibt unverändert.</p>
-    <ul>
-        <li><code>iface</code></li>
-        <li><code>channel</code></li>
-        <li><code>datapoint</code></li>
-        <li><code>datapointProperty</code></li>
-        <li><code>sysvar</code></li>
-        <li><code>sysvarProperty</code></li>
-    </ul>
-</script>
-
-