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

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # CHANGELOG
 
+**Version 6.0.4** - July 2026<br/>
+
+- **Expose KNX to Matter (BETA) — clearer editor layout**: reorganized the device editor into dedicated **KNX mappings** and **Advanced options** tabs, following the established KNXUltimate node UI. Type-specific compatibility settings are easier to find, and checkbox labels now include icons with the checkbox positioned after the text. All saved fields and runtime behavior remain unchanged.<br/>
+
 **Version 6.0.3** - July 2026<br/>
 
 - **Expose KNX to Matter (BETA) — Alexa cover percentage workaround**: covers/shutters can optionally be exposed to Matter controllers as dimmable lights when Alexa does not send percentage commands to a native Window Covering endpoint. Brightness represents openness (`100%` open, `0%` closed), while On/Off opens or closes the cover. Commands and status remain mapped through the existing KNX cover position GA/DPT, including position inversion and loop-protected KNX-to-Matter feedback. The standard Matter Window Covering endpoint remains the default.<br/>

package/nodes/knxUltimateMatterBridge.html

@@ -105,6 +105,9 @@
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
 
+        // Use the same jQuery UI tab structure as the main KNXUltimate node.
+        $('#mb-tabs').tabs();
+
         // Resolves the KNX gateway at query time: the selected one, or - as a
         // fallback - the first knxUltimate-config available, so the GA list works
         // even before the user picks the gateway on this device node.
@@ -143,7 +146,7 @@
         // on one or more rows (same pattern used across the rest of the KNX-Ultimate nodes).
         const $fields = $('#mb-ga-fields').css({ display: 'flex', flexWrap: 'wrap', alignItems: 'flex-end', gap: '10px' });
         const $invertRow = $('#mb-invert-row');
-        const $advancedRows = $('#mb-advanced-details');
+        const $advancedRows = $('#mb-compatibility-options');
         const $dimmerAdvancedRows = $('.mb-dimmer-advanced-row');
         const $coverAdvancedRows = $('.mb-cover-advanced-row');
         const gaInputs = {};
@@ -311,90 +314,101 @@
     <select id="node-input-deviceType" style="width:260px;"></select>
   </div>
 
-  <div class="form-tips" style="display:block; width:100%; max-width:none; box-sizing:border-box; margin-bottom:8px; border-left:4px solid #d9822b;">
-    <i class="fa fa-triangle-exclamation"></i>
-    <span data-i18n="knxUltimateMatterBridge.type_change_warning"></span>
-  </div>
-
-  <div id="mb-ga-fields"></div>
-
-  <div class="form-row" id="mb-invert-row" style="display:none;">
-    <label for="node-input-invertPosition" style="width:auto;">
-      <input type="checkbox" id="node-input-invertPosition" style="width:auto; display:inline-block; vertical-align:middle;">
-      <span data-i18n="knxUltimateMatterBridge.fields.invert"></span>
-    </label>
-  </div>
-
-  <details id="mb-advanced-details" style="margin:10px 0 8px 0; display:none;">
-    <summary style="cursor:pointer;">
-      <i class="fa fa-sliders"></i>
-      <b><span data-i18n="knxUltimateMatterBridge.advanced.title"></span></b>
-      <span data-i18n="knxUltimateMatterBridge.advanced.help"></span>
-    </summary>
-
-    <div class="form-row mb-dimmer-advanced-row" style="display:none; margin-top:8px;">
-      <label for="node-input-turnOnBehavior" style="width:260px;">
-        <i class="fa fa-lightbulb-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.turn_on_behavior"></span>
-      </label>
-      <select id="node-input-turnOnBehavior" style="width:280px;">
-        <option value="ignoreLevelAfterOn" data-i18n="knxUltimateMatterBridge.advanced.turn_on_ignore_level"></option>
-        <option value="forwardAll" data-i18n="knxUltimateMatterBridge.advanced.turn_on_forward_all"></option>
-      </select>
-    </div>
-
-    <div class="form-row mb-dimmer-advanced-row" style="display:none;">
-      <label for="node-input-ignoreLevelAfterOnMs" style="width:260px;">
-        <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.ignore_level_ms"></span>
-      </label>
-      <input type="number" id="node-input-ignoreLevelAfterOnMs" min="0" step="100" style="width:120px;">
-    </div>
-
-    <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
-      <label for="node-input-coverExposeAsDimmableLight" style="width:auto;">
-        <input type="checkbox" id="node-input-coverExposeAsDimmableLight" style="width:auto; display:inline-block; vertical-align:middle;">
-        <span data-i18n="knxUltimateMatterBridge.advanced.cover_expose_as_light"></span>
-      </label>
-      <div class="form-tips" style="margin-top:5px;" data-i18n="knxUltimateMatterBridge.advanced.cover_expose_as_light_help"></div>
+  <div id="mb-tabs" style="margin-top:12px;">
+    <ul>
+      <li><a href="#mb-tab-mappings"><i class="fa fa-exchange"></i> <span data-i18n="knxUltimateMatterBridge.tabs.mappings"></span></a></li>
+      <li><a href="#mb-tab-advanced"><i class="fa fa-sliders"></i> <span data-i18n="knxUltimateMatterBridge.tabs.advanced"></span></a></li>
+    </ul>
+
+    <div id="mb-tab-mappings" style="padding-top:12px;">
+      <div class="form-tips" style="display:block; width:100%; max-width:none; box-sizing:border-box; margin-bottom:12px; border-left:4px solid #d9822b;">
+        <i class="fa fa-triangle-exclamation"></i>
+        <span data-i18n="knxUltimateMatterBridge.type_change_warning"></span>
+      </div>
+
+      <div id="mb-ga-fields"></div>
+
+      <div class="form-row" id="mb-invert-row" style="display:none;">
+        <label for="node-input-invertPosition" style="width:auto;">
+          <i class="fa fa-exchange"></i>
+          <span data-i18n="knxUltimateMatterBridge.fields.invert"></span>
+          <input type="checkbox" id="node-input-invertPosition" style="width:auto; display:inline-block; vertical-align:middle; margin-left:6px;">
+        </label>
+      </div>
     </div>
 
