node-red-contrib-knx-ultimate 6.3.12 → 6.3.14

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 
 # CHANGELOG
 
+**Version 6.3.14** - August 2026<br/>
+
+- **Expose KNX to Matter — Room Air Conditioner and Door Lock**: added native Matter **Room Air Conditioner** (`0x0072`) and **Door Lock** (`0x000A`) profiles. A room AC combines On/Off, current temperature, heating/cooling setpoints and fan speed in one endpoint; a door lock maps separate Lock/Unlock command and Locked/Unlocked status GAs. Both profiles support KNX or flow-backed state updates without feedback loops, with editor help and documentation in EN/IT/DE/FR/ES/zh-CN.<br/>
+
+**Version 6.3.13** - August 2026<br/>
+
+- **Matter**: promoted Matter Controller, Matter Bridge and Expose KNX to Matter from BETA to production-ready status; removed BETA labels and experimental warnings from the palette, editor help, examples and multilingual documentation while retaining pairing, backup and endpoint-structure safety guidance.<br/>
+- **Matter visual identity**: changed the Matter node background to the official Matter Day color (`#F3FFFF`) and the controller/bridge icon artwork to Matter Night (`#131926`) for readable, standards-aligned palette and canvas presentation.<br/>
+
 **Version 6.3.12** - August 2026<br/>
 
 - **HUE Controller**: completed the EN, IT, DE, FR, ES and zh-CN editor translations, including Light Level, Locate, Light mapping labels, mapping placeholders, error messages and tutorial links; the embedded profiles and dynamic device labels now follow Node-RED's active locale instead of a potentially stale page-language attribute. Corrected French/Spanish Hue and KNX terminology and realigned the localized help and wiki documentation.<br/>

package/examples/Matter Controller - Semantic Flow Input.json

@@ -4,7 +4,7 @@
     "type": "tab",
     "label": "Matter Controller - Flow input",
     "disabled": false,
