node-red-contrib-knx-ultimate 8.1.0 → 8.3.0

package/nodes/knxUltimate-config.js

@@ -25,6 +25,7 @@ const loggerClass = require('./utils/sysLogger')
 const payloadRounder = require('./utils/payloadManipulation')
 const utils = require('./utils/utils')
 const dispatchWatchDogNodeError = require('./utils/watchDogErrorDispatcher')
+const { createFileStorage } = require('./utils/fileStorage')
 
 // Versions logged once at startup (node package + KNXUltimate engine)
 let NODE_VERSION = 'unknown'
@@ -32,6 +33,19 @@ try { NODE_VERSION = require('../package.json').version } catch (e) { /* empty *
 let KNX_ENGINE_VERSION = 'unknown'
 try { KNX_ENGINE_VERSION = require('knxultimate/package.json').version } catch (e) { /* empty */ }
 
+// Returns the group service of a bus telegram, or null when it is not one:
+// transport control TPDUs (T_Connect, T_Disconnect, T_ACK, T_NAK: TPCI only, no APCI)
+// and point-to-point telegrams (cEMI Ctrl2 address type 0 = individual destination).
+const getGroupServiceEvent = (cEMIMessage) => {
+  const npdu = cEMIMessage?.npdu
+  if (!npdu || npdu.isTransportControl === true) return null
+  if (cEMIMessage.control?.addressType === 0) return null
+  if (npdu.isGroupRead) return 'GroupValue_Read'
+  if (npdu.isGroupResponse) return 'GroupValue_Response'
+  if (npdu.isGroupWrite) return 'GroupValue_Write'
+  return null
+}
+
 // DATAPONT MANIPULATION HELPERS
 // ####################
 const sortBy = (field) => (a, b) => {
@@ -210,6 +224,8 @@ module.exports = (RED) => {
     node.port = parseInt(config.port)
     node.physAddr = config.physAddr // the KNX physical address we'd like to use
     node.suppressACKRequest = typeof config.suppressACKRequest === 'undefined' ? true : config.suppressACKRequest // enable this option to suppress the acknowledge flag with outgoing L_Data.req requests. LoxOne needs this
+    // TunnelUDP: wait for the TUNNELLING_ACK of each request (yes/no). "auto" leaves it to the KNX engine, which follows suppressACKRequest.
+    node.waitForTunnelingAck = config.waitForTunnelingAck === 'yes' ? true : config.waitForTunnelingAck === 'no' ? false : undefined
     node.linkStatus = 'disconnected' // Can be: connected or disconnected
     node.nodeClients = [] // Stores the registered clients
     node.KNXEthInterface = typeof config.KNXEthInterface === 'undefined' ? 'Auto' : config.KNXEthInterface
@@ -226,6 +242,16 @@ module.exports = (RED) => {
     try {
       node.sysLogger = new loggerClass({ loglevel: node.loglevel, setPrefix: node.type + ' <' + (node.name || node.id || '') + '>' })
     } catch (error) { console.log(error.stack) }
+    // File Cache Control: every file written by this gateway and by its nodes goes through this storage.
+    node.fileCacheMode = config.fileCacheMode || 'freshness'
+    node.fileStorage = createFileStorage({
+      ownerId: node.id,
+      mode: node.fileCacheMode,
+      interval: config.fileCacheInterval,
+      intervalUnit: config.fileCacheIntervalUnit,
+      log: (level, message) => node.sysLogger?.[level]?.(message)
+    })
+    node.persistFile = path.join(node.userDir, 'knxpersistvalues', 'knxpersist' + node.id + '.json')
     node.csv = readCSV(config.csv) // Array from ETS CSV Group Addresses {ga:group address, dpt: datapoint, devicename: full device name with main and subgroups}
     node.csvByGa = new Map()
     if (Array.isArray(node.csv)) {
@@ -247,15 +273,27 @@ module.exports = (RED) => {
       return node.exposedGAsByGa.get(ga)
     }
 
+    // The persist file is serialized only when the storage commits it.
+    const saveExposedGAs = () => {
+      node.fileStorage.writeFile(node.persistFile, () => JSON.stringify(node.exposedGAs))
+    }
+    const rawValueKey = (rawValue) => {
+      try { return Buffer.from(rawValue?.data ?? rawValue).toString('hex') } catch (error) { return undefined }
+    }
+
     node.upsertExposedGAEntry = (entry) => {
       if (!entry || typeof entry.ga !== 'string' || entry.ga === '') return undefined
       const existing = node.exposedGAsByGa.get(entry.ga)
       if (existing) {
+        // A repeated value does not need to be written again.
+        const changed = rawValueKey(existing.rawValue) !== rawValueKey(entry.rawValue) || existing.dpt !== entry.dpt || existing.devicename !== entry.devicename
         Object.assign(existing, entry)
+        if (changed) saveExposedGAs()
         return existing
       }
       node.exposedGAs.push(entry)
       node.exposedGAsByGa.set(entry.ga, entry)
+      saveExposedGAs()
       return entry
     }
 
@@ -263,7 +301,10 @@ module.exports = (RED) => {
       if (typeof ga !== 'string' || ga === '') return
       node.exposedGAsByGa.delete(ga)
       const index = node.exposedGAs.findIndex((item) => item.ga === ga)
-      if (index > -1) node.exposedGAs.splice(index, 1)
+      if (index > -1) {
+        node.exposedGAs.splice(index, 1)
+        saveExposedGAs()
+      }
     }
 
     // 12/11/2021 Connect at start delay
@@ -520,7 +561,6 @@ module.exports = (RED) => {
     node.delaybetweentelegrams = (config.delaybetweentelegrams === undefined || config.delaybetweentelegrams === null || config.delaybetweentelegrams === '') ? 25 : Number(config.delaybetweentelegrams)
     if (node.delaybetweentelegrams < 25) node.delaybetweentelegrams = 25 // Protection avoiding handleKNXQueue hangs
     if (node.delaybetweentelegrams > 100) node.delaybetweentelegrams = 100 // Protection avoiding handleKNXQueue hangs
-    node.timerSaveExposedGAs = null // Timer to save the exposed GA every once in a while
 
     // 05/12/2021 Set the protocol (this is undefined if coming from ild versions
     if (node.hostProtocol === 'Auto') {
@@ -781,50 +821,18 @@ module.exports = (RED) => {
       }
     })()
 
-    // 04/04/2021 Supergiovane, creates the service paths where the persistent files are created.
-    // The values file is stored only upon disconnection/close
+    // 04/04/2021 Supergiovane, persistent GA values. The file is written by the
+    // File Cache Control storage, according to the selected disk-wearing mode.
     // ************************
-    function setupDirectory (_aPath) {
-      if (!fs.existsSync(_aPath)) {
-        // Create the path
-        try {
-          fs.mkdirSync(_aPath)
-          return true
-        } catch (error) {
-          return false
-        }
-      } else {
-        return true
-      }
-    }
-    if (!setupDirectory(node.userDir)) {
-      node.sysLogger?.error('Unable to set up MAIN directory: ' + node.userDir)
-    }
-    if (!setupDirectory(path.join(node.userDir, 'knxpersistvalues'))) {
-      node.sysLogger?.error('Unable to set up cache directory: ' + path.join(node.userDir, 'knxpersistvalues'))
-    } else {
-      node.sysLogger?.info('payload cache set to ' + path.join(node.userDir, 'knxpersistvalues'))
-    }
-
-    async function saveExposedGAs () {
-      const sFile = path.join(node.userDir, 'knxpersistvalues', 'knxpersist' + node.id + '.json')
-      try {
-        if (node.exposedGAs.length > 0) {
-          fs.writeFileSync(sFile, JSON.stringify(node.exposedGAs))
-          // node.sysLogger?.debug("wrote peristent values to the file " + sFile);
-        }
-      } catch (err) {
-        node.sysLogger?.error('unable to write peristent values to the file ' + sFile + ' ' + err.message)
-      }
-    }
+    node.sysLogger?.info('payload cache set to ' + node.persistFile + ', file cache mode ' + node.fileStorage.mode)
     function loadExposedGAs () {
-      const sFile = path.join(node.userDir, 'knxpersistvalues', 'knxpersist' + node.id + '.json')
       try {
-        node.exposedGAs = JSON.parse(fs.readFileSync(sFile, 'utf8'))
+        // The storage returns the values not yet written to disk, too.
+        node.exposedGAs = JSON.parse(node.fileStorage.readFile(node.persistFile, 'utf8'))
         if (!Array.isArray(node.exposedGAs)) node.exposedGAs = []
       } catch (err) {
         node.exposedGAs = []
-        node.sysLogger?.info('unable to read peristent file ' + sFile + ' ' + err.message)
+        node.sysLogger?.info('unable to read peristent file ' + node.persistFile + ' ' + err.message)
       }
       node.rebuildExposedGAIndex()
     }
@@ -900,12 +908,6 @@ module.exports = (RED) => {
       loadExposedGAs() // 04/04/2021 load the current values of GA payload
       node.sysLogger?.info('Loaded persist GA values', node.exposedGAs?.length)
 
-      if (node.timerSaveExposedGAs !== null) clearInterval(node.timerSaveExposedGAs)
-      node.timerSaveExposedGAs = setInterval(async () => {
-        await saveExposedGAs()
-      }, 5000)
-      node.sysLogger?.info('Started timerSaveExposedGAs with array lenght ', node.exposedGAs?.length)
-
       try {
         const readHistory = []
 
@@ -1151,6 +1153,7 @@ module.exports = (RED) => {
         ipPort: node.port,
         physAddr: node.physAddr, // the KNX physical address we'd like to use
         suppress_ack_ldatareq: node.suppressACKRequest,
+        waitForTunnelingAck: node.waitForTunnelingAck,
         loglevel: node.loglevel,
         hostProtocol: node.hostProtocol,
         isSecureKNXEnabled: node.knxSecureSelected,
@@ -1338,6 +1341,7 @@ module.exports = (RED) => {
         })
         node.knxConnection.on(knx.KNXClientEvents.connected, (info) => {
           node.linkStatus = 'connected'
+          node.fileStorage.handleGatewayEvent()
 
           // Track serial driver for forced close on redeploy
           if (node.hostProtocol === 'SerialFT12' && node.knxConnection && node.knxConnection._serialDriver) {
@@ -1399,18 +1403,20 @@ module.exports = (RED) => {
         return
       }
 
-      let _evt = null
-      if (_datagram.cEMIMessage.npdu.isGroupRead) _evt = 'GroupValue_Read'
-      if (_datagram.cEMIMessage.npdu.isGroupResponse) _evt = 'GroupValue_Response'
-      if (_datagram.cEMIMessage.npdu.isGroupWrite) _evt = 'GroupValue_Write'
-
       let _src = null
       _src = _datagram.cEMIMessage.srcAddress.toString()
 
       let _dest = null
       _dest = _datagram.cEMIMessage.dstAddress.toString()
 
-      if (_evt === null || _src === null || _dest === null) {
+      // Point-to-point and transport control telegrams (e.g. an ETS device scan) are valid, but not for us
+      const _evt = getGroupServiceEvent(_datagram.cEMIMessage)
+      if (_evt === null) {
+        node.sysLogger?.debug(`HandleBusEvent: ignored non group telegram src=${_src} dest=${_dest}`)
+        return
+      }
+
+      if (_src === null || _dest === null) {
         node.sysLogger?.warn(`HandleBusEvent: unable to parse telegram, ignored (evt=${_evt || 'n/a'} src=${_src || 'n/a'} dest=${_dest || 'n/a'})`)
         return
       };
@@ -2660,10 +2666,6 @@ module.exports = (RED) => {
     }, 10000)
 
     node.Disconnect = async (_sNodeStatus = '', _sColor = 'grey') => {
-      if (node.timerSaveExposedGAs !== null) {
-        clearInterval(node.timerSaveExposedGAs)
-        node.timerSaveExposedGAs = null
-      }
       if (node.timerDoInitialRead !== null) {
         clearTimeout(node.timerDoInitialRead) // 17/02/2020 Stop the initial read timer
         node.timerDoInitialRead = null
@@ -2724,7 +2726,7 @@ module.exports = (RED) => {
       }
 
       node.setAllClientsStatus('Disconnected', _sColor, _sNodeStatus)
-      await saveExposedGAs() // 04/04/2021 save the current values of GA payload
+      node.fileStorage.handleGatewayEvent() // 04/04/2021 save the current values of GA payload
       node.sysLogger?.debug('Disconnected, node.autoReconnect:' + node.autoReconnect)
     }
 
@@ -2736,6 +2738,9 @@ module.exports = (RED) => {
         }
         await node.Disconnect()
       } catch (error) { /* empty */ }
+      try {
+        node.fileStorage.close()
+      } catch (error) { /* empty */ }
       node.nodeClients = [] // 05/04/2022 Nullify
       try {
         node.sysLogger?.destroy()
@@ -2754,5 +2759,6 @@ module.exports = (RED) => {
 }
 
 module.exports.__test = {
-  resolveHostAddress
+  resolveHostAddress,
+  getGroupServiceEvent
 }

package/nodes/knxUltimate.html

@@ -790,6 +790,9 @@ return msg;`
                     node.initialread = 0;
                     $("#node-input-initialread").val(0)
                 }
+                // Reading the initial value from file is limited when the gateway does not write files.
+                const refreshFileCacheTip = KNX_bindFileCacheDisabledTip($("#knxUltimate-file-cache-tip"), $("#node-input-server"), () => ['2', '3'].includes(String($("#node-input-initialread").val())));
+                $("#node-input-initialread").on('change', refreshFileCacheTip);
 
                 oNodeServer = RED.nodes.node($("#node-input-server").val());
                 if (oNodeServer === undefined) {
@@ -1352,6 +1355,7 @@ return msg;`
                         <option value=2 data-i18n="knxUltimate.properties.node-input-initialread2"></option>
                         <option value=3 data-i18n="knxUltimate.properties.node-input-initialread3"></option>
                     </select>
+                    <div class="form-tips" id="knxUltimate-file-cache-tip" style="display:none; margin-top:6px;"></div>
 
                 </div>
                 <div class="form-row" id="divInputRBE">

package/nodes/knxUltimateUtility.html

@@ -12,6 +12,8 @@
     const text = (key) => RED._('node-red-contrib-knx-ultimate/knxUltimateUtility:knxUltimateUtility.' + key);
     const activeType = (node) => node._utilityEditor ? node._utilityEditor.type() : node.utilityType;
     const validationContext = (node) => typeof node._utilityEditor?.values === 'function' ? node._utilityEditor.values() : node;
+    // Functions that save files through the gateway's File Cache Control.
+    const usesFiles = (type) => type === 'autoresponder' || type === 'scenecontroller' || (type === 'logger' && $('#node-input-saveMode').val() === 'emit_save');
 
     function buildDefaults() {
       // Node-RED must know every persistable field and the real config-node
@@ -136,6 +138,7 @@
         let closed = false;
         let helpTimer;
         const container = $('#knx-utility-profile-editor');
+        const refreshFileCacheTip = KNX_bindFileCacheDisabledTip($('#knx-utility-file-cache-tip'), $('#node-input-server'), () => usesFiles(selectedType));
 
         // Edit a separate context: profile hooks (including asynchronous ETS
         // suggestions) must never mutate the saved node before Done is pressed.
@@ -201,6 +204,8 @@
           $('#knx-utility-pin-description').text(text('pins.' + type));
           $('#node-input-name').attr('placeholder', isGlobalContext ? mounted.defaults.name.value : 'KNX Utility · ' + text('types.' + type));
           if (typeof mounted.oneditprepare === 'function') mounted.oneditprepare.call(context);
+          $('#node-input-saveMode').on('change.knxFileCacheTip', refreshFileCacheTip);
+          refreshFileCacheTip();
           // These controls are mounted after Node-RED attaches its initial
           // validation handlers. Trigger a shared field's standard handler so
           // the complete editor validates again while the user edits a profile.
@@ -250,6 +255,7 @@
             closed = true;
             dispose();
             $('#node-input-utilityType').off('.knxUtility');
+            $('#node-input-server').off('.knxFileCacheTip');
           }
         };
         const initialType = node.utilityType || 'alerter';
@@ -311,6 +317,7 @@
     <label for="node-input-server"><i class="fa fa-circle-o"></i> <span data-i18n="knxUltimateUtility.gateway"></span></label>
     <input type="text" id="node-input-server">
   </div>
+  <div class="form-tips" id="knx-utility-file-cache-tip" style="display:none"></div>
   <div class="form-row">
     <label for="node-input-name"><i class="fa fa-tag"></i> <span id="knx-utility-name-label" data-i18n="knxUltimateUtility.name"></span></label>
     <input type="text" id="node-input-name">

package/nodes/knxUltimateViewer.html

@@ -77,6 +77,8 @@
                 const base = raw.split("-")[0];
                 return ["en", "it", "de", "fr", "es"].includes(base) ? base : "en";
             };
+            // The history is kept only in memory when the gateway does not write files.
+            KNX_bindFileCacheDisabledTip($("#knx-viewer-file-cache-tip"), $("#node-input-server"));
             $("#knx-viewer-open-web-page").on("click", function (evt) {
                 evt.preventDefault();
                 const adminRoot = resolveAdminRoot();
@@ -128,6 +130,7 @@
     </label>
     <input type="text" id="node-input-server" />
 </div>
+<div class="form-tips" id="knx-viewer-file-cache-tip" style="display:none;"></div>
 
 <div class="form-row">
     <label for="node-input-name">

package/nodes/knxUltimateViewer.js

@@ -4,6 +4,7 @@ const KNXAddress = require('knxultimate').KNXAddress
 const _ = require('lodash')
 const { getRequestAccessToken, normalizeAuthFromAccessTokenQuery } = require('./utils/httpAdminAccessToken')
 const createViewerHistory = require('./utils/knxViewerHistory')
+const { storageOf } = require('./utils/fileStorage')
 
 const viewerRuntimeContexts = new WeakMap()
 const knxUltimateViewerVueDistDir = path.join(__dirname, 'plugins', 'knxUltimateViewer-vue')
@@ -314,7 +315,8 @@ module.exports = function (RED) {
         userDir: RED.settings.userDir,
         nodeId: node.id,
         gatewayId: node.serverKNX.id,
-        onError: reportHistoryError
+        onError: reportHistoryError,
+        storage: storageOf(node.serverKNX)
       })
       node.viewerHistory.ready.catch(reportHistoryError)
     } catch (error) {

package/nodes/locales/de/knxUltimate-config.html

@@ -39,10 +39,10 @@ Dieser Node stellt die Verbindung zu deinem KNX/IP-Gateway her.
 |Eigenschaft|Beschreibung|
 |--|--|
 | Suppress repeated (R-Flag) telegrams fom BUS | Wiederholte BUS-Telegramme (R-Flag) ignorieren. |
-| Suppress ACK request in tunneling mode | Für sehr alte KNX/IP-Gateways: ACK ignorieren, alle Telegramme akzeptieren. |
+| Bus-ACK-Anforderung unterdrücken | Bus-ACK. Wenn aktiviert, fordern die an den KNX-Bus gesendeten Telegramme (Tunnel UDP, Multicast und Serial FT1.2) keine Bestätigung der empfangenden Geräte mehr an. Bei Tunnel UDP und "Auf Tunnelling-ACK warten" auf Automatisch wartet der Knoten außerdem nicht mehr auf die Bestätigung der Schnittstelle. Nur aktivieren, wenn Ihre Schnittstelle es erfordert, z. B. einige alte oder Weinzierl-KNX/IP-Schnittstellen, eibPORT und Loxone. Standard: deaktiviert. |
+| Auf Tunnelling-ACK warten (Tunnel UDP) | Schnittstellen-ACK. Bei Tunnel UDP wartet der Knoten, bis die KNX/IP-Schnittstelle jedes Telegramm bestätigt: Ein unbestätigtes Telegramm wird noch einmal gesendet, dann wird die Verbindung geschlossen und neu aufgebaut. Automatisch wartet nur, wenn "Bus-ACK-Anforderung unterdrücken" deaktiviert ist, wie in früheren Versionen. Ja wartet immer, Nein nie. eibPORT- und Loxone-Gateways benötigen "Bus-ACK-Anforderung unterdrücken" zusammen mit Ja. |
 | Flow-Bubbles-Plugin aktivieren | Zeigt im Editor neben jedem KNX Device Node eine kleine farbige Bubble an. Die Bubble spiegelt den zuletzt vom Gateway empfangenen Live-Status wider und wird abgeblendet, wenn die Daten veraltet sind. Nützlich bei Inbetriebnahme und Debugging. Standard: deaktiviert. |
 | Delay between each telegram (ms) | KNX erlaubt max. 50 Telegramme/s. 25-50 ms sind üblich; bei langsamen Verbindungen höher (z. B. 200-500 ms). |
-| Loglevel | Log-Detailgrad. Standard: "Error". |
 | Aktualisierung der Status-Badges | Legt fest, wie oft die Statusanzeige der Nodes erneuert wird. Mit einer Verzögerung werden Zwischenstände verworfen und nur der letzte Wert nach dem gewählten Intervall angezeigt. Wählen Sie **Sofort**, um das bisherige Echtzeitverhalten beizubehalten. |
 | Status Datum/Uhrzeit-Format | Legt fest, wie Datum/Uhrzeit im Status-Badge angezeigt werden (nützlich, wenn das OS-Locale nicht konfigurierbar ist). |
 | Benutzerdefiniertes Format | Wird verwendet, wenn **Benutzerdefiniert (Tokens)** gewählt ist. Tokens: `YYYY`, `YY`, `MMM`, `MM`, `DD`, `HH`, `mm`, `ss`, `A`, `a`, `Z`. Verwenden Sie `[Text]` für Literale. |
@@ -59,12 +59,15 @@ Dieser Node stellt die Verbindung zu deinem KNX/IP-Gateway her.
 
 <br/>
 
-**Werkzeuge**
+**Datei-Cache-Steuerung**
 
 |Eigenschaft|Beschreibung|
 |--|--|
-| Gather debug info for troubleshoot | Button klicken und Ausgabe an ein GitHub-Issue anhängen. |
-| Get all used GA for KNX routing filter | Mit READ eine Textliste aller in Flows verwendeten GAs für dieses Gateway holen - zum Befüllen der Filtertabelle deines KNX/IP-Routers. |
+| Loglevel | Log-Detailgrad. Standard: "Error". Das Log ist von der Schreibverschleiß-Verwaltung nicht betroffen. |
+| Schreibverschleiß-Verwaltung | Legt fest, wie oft KNX Ultimate seine Dateien auf den Datenträger schreibt: GA-Werte, Szenen des Scene Controllers, AutoResponder-Werte, Logger-Datei und Viewer-Verlauf. Nützlich, um den Verschleiß von SD-Karten zu verringern. Dateien werden nur geschrieben, wenn sich ihr Inhalt geändert hat. **Aktualität zuerst** (Standard) speichert Änderungen alle 5 Sekunden. **Ausgewogen** speichert sie nur beim Verbinden oder Trennen des Gateways sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird. **Schreiben deaktivieren** schreibt nie auf den Datenträger: Die Daten bleiben nur im Speicher, und bei jedem Neustart von Node-RED gehen alle aktuellen GA-Werte und die von den KNX-Ultimate-Knoten gespeicherten Daten verloren. **Benutzerdefiniertes Intervall** speichert Änderungen im gewählten Intervall (5 Sekunden bis 30 Tage) sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird. |
+| Schreibintervall | Sichtbar bei **Benutzerdefiniertes Intervall**. Wert und Einheit (Sekunden, Minuten, Stunden, Tage) des Schreibintervalls. |
+
+> Ist das Schreiben deaktiviert, zeigen die KNX-Ultimate-Knoten, die Dateien verwenden (Device mit initialem Lesen aus Datei, Scene Controller, AutoResponder, Logger mit Speicherung in Datei, Viewer), einen Hinweis in ihrem Editor.
 
 <br/>
 

package/nodes/locales/de/knxUltimate-config.json

@@ -19,7 +19,7 @@
             "discovering": "Suche...",
             "interfaces_found": "Schnittstellen gefunden.",
             "discovery_failed": "Suche fehlgeschlagen.",
-            "weinzierl_ack_autoenabled": "Weinzierl-Interface erkannt: 'Suppress ACK request' wurde automatisch aktiviert. Du kannst es im Tab 'Erweitert' deaktivieren.",
+            "weinzierl_ack_autoenabled": "Weinzierl-Interface erkannt: 'Bus-ACK-Anforderung unterdrücken' wurde automatisch aktiviert. Du kannst es im Tab 'Erweitert' deaktivieren.",
             "address": "Adresse",
             "iface_auto": "Auto",
             "iface_manual": "Schnittstellennamen manuell eingeben",
@@ -63,15 +63,20 @@
             "configuration": "Konfiguration",
             "advanced": "Erweitert",
             "ets_import": "ETS-Import",
-            "utility": "Dienstprogramme"
+            "file_cache": "Datei-Cache-Steuerung"
         },
         "advanced": {
             "knx_phy_addr": "KNX-Adresse",
             "show_date_status": "Tag und Uhrzeit des letzten Updates im Status anzeigen",
             "show_device_status": "Gerätenamen im Status anzeigen (\"Alle Gruppenadressen abhören\" erforderlich)",
             "show_datapoint_status": "Datenpunkt im Status anzeigen",
-            "suppress_ack": "ACK-Anfrage unterdrücken in Tunnel Modus",
-            "suppress_ack_help": "Diese Option unterstützt die Kompatibilität mit der alten Firmware des alten IP-Interfaces.Achtung: Der Knoten kann die Trennung vom Gateway möglicherweise nicht bemerken. Verwenden Sie in diesem Fall den Watchdog im Ethernet+KNX-Twisted-Pair Modus.",
+            "suppress_ack": "Bus-ACK-Anforderung unterdrücken",
+            "suppress_ack_help": "Bus-ACK. Wenn aktiviert, fordern die an den KNX-Bus gesendeten Telegramme (Tunnel UDP, Multicast und Serial FT1.2) keine Bestätigung der empfangenden Geräte mehr an. Bei Tunnel UDP und \"Auf Tunnelling-ACK warten\" auf Automatisch wartet der Knoten außerdem nicht mehr auf die Bestätigung der Schnittstelle. Nur aktivieren, wenn Ihre Schnittstelle es erfordert, z. B. einige alte oder Weinzierl-KNX/IP-Schnittstellen, eibPORT und Loxone. Standard: deaktiviert.",
+            "wait_tunneling_ack": "Auf Tunnelling-ACK warten (Tunnel UDP)",
+            "wait_tunneling_ack_auto": "Automatisch (nur wenn die Bus-ACK-Anforderung nicht unterdrückt ist)",
+            "wait_tunneling_ack_yes": "Ja (einmal wiederholen, dann trennen)",
+            "wait_tunneling_ack_no": "Nein",
+            "wait_tunneling_ack_help": "Schnittstellen-ACK. Bei Tunnel UDP wartet der Knoten, bis die KNX/IP-Schnittstelle jedes Telegramm bestätigt: Ein unbestätigtes Telegramm wird noch einmal gesendet, dann wird die Verbindung geschlossen und neu aufgebaut. Automatisch wartet nur, wenn \"Bus-ACK-Anforderung unterdrücken\" deaktiviert ist, wie in früheren Versionen. Ja wartet immer, Nein nie. eibPORT- und Loxone-Gateways benötigen \"Bus-ACK-Anforderung unterdrücken\" zusammen mit Ja.",
             "ignoreTelegramsWithRepeatedFlag": "Wiederholt (R-Flag) telegramme vom BUS unterdrücken",
             "enable_flow_bubbles": "Flow-Bubbles-Plugin aktivieren",
             "enable_flow_bubbles_help": "Zeigt Live-Status-Bubbles neben KNX Device Nodes im Editor an. Nützlich bei Inbetriebnahme und Debugging.",
@@ -133,22 +138,19 @@
             "tunnel_user_password": "Tunnel-Benutzerpasswort",
             "ga_list_label": "ETS-Gruppenadressliste"
         },
-        "utility": {
-            "gather_debug": "Debug und Log zur Fehlersuche sammeln",
-            "get_all_used_ga": "Alle verwendeten GA für KNX-Routing-Filter abrufen",
-            "read_button": "Lesen",
-            "copy_ga_router": "Kopieren Sie diese Gruppenadressen in die Routing-Tabelle Ihres KNX/IP-Routers.",
-            "clear_persist_label": "Persistenten GA-Cache für dieses Gateway löschen",
-            "clear_persist_button": "Löschen",
-            "clear_persist_confirm": "Dadurch wird die persistente GA-Cache-Datei für dieses Gateway gelöscht. Fortfahren?",
-            "clear_persist_ok": "Löschen",
-            "clear_persist_cancel": "Abbrechen",
-            "clear_persist_done": "Persistenter GA-Cache gelöscht.",
-            "clear_persist_fail": "Persistenter GA-Cache konnte nicht gelöscht werden",
-            "reveal_keyring_label": "Keyring-Passwörter im Klartext anzeigen (KNX Secure)",
-            "reveal_keyring_button": "Anzeigen",
-            "reveal_keyring_loading": "Keyring wird dekodiert, bitte warten...",
-            "reveal_keyring_fail": "Keyring konnte nicht dekodiert werden. Prüfen Sie die Keyring-Datei und das allgemeine Passwort."
+        "file_cache": {
+            "mode": "Schreibverschleiß-Verwaltung",
+            "mode_freshness": "Aktualität zuerst",
+            "mode_balanced": "Ausgewogen",
+            "mode_disabled": "Schreiben deaktivieren",
+            "mode_custom": "Benutzerdefiniertes Intervall",
+            "interval": "Schreibintervall",
+            "unit_seconds": "Sekunden",
+            "unit_minutes": "Minuten",
+            "unit_hours": "Stunden",
+            "unit_days": "Tage",
+            "disabled_tip": "Das Schreiben auf den Datenträger ist deaktiviert (Datei-Cache-Steuerung des KNX-Gateways): Bei jedem Neustart von Node-RED gehen alle aktuellen GA-Werte und die von den KNX-Ultimate-Knoten gespeicherten Daten verloren.",
+            "description": "Legt fest, wie oft KNX Ultimate seine Dateien auf den Datenträger schreibt (GA-Werte, Szenen des Scene Controllers, AutoResponder-Werte, Logger-Datei, Viewer-Verlauf), um den Verschleiß von SD-Karten zu verringern. Dateien werden nur geschrieben, wenn sich ihr Inhalt geändert hat. Das Log ist nicht betroffen: Verwenden Sie dafür die Protokollstufe.<br/><b>Aktualität zuerst</b>: Änderungen werden alle 5 Sekunden gespeichert.<br/><b>Ausgewogen</b>: Änderungen werden nur beim Verbinden oder Trennen des Gateways gespeichert sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird.<br/><b>Schreiben deaktivieren</b>: Es wird nichts auf den Datenträger geschrieben.<br/><b>Benutzerdefiniertes Intervall</b>: Änderungen werden im gewählten Intervall (5 Sekunden bis 30 Tage) gespeichert sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird."
         }
     }
 }

package/nodes/locales/de/knxUltimate.html

@@ -54,6 +54,8 @@ Der Button wird nur eingeblendet, wenn die Option aktiv ist. Im Universalmodus i
 | Auf Lese-Telegramme reagieren | Sendet bei Read eine Nachricht an den Flow (z. B. um eigene Werte zu liefern). |
 | Multiply/Decimals/Negatives | Skaliert, rundet und behandelt negative Werte (nur numerische Werte). |
 
+> 💾 Wann die von **Bei Verbindung/Wiederverbindung der Wert lesen** (aus Datei) genutzten GA-Werte auf den Datenträger geschrieben werden, bestimmt die **Datei-Cache-Steuerung** des KNX-Gateways. Mit **Schreiben deaktivieren** bleiben sie nur im Speicher und gehen bei jedem Neustart von Node-RED verloren. Siehe den Tab **Datei-Cache-Steuerung** des KNX-Gateways.
+
 <br/>
 <br/>
 

package/nodes/locales/de/knxUltimateUtility.html

@@ -163,6 +163,8 @@ msg = {
 
 ## AutoResponder
 
+> 💾 Wann die gespeicherten Werte auf den Datenträger geschrieben werden, bestimmt die **Datei-Cache-Steuerung** des KNX-Gateways. Mit **Schreiben deaktivieren** bleiben sie nur im Speicher und gehen bei jedem Neustart von Node-RED verloren. Siehe den Tab **Datei-Cache-Steuerung** des KNX-Gateways.
+
  Dieser Knoten antwortet auf Leseanfragen aus dem KNX -Bus.
 
 Der Knoten zeichnet alle an den KNX -Bus übertragenen Telegramme auf und speichert die Werte im Speicher.
@@ -502,6 +504,8 @@ global.set("KNXContextBanana_WRITE", toSend);
 
 ## Logger
 
+> 💾 Wann die Daten der XML-Datei von **Payload senden und in Datei speichern** auf den Datenträger geschrieben werden, bestimmt die **Datei-Cache-Steuerung** des KNX-Gateways. Mit **Schreiben deaktivieren** bleiben sie nur im Speicher und gehen bei jedem Neustart von Node-RED verloren. Siehe den Tab **Datei-Cache-Steuerung** des KNX-Gateways.
+
 ### Logger
 
 Der Logger-Node zeichnet alle Telegramme auf und erzeugt eine ETS-Busmonitor-kompatible XML-Datei.
@@ -761,6 +765,8 @@ return msg;
 
 ## Szenensteuerung
 
+> 💾 Wann die gespeicherten Szenen auf den Datenträger geschrieben werden, bestimmt die **Datei-Cache-Steuerung** des KNX-Gateways. Mit **Schreiben deaktivieren** bleiben sie nur im Speicher und gehen bei jedem Neustart von Node-RED verloren. Siehe den Tab **Datei-Cache-Steuerung** des KNX-Gateways.
+
 ### Scene Controller
 
 Der Scene-Controller-Node verhält sich wie ein KNX-Szenencontroller: Szenen speichern und abrufen.

package/nodes/locales/de/knxUltimateViewer.html

@@ -19,6 +19,8 @@ Wählen Sie einen Viewer, durchsuchen Sie die Liste oder blättern Sie zu älter
 
 Der aktive Viewer-Knoten speichert den Verlauf automatisch in Dateien unter `userDir/knxultimatestorage/viewer`, getrennt nach Viewer und Gateway. Änderungen, die älter als 24 Stunden sind, werden automatisch entfernt. Nach einem Neustart von Node-RED lädt der Viewer den noch in diesem Zeitraum liegenden Verlauf.
 
+> 💾 Wann die Verlaufsdateien auf den Datenträger geschrieben werden, bestimmt die **Datei-Cache-Steuerung** des KNX-Gateways. Mit **Schreiben deaktivieren** bleiben sie nur im Speicher und gehen bei jedem Neustart von Node-RED verloren. Siehe den Tab **Datei-Cache-Steuerung** des KNX-Gateways.
+
 Die Aufzeichnung beginnt, sobald der aktualisierte Viewer bereitgestellt ist und läuft. Frühere Bustelegramme werden nicht nachträglich rekonstruiert.
 
 ## Flow-Ausgänge

package/nodes/locales/en/knxUltimate-config.html

@@ -39,10 +39,10 @@
 |Property|Description|
 |--|--|
 | Suppress repeated (R-Flag) telegrams fom BUS | Ignore repeated KNX telegrams coming from the bus. Default is unchecked. |
-| Suppress ACK request in tunneling mode | Enable it if you have a very old KNX/IP gateway. It ignores the ACK procedure and accepts all telegrams. Default is unchecked.|
+| Suppress the bus ACK request | Bus ACK. When checked, the telegrams sent to the KNX bus (Tunnel UDP, Multicast and Serial FT1.2) no longer ask the receiving devices for an acknowledgement. With Tunnel UDP and "Wait for the tunnelling ACK" set to Auto, the node also stops waiting for the interface's confirmation. Enable it only if your interface needs it, for example some old or Weinzierl KNX/IP interfaces, eibPORT and Loxone. Default is unchecked. |
+| Wait for the tunnelling ACK (Tunnel UDP) | Interface ACK. With Tunnel UDP, the node waits for the KNX/IP interface to confirm every telegram: a telegram that is not confirmed is sent once more, then the connection is closed and opened again. Auto waits only when "Suppress the bus ACK request" is unchecked, as in previous versions. Yes always waits, No never waits. eibPORT and Loxone gateways need "Suppress the bus ACK request" checked together with Yes. |
 | Enable flow bubbles plugin | Draw a small coloured bubble next to each KNX Device node in the editor. The bubble reflects the latest live state received from the gateway and becomes dim when the data is stale. Useful during commissioning and debugging. Default is unchecked. |
 | Delay between each telegram (in milliseconds) | KNX specs states, that the maximum telegram sending speed is 50 telegrams per second. A speed between 25 and 50ms should be fine, unless you're connecting to a remote KNX Gateway via a slow internet connection (in this case, you should increase the value by, for example, 200 to 500ms or more). |
-| Loglevel | Log level, in case you need to debug something with the dev. Default is "Error", |
 | Node status throttle | Delay how often node badges are refreshed. When a delay is selected, intermediate status changes are discarded and the last one is shown after the chosen interval. Select **Immediate** to keep the legacy real-time behaviour. |
 | Status date/time format | Choose how the timestamp is shown in node status badges (useful when the host OS locale cannot be configured). |
 | Custom format | Used when **Custom (tokens)** is selected. Tokens: `YYYY`, `YY`, `MMM`, `MM`, `DD`, `HH`, `mm`, `ss`, `A`, `a`, `Z`. Use `[text]` for literals. |
@@ -59,12 +59,15 @@
 
 <br/>
 
-**Utility**
+**File Cache Control**
 
 |Property|Description|
 |--|--|
-| Gather debug info for troubleshoot | Please click the button and add it to the gitHub issue you want to open, it will help me a lot to helping you. |
-| Get all used GA for KNX routing filter | Press READ to retrieve a plain text list of all group address belonging to this gateway, that has been used in the flows. You can use this list to populate your KNX/IP router filter table. |
+| Loglevel | Log level, in case you need to debug something with the dev. Default is "Error". The log is not affected by the disk-wear management. |
+| Disk-wear management | Sets how often KNX Ultimate writes its files to disk: GA values, Scene Controller scenes, AutoResponder values, Logger file and Viewer history. Useful to reduce the wear of SD cards. Files are written only when their content has changed. **Freshness priority** (default) saves the changes every 5 seconds. **Balanced** saves them only when the gateway connects or disconnects, and when Node-RED stops or the gateway is redeployed. **Disable writing** never writes to disk: the data is kept in memory only and, at every restart of Node-RED, all the current GA values and the data saved by the KNX Ultimate nodes are lost. **Custom interval** saves the changes at the chosen interval, from 5 seconds to 30 days, and when Node-RED stops or the gateway is redeployed. |
+| Write interval | Visible with **Custom interval**. Number and unit (seconds, minutes, hours, days) of the write interval. |
+
+> When writing is disabled, the KNX Ultimate nodes that use files (Device with initial read from file, Scene Controller, AutoResponder, Logger saving to file, Viewer) show a reminder in their editor.
 
 <br/>
 

package/nodes/locales/en/knxUltimate-config.json

@@ -19,7 +19,7 @@
             "discovering": "Discovering...",
             "interfaces_found": "interfaces found.",
             "discovery_failed": "Discovery failed.",
-            "weinzierl_ack_autoenabled": "Weinzierl interface detected: 'Suppress ACK request' has been enabled automatically. You can disable it in the Advanced tab.",
+            "weinzierl_ack_autoenabled": "Weinzierl interface detected: 'Suppress the bus ACK request' has been enabled automatically. You can disable it in the Advanced tab.",
             "address": "Address",
             "iface_auto": "Auto",
             "iface_manual": "Manually enter interface's name",
@@ -64,15 +64,20 @@
             "configuration": "Configuration",
             "advanced": "Advanced",
             "ets_import": "ETS file import",
-            "utility": "Utility"
+            "file_cache": "File Cache Control"
         },
         "advanced": {
             "knx_phy_addr": "KNX Physical Address",
             "show_date_status": "Show last update day and time in status",
             "show_device_status": "Show device name in status (require \"Listen all Group Address\" )",
             "show_datapoint_status": "Show datapoint in status",
-            "suppress_ack": "Suppress ACK request in tunneling mode",
-            "suppress_ack_help": "The option above helps old KNX/IP Interfaces compatibility. Warning: the node may not notice the disconnection from the gateway. In this case, use the watchdog in Ethernet+KNX twisted pair mode.",
+            "suppress_ack": "Suppress the bus ACK request",
+            "suppress_ack_help": "Bus ACK. When checked, the telegrams sent to the KNX bus (Tunnel UDP, Multicast and Serial FT1.2) no longer ask the receiving devices for an acknowledgement. With Tunnel UDP and \"Wait for the tunnelling ACK\" set to Auto, the node also stops waiting for the interface's confirmation. Enable it only if your interface needs it, for example some old or Weinzierl KNX/IP interfaces, eibPORT and Loxone. Default is unchecked.",
+            "wait_tunneling_ack": "Wait for the tunnelling ACK (Tunnel UDP)",
+            "wait_tunneling_ack_auto": "Auto (only if the bus ACK request is not suppressed)",
+            "wait_tunneling_ack_yes": "Yes (repeat once, then disconnect)",
+            "wait_tunneling_ack_no": "No",
+            "wait_tunneling_ack_help": "Interface ACK. With Tunnel UDP, the node waits for the KNX/IP interface to confirm every telegram: a telegram that is not confirmed is sent once more, then the connection is closed and opened again. Auto waits only when \"Suppress the bus ACK request\" is unchecked, as in previous versions. Yes always waits, No never waits. eibPORT and Loxone gateways need \"Suppress the bus ACK request\" checked together with Yes.",
             "ignoreTelegramsWithRepeatedFlag": "Suppress repeated (R-Flag) telegrams fom BUS",
             "enable_flow_bubbles": "Enable flow bubbles plugin",
             "enable_flow_bubbles_help": "Draw live status bubbles next to KNX Device nodes in the editor. Useful during commissioning and debugging.",
@@ -137,22 +142,19 @@
             "tunnel_user_password": "Tunnel user password",
             "ga_list_label": "ETS group address list"
         },
-        "utility": {
-            "gather_debug": "Gather debug and log for troubleshoot",
-            "get_all_used_ga": "Get all used GA for KNX routing filter",
-            "read_button": "Read",
-            "copy_ga_router": "Copy these group addresses in your routing table list of your KNX/IP router.",
-            "clear_persist_label": "Clear persisted GA cache for this gateway",
-            "clear_persist_button": "Clear",
-            "clear_persist_confirm": "This deletes the persisted GA cache file for this gateway. Continue?",
-            "clear_persist_ok": "Delete",
-            "clear_persist_cancel": "Cancel",
-            "clear_persist_done": "Persisted GA cache deleted.",
-            "clear_persist_fail": "Unable to delete persisted GA cache",
-            "reveal_keyring_label": "Reveal keyring passwords in clear text (KNX Secure)",
-            "reveal_keyring_button": "Reveal",
-            "reveal_keyring_loading": "Decoding keyring, please wait...",
-            "reveal_keyring_fail": "Unable to decode the keyring. Check the keyring file and the general password."
+        "file_cache": {
+            "mode": "Disk-wear management",
+            "mode_freshness": "Freshness priority",
+            "mode_balanced": "Balanced",
+            "mode_disabled": "Disable writing",
+            "mode_custom": "Custom interval",
+            "interval": "Write interval",
+            "unit_seconds": "seconds",
+            "unit_minutes": "minutes",
+            "unit_hours": "hours",
+            "unit_days": "days",
+            "disabled_tip": "Writing to disk is disabled (File Cache Control of the KNX gateway): at every restart of Node-RED, all the current GA values and the data saved by the KNX Ultimate nodes will be lost.",
+            "description": "Sets how often KNX Ultimate writes its files to disk (GA values, Scene Controller scenes, AutoResponder values, Logger file, Viewer history), to reduce the wear of SD cards. Files are written only when their content has changed. The log is not affected: use the log level for it.<br/><b>Freshness priority</b>: changes are saved every 5 seconds.<br/><b>Balanced</b>: changes are saved only when the gateway connects or disconnects, and when Node-RED stops or the gateway is redeployed.<br/><b>Disable writing</b>: nothing is written to disk.<br/><b>Custom interval</b>: changes are saved at the chosen interval (5 seconds to 30 days), and when Node-RED stops or the gateway is redeployed."
         }
     }
 }