node-red-contrib-knx-ultimate 6.0.4 → 6.0.6

package/nodes/locales/zh-CN/knxUltimateMatterBridge.html

@@ -9,6 +9,8 @@
 
 这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
 
+桥接器配对后更改设备类型会改变 Matter 端点结构。控制器可能会将旧端点保留为不可达；此时请重置并重新配对桥接器，或创建新的公开设备。
+
 ## 配置
 
 |字段|说明|
@@ -28,7 +30,7 @@
 | RGB 彩色灯 | + RGB 颜色命令/状态 GA (DPT 232.600)。Matter 颜色（hue/saturation 或 XY，来自 App 的色轮）与 KNX RGB 三元组相互转换 |
 | 色温灯 | + 色温命令/状态 GA，开尔文 (DPT 7.600) |
 | 窗帘/卷帘 | 上/下 (DPT 1.008)、停止 (DPT 1.017)、位置 % 命令/状态 (DPT 5.001)、可选位置反转 |
-| 温控器（采暖） | 当前温度 GA、设定点命令/状态 GA (DPT 9.001) |
+| 温控器（采暖和/或制冷） | 当前温度 GA、设定点命令/状态 GA (DPT 9.001)。如再配置制冷设定点命令/状态 GA，则同时提供 Cool 模式（双设定点） |
 | 风扇/新风 | 速度 % 命令/状态 GA (DPT 5.001) |
 | 传感器（温度、湿度、光照、人体、门磁） | 各一个状态 GA |
 | 烟雾/CO 报警器 | 烟雾报警状态 GA + 可选 CO 报警状态 GA (DPT 1.005)：手机上的紧急通知 |
@@ -41,7 +43,7 @@
 
 ## 高级兼容性
 
-这些选项只会在适用于所选类型时显示。调光设备可以忽略某些控制器在 `On` 后立即发送的亮度命令。窗帘可以在命令后乐观更新 Matter 位置，并在 KNX 状态 GA 报告真实位置时再修正。
+这些选项只会在适用于所选类型时显示。调光设备可以忽略某些控制器在 `On` 后立即发送的亮度命令。对于窗帘，**交换打开 / 关闭**会同时反转 KNX 二进制命令和百分比方向。**窗帘滑块防抖**会在写入 KNX 前合并快速的中间目标：`0` 使用自适应窗口（首个命令 400 ms，后续命令 150 ms）；`1`–`5000` 使用固定窗口。窗帘还可先乐观更新 Matter 位置，再由 KNX 状态 GA 修正。
 
 ## 节点引脚
 

package/nodes/locales/zh-CN/knxUltimateMatterBridge.json

@@ -17,24 +17,25 @@
       "name_placeholder": "例如 厨房灯",
       "invert": "反转位置 %"
     },
