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

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # 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/>

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: [] },
@@ -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);

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/locales/de/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/en/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/es/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/fr/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/it/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/zh-CN/knxUltimateMatterBridge.html

@@ -27,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) |
@@ -45,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

@@ -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/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.13",
+  "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/",