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

package/CHANGELOG.md

@@ -6,6 +6,22 @@
 
 # CHANGELOG
 
+**Version 6.0.5** - July 2026<br/>
+
+- **Expose KNX to Matter (BETA) — dedup for duplicate Alexa light commands**: same Alexa quirk as the covers below, on lights: a single "turn on" / "set to 50%" voice request could arrive as up to two *identical* cluster commands (two `On`, or `MoveToLevelWithOnOff` + `MoveToLevel` with the same level), making the node emit duplicate raw msgs on `OnOffLightDevice`/`DimmableLightDevice` ([discussion #516](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/discussions/516)). A short leading-edge dedup now forwards the first command immediately (no added latency — lights react instantly) and drops only a command identical to the one just emitted for the same function within the window; any change of value (a real On→Off, or a different brightness) always passes through at once, so genuine commands are never swallowed. The window is exposed in the node's **Advanced** tab as *Alexa duplicate-command window* (default 1.2s, **0 = disabled/raw**), the same approach the Home Assistant Matter Hub adopted for this Alexa behavior. The complementary *ignore brightness after On* option (already present) covers Alexa's other habit of sending a brightness right after On.<br/>
+- **Expose KNX to Matter (BETA) — Home Assistant Matter Hub-style cover compatibility**: `WindowCovering` now exposes **Swap Open / Close** and **Cover slider debounce** in the Advanced tab. Swap reverses the binary KNX Up/Down command and percentage direction symmetrically for Alexa installations that interpret them backwards. Debounce collapses rapid `GoToLiftPercentage` targets into the last KNX command; `0` uses the adaptive Home Assistant Matter Hub windows (400ms first command / 150ms subsequent commands), while `1`–`5000` selects a fixed per-cover window. `StopMotion` remains immediate and cancels every pending movement. Help HTML and Matter Bridge docs were updated in EN/IT/DE/FR/ES/zh-CN.<br/>
+- **Expose KNX to Matter (BETA) — cover "arrived" safety net**: in *Wait for KNX status* mode, if no KNX status telegram confirms the exact requested position within a generous window (45s), the node now falls back to reflecting the requested position to Matter anyway. Without this, a real actuator that never reports back the *exact* requested percentage (positioning tolerance/drift) could leave the Matter device reporting "still moving" forever, since matter.js only clears `OperationalStatus` on an exact match.<br/>
+- **Expose KNX to Matter (BETA) — raw color commands**: RGB and tunable-white lights now capture color commands at the same "raw" command boundary already used for On/Off, dimming and covers - a repeated color command (e.g. the same color sent twice) is forwarded on the node's optional output PIN every time, not just on the first. Only possible for ColorControl because it is command-based (`MoveToHue`, `MoveToSaturation`, `MoveToHueAndSaturation`, `MoveToColor`, `MoveToColorTemperature`); Thermostat setpoints and Fan speed remain attribute-write only in the Matter spec, so they still report only on actual value changes - there is no lower-level hook matter.js exposes for those.<br/>
+- **Expose KNX to Matter (BETA) — fixed WindowCovering percentage commands**: `GoToLiftPercentage` commands (e.g. "Alexa, set the cover to 50%") were being misread as plain Open/Close commands, discarding the requested percentage. matter.js always resolves the command's `direction` parameter to a concrete Open/Close before calling our handler — it is not a usable signal — while `targetPercent100ths` is always populated. The node now classifies purely on the target position (0/10000 → Up/Down GA, anything else → Position GA), fixing intermediate cover positions from any Matter controller. Thanks to [@till69](https://github.com/till69) for tracing this down in [discussion #516](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/discussions/516).<br/>
+- **Expose KNX to Matter (BETA) — removed the "Expose as dimmable light" Alexa workaround**: now that the actual cause of Alexa's broken cover percentages is fixed (see above), the v6.0.3 workaround that exposed covers as dimmable lights is no longer needed and has been removed, including its editor checkbox. **Breaking for the small number of BETA users who enabled it**: existing flows with the option turned on simply revert to a normal Matter Window Covering device on next deploy - you may need to remove/re-add the accessory in your controller's app.<br/>
+- **Expose KNX to Matter (BETA) — heating/cooling thermostats**: the bridged Thermostat can now expose a **Cooling setpoint** in addition to the existing heating one. Add a *Cooling setpoint command/status GA* on the device to automatically upgrade the Matter endpoint to a dual-mode (Heat/Cool) thermostat; leaving it empty keeps the previous heating-only behavior unchanged. Mode (Heat/Cool) switches from the controller are accepted but not yet mirrored back to KNX.<br/>
+- **Expose KNX to Matter (BETA) — stable per-device identity**: bridged devices now also set the optional `UniqueID` of `BridgedDeviceBasicInformation` (matching the existing serial number), improving cross-reset device identity for controllers that rely on it (e.g. Apple Home) alongside the endpoint number.<br/>
+- **Matter Bridge/Controller — safer shared storage initialization**: the `storage.path` write on the process-wide matter.js `Environment.default`, followed by the `ServerNode`/`CommissioningController` creation, is now serialized through a small FIFO lock (`matterEnvironmentLock.mjs`) shared by both engines, removing a theoretical race between a concurrently starting Matter Bridge and Matter Controller.<br/>
+
+**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

@@ -50,7 +50,9 @@
       thermostat: [
         { key: 'CurrentTemp', labelKey: 'fn_currenttemp', dptPrefix: '9.', fallbackDpt: '9.001' },
         { key: 'Setpoint', labelKey: 'fn_setpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
-        { key: 'SetpointStatus', labelKey: 'fn_setpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' }
+        { key: 'SetpointStatus', labelKey: 'fn_setpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' }
       ],
       smokecoalarm: [
         { key: 'Smoke', labelKey: 'fn_smoke_ga', dptPrefix: '1.', fallbackDpt: '1.005' },
@@ -75,7 +77,9 @@
       name: { value: '' },
       deviceType: { value: 'onofflight' },
       invertPosition: { value: false },
-      coverExposeAsDimmableLight: { value: false },
+      coverSwapOpenClose: { value: false },
+      coverSliderDebounceMs: { value: 0 },
+      commandDedupMs: { value: 1200 },
       turnOnBehavior: { value: 'ignoreLevelAfterOn' },
       ignoreLevelAfterOnMs: { value: 800 },
       coverUpdateMode: { value: 'optimistic' },
@@ -105,6 +109,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 +150,8 @@
         // 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 $commandAdvancedRows = $('.mb-command-advanced-row');
         const $dimmerAdvancedRows = $('.mb-dimmer-advanced-row');
         const $coverAdvancedRows = $('.mb-cover-advanced-row');
         const gaInputs = {};
@@ -217,7 +225,11 @@
           $invertRow.toggle(selected === 'windowcovering');
           const hasLevel = selected === 'dimmablelight' || selected === 'rgblight' || selected === 'colortemperaturelight';
           const isCover = selected === 'windowcovering';
-          $advancedRows.toggle(hasLevel || isCover);
+          // The Alexa duplicate-command dedup applies to any device that emits On/Off or
+          // level commands (plain on/off lights and plugs included), not just dimmers.
+          const hasCommand = selected === 'onofflight' || selected === 'onoffplug' || hasLevel;
+          $advancedRows.toggle(hasCommand || isCover);
+          $commandAdvancedRows.toggle(hasCommand);
           $dimmerAdvancedRows.toggle(hasLevel);
           $coverAdvancedRows.toggle(isCover);
         }
@@ -229,7 +241,9 @@
         node._matterGaInputs = gaInputs;
 
         $('#node-input-invertPosition').prop('checked', node.invertPosition === true);
-        $('#node-input-coverExposeAsDimmableLight').prop('checked', node.coverExposeAsDimmableLight === true);
+        $('#node-input-coverSwapOpenClose').prop('checked', node.coverSwapOpenClose === true);
+        $('#node-input-coverSliderDebounceMs').val(node.coverSliderDebounceMs === undefined ? 0 : node.coverSliderDebounceMs);
+        $('#node-input-commandDedupMs').val(node.commandDedupMs === undefined ? 1200 : node.commandDedupMs);
         $('#node-input-turnOnBehavior').val(node.turnOnBehavior || 'ignoreLevelAfterOn');
         $('#node-input-ignoreLevelAfterOnMs').val(node.ignoreLevelAfterOnMs === undefined ? 800 : node.ignoreLevelAfterOnMs);
         $('#node-input-coverUpdateMode').val(node.coverUpdateMode || 'optimistic');
@@ -243,7 +257,7 @@
         const selected = $('#node-input-deviceType').val();
         node.deviceType = selected;
         node.invertPosition = $('#node-input-invertPosition').is(':checked');
-        node.coverExposeAsDimmableLight = selected === 'windowcovering' && $('#node-input-coverExposeAsDimmableLight').is(':checked');
+        node.coverSwapOpenClose = $('#node-input-coverSwapOpenClose').is(':checked');
         const active = TYPE_FIELDS[selected] || [];
         const gaInputs = node._matterGaInputs || {};
         // Clear every GA/DPT, then write only the ones of the selected type, reading
@@ -261,6 +275,11 @@
           }
         });
         delete node._matterGaInputs;