-  "advanced": {
+    "advanced": {
       "title": "高级兼容性",
       "help": " 仅当 Matter 控制器或 KNX 执行器需要特殊处理时使用这些选项。",
+      "alexa_dedup_ms": "Alexa 去重窗口 (毫秒, 0 = 关闭)",
       "turn_on_behavior": "开灯行为",
       "turn_on_ignore_level": "忽略 On 后立即发送的亮度",
       "turn_on_forward_all": "转发每个亮度命令",
-    "ignore_level_ms": "On 后忽略亮度时间 (ms)",
-    "cover_expose_as_light": "将窗帘显示为可调光灯（Alexa 兼容方案）",
-    "cover_expose_as_light_help": "仅当 Alexa 无法设置窗帘百分比时使用。亮度表示窗帘开启程度；KNX 组地址保持不变。",
+      "ignore_level_ms": "On 后忽略亮度时间 (ms)",
+      "cover_swap_open_close": "交换窗帘打开 / 关闭",
+      "cover_slider_debounce": "窗帘滑块防抖（毫秒，0 = 自适应）",
       "cover_update_mode": "窗帘状态更新",
       "cover_optimistic": "乐观更新 Matter 位置",
       "cover_wait_status": "仅等待 KNX 状态",
-    "cover_status_timeout": "窗帘状态超时 (ms)"
-  },
-  "tabs": {
-    "mappings": "KNX 映射",
-    "advanced": "高级选项"
-  },
+      "cover_status_timeout": "窗帘状态超时 (ms)"
+    },
+    "tabs": {
+      "mappings": "KNX 映射",
+      "advanced": "高级选项"
+    },
     "functions": {
       "fn_onoff_cmd": "开/关 命令 GA",
       "fn_onoff_status": "开/关 状态 GA",
@@ -48,6 +49,8 @@
       "fn_currenttemp": "当前温度 GA",
       "fn_setpoint_cmd": "设定点 命令 GA",
       "fn_setpoint_status": "设定点 状态 GA",
+      "fn_coolingsetpoint_cmd": "制冷设定点 命令 GA",
+      "fn_coolingsetpoint_status": "制冷设定点 状态 GA",
       "fn_rgb_cmd": "RGB 颜色命令 GA (DPT 232.600)",
       "fn_rgb_status": "RGB 颜色状态 GA (DPT 232.600)",
       "fn_ct_cmd": "色温命令 GA（开尔文）",

package/nodes/locales/zh-CN/matter-config.html

@@ -15,10 +15,14 @@
 
 如果设备是全新的且仅支持蓝牙配对，请先用厂商 App 或其他 Matter 控制器（Alexa、Google Home、Apple Home）配对，然后使用其**"与其他中枢共享/配对"**功能为 KNX-Ultimate 生成新的配对码。这样设备可以同时加入多个 fabric。
 
+优先使用二维码 payload（`MT:...`），因为它包含完整的鉴别码。手动配对码只包含短鉴别码；当多个相同型号同时处于配对模式时，可能会选错设备。请一次只配对一个设备。
+
 ## 存储
 
 Fabric 凭据和已配对设备保存在 Node-RED 用户目录下的 `knxultimatestorage/matter` 文件夹中。删除该文件夹将移除所有配对。
 
+使用 **导出** 下载此控制器实例的完整备份，其中包含 Fabric、私有凭据、会话和已配网设备数据。**请像密码一样保护此文件。** 导入会替换此实例当前的 Matter 存储并短暂重启控制器。控制器备份不能导入网桥。
+
 ## 移除设备
 
 使用已配对设备列表中的垃圾桶按钮。控制器会尝试正确地解除设备调试；如果设备无法访问，仍会从 fabric 中移除（之后可能需要对设备进行恢复出厂设置）。

package/nodes/locales/zh-CN/matter-config.json

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Matter 控制器",
-      "intro": "此节点是一个 Matter 控制器（拥有自己的 fabric）。在此配对您的 Matter 设备，然后使用 \"Matter Device\" 节点将其映射到 KNX 组地址。请先部署该节点，然后回到这里配对设备。",
       "node-config-input-name": "名称",
       "fabric_label": "Fabric 标签",
       "pairing_title": "配对新设备",
@@ -24,7 +23,13 @@
       "pairing_ok": "设备配对成功！",
       "rename_button": "重命名",
       "rename_prompt": "新的设备名称",
-      "rename_ok": "设备已重命名。"
+      "rename_ok": "设备已重命名。",
+      "storage_title": "Fabric 和配网备份",
+      "storage_export": "导出",
+      "storage_import": "导入",
+      "storage_warning": "备份包含 Fabric 凭据、私钥和已配网设备数据。请像密码一样妥善保管。导入会替换此控制器的 Matter 存储并短暂重启。",
+      "storage_import_confirm": "要用所选备份替换此控制器的 Matter Fabric 和已配网设备吗？",
+      "storage_import_ok": "Matter 备份已导入，控制器已重启。"
     }
   }
 }

package/nodes/locales/zh-CN/matterbridge-config.html

@@ -21,12 +21,16 @@
 2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
 3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
 
+二维码隐藏后如需添加其他控制器，请从一个已配对的控制器开启配对模式，然后在新控制器中添加 Matter 设备。仅在需要移除所有现有控制器并重新开始时使用**重置配对**。
+
 **重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
 
 ## 身份与存储
 
 桥接器身份与此配置节点绑定，保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署（即使更改端口或名称）**不**需要重新配对。只有删除此配置节点并新建一个才会改变身份——此时请从 Matter App 中移除旧桥接器并重新配对。
 
