node-red-contrib-ccu 4.4.4 → 4.4.5

package/CHANGELOG.md

@@ -5,6 +5,31 @@ Notable changes to node-red-contrib-ccu. Format follows
 user-visible symptom and the cause, not the commit list (the release notes
 append commits automatically).
 
+## 4.4.5 (2026-09-26)
+
+### Fixed
+
+- **A Node-RED started before rfd went through the CCU's proxy for good.**
+  The connection decides at start whether it runs on the CCU itself, and
+  looked only for a listener on rfd's direct port. On openccu-lite, where
+  RedMatic starts at boot before the interface processes (the early start),
+  that port is not open yet, so every interface went through lighttpd's
+  proxy ports (XML-RPC instead of BIN-RPC for BidCos) until the next restart.
+  A loopback host on a system that has the CCU's interface list
+  (`/etc/config/InterfacesList.xml`) is now taken as local as well.
+- **Waiting for an interface process that is still starting is no warning**
+  (task 12). Before the interface was ever connected, a refused connection
+  is one info line (_"HmIP-RF not listening yet (connect ECONNREFUSED),
+  waiting for it - retrying in 1 s"_); another transport error, or a refused
+  connection after the interface had been connected, is still a warning, and
+  a fault answer an error.
+
+### Changed
+
+- **A failed `init` is retried after 1 s, 2 s, 4 s and 8 s, then every 15 s**
+  (task 12; was 2, 4, 8, 16 s, then every 30 s), the schedule of hm2mqtt.js and
+  the Homematic Manager.
+
 ## 4.4.4 (2026-09-17)
 
 ### Fixed

package/README.md

@@ -28,6 +28,19 @@ Some example flows can be found in the [RedMatic Wiki](https://github.com/rdmtc/
 
 **Starting with Version 3.x these Nodes need Node-RED >= 1.0 to work correctly**
 
+## openccu-lite
+
+[openccu-lite](https://github.com/hobbyquaker/openccu-lite) is a Homematic CCU firmware based on OpenCCU **without
+ReGaHSS**. The interface processes (`rfd`, `hs485d`, `hmipserver`) are the same, so everything these nodes do over
+BINRPC/XMLRPC works unchanged. Device, channel, room and function names come from the system's metadata API instead of
+ReGaHSS; the connection node detects this at start (`GET /api/meta/v1/version`), nothing has to be configured, and
+`msg.channelName`, `msg.rooms`, `msg.functions` and the room/function filters keep their shape.
+
+- Node-RED **on the system** (RedMatic from its addon catalogue): the system's own read-only token is used, nothing to do.
+- Node-RED **elsewhere**: an API token of the system goes into the connection node's **openccu-lite token** field.
+- **System variables, programs and HM-Script do not exist there.** The `ccu-sysvar`, `ccu-program`, `ccu-script` and
+  `ccu-poll` nodes stay in the flows and answer every message with an error.
+
 ## Home Assistant
 
 The `ccu-homeassistant` node publishes

package/nodes/lib/initretry.js

@@ -5,16 +5,20 @@
  * addon started before the interfaces, a daemon restart) used to leave the
  * interface without events: rpcCheckInit only runs with cached devices and
  * then waits pingTimeout (600 s for HmIP-RF). Now a failed init schedules its
- * own retry, 2 s, 4 s, 8 s, 16 s and then every 30 s, until it succeeds or the
- * node is closed.
+ * own retry, 1 s, 2 s, 4 s, 8 s and then every 15 s (task 12), until it
+ * succeeds or the node is closed.
  *
- * While the process is unreachable the interface is "waiting": one warn line,
- * then debug. A fault answer (the process is up and refuses the init) stays an
- * error, logged once per distinct fault.
+ * While the process is unreachable the interface is "waiting": one line, then
+ * debug. Before the interface was ever connected, a refused connection is
+ * info - the process is still starting (openccu-lite's early start starts
+ * Node-RED before rfd and hmipserver) - and every other transport error, or a
+ * refusal after it had been connected, is a warning. A fault answer (the
+ * process is up and refuses the init) stays an error, logged once per
+ * distinct fault.
  */
 
-const RETRY_DELAYS = [2000, 4000, 8000, 16000];
-const RETRY_MAX_DELAY = 30000;
+const RETRY_DELAYS = [1000, 2000, 4000, 8000];
+const RETRY_MAX_DELAY = 15000;
 
 /**
  * The delay before the next attempt.
@@ -39,6 +43,15 @@ function isFault(error) {
     return Boolean(error) && typeof error === 'object' && error.faultCode !== undefined;
 }
 
+/**
+ * Whether nothing listens on the port (yet): the process is not started.
+ * @param {*} error
+ * @returns {boolean}
+ */
+function isRefused(error) {
+    return Boolean(error) && (error.code === 'ECONNREFUSED' || /ECONNREFUSED/.test(String(error.message || '')));
+}
+
 /**
  * A short reason for the log line, e.g. "connect ECONNREFUSED".
  * @param {*} error
@@ -77,6 +90,7 @@ class InitRetry {
         this.timers = timers || {setTimeout, clearTimeout};
         this.timer = null;
         this.stopped = false;
+        this.everConnected = false;
         this.reset();
     }
 
@@ -122,7 +136,18 @@ class InitRetry {
                 );
             } else {
                 this.warned = true;
-                this.logger.warn(this.iface + ' not reachable yet (' + reason + '), retrying');
+                if (!this.everConnected && isRefused(error)) {
+                    this.logger.info(
+                        this.iface +
+                            ' not listening yet (' +
+                            reason +
+                            '), waiting for it - retrying in ' +
+                            seconds +
+                            ' s',
+                    );
+                } else {
+                    this.logger.warn(this.iface + ' not reachable yet (' + reason + '), retrying');
+                }
             }
 
             this.onState('waiting');
@@ -160,6 +185,7 @@ class InitRetry {
             this.logger.info(this.iface + ' connected after ' + (this.failures + 1) + ' attempts');
         }
 
+        this.everConnected = true;
         this.reset();
         this.onState('connected');
     }
@@ -178,4 +204,4 @@ class InitRetry {
     }
 }
 
-module.exports = {InitRetry, retryDelay, isFault, describeError, RETRY_DELAYS, RETRY_MAX_DELAY};
+module.exports = {InitRetry, retryDelay, isFault, isRefused, describeError, RETRY_DELAYS, RETRY_MAX_DELAY};

package/nodes/lib/localccu.js

@@ -17,7 +17,15 @@
    Rather than chasing lighttpd's include chain, ask the kernel: a
    listener on the direct port is exactly the condition that makes using
    it correct. /proc/net/tcp is a plain file, so this stays synchronous -
-   the interface table is built in the connection node's constructor. */
+   the interface table is built in the connection node's constructor.
+
+   A listener alone misses a start before rfd: openccu-lite starts an addon
+   that copes with it before the interface processes (its early start), so
+   the ports are not open yet and the connection went through the proxy for
+   good. The CCU's own interface list, /etc/config/InterfacesList.xml, is
+   there from the first second on every CCU firmware (CCU3, OpenCCU,
+   openccu-lite), so a loopback host with that file is the CCU we run on as
+   well. */
 
 const fs = require('fs');
 
@@ -26,6 +34,9 @@ const LOCAL_PROBE_PORTS = [32001, 31999];
 
 const PROC_NET_TCP = ['/proc/net/tcp', '/proc/net/tcp6'];
 
+/** The CCU firmware's list of its interface processes. */
+const INTERFACES_LIST = '/etc/config/InterfacesList.xml';
+
 /** /proc/net/tcp connection state 0A = TCP_LISTEN. */
 const TCP_LISTEN = '0A';
 
@@ -67,6 +78,7 @@ function listeningPorts(files) {
  * @param {string} host the configured CCU host
  * @param {object} [options]
  * @param {string[]} [options.files] /proc files to read, for tests
+ * @param {string} [options.interfacesList] the CCU's interface list, for tests
  * @returns {boolean}
  */
 function isLocalCcu(host, options) {
@@ -75,7 +87,13 @@ function isLocalCcu(host, options) {
     }
 
     const ports = listeningPorts(options && options.files);
-    return LOCAL_PROBE_PORTS.some((port) => ports.has(port));
+    if (LOCAL_PROBE_PORTS.some((port) => ports.has(port))) {
+        return true;
+    }
+
+    // the interface processes are not up yet (a start before them): the
+    // firmware's interface list still says this is the CCU
+    return fs.existsSync((options && options.interfacesList) || INTERFACES_LIST);
 }
 
-module.exports = {isLocalCcu, listeningPorts, LOCAL_PROBE_PORTS};
+module.exports = {isLocalCcu, listeningPorts, LOCAL_PROBE_PORTS, INTERFACES_LIST};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-ccu",
-  "version": "4.4.4",
+  "version": "4.4.5",
   "license": "MIT",
   "main": "none",
   "keywords": [