-    <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
-      <label for="node-input-coverUpdateMode" style="width:260px;">
-        <i class="fa fa-window-maximize"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_update_mode"></span>
-      </label>
-      <select id="node-input-coverUpdateMode" style="width:280px;">
-        <option value="optimistic" data-i18n="knxUltimateMatterBridge.advanced.cover_optimistic"></option>
-        <option value="waitStatus" data-i18n="knxUltimateMatterBridge.advanced.cover_wait_status"></option>
-      </select>
+    <div id="mb-tab-advanced" style="padding-top:12px;">
+      <div id="mb-compatibility-options" style="display:none;">
+        <div class="form-tips" style="display:block; width:100%; max-width:none; box-sizing:border-box; margin-bottom:12px; border-left:4px solid #4b8cc4;">
+          <i class="fa fa-info-circle"></i>
+          <b data-i18n="knxUltimateMatterBridge.advanced.title"></b>
+          <span data-i18n="knxUltimateMatterBridge.advanced.help"></span>
+        </div>
+
+        <div class="form-row mb-dimmer-advanced-row" style="display:none; margin-top:8px;">
+          <label for="node-input-turnOnBehavior" style="width:260px;">
+            <i class="fa fa-lightbulb-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.turn_on_behavior"></span>
+          </label>
+          <select id="node-input-turnOnBehavior" style="width:280px;">
+            <option value="ignoreLevelAfterOn" data-i18n="knxUltimateMatterBridge.advanced.turn_on_ignore_level"></option>
+            <option value="forwardAll" data-i18n="knxUltimateMatterBridge.advanced.turn_on_forward_all"></option>
+          </select>
+        </div>
+
+        <div class="form-row mb-dimmer-advanced-row" style="display:none;">
+          <label for="node-input-ignoreLevelAfterOnMs" style="width:260px;">
+            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.ignore_level_ms"></span>
+          </label>
+          <input type="number" id="node-input-ignoreLevelAfterOnMs" min="0" step="100" style="width:120px;">
+        </div>
+
+        <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
+          <label for="node-input-coverExposeAsDimmableLight" style="width:auto;">
+            <i class="fa fa-lightbulb-o"></i>
+            <span data-i18n="knxUltimateMatterBridge.advanced.cover_expose_as_light"></span>
+            <input type="checkbox" id="node-input-coverExposeAsDimmableLight" style="width:auto; display:inline-block; vertical-align:middle; margin-left:6px;">
+          </label>
+          <div class="form-tips" style="margin-top:5px;" data-i18n="knxUltimateMatterBridge.advanced.cover_expose_as_light_help"></div>
+        </div>
+
+        <div class="form-row mb-cover-advanced-row" style="display:none; margin-top:8px;">
+          <label for="node-input-coverUpdateMode" style="width:260px;">
+            <i class="fa fa-window-maximize"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_update_mode"></span>
+          </label>
+          <select id="node-input-coverUpdateMode" style="width:280px;">
+            <option value="optimistic" data-i18n="knxUltimateMatterBridge.advanced.cover_optimistic"></option>
+            <option value="waitStatus" data-i18n="knxUltimateMatterBridge.advanced.cover_wait_status"></option>
+          </select>
+        </div>
+
+        <div class="form-row mb-cover-advanced-row" style="display:none;">
+          <label for="node-input-coverStatusTimeoutMs" style="width:260px;">
+            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_status_timeout"></span>
+          </label>
+          <input type="number" id="node-input-coverStatusTimeoutMs" min="0" step="500" style="width:120px;">
+        </div>
+      </div>
+
+      <div class="form-row">
+        <label for="node-input-readStatusAtStartup" style="width:260px;">
+          <i class="fa fa-question-circle"></i> <span data-i18n="knxUltimateMatterBridge.read_status_startup"></span>
+        </label>
+        <select id="node-input-readStatusAtStartup" style="width:120px;">
+          <option value="yes" data-i18n="knxUltimateMatterBridge.opt_yes"></option>
+          <option value="no" data-i18n="knxUltimateMatterBridge.opt_no"></option>
+        </select>
+      </div>
+
+      <div class="form-row">
+        <label for="node-input-enableNodePINS" style="width:260px;">
+          <i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.node_pins"></span>
+        </label>
+        <select id="node-input-enableNodePINS" style="width:220px;">
+          <option value="no" data-i18n="knxUltimateMatterBridge.node_pins_hide"></option>
+          <option value="yes" data-i18n="knxUltimateMatterBridge.node_pins_show"></option>
+        </select>
+      </div>
     </div>