+使用 **导出** 下载此网桥实例的完整备份，其中包含 Fabric、私有凭据、会话和配对数据。**请像密码一样保护此文件。** 导入会替换此实例的存储并短暂重启网桥。网桥备份不能导入控制器。
+
 ## 说明
 
 - Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。

package/nodes/locales/zh-CN/matterbridge-config.json

@@ -16,7 +16,10 @@
       "deploy_first": "请先部署此配置节点，然后点击刷新。",
       "reset_button": "重置配对",
       "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
-      "reset_ok": "配对已重置。桥接器重新进入配对模式。"
+      "reset_ok": "配对已重置。桥接器重新进入配对模式。",
+      "storage_title": "Fabric 和配网备份", "storage_export": "导出", "storage_import": "导入",
+      "storage_warning": "备份包含 Fabric 凭据、私钥和配对数据。请像密码一样妥善保管。导入会替换此网桥的 Matter 存储并短暂重启。",
+      "storage_import_confirm": "要用所选备份替换此网桥的 Matter Fabric 和已配对控制器吗？", "storage_import_ok": "Matter 备份已导入，网桥已重启。"
     }
   }
 }

package/nodes/matter-config.html

@@ -3,6 +3,7 @@
 <script type="text/javascript">
     RED.nodes.registerType('matter-config', {
         category: 'config',
+        icon: 'node-matter-controller-icon.svg',
         defaults: {
             name: { value: "Matter Controller" },
             fabricLabel: { value: "KNX-Ultimate" }
@@ -20,6 +21,23 @@
             var $devicesBody = $("#matter-devices-body");
             var $refreshDevices = $("#matterRefreshDevices");
             var $pairSpinner = $("#matterPairSpinner");
+            var $storageExport = $('#matter-storage-export');
+            var $storageImport = $('#matter-storage-import');
+            var $storageFile = $('#matter-storage-file');
+
+            function storageExportUrl() {
+                var adminRoot = (RED.settings && typeof RED.settings.httpAdminRoot === 'string') ? RED.settings.httpAdminRoot : '/';
+                adminRoot = String(adminRoot || '/').trim();
+                adminRoot = adminRoot === '/' ? '' : '/' + adminRoot.replace(/^\/+|\/+$/g, '');
+                var params = new URLSearchParams();
+                params.set('serverId', node.id);
+                params.set('_', String(Date.now()));
+                try {
+                    var tokens = (RED.settings && typeof RED.settings.get === 'function') ? RED.settings.get('auth-tokens') : null;
+                    if (tokens && typeof tokens.access_token === 'string' && tokens.access_token.trim() !== '') params.set('access_token', tokens.access_token.trim());
+                } catch (error) { }
+                return adminRoot + '/KNXUltimateMatterStorageExport?' + params.toString();
+            }
 
             function notifyPairingError(msg) {
                 var text = RED._("node-red-contrib-knx-ultimate/matter-config:matter-config.properties.pairing_failed") + ': ' + (msg || '');
@@ -148,6 +166,32 @@
             });
 
             loadDevices();
+
+            $storageExport.on('click', function () {
+                window.location = storageExportUrl();
+            });
+            $storageImport.on('click', function () { $storageFile.trigger('click'); });
+            $storageFile.on('change', function () {
+                var file = this.files && this.files[0];
+                this.value = '';
+                if (!file || !window.confirm(RED._('node-red-contrib-knx-ultimate/matter-config:matter-config.properties.storage_import_confirm'))) return;
+                var reader = new FileReader();
+                reader.onload = function () {
+                    var backup;
+                    try { backup = JSON.parse(reader.result); } catch (error) { RED.notify(error.message, { type: 'error' }); return; }
+                    $storageImport.prop('disabled', true);
+                    $.ajax({
+                        url: 'KNXUltimateMatterStorageImport?serverId=' + encodeURIComponent(node.id),
+                        method: 'POST', contentType: 'application/json', data: JSON.stringify(backup)
+                    }).done(function () {
+                        RED.notify(RED._('node-red-contrib-knx-ultimate/matter-config:matter-config.properties.storage_import_ok'), { type: 'success' });
+                        loadDevices();
+                    }).fail(function (xhr) {
+                        RED.notify((xhr.responseJSON && xhr.responseJSON.error) || xhr.statusText, { type: 'error', fixed: true });
+                    }).always(function () { $storageImport.prop('disabled', false); });
+                };
+                reader.readAsText(file);
+            });
         },
         oneditsave: function () {
             // Return to the info tab
@@ -167,7 +211,6 @@
   </div>
 
   <div class="form-row">
-    <b><span data-i18n="matter-config.properties.title"></span></b>
     <p align="center" style="margin:8px 0;">
       <svg width="70" height="77" viewBox="0 8 40 44" xmlns="http://www.w3.org/2000/svg" aria-label="Matter" style="vertical-align:middle;">
         <g fill="currentColor" stroke="none">
@@ -187,9 +230,8 @@
         </g>
       </svg>
       <br/>
-      <span style="font-size:18px; font-weight:600; letter-spacing:1px;">matter</span>
+      <span style="font-size:18px; font-weight:600; letter-spacing:1px;" data-i18n="matter-config.properties.title"></span>
     </p>
-    <p><span data-i18n="matter-config.properties.intro"></span></p>
   </div>
 
   <div class="form-row">
@@ -210,9 +252,17 @@
 
   <hr/>
 
+  <div class="form-row">
+    <b><i class="fa fa-database"></i>&nbsp;<span data-i18n="matter-config.properties.storage_title"></span></b>
+    <button type="button" id="matter-storage-export" class="red-ui-button" style="margin-left:8px;"><i class="fa fa-download"></i>&nbsp;<span data-i18n="matter-config.properties.storage_export"></span></button>
+    <button type="button" id="matter-storage-import" class="red-ui-button"><i class="fa fa-upload"></i>&nbsp;<span data-i18n="matter-config.properties.storage_import"></span></button>
+    <input type="file" id="matter-storage-file" accept="application/json,.json" style="display:none;">
+  </div>
+
+  <hr/>
+
   <div class="form-row">
     <b><i class="fa fa-qrcode"></i>&nbsp;<span data-i18n="matter-config.properties.pairing_title"></span></b>
-    <p><span data-i18n="matter-config.properties.pairing_help"></span></p>
   </div>
 
   <div class="form-row">
@@ -236,15 +286,6 @@
     </label>
     <input type="text" id="matter-pairing-name" placeholder="Kitchen plug" style="width:250px;">
   </div>
-  <div class="form-tips" style="margin: 4px 0 8px; font-size:12px;">
-    <i class="fa fa-circle-info" style="color:#1b7d33; margin-right:4px;"></i>
-    <span data-i18n="matter-config.properties.pairing_hint">Prefer the QR code (MT:…): it carries the full device discriminator. The manual code
-    stores only a short discriminator and cannot reliably tell identical devices apart
-    (e.g. several Shelly of the same model), which can pair the wrong one or report it as
-    already commissioned. Pair one device at a time; if a device is already paired
-    elsewhere, factory-reset it first.</span>
-  </div>
-
   <hr/>
 
   <div class="form-row">
@@ -270,9 +311,9 @@
   </div>
 
   <br/>
-   <br/>
-    <br/>
-    <br/>
-   <br/>
-    <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
 </script>

package/nodes/matter-config.js

@@ -1,5 +1,8 @@
 /* eslint-disable max-len */
 const path = require('path')
+const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
+const matterPackageVersion = require('@matter/main').version
+const { Specification } = require('@matter/model')
 
 // 10/09/2024 Setup the color logger
 const loggerSetup = (options) => {
@@ -18,6 +21,7 @@ module.exports = (RED) => {
     node.sysLogger = null
     node.matterManager = null
     node.timerMatterConfigCheckState = null
+    node.storageOperation = null
     try {
       node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matter-config.js' })
     } catch (error) { console.log(error.stack) }
@@ -190,6 +194,35 @@ module.exports = (RED) => {
       if (node.matterManager === null) throw new Error('Matter controller not started')
       return node.matterManager.renameNode(_nodeId, _label)
     }
+
+    const withStoppedController = async (operation) => {
+      if (node.storageOperation !== null) throw new Error('Another Matter storage operation is already running')
+      node.storageOperation = (async () => {
+        if (node.matterManager !== null) await node.matterManager.close()
+        node.matterManager = null
+        try {
+          return await operation()
+        } finally {
+          await node.initMatterConnection()
+        }
+      })()
+      try { return await node.storageOperation } finally { node.storageOperation = null }
+    }
+
+    node.exportMatterStorage = () => withStoppedController(() => exportMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'controller',
+      protocolVersion: Specification.REVISION,
+      packageVersion: matterPackageVersion
+    }))
+
+    node.importMatterStorage = (backup) => withStoppedController(() => importMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'controller',
+      backup
+    }))
     // END functions called from the nodes -------------------------------------------------------------
 
     node.addClient = (_Node) => {

package/nodes/matterbridge-config.html

@@ -3,6 +3,7 @@
 <script type="text/javascript">
     RED.nodes.registerType('matterbridge-config', {
         category: 'config',
+        icon: 'node-matter-bridge-icon.svg',
         defaults: {
             name: { value: '' },
             bridgeDeviceName: { value: '' },
@@ -15,6 +16,21 @@
             var $pairingBody = $('#mbc-pairing-body');
             var $refreshPairing = $('#mbc-refresh-pairing');
             var $resetButton = $('#mbc-factory-reset');
+            var $storageFile = $('#mbc-storage-file');
+
+            function storageExportUrl() {
+                var adminRoot = (RED.settings && typeof RED.settings.httpAdminRoot === 'string') ? RED.settings.httpAdminRoot : '/';
+                adminRoot = String(adminRoot || '/').trim();
+                adminRoot = adminRoot === '/' ? '' : '/' + adminRoot.replace(/^\/+|\/+$/g, '');
+                var params = new URLSearchParams();
+                params.set('configId', node.id);
+                params.set('_', String(Date.now()));
+                try {
+                    var tokens = (RED.settings && typeof RED.settings.get === 'function') ? RED.settings.get('auth-tokens') : null;
+                    if (tokens && typeof tokens.access_token === 'string' && tokens.access_token.trim() !== '') params.set('access_token', tokens.access_token.trim());
+                } catch (error) { }
+                return adminRoot + '/KNXUltimateMatterBridgeStorageExport?' + params.toString();
+            }
 
             var t = function (key) {
                 return RED._('node-red-contrib-knx-ultimate/matterbridge-config:matterbridge-config.properties.' + key);
@@ -37,7 +53,6 @@
                         info.fabrics.forEach(function (f) {
                             $pairingBody.append($('<div style="margin-left:10px;"></div>').text('• ' + (f.label || 'Controller') + ' (vendor ' + f.vendorId + ')'));
                         });
-                        $pairingBody.append($('<p style="max-width:760px; margin:14px auto 0; color:#777;"></p>').text(t('commissioned_hint')));
                         $resetButton.show();
                         return;
                     }
@@ -69,6 +84,26 @@
                     loadPairingInfo();
                 }).always(function () { $resetButton.prop('disabled', false); });
             });