+        // Keep an explicit 0 (dedup disabled); treat only an empty/invalid field as the default.
+        const dedupRaw = $('#node-input-commandDedupMs').val();
+        this.commandDedupMs = (dedupRaw === '' || dedupRaw === null || isNaN(Number(dedupRaw))) ? 1200 : Math.max(0, Number(dedupRaw));
+        const coverDebounceRaw = $('#node-input-coverSliderDebounceMs').val();
+        this.coverSliderDebounceMs = (coverDebounceRaw === '' || coverDebounceRaw === null || isNaN(Number(coverDebounceRaw))) ? 0 : Math.min(5000, Math.max(0, Number(coverDebounceRaw)));
         this.turnOnBehavior = $('#node-input-turnOnBehavior').val() || 'ignoreLevelAfterOn';
         this.ignoreLevelAfterOnMs = Number($('#node-input-ignoreLevelAfterOnMs').val()) || 0;
         this.coverUpdateMode = $('#node-input-coverUpdateMode').val() || 'optimistic';
@@ -311,90 +330,107 @@
     <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-row mb-command-advanced-row" style="display:none; margin-top:8px;">
+          <label for="node-input-commandDedupMs" style="width:260px;">
+            <i class="fa fa-clone"></i> <span data-i18n="knxUltimateMatterBridge.advanced.alexa_dedup_ms"></span>
+          </label>
+          <input type="number" id="node-input-commandDedupMs" min="0" step="100" style="width:120px;">
+        </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-coverSwapOpenClose" style="width:260px;">
+            <i class="fa fa-exchange"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_swap_open_close"></span>
+          </label>
+          <input type="checkbox" id="node-input-coverSwapOpenClose" style="width:auto; vertical-align:middle;">
+        </div>
+
+        <div class="form-row mb-cover-advanced-row" style="display:none;">
+          <label for="node-input-coverSliderDebounceMs" style="width:260px;">
+            <i class="fa fa-clock-o"></i> <span data-i18n="knxUltimateMatterBridge.advanced.cover_slider_debounce"></span>
+          </label>
+          <input type="number" id="node-input-coverSliderDebounceMs" min="0" max="5000" step="50" style="width:120px;">
+        </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/>
@@ -416,8 +452,9 @@ Point it to a **Matter Bridge** configuration node (the actual bridge, paired on
 The advanced compatibility options are intentionally type-specific:
 
 - dimmable devices can ignore the brightness command that some controllers send immediately after an On command
+- covers can swap Open/Close (including the percentage direction) for controllers such as Alexa that interpret them in reverse
+- cover slider debounce coalesces rapid intermediate targets before writing to KNX: `0` uses adaptive 400/150 ms windows, while `1`–`5000` forces a fixed window
 - covers can optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position
-- if Alexa cannot set a cover percentage, a cover can be exposed as a dimmable light: brightness means openness, while the configured KNX cover GAs and DPTs remain unchanged
 
 The **KNX gateway is optional**: without it, enable the node PINs and drive the device from the flow.
 

package/nodes/knxUltimateMatterBridge.js

@@ -51,7 +51,9 @@ module.exports = function (RED) {
     thermostat: [
       { fn: 'currenttemp', direction: 'status', ga: 'gaCurrentTemp', dpt: 'dptCurrentTemp', fallbackDpt: '9.001' },
       { fn: 'setpoint', direction: 'command', ga: 'gaSetpoint', dpt: 'dptSetpoint', fallbackDpt: '9.001' },
-      { fn: 'setpoint', direction: 'status', ga: 'gaSetpointStatus', dpt: 'dptSetpointStatus', fallbackDpt: '9.001' }
+      { fn: 'setpoint', direction: 'status', ga: 'gaSetpointStatus', dpt: 'dptSetpointStatus', fallbackDpt: '9.001' },
+      { fn: 'coolingsetpoint', direction: 'command', ga: 'gaCoolingSetpoint', dpt: 'dptCoolingSetpoint', fallbackDpt: '9.001' },
+      { fn: 'coolingsetpoint', direction: 'status', ga: 'gaCoolingSetpointStatus', dpt: 'dptCoolingSetpointStatus', fallbackDpt: '9.001' }
     ],
     smokecoalarm: [
       { fn: 'smoke', direction: 'status', ga: 'gaSmoke', dpt: 'dptSmoke', fallbackDpt: '1.005' },
@@ -77,10 +79,17 @@ module.exports = function (RED) {
     // The Matter device id is the (stable) Node-RED node id, so the endpoint survives re-deploys.
     node.matterDeviceId = node.id
     node.invertPosition = config.invertPosition === true || config.invertPosition === 'true'
-    node.coverExposeAsDimmableLight = config.coverExposeAsDimmableLight === true || config.coverExposeAsDimmableLight === 'true'
+    node.coverSwapOpenClose = config.coverSwapOpenClose === true || config.coverSwapOpenClose === 'true'
+    node.coverSliderDebounceMs = Number(config.coverSliderDebounceMs)
+    if (!Number.isFinite(node.coverSliderDebounceMs) || node.coverSliderDebounceMs < 0) node.coverSliderDebounceMs = 0
+    node.coverSliderDebounceMs = Math.min(5000, node.coverSliderDebounceMs)
     node.turnOnBehavior = config.turnOnBehavior || 'ignoreLevelAfterOn'
     node.ignoreLevelAfterOnMs = Number(config.ignoreLevelAfterOnMs)
     if (!Number.isFinite(node.ignoreLevelAfterOnMs) || node.ignoreLevelAfterOnMs < 0) node.ignoreLevelAfterOnMs = 800
+    // Alexa duplicate-command dedup window (ms). 0 disables it (raw forwarding);
+    // an empty/invalid value falls back to the 1200ms default. See the device factory.
+    node.commandDedupMs = Number(config.commandDedupMs)
+    if (!Number.isFinite(node.commandDedupMs) || node.commandDedupMs < 0) node.commandDedupMs = 1200
     node.coverUpdateMode = config.coverUpdateMode || 'optimistic'
     node.coverStatusTimeoutMs = Number(config.coverStatusTimeoutMs)
     if (!Number.isFinite(node.coverStatusTimeoutMs) || node.coverStatusTimeoutMs < 0) node.coverStatusTimeoutMs = 3000
@@ -110,6 +119,15 @@ module.exports = function (RED) {
     let initialReadTimer = null
     let suppressLevelCommandsUntil = 0
     let coverStatusTimer = null
+    let coverArrivalTimer = null
+    // Generous safety net, independent from the (short, configurable) coverStatusTimeoutMs
+    // warning below: real KNX cover actuators are not guaranteed to report back EXACTLY the
+    // requested percent100ths (positioning tolerance, drift...), and matter.js's
+    // WindowCoveringServer only clears OperationalStatus (Opening/Closing) back to Stopped
+    // once currentPosition === targetPosition exactly. Without this, a controller could show
+    // the cover as "still moving" forever after a movement that in reality completed close
+    // enough. Not (yet) user-configurable - ask if you want it exposed in the editor.
+    const COVER_ARRIVAL_FALLBACK_MS = Number(config.coverArrivalFallbackMs) > 0 ? Number(config.coverArrivalFallbackMs) : 45000
 
     const formatTs = (date) => {
       const d = date instanceof Date ? date : new Date(date)
@@ -157,6 +175,13 @@ module.exports = function (RED) {
       }
     }
 
+    const clearCoverArrivalTimer = () => {
+      if (coverArrivalTimer !== null) {
+        clearTimeout(coverArrivalTimer)
+        coverArrivalTimer = null
+      }
+    }
+
     // Precompute the routing tables for this single device:
     // statusRoutes: GA -> [{ fn, dpt }] (KNX -> Matter)
     // commandRoutes: fn -> { ga, dpt } (Matter -> KNX)
@@ -181,20 +206,42 @@ module.exports = function (RED) {
       return false
     }
 
-    const applyOptimisticCoverPosition = (command) => {
-      if (node.deviceType !== 'windowcovering' || node.coverUpdateMode !== 'optimistic' || !node.serverMatterBridge) return
-      let optimisticPosition
-      if (command.fn === 'position') optimisticPosition = command.value
-      if (command.fn === 'updown') optimisticPosition = command.value === true ? 100 : 0
-      if (optimisticPosition === undefined) return
-      node.serverMatterBridge.setDeviceState(node.matterDeviceId, 'position', optimisticPosition)
+    // Matter-side feedback for a movement command just sent to KNX.
+    // - 'optimistic' (unchanged): reflect the requested position to Matter immediately; real
+    //   KNX status, if configured, corrects it afterwards via handleSend below.
+    // - 'waitStatus': wait for the real KNX status GA. If it doesn't arrive within
+    //   coverStatusTimeoutMs, just warn in the node status (as before). If NOTHING arrives
+    //   within the much longer COVER_ARRIVAL_FALLBACK_MS either, fall back to reflecting the
+    //   requested position anyway, so a real actuator that never reports back the exact
+    //   target percent100ths doesn't leave the Matter device stuck "moving" forever.
+    const applyCoverPositionFeedback = (command) => {
+      if (node.deviceType !== 'windowcovering' || !node.serverMatterBridge) return
+      let requestedPosition
+      if (command.fn === 'position') requestedPosition = command.value
+      if (command.fn === 'updown') requestedPosition = command.value === true ? 100 : 0
+      if (requestedPosition === undefined) return
+
       clearCoverStatusTimer()
-      if (node.coverStatusTimeoutMs > 0 && hasStatusRouteFor('position')) {
+      clearCoverArrivalTimer()
+
+      if (node.coverUpdateMode === 'optimistic') {
+        node.serverMatterBridge.setDeviceState(node.matterDeviceId, 'position', requestedPosition)
+        return
+      }
+
+      if (!hasStatusRouteFor('position')) return // no status GA at all: nothing to wait for or fall back from; the flow (if any) owns feedback
+
+      if (node.coverStatusTimeoutMs > 0) {
         coverStatusTimer = setTimeout(() => {
           coverStatusTimer = null
-          node.setNodeStatus({ fill: 'yellow', shape: 'ring', text: 'Waiting for KNX cover status', payload: optimisticPosition })
+          node.setNodeStatus({ fill: 'yellow', shape: 'ring', text: 'Waiting for KNX cover status', payload: requestedPosition })
         }, node.coverStatusTimeoutMs)
       }
+      coverArrivalTimer = setTimeout(() => {
+        coverArrivalTimer = null
+        node.serverMatterBridge.setDeviceState(node.matterDeviceId, 'position', requestedPosition)
+        node.setNodeStatus({ fill: 'yellow', shape: 'ring', text: 'No exact KNX confirmation in time, assuming arrived at', payload: requestedPosition })
+      }, COVER_ARRIVAL_FALLBACK_MS)
     }
     node.knxUltimateAcceptedGAs = Array.from(statusRoutes.keys())
 
@@ -204,8 +251,15 @@ module.exports = function (RED) {
       type: node.deviceType,
       name: node.name,
       invertPosition: node.invertPosition === true,
-      coverExposeAsDimmableLight: node.coverExposeAsDimmableLight === true,
-      coverUpdateMode: node.coverUpdateMode
+      coverSwapOpenClose: node.coverSwapOpenClose === true,
+      coverSliderDebounceMs: node.coverSliderDebounceMs,
+      commandDedupMs: node.commandDedupMs,
+      coverUpdateMode: node.coverUpdateMode,
+      // Thermostat only: whether a heating/cooling setpoint GA (command or status) was
+      // configured, so the bridge engine can build a Heating-only, Cooling-only or dual
+      // ThermostatServer without a dedicated "mode" dropdown in the editor.
+      hasHeatingSetpoint: devConfigValue('gaSetpoint') !== '' || devConfigValue('gaSetpointStatus') !== '',
+      hasCoolingSetpoint: devConfigValue('gaCoolingSetpoint') !== '' || devConfigValue('gaCoolingSetpointStatus') !== ''
     })
 
     // Reflects the bridge (config node) status on this device node.
@@ -248,7 +302,7 @@ module.exports = function (RED) {
         }
         // Confirm the requested position to Matter even when this is a flow-only
         // device and no KNX command GA is configured.
-        applyOptimisticCoverPosition(command)
+        applyCoverPositionFeedback(command)
         const route = commandRoutes.get(command.fn)
         if (route === undefined) {
           if (node.enableNodePINS) return // Flow-only device: the flow already got the command
@@ -286,7 +340,7 @@ module.exports = function (RED) {
             const value = dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(route.dpt))
             if (value === undefined || value === null) return
             node.serverMatterBridge.setDeviceState(node.matterDeviceId, route.fn, value)
-            if (node.deviceType === 'windowcovering' && route.fn === 'position') clearCoverStatusTimer()
+            if (node.deviceType === 'windowcovering' && route.fn === 'position') { clearCoverStatusTimer(); clearCoverArrivalTimer() }
             node.setNodeStatus({ fill: 'blue', shape: 'dot', text: `KNX->Matter ${route.fn}`, payload: value })
           } catch (error) {
             node.setNodeStatus({ fill: 'red', shape: 'dot', text: `KNX->Matter error ${error.message}` })
@@ -358,6 +412,7 @@ module.exports = function (RED) {
       try {
         if (initialReadTimer !== null) clearTimeout(initialReadTimer)
         clearCoverStatusTimer()
+        clearCoverArrivalTimer()
       } catch (error) { /* empty */ }
       try {
         if (node.serverKNX) node.serverKNX.removeClient(node)

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -28,7 +28,7 @@ Das ist die Gegenrichtung zum *Matter Device*-Node: Dort steuert KNX ein Matter-
 | RGB-Farblicht | + RGB-Farbe Befehls-/Status-GA (DPT 232.600). Die Matter-Farbe (Hue/Saturation oder XY, vom Farbrad der App) wird von/zur KNX-RGB-Triplette konvertiert |
 | Tunable-White-Licht | + Farbtemperatur Befehls-/Status-GA in Kelvin (DPT 7.600) |
 | Rollladen / Jalousie | Auf/Ab (DPT 1.008), Stopp (DPT 1.017), Position % Befehl/Status (DPT 5.001), optionale Positionsumkehr |
-| Thermostat (Heizung) | GA aktuelle Temperatur, Sollwert Befehls-/Status-GA (DPT 9.001) |
+| Thermostat (Heizung und/oder Kühlung) | GA aktuelle Temperatur, Sollwert Befehls-/Status-GA (DPT 9.001). Mit zusätzlichem Kühl-Sollwert Befehls-/Status-GA wird auch der Kühlmodus (Doppel-Sollwert) bereitgestellt |
 | Ventilator / Lüftung | Geschwindigkeit % Befehls-/Status-GA (DPT 5.001) |
 | Sensoren (Temperatur, Feuchte, Licht, Präsenz, Kontakt) | Je eine Status-GA |
 | Rauch-/CO-Melder | Rauchalarm Status-GA + optionale CO-Alarm Status-GA (DPT 1.005): kritische Benachrichtigungen auf dem Telefon |
@@ -41,7 +41,7 @@ Das ist die Gegenrichtung zum *Matter Device*-Node: Dort steuert KNX ein Matter-
 
 ## Erweiterte Kompatibilität
 
-Diese Optionen werden nur angezeigt, wenn sie zum gewählten Typ passen. Dimmbare Geräte können den Helligkeitsbefehl ignorieren, den manche Controller direkt nach `Ein` senden. Rollläden/Jalousien können die Matter-Position nach einem Befehl optimistisch aktualisieren und sie korrigieren, sobald die KNX-Status-GA die echte Position meldet.
+Diese Optionen werden nur angezeigt, wenn sie zum gewählten Typ passen. Dimmbare Geräte können den Helligkeitsbefehl ignorieren, den manche Controller direkt nach `Ein` senden. Bei Abdeckungen kehrt **Öffnen / Schließen tauschen** sowohl den binären KNX-Befehl als auch die Prozentrichtung um. **Abdeckungsregler-Entprellung** fasst schnelle Zwischenziele vor dem KNX-Schreiben zusammen: `0` nutzt adaptive Fenster (400 ms für den ersten, 150 ms für weitere Befehle); `1`–`5000` erzwingt ein festes Fenster. Die Matter-Position kann außerdem optimistisch aktualisiert und später durch die KNX-Status-GA korrigiert werden.
 
 ## Node-PINs
 

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -20,17 +20,22 @@
     "advanced": {
       "title": "Erweiterte Kompatibilität",
       "help": " Verwende diese Optionen nur, wenn ein Matter-Controller oder ein KNX-Aktor eine besondere Behandlung benötigt.",
+      "alexa_dedup_ms": "Alexa-Duplikat-Fenster (ms, 0 = aus)",
       "turn_on_behavior": "Einschaltverhalten",
       "turn_on_ignore_level": "Helligkeit direkt nach Ein ignorieren",
       "turn_on_forward_all": "Jeden Helligkeitsbefehl weiterleiten",
-    "ignore_level_ms": "Helligkeit nach Ein ignorieren (ms)",
-    "cover_expose_as_light": "Rollladen als dimmbares Licht anzeigen (Alexa-Workaround)",
-    "cover_expose_as_light_help": "Nur verwenden, wenn Alexa die Rollladenposition nicht einstellen kann. Die Helligkeit entspricht der Öffnung; die KNX-Gruppenadressen bleiben unverändert.",
+      "ignore_level_ms": "Helligkeit nach Ein ignorieren (ms)",
+      "cover_swap_open_close": "Abdeckung Öffnen / Schließen tauschen",
+      "cover_slider_debounce": "Abdeckungsregler-Entprellung (ms, 0 = adaptiv)",
       "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)"
     },
+    "tabs": {
+      "mappings": "KNX-Zuordnungen",
+      "advanced": "Erweiterte Optionen"
+    },
     "functions": {
       "fn_onoff_cmd": "Ein/Aus Befehls-GA",
       "fn_onoff_status": "Ein/Aus Status-GA",
@@ -44,6 +49,8 @@
       "fn_currenttemp": "GA aktuelle Temperatur",
       "fn_setpoint_cmd": "Sollwert Befehls-GA",
       "fn_setpoint_status": "Sollwert Status-GA",
+      "fn_coolingsetpoint_cmd": "Kühl-Sollwert Befehls-GA",
+      "fn_coolingsetpoint_status": "Kühl-Sollwert Status-GA",
       "fn_rgb_cmd": "RGB-Farbe Befehls-GA (DPT 232.600)",
       "fn_rgb_status": "RGB-Farbe Status-GA (DPT 232.600)",
       "fn_ct_cmd": "Farbtemperatur Befehls-GA (Kelvin)",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -28,7 +28,7 @@ This is the opposite direction of the *Matter Device* node: there KNX controls a
 | RGB color light | + RGB color command/status GA (DPT 232.600). The Matter color (hue/saturation or XY, from the app color wheel) is converted to/from the KNX RGB triplet |
 | Tunable white light | + Color temperature command/status GA in Kelvin (DPT 7.600) |
 | Cover / Shutter | Up/Down (DPT 1.008), Stop (DPT 1.017), Position % command/status (DPT 5.001), optional position inversion |
-| Thermostat (heating) | Current temperature GA, Setpoint command/status GA (DPT 9.001) |
+| Thermostat (heating and/or cooling) | Current temperature GA, Setpoint command/status GA (DPT 9.001). Optionally add a Cooling setpoint command/status GA to also expose a Cool mode (dual-setpoint) |
 | Fan / Ventilation | Fan speed % command/status GA (DPT 5.001) |
 | Sensors (temperature, humidity, light, occupancy, contact) | One status GA each |
 | Smoke/CO alarm | Smoke alarm status GA + optional CO alarm status GA (DPT 1.005): critical notifications on the phone |
@@ -41,7 +41,7 @@ This is the opposite direction of the *Matter Device* node: there KNX controls a
 
 ## Advanced compatibility
 
-These options are hidden unless they apply to the selected type. Dimmable devices can ignore the brightness command that some controllers send immediately after `On`. Covers can optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position.
+These options are hidden unless they apply to the selected type. Dimmable devices can ignore the brightness command that some controllers send immediately after `On`. For covers, **Swap Open / Close** reverses both the binary KNX command and percentage direction. **Cover slider debounce** coalesces rapid intermediate targets before writing to KNX: `0` uses adaptive windows (400 ms for the first command, 150 ms for subsequent commands); `1`–`5000` forces one fixed window. Covers can also optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position.
 
 ## Node PINs
 

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -20,17 +20,22 @@
     "advanced": {
       "title": "Advanced compatibility",
       "help": " Use these options only when a Matter controller or a KNX actuator needs special handling.",
+      "alexa_dedup_ms": "Alexa duplicate-command window (ms, 0 = off)",
       "turn_on_behavior": "Turn-on behavior",
       "turn_on_ignore_level": "Ignore brightness sent immediately after On",
       "turn_on_forward_all": "Forward every brightness command",
-    "ignore_level_ms": "Ignore brightness after On (ms)",
-    "cover_expose_as_light": "Expose cover as a dimmable light (Alexa workaround)",
-    "cover_expose_as_light_help": "Use only if Alexa cannot set the cover percentage. Brightness represents how open the cover is; KNX group addresses remain unchanged.",
+      "ignore_level_ms": "Ignore brightness after On (ms)",
+      "cover_swap_open_close": "Swap cover Open / Close",
+      "cover_slider_debounce": "Cover slider debounce (ms, 0 = adaptive)",
       "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)"
     },
+    "tabs": {
+      "mappings": "KNX mappings",
+      "advanced": "Advanced options"
+    },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",
@@ -44,6 +49,8 @@
       "fn_currenttemp": "Current temperature GA",
       "fn_setpoint_cmd": "Setpoint command GA",
       "fn_setpoint_status": "Setpoint status GA",
+      "fn_coolingsetpoint_cmd": "Cooling setpoint command GA",
+      "fn_coolingsetpoint_status": "Cooling setpoint status GA",
       "fn_rgb_cmd": "RGB color command GA (DPT 232.600)",
       "fn_rgb_status": "RGB color status GA (DPT 232.600)",
       "fn_ct_cmd": "Color temperature command GA (Kelvin)",

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -28,7 +28,7 @@ Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un disposit
 | Luz RGB (color) | + GA comando/estado color RGB (DPT 232.600). El color Matter (hue/saturation o XY, de la rueda de color de la app) se convierte desde/hacia la terna RGB KNX |
 | Luz blanco dinámico | + GA comando/estado temperatura de color en Kelvin (DPT 7.600) |
 | Persiana / Cortina | Subir/Bajar (DPT 1.008), Stop (DPT 1.017), posición % comando/estado (DPT 5.001), inversión de posición opcional |
-| Termostato (calefacción) | GA temperatura actual, GA comando/estado consigna (DPT 9.001) |
+| Termostato (calefacción y/o refrigeración) | GA temperatura actual, GA comando/estado consigna (DPT 9.001). Añadiendo también la GA comando/estado consigna de refrigeración se expone también el modo Cool (doble consigna) |
 | Ventilador / VMC | GA comando/estado velocidad % (DPT 5.001) |
 | Sensores (temperatura, humedad, luz, presencia, contacto) | Una GA de estado cada uno |
 | Alarma humo/CO | GA estado alarma de humo + GA estado alarma CO opcional (DPT 1.005): notificaciones críticas en el teléfono |
@@ -41,7 +41,7 @@ Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un disposit
 
 ## Compatibilidad avanzada
 
-Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Los dispositivos regulables pueden ignorar el comando de brillo que algunos controladores envían justo después de `On`. Las persianas pueden actualizar de forma optimista la posición Matter tras un comando y corregirla cuando la GA de estado KNX informa la posición real.
+Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Los dispositivos regulables pueden ignorar el brillo enviado justo después de `On`. Para persianas, **Intercambiar Abrir / Cerrar** invierte el comando KNX binario y la dirección porcentual. **Antirrebote del deslizador** agrupa objetivos intermedios rápidos antes de escribir en KNX: `0` usa ventanas adaptativas (400 ms para el primer comando y 150 ms para los siguientes); `1`–`5000` fuerza una ventana fija. La posición Matter también puede actualizarse de forma optimista y corregirse después mediante la GA de estado KNX.
 
 ## PINes del nodo