-
-    <div class="form-row mb-cover-advanced-row" style="display:none;">
-      <label for="node-input-coverStatusTimeoutMs" style="width:260px;">
-        <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_status_timeout"></span>
-      </label>
-      <input type="number" id="node-input-coverStatusTimeoutMs" min="0" step="500" style="width:120px;">
-    </div>
-  </details>
-
-  <hr/>
-
-  <div class="form-row">
-    <label for="node-input-readStatusAtStartup" style="width:260px;">
-      <i class="fa fa-question-circle"></i> <span data-i18n="knxUltimateMatterBridge.read_status_startup"></span>
-    </label>
-    <select id="node-input-readStatusAtStartup" style="width:120px;">
-      <option value="yes" data-i18n="knxUltimateMatterBridge.opt_yes"></option>
-      <option value="no" data-i18n="knxUltimateMatterBridge.opt_no"></option>
-    </select>
-  </div>
-
-  <div class="form-row">
-    <label for="node-input-enableNodePINS" style="width:260px;">
-      <i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.node_pins"></span>
-    </label>
-    <select id="node-input-enableNodePINS" style="width:220px;">
-      <option value="no" data-i18n="knxUltimateMatterBridge.node_pins_hide"></option>
-      <option value="yes" data-i18n="knxUltimateMatterBridge.node_pins_show"></option>
-    </select>
   </div>
 
   <br/>

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -17,7 +17,7 @@
       "name_placeholder": "z.B. Küchenlicht",
       "invert": "Position % invertieren"
     },
-    "advanced": {
+  "advanced": {
       "title": "Erweiterte Kompatibilität",
       "help": " Verwende diese Optionen nur, wenn ein Matter-Controller oder ein KNX-Aktor eine besondere Behandlung benötigt.",
       "turn_on_behavior": "Einschaltverhalten",
@@ -29,8 +29,12 @@
       "cover_update_mode": "Jalousie-/Rollladenstatus",
       "cover_optimistic": "Matter-Position optimistisch aktualisieren",
       "cover_wait_status": "Nur auf KNX-Status warten",
-      "cover_status_timeout": "Timeout für Positionsstatus (ms)"
-    },
+    "cover_status_timeout": "Timeout für Positionsstatus (ms)"
+  },
+  "tabs": {
+    "mappings": "KNX-Zuordnungen",
+    "advanced": "Erweiterte Optionen"
+  },
     "functions": {
       "fn_onoff_cmd": "Ein/Aus Befehls-GA",
       "fn_onoff_status": "Ein/Aus Status-GA",

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -17,7 +17,7 @@
       "name_placeholder": "e.g. Kitchen light",
       "invert": "Invert position %"
     },