+            $('#mbc-storage-export').on('click', function () {
+                window.location = storageExportUrl();
+            });
+            $('#mbc-storage-import').on('click', function () { $storageFile.trigger('click'); });
+            $storageFile.on('change', function () {
+                var file = this.files && this.files[0];
+                this.value = '';
+                if (!file || !window.confirm(t('storage_import_confirm'))) return;
+                var reader = new FileReader();
+                reader.onload = function () {
+                    var backup;
+                    try { backup = JSON.parse(reader.result); } catch (error) { RED.notify(error.message, { type: 'error' }); return; }
+                    $('#mbc-storage-import').prop('disabled', true);
+                    $.ajax({ url: 'KNXUltimateMatterBridgeStorageImport?configId=' + encodeURIComponent(node.id), method: 'POST', contentType: 'application/json', data: JSON.stringify(backup) })
+                        .done(function () { RED.notify(t('storage_import_ok'), { type: 'success' }); loadPairingInfo(); })
+                        .fail(function (xhr) { RED.notify((xhr.responseJSON && xhr.responseJSON.error) || xhr.statusText, { type: 'error', fixed: true }); })
+                        .always(function () { $('#mbc-storage-import').prop('disabled', false); });
+                };
+                reader.readAsText(file);
+            });
 
             loadPairingInfo();
         },