-    "info": "Example of the semantic msg.payload = { function, value } contract for Control Matter from KNX (BETA).\n\nAfter importing:\n1. Open the example Matter Controller node.\n2. Select your existing Matter Controller configuration and a commissioned non-light endpoint.\n3. Enable Node Input/Output PINs.\n4. In the Flow input section shown below the PIN selector, use only the Inject nodes matching functions advertised by the device.\n\nThis example creates no matter-config and sends no command automatically."
+    "info": "Example of the semantic msg.payload = { function, value } contract for Control Matter from KNX.\n\nAfter importing:\n1. Open the example Matter Controller node.\n2. Select your existing Matter Controller configuration and a commissioned non-light endpoint.\n3. Enable Node Input/Output PINs.\n4. In the Flow input section shown below the PIN selector, use only the Inject nodes matching functions advertised by the device.\n\nThis example creates no matter-config and sends no command automatically."
   },
   {
     "id": "matter_semantic_instructions",

package/nodes/icons/node-matter-bridge-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Matter Bridge">
-  <text x="20" y="21" fill="#ffffff" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
+  <text x="20" y="21" fill="#131926" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
   <path d="M 37 34 H 12 V 29 L 2 38 L 12 47 V 42 H 25"
-    fill="none" stroke="#ffffff" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
+    fill="none" stroke="#131926" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

package/nodes/icons/node-matter-controller-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Matter Controller">
-  <text x="20" y="21" fill="#ffffff" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
+  <text x="20" y="21" fill="#131926" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="700" textLength="38" lengthAdjust="spacingAndGlyphs">mat</text>
   <path d="M 3 34 H 28 V 29 L 38 38 L 28 47 V 42 H 15"
-    fill="none" stroke="#ffffff" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
+    fill="none" stroke="#131926" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

package/nodes/icons/node-matter-icon.svg

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="40" height="60" viewBox="0 0 40 60" xmlns="http://www.w3.org/2000/svg">
-    <g fill="#ffffff" stroke="none">
+    <g fill="#131926" stroke="none">
         <circle cx="20" cy="30" r="4.5"/>
         <g id="matterArrow">
             <rect x="18.4" y="9" width="3.2" height="11"/>

package/nodes/knxUltimateMatterBridge.html

@@ -54,6 +54,21 @@
         { key: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
         { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' }
       ],
+      roomairconditioner: [
+        { key: 'OnOff', labelKey: 'fn_onoff_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { key: 'OnOffStatus', labelKey: 'fn_onoff_status', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { 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: 'CoolingSetpoint', labelKey: 'fn_coolingsetpoint_cmd', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'CoolingSetpointStatus', labelKey: 'fn_coolingsetpoint_status', dptPrefix: '9.', fallbackDpt: '9.001' },
+        { key: 'FanSpeed', labelKey: 'fn_fanspeed_cmd', dptPrefix: '5.', fallbackDpt: '5.001' },
+        { key: 'FanSpeedStatus', labelKey: 'fn_fanspeed_status', dptPrefix: '5.', fallbackDpt: '5.001' }
+      ],
+      doorlock: [
+        { key: 'Lock', labelKey: 'fn_lock_cmd', dptPrefix: '1.', fallbackDpt: '1.001' },
+        { key: 'LockStatus', labelKey: 'fn_lock_status', dptPrefix: '1.', fallbackDpt: '1.001' }
+      ],
       smokecoalarm: [
         { key: 'Smoke', labelKey: 'fn_smoke_ga', dptPrefix: '1.', fallbackDpt: '1.005' },
         { key: 'CO', labelKey: 'fn_co_ga', dptPrefix: '1.', fallbackDpt: '1.005' }
@@ -66,7 +81,7 @@
       ],
       robotvacuum: [] // Flow-only: no GA fields, controlled via the node PINs
     };
-    const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'fan', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
+    const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'roomairconditioner', 'fan', 'doorlock', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
     const FLOW_HELP = {
       onofflight: { input: [['onoff', true]], output: [['onoff', true]] },
       onoffplug: { input: [['onoff', true]], output: [['onoff', true]] },
@@ -80,6 +95,8 @@
       contactsensor: { input: [['contact', true]], output: [] },
       windowcovering: { input: [['position', 35]], output: [['updown', false], ['position', 35], ['stop', true]] },
       thermostat: { input: [['currenttemp', 21.5], ['setpoint', 21], ['coolingsetpoint', 24]], output: [['setpoint', 21], ['coolingsetpoint', 24]] },
+      roomairconditioner: { input: [['onoff', true], ['currenttemp', 25.5], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]], output: [['onoff', true], ['setpoint', 21], ['coolingsetpoint', 24], ['fanspeed', 60]] },
+      doorlock: { input: [['lock', true]], output: [['lock', true]] },
       smokecoalarm: { input: [['smoke', true], ['co', true]], output: [] },
       waterleakdetector: { input: [['leak', true]], output: [] },
       airqualitysensor: { input: [['co2', 850]], output: [] },
@@ -118,15 +135,15 @@
 
     RED.nodes.registerType('knxUltimateMatterBridge', {
       category: 'KNX Ultimate Matter',
-      color: '#8FE3D4',
+      color: '#F3FFFF',
       defaults: gaDefaults,
       inputs: 0,
       outputs: 0,
       icon: 'node-matter-bridge-icon.svg',
       label() {
-        return this.name || 'Expose KNX to Matter (BETA)';
+        return this.name || 'Expose KNX to Matter';
       },
-      paletteLabel: 'Expose KNX to Matter (BETA)',
+      paletteLabel: 'Expose KNX to Matter',
       oneditprepare() {
         try { RED.sidebar.show('help'); } catch (error) { /* empty */ }
         const node = this;
@@ -379,7 +396,7 @@
           const isCover = selected === 'windowcovering';
           // 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;
+          const hasCommand = selected === 'onofflight' || selected === 'onoffplug' || selected === 'roomairconditioner' || hasLevel;
           $advancedRows.toggle(hasCommand || isCover);
           $commandAdvancedRows.toggle(hasCommand);
           $dimmerAdvancedRows.toggle(hasLevel);
@@ -632,7 +649,7 @@
 </script>
 
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-Exposes **one KNX device as a Matter device**. This node is in **BETA**.
+Exposes **one KNX device as a Matter device**.
 
 Point it to a **Matter Bridge** configuration node (the actual bridge, paired once by Alexa/Google Home/Apple Home), pick the device type, give it the name the assistant will use, and fill the group addresses.
 

package/nodes/knxUltimateMatterBridge.js

@@ -55,6 +55,21 @@ module.exports = function (RED) {
       { fn: 'coolingsetpoint', direction: 'command', ga: 'gaCoolingSetpoint', dpt: 'dptCoolingSetpoint', fallbackDpt: '9.001' },
       { fn: 'coolingsetpoint', direction: 'status', ga: 'gaCoolingSetpointStatus', dpt: 'dptCoolingSetpointStatus', fallbackDpt: '9.001' }
     ],
+    roomairconditioner: [
+      { fn: 'onoff', direction: 'command', ga: 'gaOnOff', dpt: 'dptOnOff', fallbackDpt: '1.001' },
+      { fn: 'onoff', direction: 'status', ga: 'gaOnOffStatus', dpt: 'dptOnOffStatus', fallbackDpt: '1.001' },
+      { 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: 'coolingsetpoint', direction: 'command', ga: 'gaCoolingSetpoint', dpt: 'dptCoolingSetpoint', fallbackDpt: '9.001' },
+      { fn: 'coolingsetpoint', direction: 'status', ga: 'gaCoolingSetpointStatus', dpt: 'dptCoolingSetpointStatus', fallbackDpt: '9.001' },
+      { fn: 'fanspeed', direction: 'command', ga: 'gaFanSpeed', dpt: 'dptFanSpeed', fallbackDpt: '5.001' },
+      { fn: 'fanspeed', direction: 'status', ga: 'gaFanSpeedStatus', dpt: 'dptFanSpeedStatus', fallbackDpt: '5.001' }
+    ],
+    doorlock: [
+      { fn: 'lock', direction: 'command', ga: 'gaLock', dpt: 'dptLock', fallbackDpt: '1.001' },
+      { fn: 'lock', direction: 'status', ga: 'gaLockStatus', dpt: 'dptLockStatus', fallbackDpt: '1.001' }
+    ],
     smokecoalarm: [
       { fn: 'smoke', direction: 'status', ga: 'gaSmoke', dpt: 'dptSmoke', fallbackDpt: '1.005' },
       { fn: 'co', direction: 'status', ga: 'gaCO', dpt: 'dptCO', fallbackDpt: '1.005' }
@@ -275,9 +290,9 @@ module.exports = function (RED) {
       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.
+      // Thermostat/Room Air Conditioner: 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.
       hasHeatingSetpoint: devConfigValue('gaSetpoint') !== '' || devConfigValue('gaSetpointStatus') !== '',
       hasCoolingSetpoint: devConfigValue('gaCoolingSetpoint') !== '' || devConfigValue('gaCoolingSetpointStatus') !== ''
     })

package/nodes/knxUltimateMatterControllerDevice.html

@@ -10,7 +10,7 @@
 
     RED.nodes.registerType("knxUltimateMatterControllerDevice", {
       category: "KNX Ultimate Matter",
-      color: "#8FE3D4",
+      color: "#F3FFFF",
       defaults: {
         //buttonState: {value: true},
         server: { type: "knxUltimate-config", required: false },
@@ -142,9 +142,9 @@
       outputs: 0,
       icon: "node-matter-controller-icon.svg",
       label: function () {
-        return this.name || this.matterDeviceName || "Control Matter from KNX (BETA)";
+        return this.name || this.matterDeviceName || "Control Matter from KNX";
       },
-      paletteLabel: "Control Matter from KNX (BETA)",
+      paletteLabel: "Control Matter from KNX",
       oneditprepare: function () {
         // Go to the help panel
         try {

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
-
 ## Übersicht
 
 Jeder Expose KNX to Matter Node stellt **ein KNX-Gerät als Matter-Gerät** bereit: Die gekoppelten Controller (Alexa, Google Home, Apple Home...) sehen es mit dem von dir vergebenen Namen — bereit für App- und Sprachsteuerung. Verweise ihn auf einen **Matter Bridge**-Konfigurations-Node (die eigentliche Bridge, einmal gekoppelt - der Kopplungs-QR-Code lebt dort) und füge beliebig viele Device-Nodes hinzu, überall in deinen Flows.
@@ -29,7 +27,9 @@ Das Ändern des Gerätetyps nach der Kopplung der Bridge verändert die Matter-E
 | 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 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 |
+| Raumklimagerät | Ein Matter-Gerät kombiniert Ein/Aus (DPT 1.001), aktuelle Temperatur und Heiz-/Kühl-Sollwerte (DPT 9.001) sowie Lüftergeschwindigkeit % (DPT 5.001), jeweils als Befehls-/Status-GA |
 | Ventilator / Lüftung | Geschwindigkeit % Befehls-/Status-GA (DPT 5.001) |
+| Türschloss | Verriegeln/Entriegeln Befehls-GA und Verriegelt/Entriegelt Status-GA (DPT 1.001; `true` = verriegelt) |
 | 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 |
 | Wasserleckmelder | Leckage Status-GA (DPT 1.005) |
@@ -47,7 +47,7 @@ Diese Optionen werden nur angezeigt, wenn sie zum gewählten Typ passen. Dimmbar
 
 Der PIN-Selektor befindet sich außerhalb der Editor-Tabs. Nach dem Aktivieren erscheint direkt darunter ein kontextbezogener Bereich **Flow-Eingang/-Ausgang** mit kopierbaren Beispielen für den ausgewählten Gerätetyp:
 
-- **Input**: aktualisiere den Matter-Zustand aus dem Flow, ohne den KNX-Bus: `msg.payload = { function: "onoff", value: true }` (`function` ist eine von `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Nützlich, um im Flow berechnete Werte (z.B. einen virtuellen Sensor) für Alexa & Co. bereitzustellen.
+- **Input**: aktualisiere den Matter-Zustand aus dem Flow, ohne den KNX-Bus: `msg.payload = { function: "onoff", value: true }` (`function` ist eine von `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Nützlich, um im Flow berechnete Werte (z.B. einen virtuellen Sensor) für Alexa & Co. bereitzustellen.
 - **Output**: Jeder von einem Matter-Controller empfangene Befehl wird an den Flow weitergeleitet: `msg.topic` = Gerätename, `msg.payload` = Wert, `msg.matter` = der rohe Befehl. Ein Gerät ohne Befehls-GAs wird zum **Nur-Flow-Gerät**.
 
 ## Hinweise

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Name der Matter-Bridge",
     "port": "Port",
     "devices_help": "Füge die KNX-Geräte hinzu, die über Matter bereitgestellt werden sollen. Der \"Name\" ist der, den Alexa/Google/Apple anzeigen und für Sprachbefehle verwenden. Befehls-GA = wird geschrieben, wenn der Assistent einen Befehl sendet; Status-GA = wird vom Bus gelesen, um die App aktuell zu halten.",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "Leckage Status-GA",
       "fn_co2_ga": "CO2 Status-GA (ppm, DPT 9.008)",
       "fn_fanspeed_cmd": "Lüftergeschwindigkeit % Befehls-GA",
-      "fn_fanspeed_status": "Lüftergeschwindigkeit % Status-GA"
+      "fn_fanspeed_status": "Lüftergeschwindigkeit % Status-GA",
+      "fn_lock_cmd": "Verriegeln/Entriegeln Befehls-GA",
+      "fn_lock_status": "Verriegelt/Entriegelt Status-GA"
     },
     "types": {
       "onofflight": "Ein/Aus-Licht",
@@ -89,7 +91,9 @@
       "contactsensor": "Kontaktsensor",
       "windowcovering": "Rollladen / Jalousie",
       "thermostat": "Thermostat (Heizung)",
+      "roomairconditioner": "Raumklimagerät",
       "fan": "Ventilator / Lüftung",
+      "doorlock": "Türschloss",
       "smokecoalarm": "Rauch-/CO-Melder",
       "waterleakdetector": "Wasserleckmelder",
       "airqualitysensor": "Luftqualitätssensor (CO2)",

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> Dieser Knoten ist **BETA**: das Verhalten kann sich ändern, während die Matter-Implementierung weiter verfeinert wird.
-
 Dieser Knoten steuert einen bereits gekoppelten Matter-Endpunkt über KNX. Wähle das Matter-Gerät aus; der Editor erkennt die Fähigkeiten des Endpunkts und zeigt nur die passenden KNX-Zuordnungen.
 
 Ein Klick oder Fokus auf das Matter-Gerätefeld öffnet immer die vollständige Liste der gekoppelten Endpunkte, auch wenn bereits ein Gerät ausgewählt ist. Beim Tippen wird die Liste weiterhin gefiltert.

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

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Matter Bridge (BETA)
-
-> Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
+# Matter Bridge
 
 ## Übersicht
 

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> This node is in **BETA**: it works, but details may still change between releases.
-
 ## Overview
 
 Each Expose KNX to Matter node exposes **one KNX device as a Matter device**: the paired controllers (Alexa, Google Home, Apple Home...) see it, with the name you typed, ready for app and voice control. Point it to a **Matter Bridge** configuration node (the actual bridge, paired once - the pairing QR code lives there) and add as many device nodes as you want, anywhere in your flows.
@@ -29,7 +27,9 @@ Changing the device type after the bridge has been paired changes the Matter end
 | 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 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) |
+| Room air conditioner | One Matter device combining On/Off (DPT 1.001), current temperature and heating/cooling setpoints (DPT 9.001), and fan speed % (DPT 5.001) command/status GAs |
 | Fan / Ventilation | Fan speed % command/status GA (DPT 5.001) |
+| Door lock | Lock/Unlock command GA and Locked/Unlocked status GA (DPT 1.001; `true` = locked) |
 | 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 |
 | Water leak detector | Leak status GA (DPT 1.005) |
@@ -47,7 +47,7 @@ These options are hidden unless they apply to the selected type. Dimmable device
 
 The PIN selector is outside the editor tabs. Enabling it reveals a contextual **Flow input/output** section directly below, with copyable examples filtered to the selected device type:
 
-- **Input**: update the Matter state from the flow, without the KNX bus: `msg.payload = { function: "onoff", value: true }` (`function` is one of `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Useful to expose flow-computed values (e.g. a virtual sensor) to Alexa & Co.
+- **Input**: update the Matter state from the flow, without the KNX bus: `msg.payload = { function: "onoff", value: true }` (`function` is one of `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Useful to expose flow-computed values (e.g. a virtual sensor) to Alexa & Co.
 - **Output**: every command received from a Matter controller is forwarded to the flow: `msg.topic` = device name, `msg.payload` = value, `msg.matter` = the raw command. A device without command GAs becomes a **flow-only device**.
 
 ## Notes

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Matter bridge name",
     "port": "Port",
     "devices_help": "Add the KNX devices to expose on Matter. The \"Name\" is what Alexa/Google/Apple will show and use for voice commands. Command GA = written when the assistant sends a command; Status GA = read from the bus to keep the app updated.",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "Leak status GA",
       "fn_co2_ga": "CO2 status GA (ppm, DPT 9.008)",
       "fn_fanspeed_cmd": "Fan speed % command GA",
-      "fn_fanspeed_status": "Fan speed % status GA"
+      "fn_fanspeed_status": "Fan speed % status GA",
+      "fn_lock_cmd": "Lock/Unlock command GA",
+      "fn_lock_status": "Locked/Unlocked status GA"
     },
     "types": {
       "onofflight": "On/Off light",
@@ -89,7 +91,9 @@
       "contactsensor": "Contact sensor",
       "windowcovering": "Cover / Shutter",
       "thermostat": "Thermostat (heating)",
+      "roomairconditioner": "Room air conditioner",
       "fan": "Fan / Ventilation",
+      "doorlock": "Door lock",
       "smokecoalarm": "Smoke/CO alarm",
       "waterleakdetector": "Water leak detector",
       "airqualitysensor": "Air quality sensor (CO2)",

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> This node is in **BETA**: behaviour can change while the Matter implementation is refined.
-
 This node controls a commissioned Matter endpoint from KNX. Select the Matter device and the editor detects its capabilities, then shows only the KNX mappings that make sense for that endpoint.
 
 Clicking or focusing the Matter device field always opens the complete commissioned endpoint list, even when a device is already selected. Typing continues to filter it.

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

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Matter Bridge (BETA)
-
-> This node is in **BETA**: it works, but details may still change between releases.
+# Matter Bridge
 
 ## Overview
 

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
-
 ## Descripción general
 
 Cada nodo Expose KNX to Matter expone **un dispositivo KNX como dispositivo Matter**: los controladores emparejados (Alexa, Google Home, Apple Home...) lo ven, con el nombre que hayas elegido, listo para el control por app y por voz. Apúntalo a un nodo de configuración **Bridge Matter** (el bridge en sí, emparejado una sola vez - el QR de emparejamiento vive allí) y añade tantos nodos de dispositivo como quieras, en cualquier flow.
@@ -29,7 +27,9 @@ Cambiar el tipo de dispositivo después de emparejar el bridge modifica la estru
 | 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 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) |
+| Aire acondicionado de habitación | Un dispositivo Matter combina GA comando/estado On/Off (DPT 1.001), temperatura actual y consignas de calefacción/refrigeración (DPT 9.001), y velocidad del ventilador % (DPT 5.001) |
 | Ventilador / VMC | GA comando/estado velocidad % (DPT 5.001) |
+| Cerradura de puerta | GA comando bloqueo/desbloqueo y GA estado bloqueado/desbloqueado (DPT 1.001; `true` = bloqueada) |
 | 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 |
 | Detector de fugas de agua | GA estado fuga (DPT 1.005) |
@@ -47,7 +47,7 @@ Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Lo
 
 El selector de PINes está fuera de las pestañas del editor. Al activarlo aparece justo debajo una sección contextual **Entrada/salida del flow**, con ejemplos copiables filtrados según el tipo de dispositivo:
 
-- **Entrada**: actualiza el estado Matter desde el flow, sin pasar por el bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` es una de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Útil para exponer a Alexa y cía. valores calculados en el flow (p.ej. un sensor virtual).
+- **Entrada**: actualiza el estado Matter desde el flow, sin pasar por el bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` es una de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Útil para exponer a Alexa y cía. valores calculados en el flow (p.ej. un sensor virtual).
 - **Salida**: cada comando recibido de un controlador Matter se reenvía al flow: `msg.topic` = nombre del dispositivo, `msg.payload` = valor, `msg.matter` = el comando en bruto. Un dispositivo sin GA de comando se convierte en un **dispositivo solo-flow**.
 
 ## Notas

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Nombre del bridge Matter",
     "port": "Puerto",
     "devices_help": "Añade los dispositivos KNX a exponer en Matter. El \"Nombre\" es el que Alexa/Google/Apple muestran y usan para los comandos de voz. GA de comando = se escribe cuando el asistente envía un comando; GA de estado = se lee del bus para mantener la app actualizada.",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "GA estado fuga de agua",
       "fn_co2_ga": "GA estado CO2 (ppm, DPT 9.008)",
       "fn_fanspeed_cmd": "GA comando velocidad ventilador %",
-      "fn_fanspeed_status": "GA estado velocidad ventilador %"
+      "fn_fanspeed_status": "GA estado velocidad ventilador %",
+      "fn_lock_cmd": "GA comando bloqueo/desbloqueo",
+      "fn_lock_status": "GA estado bloqueado/desbloqueado"
     },
     "types": {
       "onofflight": "Luz On/Off",
@@ -89,7 +91,9 @@
       "contactsensor": "Sensor de contacto",
       "windowcovering": "Persiana / Cortina",
       "thermostat": "Termostato (calefacción)",
+      "roomairconditioner": "Aire acondicionado de habitación",
       "fan": "Ventilador / VMC",
+      "doorlock": "Cerradura de puerta",
       "smokecoalarm": "Alarma humo/CO",
       "waterleakdetector": "Detector de fugas de agua",
       "airqualitysensor": "Sensor de calidad del aire (CO2)",

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> Este nodo está en **BETA**: el comportamiento puede cambiar mientras se mejora la implementación Matter.
-
 Este nodo controla desde KNX un endpoint Matter ya emparejado. Selecciona el dispositivo Matter y el editor detecta sus capacidades, mostrando solo las asignaciones KNX coherentes con ese endpoint.
 
 Al hacer clic o enfocar el campo del dispositivo Matter siempre se abre la lista completa de endpoints emparejados, aunque ya haya un dispositivo seleccionado. Al escribir, la lista sigue filtrándose.

package/nodes/locales/es/matterbridge-config.html

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Bridge Matter (BETA)
-
-> Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
+# Bridge Matter
 
 ## Descripción general
 

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
-
 ## Vue d'ensemble
 
 Chaque nœud Expose KNX to Matter expose **un appareil KNX comme appareil Matter** : les contrôleurs appairés (Alexa, Google Home, Apple Home...) le voient, avec le nom que vous avez choisi, prêt pour le contrôle par app et à la voix. Pointez-le vers un nœud de configuration **Bridge Matter** (le bridge lui-même, appairé une seule fois - le QR d'appairage vit là-bas) et ajoutez autant de nœuds d'appareil que vous voulez, n'importe où dans vos flux.
@@ -29,7 +27,9 @@ Changer le type d'appareil après l'appairage du bridge modifie la structure de
 | Lumière blanc dynamique | + GA commande/état température de couleur en Kelvin (DPT 7.600) |
 | Volet / Store | Monter/Descendre (DPT 1.008), Stop (DPT 1.017), position % commande/état (DPT 5.001), inversion de position optionnelle |
 | Thermostat (chauffage et/ou rafraîchissement) | GA température actuelle, GA commande/état consigne (DPT 9.001). En ajoutant aussi la GA commande/état consigne rafraîchissement, le mode Cool (double consigne) est également exposé |
+| Climatiseur individuel | Un appareil Matter combine les GA commande/état On/Off (DPT 1.001), température actuelle et consignes chauffage/rafraîchissement (DPT 9.001), et vitesse ventilateur % (DPT 5.001) |
 | Ventilateur / VMC | GA commande/état vitesse % (DPT 5.001) |
+| Serrure de porte | GA commande verrouillage/déverrouillage et GA état verrouillé/déverrouillé (DPT 1.001 ; `true` = verrouillée) |
 | Capteurs (température, humidité, lumière, présence, contact) | Une GA d'état chacun |
 | Détecteur fumée/CO | GA état alarme fumée + GA état alarme CO optionnelle (DPT 1.005) : notifications critiques sur le téléphone |
 | Détecteur de fuite d'eau | GA état fuite (DPT 1.005) |
@@ -47,7 +47,7 @@ Ces options ne s'affichent que lorsqu'elles s'appliquent au type sélectionné.
 
 Le sélecteur de PIN se trouve hors des onglets de l'éditeur. Son activation affiche juste dessous une section contextuelle **Entrée/sortie du flow**, avec des exemples copiables filtrés selon le type d'appareil :
 
-- **Entrée** : mettez à jour l'état Matter depuis le flux, sans passer par le bus KNX : `msg.payload = { function: "onoff", value: true }` (`function` est l'une de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flux (ex. un capteur virtuel).
+- **Entrée** : mettez à jour l'état Matter depuis le flux, sans passer par le bus KNX : `msg.payload = { function: "onoff", value: true }` (`function` est l'une de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flux (ex. un capteur virtuel).
 - **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flux : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Un appareil sans GA de commande devient un **appareil flow uniquement**.
 
 ## Notes

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Nom du bridge Matter",
     "port": "Port",
     "devices_help": "Ajoutez les appareils KNX à exposer sur Matter. Le \"Nom\" est celui qu'Alexa/Google/Apple affichent et utilisent pour les commandes vocales. GA de commande = écrite quand l'assistant envoie une commande ; GA d'état = lue depuis le bus pour tenir l'app à jour.",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "GA état fuite d'eau",
       "fn_co2_ga": "GA état CO2 (ppm, DPT 9.008)",
       "fn_fanspeed_cmd": "GA commande vitesse ventilateur %",
-      "fn_fanspeed_status": "GA état vitesse ventilateur %"
+      "fn_fanspeed_status": "GA état vitesse ventilateur %",
+      "fn_lock_cmd": "GA commande verrouillage/déverrouillage",
+      "fn_lock_status": "GA état verrouillé/déverrouillé"
     },
     "types": {
       "onofflight": "Lumière On/Off",
@@ -89,7 +91,9 @@
       "contactsensor": "Capteur de contact",
       "windowcovering": "Volet / Store",
       "thermostat": "Thermostat (chauffage)",
+      "roomairconditioner": "Climatiseur individuel",
       "fan": "Ventilateur / VMC",
+      "doorlock": "Serrure de porte",
       "smokecoalarm": "Détecteur fumée/CO",
       "waterleakdetector": "Détecteur de fuite d'eau",
       "airqualitysensor": "Capteur de qualité d'air (CO2)",

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> Ce nœud est en **BETA** : le comportement peut changer pendant l amélioration de l'implémentation Matter.
-
 Ce nœud contrôle depuis KNX un endpoint Matter déjà appairé. Sélectionnez l'appareil Matter et l'éditeur détecte ses capacités, puis affiche uniquement les mappings KNX adaptés à cet endpoint.
 
 Un clic ou le focus sur le champ de l'appareil Matter ouvre toujours la liste complète des endpoints appairés, même si un appareil est déjà sélectionné. La saisie continue de filtrer la liste.

package/nodes/locales/fr/matterbridge-config.html

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Bridge Matter (BETA)
-
-> Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
+# Bridge Matter
 
 ## Vue d'ensemble
 

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
-
 ## Panoramica
 
 Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matter**: i controller abbinati (Alexa, Google Home, Apple Home...) lo vedono, con il nome che hai scelto, pronto per il controllo da app e vocale. Puntalo a un nodo di configurazione **Bridge Matter** (il bridge vero e proprio, abbinato una sola volta - il QR di abbinamento vive lì) e aggiungi quanti nodi device vuoi, ovunque nei tuoi flow.
@@ -29,7 +27,9 @@ Cambiare il tipo dispositivo dopo l'abbinamento del bridge modifica la struttura
 | Luce bianco dinamico | + GA comando/stato temperatura colore in Kelvin (DPT 7.600) |
 | Tapparella / Tenda | Su/Giù (DPT 1.008), Stop (DPT 1.017), posizione % comando/stato (DPT 5.001), inversione posizione opzionale |
 | Termostato (riscaldamento e/o raffrescamento) | GA temperatura attuale, GA comando/stato setpoint (DPT 9.001). Aggiungendo anche il GA comando/stato setpoint raffrescamento si espone anche la modalità Cool (doppio setpoint) |
+| Condizionatore ambiente | Un unico dispositivo Matter che combina GA comando/stato On/Off (DPT 1.001), temperatura attuale e setpoint caldo/freddo (DPT 9.001), e velocità ventola % (DPT 5.001) |
 | Ventola / VMC | GA comando/stato velocità % (DPT 5.001) |
+| Serratura porta | GA comando blocco/sblocco e GA stato bloccato/sbloccato (DPT 1.001; `true` = bloccata) |
 | Sensori (temperatura, umidità, luminosità, presenza, contatto) | Un GA di stato ciascuno |
 | Rilevatore fumo/CO | GA stato allarme fumo + GA stato allarme CO opzionale (DPT 1.005): notifiche critiche sul telefono |
 | Rilevatore allagamento | GA stato allagamento (DPT 1.005) |
@@ -47,7 +47,7 @@ Queste opzioni sono nascoste finché non servono al tipo selezionato. I disposit
 
 Il selettore dei PIN si trova fuori dalle TAB dell'editor. Abilitandolo compare subito sotto una sezione contestuale **Input/output del flow**, con esempi copiabili filtrati per il tipo di dispositivo selezionato:
 
-- **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
+- **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
 - **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. Un dispositivo senza GA di comando diventa un **dispositivo solo-flow**.
 
 ## Note

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Nome del bridge Matter",
     "port": "Porta",
     "devices_help": "Aggiungi i dispositivi KNX da esporre su Matter. Il \"Nome\" è quello che Alexa/Google/Apple mostrano e usano per i comandi vocali. GA comando = scritto quando l'assistente invia un comando; GA stato = letto dal bus per tenere aggiornata l'app.",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "GA stato allagamento",
       "fn_co2_ga": "GA stato CO2 (ppm, DPT 9.008)",
       "fn_fanspeed_cmd": "GA comando velocità ventola %",
-      "fn_fanspeed_status": "GA stato velocità ventola %"
+      "fn_fanspeed_status": "GA stato velocità ventola %",
+      "fn_lock_cmd": "GA comando blocco/sblocco",
+      "fn_lock_status": "GA stato bloccato/sbloccato"
     },
     "types": {
       "onofflight": "Luce On/Off",
@@ -89,7 +91,9 @@
       "contactsensor": "Sensore contatto",
       "windowcovering": "Tapparella / Tenda",
       "thermostat": "Termostato (riscaldamento)",
+      "roomairconditioner": "Condizionatore ambiente",
       "fan": "Ventola / VMC",
+      "doorlock": "Serratura porta",
       "smokecoalarm": "Rilevatore fumo/CO",
       "waterleakdetector": "Rilevatore allagamento",
       "airqualitysensor": "Sensore qualità aria (CO2)",

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> Questo nodo è in **BETA**: il comportamento può cambiare mentre l'implementazione Matter viene rifinita.
-
 Questo nodo controlla da KNX un endpoint Matter già abbinato. Seleziona il dispositivo Matter e l'editor rileva le sue capability, mostrando solo le mappature KNX coerenti con quell'endpoint.
 
 Un click o il focus sul campo del dispositivo Matter apre sempre l'elenco completo degli endpoint abbinati, anche quando un dispositivo è già selezionato. Digitando, l'elenco continua a essere filtrato.

package/nodes/locales/it/matterbridge-config.html

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Bridge Matter (BETA)
-
-> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+# Bridge Matter
 
 ## Panoramica
 

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

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
-
 ## 概述
 
 每个 Expose KNX to Matter 节点将**一个 KNX 设备公开为 Matter 设备**：已配对的控制器（Alexa、Google Home、Apple Home...）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 **Matter 桥接器**配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
@@ -29,7 +27,9 @@
 | 色温灯 | + 色温命令/状态 GA，开尔文 (DPT 7.600) |
 | 窗帘/卷帘 | 上/下 (DPT 1.008)、停止 (DPT 1.017)、位置 % 命令/状态 (DPT 5.001)、可选位置反转 |
 | 温控器（采暖和/或制冷） | 当前温度 GA、设定点命令/状态 GA (DPT 9.001)。如再配置制冷设定点命令/状态 GA，则同时提供 Cool 模式（双设定点） |
+| 房间空调 | 一个 Matter 设备组合开/关命令/状态 GA (DPT 1.001)、当前温度与采暖/制冷设定点 (DPT 9.001)，以及风扇速度 % 命令/状态 GA (DPT 5.001) |
 | 风扇/新风 | 速度 % 命令/状态 GA (DPT 5.001) |
+| 门锁 | 锁定/解锁命令 GA 和锁定/解锁状态 GA (DPT 1.001；`true` = 已锁定) |
 | 传感器（温度、湿度、光照、人体、门磁） | 各一个状态 GA |
 | 烟雾/CO 报警器 | 烟雾报警状态 GA + 可选 CO 报警状态 GA (DPT 1.005)：手机上的紧急通知 |
 | 漏水探测器 | 漏水状态 GA (DPT 1.005) |
@@ -47,7 +47,7 @@
 
 引脚选择器位于编辑器选项卡之外。启用后，其下方会显示与所选设备类型匹配的 **Flow 输入/输出** 区域，并提供可复制示例：
 
-- **输入**：从 Flow 更新 Matter 状态，无需经过 KNX 总线：`msg.payload = { function: "onoff", value: true }`（`function` 为 `onoff`、`level`、`rgb`、`colortemp`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint`、`fanspeed`、`smoke`、`co`、`leak`、`co2`、`rvcstate`、`rvcmode` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
+- **输入**：从 Flow 更新 Matter 状态，无需经过 KNX 总线：`msg.payload = { function: "onoff", value: true }`（`function` 为 `onoff`、`level`、`rgb`、`colortemp`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint`、`coolingsetpoint`、`fanspeed`、`lock`、`smoke`、`co`、`leak`、`co2`、`rvcstate`、`rvcmode` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
 - **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**。
 
 ## 说明

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

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter (BETA)",
+    "title": "Expose KNX to Matter",
     "bridge_name": "Matter 桥接器名称",
     "port": "端口",
     "devices_help": "添加要在 Matter 上公开的 KNX 设备。\"名称\"是 Alexa/Google/Apple 显示并用于语音命令的名称。命令 GA = 助手发送命令时写入；状态 GA = 从总线读取以保持 App 更新。",
@@ -74,7 +74,9 @@
       "fn_leak_ga": "漏水状态 GA",
       "fn_co2_ga": "CO2 状态 GA（ppm，DPT 9.008）",
       "fn_fanspeed_cmd": "风扇速度 % 命令 GA",
-      "fn_fanspeed_status": "风扇速度 % 状态 GA"
+      "fn_fanspeed_status": "风扇速度 % 状态 GA",
+      "fn_lock_cmd": "锁定/解锁 命令 GA",
+      "fn_lock_status": "锁定/解锁 状态 GA"
     },
     "types": {
       "onofflight": "开关灯",
@@ -89,7 +91,9 @@
       "contactsensor": "门磁传感器",
       "windowcovering": "窗帘 / 卷帘",
       "thermostat": "温控器（采暖）",
+      "roomairconditioner": "房间空调",
       "fan": "风扇 / 新风",
+      "doorlock": "门锁",
       "smokecoalarm": "烟雾/CO 报警器",
       "waterleakdetector": "漏水探测器",
       "airqualitysensor": "空气质量传感器 (CO2)",

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

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-> 此节点为 **BETA**：Matter 实现继续完善时，行为可能会变化。
-
 此节点用于从 KNX 控制已经配对的 Matter endpoint。选择 Matter 设备后，编辑器会检测它的能力，并只显示与该 endpoint 匹配的 KNX 映射。
 
 单击 Matter 设备字段或使其获得焦点时，即使已经选择了设备，也会始终打开完整的已配对 endpoint 列表；输入文字仍可筛选列表。

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

@@ -1,7 +1,5 @@
 <script type="text/markdown" data-help-name="matterbridge-config">
-# Matter 桥接器 (BETA)
-
-> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
+# Matter 桥接器
 
 ## 概述
 

package/nodes/utils/matterBridgeDeviceFactory.mjs

@@ -28,6 +28,11 @@ import { AirQualitySensorDevice } from '@matter/main/devices/air-quality-sensor'
 import { AirQualityServer } from '@matter/main/behaviors/air-quality'
 import { CarbonDioxideConcentrationMeasurementServer } from '@matter/main/behaviors/carbon-dioxide-concentration-measurement'
 import { FanDevice } from '@matter/main/devices/fan'
+import { FanControlServer } from '@matter/main/behaviors/fan-control'
+import { RoomAirConditionerDevice } from '@matter/main/devices/room-air-conditioner'
+import { DoorLockDevice } from '@matter/main/devices/door-lock'
+import { DoorLockServer } from '@matter/main/behaviors/door-lock'
+import { DoorLock } from '@matter/main/clusters/door-lock'
 import { RoboticVacuumCleanerDevice } from '@matter/main/devices/robotic-vacuum-cleaner'
 import { RvcRunModeServer } from '@matter/main/behaviors/rvc-run-mode'
 import { RvcOperationalStateServer } from '@matter/main/behaviors/rvc-operational-state'
@@ -53,6 +58,8 @@ const BRIDGE_TYPES = {
   // Custom construction (dedicated server behaviors), handled in createBridgedEndpoint
   windowcovering: { device: null, functions: ['position'], commandFunctions: [] },
   thermostat: { device: null, functions: ['currenttemp', 'setpoint', 'coolingsetpoint'], commandFunctions: [] },
+  roomairconditioner: { device: null, functions: ['onoff', 'currenttemp', 'setpoint', 'coolingsetpoint', 'fanspeed'], commandFunctions: [] },
+  doorlock: { device: null, functions: ['lock'], commandFunctions: [] },
   rgblight: { device: null, functions: ['onoff', 'level', 'rgb'], commandFunctions: ['onoff', 'level'] },
   colortemperaturelight: { device: null, functions: ['onoff', 'level', 'colortemp'], commandFunctions: ['onoff', 'level'] },
   smokecoalarm: { device: null, functions: ['smoke', 'co'], commandFunctions: [] },
@@ -124,6 +131,8 @@ function knxValueToMatterPatch (def, fn, value) {
     }
     case 'onoff':
       return { onOff: { onOff: truthy(value) } }
+    case 'lock':
+      return { doorLock: { lockState: truthy(value) ? DoorLock.LockState.Locked : DoorLock.LockState.Unlocked } }
     case 'level': {
       const percent = Number(value)
       if (Number.isNaN(percent)) return undefined
@@ -281,6 +290,76 @@ function createRawColorControlServer (def, onCommand) {
   return { RawColorControlServer, attachLevelTracker }
 }
 
+function configureThermostatState (initialState, def, fallbackMode) {
+  let hasHeating = def.hasHeatingSetpoint === true
+  let hasCooling = def.hasCoolingSetpoint === true
+  // The Thermostat cluster cannot be composed without at least one operating feature.
+  // Preserve the historical heating default for the standalone Thermostat; a Room Air
+  // Conditioner with no setpoint GA configured defaults to cooling, its primary use case.
+  if (!hasHeating && !hasCooling) {
+    hasHeating = fallbackMode === 'heating'
+    hasCooling = fallbackMode === 'cooling'
+  }
+  const features = []
+  if (hasHeating) features.push('Heating')
+  if (hasCooling) features.push('Cooling')
+  initialState.thermostat = {
+    localTemperature: null,
+    // CoolingOnly=0, HeatingOnly=2, CoolingAndHeating=4 (ControlSequenceOfOperation).
+    controlSequenceOfOperation: hasHeating && hasCooling ? 4 : (hasCooling ? 0 : 2),
+    // Cool=3, Heat=4 (SystemMode). A dual-mode device starts in Heat.
+    systemMode: hasCooling && !hasHeating ? 3 : 4
+  }
+  if (hasHeating) initialState.thermostat.occupiedHeatingSetpoint = 2000 // 20°C
+  if (hasCooling) initialState.thermostat.occupiedCoolingSetpoint = 2400 // 24°C
+  return { features, hasHeating, hasCooling }
+}
+
+function attachThermostatCommandHandlers (endpoint, def, onCommand, capabilities) {
+  // Absolute thermostat targets are Matter attribute writes, not commands. The offline
+  // context marks KNX/flow state synchronization and prevents a feedback write to KNX.
+  if (capabilities.hasHeating) {
+    endpoint.events.thermostat.occupiedHeatingSetpoint$Changed.on((value, oldValue, context) => {
+      try {
+        if (context?.offline === true || value === null || value === undefined) return
+        onCommand({ deviceId: def.id, fn: 'setpoint', value: Math.round(Number(value)) / 100 })
+      } catch (error) { /* empty */ }
+    })
+  }
+  if (capabilities.hasCooling) {
+    endpoint.events.thermostat.occupiedCoolingSetpoint$Changed.on((value, oldValue, context) => {
+      try {
+        if (context?.offline === true || value === null || value === undefined) return
+        onCommand({ deviceId: def.id, fn: 'coolingsetpoint', value: Math.round(Number(value)) / 100 })
+      } catch (error) { /* empty */ }
+    })
+  }
+}
+
+function configureFanState (initialState) {
+  initialState.fanControl = {
+    fanMode: 0, // Off
+    fanModeSequence: 0, // Off/Low/Med/High (Auto requires the AUT feature)
+    percentSetting: 0,
+    percentCurrent: 0
+  }
+}
+
+function attachFanCommandHandlers (endpoint, def, onCommand) {
+  endpoint.events.fanControl.percentSetting$Changed.on((value, oldValue, context) => {
+    try {
+      if (context?.offline === true || value === null || value === undefined) return
+      onCommand({ deviceId: def.id, fn: 'fanspeed', value: clamp(Math.round(Number(value)), 0, 100) })
+    } catch (error) { /* empty */ }
+  })
+  endpoint.events.fanControl.fanMode$Changed.on((value, oldValue, context) => {
+    try {
+      if (context?.offline === true) return
+      if (Number(value) === 0) onCommand({ deviceId: def.id, fn: 'fanspeed', value: 0 })
+    } catch (error) { /* empty */ }
+  })
+}
+
 /**
  * Creates the bridged Matter endpoint for a virtual device definition.
  * @param {object} def - { id, type, name }
@@ -353,7 +432,9 @@ function createBridgedEndpoint (def, serialPrefix, onCommand) {
     return false
   }
 
-  const RawOnOffBase = def.type === 'onoffplug' ? OnOffServer : OnOffServer.with('Lighting')
+  const RawOnOffBase = def.type === 'onoffplug'
+    ? OnOffServer
+    : def.type === 'roomairconditioner' ? OnOffServer.with('DeadFrontBehavior') : OnOffServer.with('Lighting')
   class RawOnOffServer extends RawOnOffBase {
     async on () {
       await super.on()
@@ -505,57 +586,58 @@ function createBridgedEndpoint (def, serialPrefix, onCommand) {
     // Heating/Cooling capability is auto-detected from which setpoint GA(s) the KNX node
     // has configured (see knxUltimateMatterBridge.js#getMatterDef). Leaving both flags
     // unset keeps the original heating-only behavior, so existing flows are unaffected.
-    const hasCooling = def.hasCoolingSetpoint === true
-    const hasHeating = def.hasHeatingSetpoint !== false
-    const features = []
-    if (hasHeating) features.push('Heating')
-    if (hasCooling) features.push('Cooling')
-    if (features.length === 0) features.push('Heating') // never build a thermostat with neither mode
-
-    initialState.thermostat = {
-      localTemperature: null,
-      // CoolingOnly=0, HeatingOnly=2, CoolingAndHeating=4 (Matter ControlSequenceOfOperation enum)
-      controlSequenceOfOperation: hasHeating && hasCooling ? 4 : (hasCooling ? 0 : 2),
-      // Cool=3, Heat=4 (Matter SystemMode enum). Dual-mode starts in Heat; the controller can
-      // switch it, same as any physical dual thermostat without an auto/deadband mode.
-      systemMode: hasCooling && !hasHeating ? 3 : 4
-    }
-    if (hasHeating) initialState.thermostat.occupiedHeatingSetpoint = 2000 // 20°C
-    if (hasCooling) initialState.thermostat.occupiedCoolingSetpoint = 2400 // 24°C
-
-    endpoint = new Endpoint(ThermostatDevice.with(ThermostatServer.with(...features), BridgedDeviceBasicInformationServer), initialState)
-
-    // Setpoint changes from a Matter controller. Unlike OnOff/LevelControl/WindowCovering/
-    // ColorControl, an absolute setpoint has no cluster COMMAND to intercept - Thermostat
-    // only exposes SetpointRaiseLower (a *relative* command) and SetActivePresetRequest;
-    // controllers set an absolute target via a plain attribute write. matter.js only fires
-    // $Changing/$Changed when the value actually differs (verified in @matter/node's
-    // Datasource#preCommit), so a duplicate setpoint (same value sent twice) cannot be
-    // forwarded raw here - there is no lower-level hook to capture it at.
-    if (hasHeating) {
-      endpoint.events.thermostat.occupiedHeatingSetpoint$Changed.on((value, oldValue, context) => {
-        try {
-          if (context?.offline === true) return
-          if (value === null || value === undefined) return
-          onCommand({ deviceId: def.id, fn: 'setpoint', value: Math.round(Number(value)) / 100 }) // centi-°C -> °C
-        } catch (error) { /* empty */ }
-      })
-    }
-    if (hasCooling) {
-      endpoint.events.thermostat.occupiedCoolingSetpoint$Changed.on((value, oldValue, context) => {
-        try {
-          if (context?.offline === true) return
-          if (value === null || value === undefined) return
-          onCommand({ deviceId: def.id, fn: 'coolingsetpoint', value: Math.round(Number(value)) / 100 }) // centi-°C -> °C
-        } catch (error) { /* empty */ }
-      })
-    }
+    const thermostat = configureThermostatState(initialState, def, 'heating')
+    endpoint = new Endpoint(ThermostatDevice.with(ThermostatServer.with(...thermostat.features), BridgedDeviceBasicInformationServer), initialState)
+    attachThermostatCommandHandlers(endpoint, def, onCommand, thermostat)
     // NOTE: SystemMode (Heat/Cool/Off/Auto) changes from a controller are accepted by the
     // cluster but not forwarded to KNX yet: there is no single KNX DPT for HVAC mode that
     // fits every actuator. Track it via the node's optional input PIN if you need it today.
     return endpoint
   }
 
+  if (def.type === 'roomairconditioner') {
+    // Matter Room Air Conditioner (0x0072) requires OnOff with DeadFrontBehavior and a
+    // feature-selected Thermostat server. FanControl is optional in the specification,
+    // but included here so the former on/off + thermostat + fan trio becomes one endpoint.
+    const thermostat = configureThermostatState(initialState, def, 'cooling')
+    configureFanState(initialState)
+    endpoint = new Endpoint(RoomAirConditionerDevice.with(
+      RawOnOffServer,
+      ThermostatServer.with(...thermostat.features),
+      FanControlServer,
+      BridgedDeviceBasicInformationServer
+    ), initialState)
+    attachThermostatCommandHandlers(endpoint, def, onCommand, thermostat)
+    attachFanCommandHandlers(endpoint, def, onCommand)
+    return endpoint
+  }
+
+  if (def.type === 'doorlock') {
+    initialState.doorLock = {
+      lockState: DoorLock.LockState.Unlocked,
+      lockType: DoorLock.LockType.Other,
+      actuatorEnabled: true,
+      operatingMode: DoorLock.OperatingMode.Normal,
+      // matter.js currently defaults these constrained base attributes to 0, which is
+      // outside their Matter-defined 1..255 range and prevents endpoint initialization.
+      wrongCodeEntryLimit: 3,
+      userCodeTemporaryDisableTime: 10
+    }
+    class KnxDoorLockServer extends DoorLockServer {
+      async lockDoor (request) {
+        await super.lockDoor(request)
+        onCommand({ deviceId: def.id, fn: 'lock', value: true, matterCommand: { cluster: 'DoorLock', command: 'lockDoor' } })
+      }
+
+      async unlockDoor (request) {
+        await super.unlockDoor(request)
+        onCommand({ deviceId: def.id, fn: 'lock', value: false, matterCommand: { cluster: 'DoorLock', command: 'unlockDoor' } })
+      }
+    }
+    endpoint = new Endpoint(DoorLockDevice.with(KnxDoorLockServer, BridgedDeviceBasicInformationServer), initialState)
+    return endpoint
+  }
+
   if (def.type === 'occupancysensor') {
     // The OccupancySensing cluster is not added by default: the sensor type must be chosen (we expose it as PIR)
     endpoint = new Endpoint(OccupancySensorDevice.with(OccupancySensingServer.with('PassiveInfrared'), BridgedDeviceBasicInformationServer), initialState)
@@ -620,30 +702,13 @@ function createBridgedEndpoint (def, serialPrefix, onCommand) {
       BridgedDeviceBasicInformationServer
     ), initialState)
   } else if (def.type === 'fan') {
-    initialState.fanControl = {
-      fanMode: 0, // Off
-      fanModeSequence: 0, // Off/Low/Med/High (Auto requires the AUT feature)
-      percentSetting: 0,
-      percentCurrent: 0
-    }
+    configureFanState(initialState)
     endpoint = new Endpoint(FanDevice.with(BridgedDeviceBasicInformationServer), initialState)
     // Speed changes from the controller (percent write or fan mode change). Like the
     // Thermostat setpoints above, FanControlServer exposes no command to intercept for
     // percentSetting (@matter/node's FanControlServer overrides nothing beyond
     // initialize()) - it is attribute-write only, so this cannot be made "raw" either.
-    endpoint.events.fanControl.percentSetting$Changed.on((value, oldValue, context) => {
-      try {
-        if (context?.offline === true) return
-        if (value === null || value === undefined) return
-        onCommand({ deviceId: def.id, fn: 'fanspeed', value: clamp(Math.round(Number(value)), 0, 100) })
-      } catch (error) { /* empty */ }
-    })
-    endpoint.events.fanControl.fanMode$Changed.on((value, oldValue, context) => {
-      try {
-        if (context?.offline === true) return
-        if (Number(value) === 0) onCommand({ deviceId: def.id, fn: 'fanspeed', value: 0 })
-      } catch (error) { /* empty */ }
-    })
+    attachFanCommandHandlers(endpoint, def, onCommand)
   } else if (def.type === 'robotvacuum') {
     // Flow-only device: run mode changes and operational commands are forwarded to the flow
     // (node PINs); the flow reports the state back through the input PIN.

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.3.12",
+  "version": "6.3.14",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",