-    "advanced": {
+  "advanced": {
       "title": "Advanced compatibility",
       "help": " Use these options only when a Matter controller or a KNX actuator needs special handling.",
       "turn_on_behavior": "Turn-on behavior",
@@ -29,8 +29,12 @@
       "cover_update_mode": "Cover state update",
       "cover_optimistic": "Optimistically update Matter position",
       "cover_wait_status": "Wait for KNX status only",
-      "cover_status_timeout": "Cover status timeout (ms)"
-    },
+    "cover_status_timeout": "Cover status timeout (ms)"
+  },
+  "tabs": {
+    "mappings": "KNX mappings",
+    "advanced": "Advanced options"
+  },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -17,7 +17,7 @@
       "name_placeholder": "p.ej. Luz cocina",
       "invert": "Invertir posición %"
     },
-    "advanced": {
+  "advanced": {
       "title": "Compatibilidad avanzada",
       "help": " Usa estas opciones solo cuando un controlador Matter o un actuador KNX necesite un tratamiento especial.",
       "turn_on_behavior": "Comportamiento al encender",
@@ -29,8 +29,12 @@
       "cover_update_mode": "Actualización de estado de persiana",
       "cover_optimistic": "Actualizar la posición Matter de forma optimista",
       "cover_wait_status": "Esperar solo el estado KNX",
-      "cover_status_timeout": "Timeout estado persiana (ms)"
-    },
+    "cover_status_timeout": "Timeout estado persiana (ms)"
+  },
+  "tabs": {
+    "mappings": "Asignaciones KNX",
+    "advanced": "Opciones avanzadas"
+  },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA estado On/Off",

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -17,7 +17,7 @@
       "name_placeholder": "ex. Lumière cuisine",
       "invert": "Inverser la position %"
     },
-    "advanced": {
+  "advanced": {
       "title": "Compatibilité avancée",
       "help": " Utilisez ces options seulement lorsqu'un contrôleur Matter ou un actionneur KNX demande un traitement spécial.",
       "turn_on_behavior": "Comportement à l'allumage",
@@ -29,8 +29,12 @@
       "cover_update_mode": "Mise à jour état volet",
       "cover_optimistic": "Mettre à jour la position Matter de façon optimiste",
       "cover_wait_status": "Attendre seulement l'état KNX",
-      "cover_status_timeout": "Timeout état volet (ms)"
-    },
+    "cover_status_timeout": "Timeout état volet (ms)"
+  },
+  "tabs": {
+    "mappings": "Mappages KNX",
+    "advanced": "Options avancées"
+  },
     "functions": {
       "fn_onoff_cmd": "GA commande On/Off",
       "fn_onoff_status": "GA état On/Off",

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -17,7 +17,7 @@
       "name_placeholder": "es. Luce cucina",
       "invert": "Inverti posizione %"
     },
-    "advanced": {
+  "advanced": {
       "title": "Compatibilità avanzata",
       "help": " Usa queste opzioni solo quando un controller Matter o un attuatore KNX richiede una gestione speciale.",
       "turn_on_behavior": "Comportamento all'accensione",
@@ -29,8 +29,12 @@
       "cover_update_mode": "Aggiornamento stato tapparella",
       "cover_optimistic": "Aggiorna ottimisticamente la posizione Matter",
       "cover_wait_status": "Attendi solo lo stato KNX",
-      "cover_status_timeout": "Timeout stato tapparella (ms)"
-    },
+    "cover_status_timeout": "Timeout stato tapparella (ms)"
+  },
+  "tabs": {
+    "mappings": "Mappature KNX",
+    "advanced": "Opzioni avanzate"
+  },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",

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

@@ -17,7 +17,7 @@
       "name_placeholder": "例如 厨房灯",
       "invert": "反转位置 %"
     },
-    "advanced": {
+  "advanced": {
       "title": "高级兼容性",
       "help": " 仅当 Matter 控制器或 KNX 执行器需要特殊处理时使用这些选项。",
       "turn_on_behavior": "开灯行为",
@@ -29,8 +29,12 @@
       "cover_update_mode": "窗帘状态更新",
       "cover_optimistic": "乐观更新 Matter 位置",
       "cover_wait_status": "仅等待 KNX 状态",
-      "cover_status_timeout": "窗帘状态超时 (ms)"
-    },
+    "cover_status_timeout": "窗帘状态超时 (ms)"
+  },
+  "tabs": {
+    "mappings": "KNX 映射",
+    "advanced": "高级选项"
+  },
     "functions": {
       "fn_onoff_cmd": "开/关 命令 GA",
       "fn_onoff_status": "开/关 状态 GA",

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.0.3",
+  "version": "6.0.4",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",