@@ -87,8 +122,27 @@
   </div>
 
   <div class="form-row">
-    <b><span data-i18n="matterbridge-config.properties.title"></span></b>
-    <p><span data-i18n="matterbridge-config.properties.intro"></span></p>
+    <p align="center" style="margin:8px 0;">
+      <svg width="70" height="77" viewBox="0 8 40 44" xmlns="http://www.w3.org/2000/svg" aria-label="Matter" style="vertical-align:middle;">
+        <g fill="currentColor" stroke="none">
+          <circle cx="20" cy="30" r="4.5"/>
+          <g>
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+          <g transform="rotate(120 20 30)">
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+          <g transform="rotate(240 20 30)">
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+        </g>
+      </svg>
+      <br/>
+      <span style="font-size:18px; font-weight:600; letter-spacing:1px;" data-i18n="matterbridge-config.properties.title"></span>
+    </p>
   </div>
 
   <div class="form-row">
@@ -109,6 +163,15 @@
 
   <hr/>
 
+  <div class="form-row">
+    <b><i class="fa fa-database"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_title"></span></b>
+    <button type="button" id="mbc-storage-export" class="red-ui-button" style="margin-left:8px;"><i class="fa fa-download"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_export"></span></button>
+    <button type="button" id="mbc-storage-import" class="red-ui-button"><i class="fa fa-upload"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_import"></span></button>
+    <input type="file" id="mbc-storage-file" accept="application/json,.json" style="display:none;">
+  </div>
+
+  <hr/>
+
   <div class="form-row">
     <b><i class="fa fa-qrcode"></i>&nbsp;<span data-i18n="matterbridge-config.properties.pairing_title"></span></b>
     <button type="button" id="mbc-refresh-pairing" class="red-ui-button" style="margin-left:6px; color:#1b7d33; border-color:#1b7d33;">
@@ -119,4 +182,11 @@
     </button>
   </div>
   <div class="form-row" id="mbc-pairing-body" style="text-align:center;"></div>
+
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
 </script>

package/nodes/matterbridge-config.js

@@ -1,5 +1,8 @@
 /* eslint-disable max-len */
 const path = require('path')
+const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
+const matterPackageVersion = require('@matter/main').version
+const { Specification } = require('@matter/model')
 
 // 10/09/2024 Setup the color logger
 const loggerSetup = (options) => {
@@ -39,6 +42,7 @@ module.exports = (RED) => {
     let startupTimer = null
     let reconcileTimer = null
     let closing = false
+    let storageOperation = null
 
     Object.defineProperty(node, 'linkStatus', {
       get: function () {
@@ -193,6 +197,40 @@ module.exports = (RED) => {
       await node.matterBridge.factoryReset()
       notifyClientsStatus()
     }
+
+    const withStoppedBridge = async (operation) => {
+      if (storageOperation !== null) throw new Error('Another Matter storage operation is already running')
+      storageOperation = (async () => {
+        const engine = node.matterBridge
+        if (engine !== null) {
+          engine.removeAllListeners()
+          await engine.close()
+          runningBridges.delete(node.id)
+          node.matterBridge = null
+        }
+        try {
+          return await operation()
+        } finally {
+          await ensureEngineStarted()
+        }
+      })()
+      try { return await storageOperation } finally { storageOperation = null }
+    }
+
+    node.exportMatterStorage = () => withStoppedBridge(() => exportMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'bridge',
+      protocolVersion: Specification.REVISION,
+      packageVersion: matterPackageVersion
+    }))
+
+    node.importMatterStorage = (backup) => withStoppedBridge(() => importMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'bridge',
+      backup
+    }))
     // END functions called from the device nodes -------------------------------------
 
     node.on('close', (removed, done) => {