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

package/CHANGELOG.md

@@ -6,8 +6,10 @@
 
 # CHANGELOG
 
-**Version 6.0.6** - July 2026<br/>
+**Version 6.0.7** - July 2026<br/>
 
+- **Control Matter from KNX (BETA) — Door Lock support**: commissioned Door Lock endpoints (including locks bridged by a vendor Matter hub) are now detected from their real `0x0101` cluster and expose KNX DPT 1 command/status mappings. `true` invokes `lockDoor`, `false` invokes `unlockDoor`, and subscribed `lockState` feedback updates KNX without command reflection. `NotFullyLocked` and `Unlatched` remain explicit flow states and are never collapsed into an unsafe binary KNX value. The optional remote-operation PIN is stored as a Node-RED credential; endpoints that do not advertise a requested command are rejected instead of receiving an invented operation. This is the first controller-side device profile in the extensible profile architecture requested in [discussion #519](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/discussions/519).<br/>
+- **Control Matter from KNX (BETA) — multi-purpose endpoint profiles**: the controller node now keeps its established light path unchanged while routing non-light endpoints through a separate capability-driven mapped profile. Selecting a plug/On-Off actuator, cover, thermostat, fan, environmental/contact/occupancy sensor, battery, electrical-power or energy endpoint builds only the KNX mappings backed by clusters, attributes and supported commands actually reported by that endpoint. These mappings now live inside a dedicated **Mappings** tab beside **Behaviour**, matching the established light editor layout. Each mapping can be disabled by leaving its GA empty; cached status supports KNX read responses and startup publication, attribute reports never reflect commands back to Matter, and cluster events remain available on the optional flow output. Saved mappings survive an untouched editor save even when the Matter endpoint is temporarily offline.<br/>
 - **Matter nodes — cleaner editors**: long pairing, storage, cache and endpoint-structure explanations were removed from the Matter node forms and consolidated in the localized HTML help, keeping the editors focused on fields, actions and live operational status.<br/>
 - **Matter nodes — distinct canvas icons**: Matter Controller and Matter Bridge nodes now use separate compact icons, with `mat` above a large right/left direction arrow, making the two integration directions immediately distinguishable in the palette, workspace and configuration selectors.<br/>
 - **Matter Controller/Bridge — protocol version and portable storage backups**: the Node-RED startup version line now logs the implemented Matter protocol revision (Matter 1.5.1, separately from the matter.js package version). Both Matter configuration editors can export and import a per-instance JSON backup containing the complete persistent Matter storage required to preserve fabrics, private credentials, sessions and commissioned/paired nodes. Import atomically replaces only the selected instance and restarts its engine; backup files contain secrets and must be protected like passwords.<br/>

package/nodes/knxUltimateMatterControllerDevice.html

@@ -18,6 +18,7 @@
         matterEndpointId: { value: 1 },
         matterDeviceName: { value: "" },
         matterDeviceCapabilities: { value: "" },
+        matterMappings: { value: "[]" },
         name: { value: "" },
 
         nameLightSwitch: { value: "" },
@@ -123,6 +124,9 @@
         restoreDayMode: { value: "no" }, // Starting from v 4.1.31
         updateLocalStateFromKNXWrite: { value: true } // Starting from v 4.1.31
       },
+      credentials: {
+        doorLockPin: { type: "password" }
+      },
       inputs: 0,
       outputs: 0,
       icon: "node-matter-controller-icon.svg",
@@ -506,11 +510,11 @@
             }
             return val;
           };
-          const matterTypePretty = { 'ma-extendedcolorlight': 'Colour light', 'ma-colortemperaturelight': 'Tunable white', 'ma-dimmablelight': 'Dimmable light', 'ma-onofflight': 'On/off light', 'ma-onoffpluginunit': 'Plug', 'ma-dimmablepluginunit': 'Dimmable plug' };
+          const matterTypePretty = { 'ma-extendedcolorlight': 'Colour light', 'ma-colortemperaturelight': 'Tunable white', 'ma-dimmablelight': 'Dimmable light', 'ma-onofflight': 'On/off light', 'ma-onoffpluginunit': 'Plug', 'ma-dimmablepluginunit': 'Dimmable plug', 'ma-doorlock': 'Door lock', 'ma-windowcovering': 'Cover', 'ma-thermostat': 'Thermostat', 'ma-fan': 'Fan', 'ma-temperaturesensor': 'Temperature sensor', 'ma-humiditysensor': 'Humidity sensor', 'ma-lightsensor': 'Light sensor', 'ma-occupancysensor': 'Occupancy sensor', 'ma-contactsensor': 'Contact sensor' };
           const matterPrettyType = (raw) => {
             const key = String(raw || '').toLowerCase();
             if (matterTypePretty[key]) return matterTypePretty[key];
-            return String(raw || '').replace(/^ma-/i, '').replace(/light$/i, ' light') || 'Light';
+            return String(raw || '').replace(/^ma-/i, '').replace(/light$/i, ' light') || 'Matter endpoint';
           };
           const normalizeMatterToken = (value) => String(value || '').toLowerCase().replace(/[^a-z0-9]/g, '');
           const getMatterCluster = (ep, clusterId) => (ep.clusters || []).find((c) => Number(c.id) === Number(clusterId));
@@ -524,10 +528,64 @@
           };
           const matterCapabilitiesFromEndpoint = (ep) => {
             const deviceTypes = (ep.deviceTypes || []).map(normalizeMatterToken);
+            const primaryDeviceType = (ep.deviceTypes || []).find((value) => !/bridgednode|aggregator|controlbridge/i.test(String(value))) || ep.name;
+            const deviceTypeDisplay = matterPrettyType(primaryDeviceType);
             const typeText = deviceTypes.join(' ');
             const onOffCluster = getMatterCluster(ep, 6);
             const levelCluster = getMatterCluster(ep, 8);
             const colorCluster = getMatterCluster(ep, 768);
+            const doorLockCluster = getMatterCluster(ep, 257);
+            if (doorLockCluster) {
+              return {
+                known: true,
+                profile: 'doorLock',
+                deviceTypeDisplay,
+                onOff: true,
+                level: false,
+                colorTemperature: false,
+                color: false,
+                lockDoor: hasMatterCommand(doorLockCluster, ['lockDoor']),
+                unlockDoor: hasMatterCommand(doorLockCluster, ['unlockDoor']),
+                requirePinForRemoteOperation: (() => {
+                  const attribute = (doorLockCluster.attributes || []).find((item) => normalizeMatterToken(item.name) === 'requirepinforremoteoperation');
+                  return attribute ? attribute.value === true : false;
+                })()
+              };
+            }
+            const isMatterLight = deviceTypes.some((type) => /(?:onoff|dimmable|colortemperature|extendedcolor)light/.test(type));
+            if (!isMatterLight) {
+              const mappedTargets = [];
+              const addCommand = (clusterId, target, label, dpt) => {
+                const cluster = getMatterCluster(ep, clusterId);
+                if (hasMatterCommand(cluster, [target])) mappedTargets.push({ direction: 'command', endpointId: Number(ep.endpointId), clusterId, targetKind: 'command', target, label, dpt });
+              };
+              const addAttribute = (clusterId, target, label, dpt, writable) => {
+                const cluster = getMatterCluster(ep, clusterId);
+                if (hasMatterAttribute(cluster, [target])) mappedTargets.push({ direction: writable ? 'command' : 'status', endpointId: Number(ep.endpointId), clusterId, targetKind: 'attribute', target, label, dpt });
+              };
+              addCommand(6, 'on', 'onoff_command', '1.001');
+              addAttribute(6, 'onOff', 'onoff_state', '1.001', false);
+              addCommand(258, 'upOrOpen', 'cover_updown', '1.008');
+              addCommand(258, 'stopMotion', 'cover_stop', '1.017');
+              addCommand(258, 'goToLiftPercentage', 'cover_position_command', '5.001');
+              addAttribute(258, 'currentPositionLiftPercent100ths', 'cover_position_state', '5.001', false);
+              addAttribute(513, 'occupiedHeatingSetpoint', 'heating_command', '9.001', true);
+              addAttribute(513, 'occupiedHeatingSetpoint', 'heating_state', '9.001', false);
+              addAttribute(513, 'occupiedCoolingSetpoint', 'cooling_command', '9.001', true);
+              addAttribute(513, 'occupiedCoolingSetpoint', 'cooling_state', '9.001', false);
+              addAttribute(513, 'localTemperature', 'local_temperature', '9.001', false);
+              addAttribute(514, 'percentSetting', 'fan_command', '5.001', true);
+              addAttribute(514, 'percentCurrent', 'fan_state', '5.001', false);
+              addAttribute(1026, 'measuredValue', 'temperature', '9.001', false);
+              addAttribute(1029, 'measuredValue', 'humidity', '9.007', false);
+              addAttribute(1024, 'measuredValue', 'illuminance', '9.004', false);
+              addAttribute(1030, 'occupancy', 'occupancy', '1.011', false);
+              addAttribute(69, 'stateValue', 'contact', '1.002', false);
+              addAttribute(47, 'batPercentRemaining', 'battery', '5.001', false);
+              addAttribute(144, 'activePower', 'active_power', '14.056', false);
+              addAttribute(145, 'cumulativeEnergyImported', 'imported_energy', '13.013', false);
+              return { known: true, profile: 'mapped', deviceTypeDisplay, onOff: false, level: false, colorTemperature: false, color: false, mappedTargets };
+            }
             const hasColorTemperatureType = /colortemperature|extendedcolor/.test(typeText);
             const hasColorType = /extendedcolor/.test(typeText);
             const hasLevelType = /dimmable|colortemperature|extendedcolor/.test(typeText);
@@ -542,6 +600,7 @@
             );
             return {
               known: true,
+              deviceTypeDisplay,
               colorDetectionVersion: 2,
               onOff: !!onOffCluster || /onoff|dimmable|colortemperature|extendedcolor/.test(typeText),
               level: !!levelCluster || hasLevelType,
@@ -578,9 +637,8 @@
             });
           };
 
-          // Matter counterpart of the Hue device fetch: every commissioned node is
-          // expanded into its light endpoints (clusters OnOff 6 / Level 8 / Color 768),
-          // so a bridge (e.g. a Hue Bridge paired via Matter) lists each lamp.
+          // Expand every commissioned node into its functional endpoints. Lights keep
+          // the legacy light UI; other endpoints select a capability-driven profile.
           const fetchHueDevices = (term, respond, { forceRefresh = false } = {}) => {
             const matterServer = getHueServerConfig();
             if (!matterServer) {
@@ -609,8 +667,10 @@
                 const items = [];
                 results.forEach((entry) => {
                   const device = entry.device;
-                  const lightEps = entry.endpoints.filter((ep) => Array.isArray(ep.clusters) && ep.clusters.some((c) => [6, 8, 768].indexOf(Number(c.id)) !== -1));
-                  const eps = lightEps.length ? lightEps : entry.endpoints.filter((ep) => Number(ep.endpointId) !== 0);
+                  // Multi-purpose controller: list every functional endpoint. Capability
+                  // detection below decides whether it uses the unchanged light path or
+                  // a dedicated/mapped non-light profile.
+                  const eps = entry.endpoints.filter((ep) => Number(ep.endpointId) !== 0);
                   const many = eps.length > 1;
                   eps.forEach((ep) => {
                     const label = matterEndpointLabel(ep);
@@ -934,12 +994,29 @@
             const supportsTemperature = hasHueDevice && caps.colorTemperature === true;
             const supportsColor = hasHueDevice && caps.color === true;
             const hasRichBehaviour = supportsDim && (supportsTemperature || supportsColor);
+            const isDoorLock = caps.profile === 'doorLock';
+            const isMapped = caps.profile === 'mapped';
+            const deviceTypeDisplay = String(caps.deviceTypeDisplay || '').trim();
 
             setMatterTabVisible('tabs-1', supportsSwitch);
             setMatterTabVisible('tabs-2', supportsDim);
             setMatterTabVisible('tabs-3', supportsTemperature);
             setMatterTabVisible('tabs-4', supportsColor);
+            setMatterTabVisible('tabs-mapped', isMapped);
             setMatterTabVisible('tabs-6', hasHueDevice);
+            $('#matter-door-lock-options').toggle(isDoorLock);
+            $('#matter-switch-command-label').text(isDoorLock
+              ? (node._('knxUltimateMatterControllerDevice.door_lock_command') || 'Lock / unlock')
+              : (node._('knxUltimateMatterControllerDevice.control') || 'Control'));
+            $('#matter-switch-status-label').text(isDoorLock
+              ? (node._('knxUltimateMatterControllerDevice.door_lock_status') || 'Lock state')
+              : (node._('knxUltimateMatterControllerDevice.status') || 'Status'));
+            $('#matter-door-lock-command-warning').toggle(isDoorLock && (caps.lockDoor === false || caps.unlockDoor === false));
+            $('#matter-door-lock-pin-required').toggle(isDoorLock && caps.requirePinForRemoteOperation === true);
+            $('#matter-mapped-profile').toggle(isMapped);
+            if (isMapped) renderMappedProfile(caps.mappedTargets || []);
+            $('#matter-selected-device-type-value').text(deviceTypeDisplay);
+            $('#matter-selected-device-type').toggle(hasHueDevice && deviceTypeDisplay !== '');
             try { $tabs.tabs('refresh'); } catch (error) { /* empty */ }
             ensureVisibleMatterTabSelected();
 
@@ -960,6 +1037,40 @@
             refreshBehaviourVisibility();
           };
 
+          const parseMatterMappings = () => {
+            try { return JSON.parse($('#node-input-matterMappings').val() || node.matterMappings || '[]'); } catch (error) { return []; }
+          };
+          const renderMappedProfile = (targets) => {
+            const saved = parseMatterMappings();
+            const $body = $('#matter-mapped-profile-body').empty();
+            targets.forEach((target) => {
+              const key = `${target.direction}:${target.endpointId}:${target.clusterId}:${target.targetKind}:${target.target}`;
+              const previous = saved.find((item) => `${item.direction}:${item.endpointId}:${item.clusterId}:${item.targetKind}:${item.target}` === key) || {};
+              const $row = $('<div class="form-row matter-mapped-row" style="display:flex;align-items:center;"></div>').data('mapping', target);
+              const translated = node._(`knxUltimateMatterControllerDevice.mapped.${target.label}`);
+              $('<label style="width:220px; margin-right:10px;"></label>').text(translated || target.target).appendTo($row);
+              $('<label style="width:25px; margin:0 5px 0 0;">GA</label>').appendTo($row);
+              const $ga = $('<input class="matter-mapped-ga" type="text" placeholder="Ex: 1/1/1" style="width:100px; margin-right:18px;">').val(previous.ga || '').appendTo($row);
+              $('<label style="width:35px; margin:0 5px 0 0;">DPT</label>').appendTo($row);
+              const $dpt = $('<input class="matter-mapped-dpt" type="text" placeholder="DPT" style="width:140px;">').val(previous.dpt || target.dpt || '').appendTo($row);
+              $ga.autocomplete({
+                minLength: 0,
+                source(request, response) {
+                  if (!hasKnxServerSelected()) { response([]); return; }
+                  $.getJSON(`knxUltimatecsv?nodeID=${resolveKnxServerValue()}&_=${Date.now()}`, (data) => {
+                    response($.map(data, (value) => {
+                      const searchable = `${value.ga} ${value.devicename} ${value.dpt}`;
+                      if (!htmlUtilsfullCSVSearch(searchable, request.term || '')) return null;
+                      return { label: `${value.ga} # ${value.devicename} # ${value.dpt}`, value: value.ga, dpt: value.dpt };
+                    }));
+                  }).fail(() => response([]));
+                },
+                select(event, ui) { if (ui.item.dpt) $dpt.val(ui.item.dpt); }
+              }).focus(function () { $(this).autocomplete('search', $(this).val()); });
+              $body.append($row);
+            });
+          };
+
           const updateTabsVisibility = () => {
             const knxSelected = hasKnxServerSelected();
             const hueDeviceSelected = getHueDeviceValue() !== '';
@@ -1321,6 +1432,20 @@
         this.matterNodeId = ($("#node-input-matterNodeId").val() || '').trim();
         this.matterEndpointId = Number($("#node-input-matterEndpointId").val() || 1);
         this.matterDeviceCapabilities = ($("#node-input-matterDeviceCapabilities").val() || '').trim();
+        const mappedMappings = [];
+        const $mappedRows = $('#matter-mapped-profile-body .matter-mapped-row');
+        $mappedRows.each(function () {
+          const base = $(this).data('mapping') || {};
+          const ga = ($(this).find('.matter-mapped-ga').val() || '').trim();
+          const dpt = ($(this).find('.matter-mapped-dpt').val() || '').trim();
+          if (ga && dpt) mappedMappings.push(Object.assign({}, base, { ga, dpt }));
+        });
+        // Preserve saved mappings when the endpoint is offline and its asynchronous
+        // structure could not be rebuilt during an untouched editor round trip.
+        this.matterMappings = $mappedRows.length > 0
+          ? JSON.stringify(mappedMappings)
+          : ($('#node-input-matterMappings').val() || this.matterMappings || '[]');
+        $('#node-input-matterMappings').val(this.matterMappings);
         this.name = this.matterDeviceName || this.name || '';
         $("#node-input-name").val(this.name);
         const parseSavedMatterCapabilities = (raw) => {
@@ -1546,9 +1671,15 @@
       <span class="hue-devices-loading" style="margin-left:6px; display:none; color:#1b7d33;">
         <i class="fa fa-circle-notch fa-spin"></i>
       </span>
+      <span id="matter-selected-device-type" style="display:none; margin-left:10px; color:#666; white-space:nowrap;">
+        <i class="fa fa-microchip"></i>
+        <span data-i18n="knxUltimateMatterControllerDevice.device_type"></span>:
+        <span id="matter-selected-device-type-value" style="font-weight:600;"></span>
+      </span>
       <input type="hidden" id="node-input-matterNodeId" />
       <input type="hidden" id="node-input-matterEndpointId" />
       <input type="hidden" id="node-input-matterDeviceCapabilities" />
+      <input type="hidden" id="node-input-matterMappings" />
       <input type="hidden" id="node-input-name" />
     </div>
 
@@ -1560,12 +1691,18 @@
         <li><a href="#tabs-2"><i class="fa-solid fa-arrow-up-wide-short"></i> <span data-i18n="knxUltimateMatterControllerDevice.tabs.dim"></span></a></li>
         <li><a href="#tabs-3"><i class="fa-solid fa-temperature-quarter"></i> <span data-i18n="knxUltimateMatterControllerDevice.tabs.tunable_white"></span></a></li>
         <li><a href="#tabs-4"><i class="fa-solid fa-palette"></i> <span data-i18n="knxUltimateMatterControllerDevice.tabs.rgb_hsv"></span></a></li>
+        <li><a href="#tabs-mapped"><i class="fa-solid fa-list-check"></i> <span data-i18n="knxUltimateMatterControllerDevice.tabs.mappings"></span></a></li>
         <li><a href="#tabs-6"><i class="fa-solid fa-code-merge"></i> <span data-i18n="knxUltimateMatterControllerDevice.tabs.behaviour"></span></a></li>
       </ul>
+      <div id="tabs-mapped">
+        <div id="matter-mapped-profile" style="display:none;">
+          <div id="matter-mapped-profile-body"></div>
+        </div>
+      </div>
       <div id="tabs-1">
         <p>
         <div class="form-row">
-          <label for="node-input-nameLightSwitch" style="width:110px;"><i class="fa fa-play-circle-o"></i> <span data-i18n="knxUltimateMatterControllerDevice.control"></span></label>
+          <label for="node-input-nameLightSwitch" style="width:110px;"><i class="fa fa-play-circle-o"></i> <span id="matter-switch-command-label" data-i18n="knxUltimateMatterControllerDevice.control"></span></label>
 
           <label for="node-input-GALightSwitch" style="width:20px;"><span data-i18n="common.ga"></span></label>
           <input type="text" id="node-input-GALightSwitch" placeholder="Ex: 1/1/1"
@@ -1578,7 +1715,7 @@
           <input type="text" id="node-input-nameLightSwitch" style="width:190px;margin-left: 5px; text-align: left;">
         </div>
         <div class="form-row">
-          <label for="node-input-nameLightState" style="width:110px;"><i class="fa fa-question-circle"></i> <span data-i18n="knxUltimateMatterControllerDevice.status"></span></label>
+          <label for="node-input-nameLightState" style="width:110px;"><i class="fa fa-question-circle"></i> <span id="matter-switch-status-label" data-i18n="knxUltimateMatterControllerDevice.status"></span></label>
 
           <label for="node-input-GALightState" style="width:20px;"><span data-i18n="common.ga"></span></label>
           <input type="text" id="node-input-GALightState" placeholder="Ex: 1/1/1"
@@ -1591,6 +1728,14 @@
               data-i18n="knxUltimateMatterControllerDevice.node-input-name"></span></label>
           <input type="text" id="node-input-nameLightState" style="width:190px;margin-left: 5px; text-align: left;">
         </div>
+        <div id="matter-door-lock-options" style="display:none;">
+          <div class="form-row">
+            <label for="node-input-doorLockPin" style="width:260px;"><i class="fa fa-key"></i> <span data-i18n="knxUltimateMatterControllerDevice.door_lock_pin"></span></label>
+            <input type="password" id="node-input-doorLockPin" style="width:210px;" autocomplete="new-password">
+          </div>
+          <div id="matter-door-lock-pin-required" class="form-tips" style="display:none;" data-i18n="knxUltimateMatterControllerDevice.door_lock_pin_required"></div>
+          <div id="matter-door-lock-command-warning" class="form-tips" style="display:none; color:#a94442;" data-i18n="knxUltimateMatterControllerDevice.door_lock_commands_missing"></div>
+        </div>
         </p>
       </div>
       <div id="tabs-2">

package/nodes/knxUltimateMatterControllerDevice.js

@@ -9,6 +9,7 @@ const dptlib = require('knxultimate').dptlib
 const hueColorConverter = require('./utils/colorManipulators/hueColorConverter')
 const { createLightEngine } = require('./utils/lightEngines')
 const { hueStateToCanonical, matterEventToHuePatch } = require('./utils/lightEngines/matterHueShim')
+const { setupMatterControllerProfile } = require('./utils/matterControllerProfiles')
 
 module.exports = function (RED) {
   function knxUltimateMatterControllerDevice (config) {
@@ -20,6 +21,10 @@ module.exports = function (RED) {
     node.matterEndpointId = config.matterEndpointId !== undefined ? Number(config.matterEndpointId) : 1
     node.matterDeviceName = config.matterDeviceName !== undefined ? String(config.matterDeviceName) : ''
 
+    let matterCapabilities = {}
+    try { matterCapabilities = JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { /* empty */ }
+    if (setupMatterControllerProfile(matterCapabilities.profile, RED, node, config)) return
+
     // Matter engine (adapter). The manager is resolved lazily at each write, because
     // matter-config creates its matterManager asynchronously after the deploy.
     node.lightEngine = createLightEngine('matter', {

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 | Matter controller | Matter-Controller-Konfigurationsknoten, in dem das Gerät gekoppelt wurde. |
 | Matter device | Matter-Endpunkt aus den gekoppelten Geräten. Die UI wird aus den echten Fähigkeiten neu aufgebaut. |
 | Switch / Steckdose / Licht On-Off | On/Off-Befehls- und Status-Gruppenadressen, normalerweise DPT `1.001`. |
+| Türschloss | Eine DPT-`1.xxx`-Befehls-GA ruft bei `true` `lockDoor` und bei `false` `unlockDoor` auf; eine separate Status-GA erhält nur eindeutige Verriegelt/Entriegelt-Zustände. Falls erforderlich, wird die Fernbedienungs-PIN im Credential-Feld gespeichert. Nicht angebotene Befehle werden abgewiesen. |
+| Andere Endpunkte | Steckdosen, Ein/Aus-Aktoren, Jalousien, Thermostate, Lüfter, Umwelt-/Kontakt-/Belegungssensoren sowie Batterie-, Leistungs- und Energieendpunkte verwenden das Mehrzweckprofil. Der Tab **Zuordnungen** enthält nur tatsächlich angebotene Cluster, Attribute und Befehle. |
 | Lichtsteuerung | Für Licht-Endpunkte wird die vollständige Licht-UI verwendet: relatives DIM (DPT `3.007`), Helligkeit %, RGB/HSV, Tunable White, Einschalt-Helligkeit/-Temperatur, Tag/Nacht-Licht, Min/Max-Dimmlevel und Dimmgeschwindigkeit. Nicht unterstützte Bereiche bleiben ausgeblendet. |
 | Sensoren | Sensor-Endpunkte zeigen ihre Mess-/Status-GA nur bei Unterstützung: Temperatur, Feuchte, Helligkeit, Präsenz, Kontakt und Batterie. |
 | Read at startup | Veröffentlicht den gecachten Matter-Wert beim Deploy/Start oder wenn sich das Gerät erneut verbindet. |

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Einstellbares Weiß",
       "rgb_hsv": "RGB/HSV",
       "effects": "Effekte",
+      "mappings": "Zuordnungen",
       "behaviour": "Verhalten"
     },
     "control": "Steuerung",
     "status": "Status",
+    "door_lock_command": "Verriegeln / entriegeln",
+    "door_lock_status": "Schlossstatus",
+    "door_lock_pin": "PIN für Fernbedienung",
+    "door_lock_pin_required": "Dieses Schloss meldet, dass für die Fernbedienung eine PIN erforderlich ist.",
+    "door_lock_commands_missing": "Dieser Endpunkt bietet nicht beide Befehle zum Verriegeln und Entriegeln an. Fehlende Befehle werden abgewiesen.",
+    "mapped": {
+      "onoff_command": "Ein/Aus-Befehl", "onoff_state": "Ein/Aus-Status", "cover_updown": "Jalousie auf/ab", "cover_stop": "Jalousie Stopp", "cover_position_command": "Positionsbefehl", "cover_position_state": "Positionsstatus", "heating_command": "Heizsollwert-Befehl", "heating_state": "Heizsollwert-Status", "cooling_command": "Kühlsollwert-Befehl", "cooling_state": "Kühlsollwert-Status", "local_temperature": "Lokale Temperatur", "fan_command": "Lüfterdrehzahl-Befehl", "fan_state": "Lüfterdrehzahl-Status", "temperature": "Temperatur", "humidity": "Luftfeuchte", "illuminance": "Beleuchtungsstärke", "occupancy": "Belegung", "contact": "Binär-/Kontaktstatus", "battery": "Batterie", "active_power": "Wirkleistung", "imported_energy": "Bezogene Energie"
+    },
     "night_lighting": "Nachtbeleuchtung",
     "no_night_lighting": "Keine Nachtbeleuchtung",
     "get_current": "Aktuellen Wert holen",
@@ -82,6 +91,7 @@
     "effect_native_label": "Hue-native Effekte",
     "matter_controller": "Matter-Controller",
     "matter_device": "Matter-Gerät",
+    "device_type": "Gerätetyp",
     "matter_section": "Matter-Gerät"
   },
   "common": {

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 | Matter controller | Matter controller configuration node where the device has been commissioned. |
 | Matter device | Matter endpoint selected from commissioned devices. The UI is rebuilt from its real capabilities. |
 | Switch / Plug / Light On-Off | On/Off command and status group addresses, usually DPT `1.001`. |
+| Door Lock | A DPT `1.xxx` command GA invokes `lockDoor` for `true` and `unlockDoor` for `false`; a separate status GA receives only unambiguous Locked/Unlocked states. If the endpoint requires it, store the remote-operation PIN in the credential field. Commands not advertised by the endpoint are rejected. |
+| Other endpoints | Plugs, On/Off actuators, covers, thermostats, fans, environmental/contact/occupancy sensors, battery, power and energy endpoints use the multi-purpose mapped profile. The dedicated **Mappings** tab contains only mappings backed by clusters, attributes and commands advertised by that endpoint; leave a GA empty to disable it. |
 | Light controls | For light endpoints, the same light UI is used: relative DIM (DPT `3.007`), brightness %, RGB/HSV, tunable white, switch-on brightness/temperature, day/night lighting, min/max dim level and dim speed. Unsupported sections are hidden. |
 | Sensors | Sensor endpoints expose their measurement/status GA only when supported: temperature, humidity, illuminance, occupancy, contact and battery. |
 | Read at startup | Publishes the cached Matter value at deploy/startup or when the device reconnects. |

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Tunable white",
       "rgb_hsv": "RGB/HSV",
       "effects": "Effects",
+      "mappings": "Mappings",
       "behaviour": "Behaviour"
     },
     "control": "Control",
     "status": "Status",
+    "door_lock_command": "Lock / unlock",
+    "door_lock_status": "Lock state",
+    "door_lock_pin": "Remote-operation PIN",
+    "door_lock_pin_required": "This lock reports that a PIN is required for remote operation.",
+    "door_lock_commands_missing": "This endpoint does not advertise both lock and unlock commands. Missing commands will be rejected.",
+    "mapped": {
+      "onoff_command": "On / Off command", "onoff_state": "On / Off state", "cover_updown": "Cover up / down", "cover_stop": "Cover stop", "cover_position_command": "Cover position command", "cover_position_state": "Cover position state", "heating_command": "Heating setpoint command", "heating_state": "Heating setpoint state", "cooling_command": "Cooling setpoint command", "cooling_state": "Cooling setpoint state", "local_temperature": "Local temperature", "fan_command": "Fan speed command", "fan_state": "Fan speed state", "temperature": "Temperature", "humidity": "Humidity", "illuminance": "Illuminance", "occupancy": "Occupancy", "contact": "Boolean / contact state", "battery": "Battery", "active_power": "Active power", "imported_energy": "Imported energy"
+    },
     "night_lighting": "Night Lighting",
     "no_night_lighting": "No night lighting",
     "get_current": "Get current",
@@ -82,6 +91,7 @@
     "effect_native_label": "Hue native effects",
     "matter_controller": "Matter controller",
     "matter_device": "Matter device",
+    "device_type": "Device type",
     "matter_section": "Matter device"
   },
   "common": {

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Sustituye a los nodos Matter separados no publicados y conserva toda la UI de lu
 | Matter controller | Nodo de configuración Matter Controller donde el dispositivo fue emparejado. |
 | Dispositivo Matter | Endpoint Matter seleccionado entre los dispositivos emparejados. La UI se reconstruye a partir de sus capacidades reales. |
 | Switch / Enchufe / Luz On-Off | Direcciones de grupo de comando y estado On/Off, normalmente DPT `1.001`. |
+| Cerradura | Una GA de comando DPT `1.xxx` invoca `lockDoor` con `true` y `unlockDoor` con `false`; una GA de estado separada recibe solo estados Bloqueada/Desbloqueada inequívocos. Si el endpoint lo exige, el PIN remoto se guarda en el campo de credencial. Los comandos no anunciados se rechazan. |
+| Otros endpoints | Enchufes, actuadores On/Off, persianas, termostatos, ventiladores, sensores ambientales/de contacto/de ocupación, batería, potencia y energía usan el perfil multipropósito. La pestaña **Mapeos** contiene únicamente las funciones respaldadas por los clústeres, atributos y comandos anunciados. |
 | Controles de luz | Para endpoints de luz se usa la UI de luz completa: DIM relativo (DPT `3.007`), brillo %, RGB/HSV, blanco ajustable, brillo/temperatura al encender, modo día/noche, nivel min/max y velocidad de regulación. Las secciones no soportadas quedan ocultas. |
 | Sensores | Los endpoints de sensor muestran su GA de medida/estado solo cuando está soportado: temperatura, humedad, iluminancia, ocupación, contacto y batería. |
 | Read at startup | Publica el valor Matter en caché al desplegar/iniciar o cuando el dispositivo se reconecta. |

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Blanco sintonizable",
       "rgb_hsv": "RGB/HSV",
       "effects": "Efectos",
+      "mappings": "Mapeos",
       "behaviour": "Comportamiento"
     },
     "control": "Control",
     "status": "Estado",
+    "door_lock_command": "Bloquear / desbloquear",
+    "door_lock_status": "Estado de la cerradura",
+    "door_lock_pin": "PIN de operación remota",
+    "door_lock_pin_required": "La cerradura indica que se requiere un PIN para operaciones remotas.",
+    "door_lock_commands_missing": "Este endpoint no anuncia ambos comandos de bloqueo y desbloqueo. Los comandos ausentes serán rechazados.",
+    "mapped": {
+      "onoff_command": "Comando Encendido / Apagado", "onoff_state": "Estado Encendido / Apagado", "cover_updown": "Persiana subir / bajar", "cover_stop": "Parar persiana", "cover_position_command": "Comando posición persiana", "cover_position_state": "Estado posición persiana", "heating_command": "Comando consigna calefacción", "heating_state": "Estado consigna calefacción", "cooling_command": "Comando consigna refrigeración", "cooling_state": "Estado consigna refrigeración", "local_temperature": "Temperatura local", "fan_command": "Comando velocidad ventilador", "fan_state": "Estado velocidad ventilador", "temperature": "Temperatura", "humidity": "Humedad", "illuminance": "Iluminancia", "occupancy": "Ocupación", "contact": "Estado booleano / contacto", "battery": "Batería", "active_power": "Potencia activa", "imported_energy": "Energía importada"
+    },
     "night_lighting": "Iluminación nocturna",
     "no_night_lighting": "Sin iluminación nocturna",
     "get_current": "Obtener",
@@ -82,6 +91,7 @@
     "effect_native_label": "Efectos nativos de tono",
     "matter_controller": "Controlador Matter",
     "matter_device": "Dispositivo Matter",
+    "device_type": "Tipo de dispositivo",
     "matter_section": "Dispositivo Matter"
   },
   "common": {

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 | Matter controller | Nœud de configuration Matter Controller dans lequel le périphérique a été appairé. |
 | Appareil Matter | Endpoint Matter choisi parmi les appareils appairés. L'UI est reconstruite à partir de ses capacités réelles. |
 | Switch / Prise / Lumière On-Off | Adresses de groupe commande et état On/Off, généralement DPT `1.001`. |
+| Serrure | Une AG de commande DPT `1.xxx` appelle `lockDoor` avec `true` et `unlockDoor` avec `false` ; une AG d'état séparée reçoit uniquement les états Verrouillé/Déverrouillé non ambigus. Si nécessaire, le PIN distant est conservé dans le champ d'identification. Les commandes non annoncées sont refusées. |
+| Autres points de terminaison | Prises, actionneurs On/Off, volets, thermostats, ventilateurs, capteurs d'environnement/contact/occupation, batterie, puissance et énergie utilisent le profil polyvalent. L'onglet **Mappages** contient uniquement les fonctions prises en charge par les clusters, attributs et commandes annoncés. |
 | Contrôles lumière | Pour les endpoints lumière, l'UI lumière complète est utilisée : DIM relatif (DPT `3.007`), luminosité %, RGB/HSV, blanc réglable, luminosité/température à l'allumage, mode jour/nuit, niveau min/max et vitesse de variation. Les sections non supportées restent masquées. |
 | Capteurs | Les endpoints capteur affichent leur GA de mesure/état uniquement si elle est supportée : température, humidité, éclairement, occupation, contact et batterie. |
 | Read at startup | Publie la valeur Matter en cache au déploiement/démarrage ou quand le périphérique se reconnecte. |

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "White à réglage réglable",
       "rgb_hsv": "RVB / HSV",
       "effects": "Effets",
+      "mappings": "Mappages",
       "behaviour": "Comportement"
     },
     "control": "Contrôle",
     "status": "Statut",
+    "door_lock_command": "Verrouiller / déverrouiller",
+    "door_lock_status": "État de la serrure",
+    "door_lock_pin": "PIN d'opération à distance",
+    "door_lock_pin_required": "Cette serrure indique qu'un PIN est requis pour les opérations à distance.",
+    "door_lock_commands_missing": "Ce point de terminaison n'annonce pas les deux commandes de verrouillage et déverrouillage. Les commandes absentes seront refusées.",
+    "mapped": {
+      "onoff_command": "Commande Marche / Arrêt", "onoff_state": "État Marche / Arrêt", "cover_updown": "Volet montée / descente", "cover_stop": "Arrêt volet", "cover_position_command": "Commande position volet", "cover_position_state": "État position volet", "heating_command": "Commande consigne chauffage", "heating_state": "État consigne chauffage", "cooling_command": "Commande consigne refroidissement", "cooling_state": "État consigne refroidissement", "local_temperature": "Température locale", "fan_command": "Commande vitesse ventilateur", "fan_state": "État vitesse ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "État booléen / contact", "battery": "Batterie", "active_power": "Puissance active", "imported_energy": "Énergie importée"
+    },
     "night_lighting": "Éclairage nocturne",
     "no_night_lighting": "Pas d'éclairage de nuit",
     "get_current": "Prendre le courant",
@@ -74,6 +83,7 @@
     "effect_native_label": "Effets natifs de la teinte",
     "matter_controller": "Contrôleur Matter",
     "matter_device": "Appareil Matter",
+    "device_type": "Type d'appareil",
     "matter_section": "Appareil Matter"
   },
   "common": {

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 | Matter controller | Nodo di configurazione Matter Controller in cui il dispositivo è stato associato. |
 | Dispositivo Matter | Endpoint Matter selezionato tra i dispositivi abbinati. La UI viene ricostruita in base alle capability reali. |
 | Switch / Presa / Luce On-Off | Indirizzi di gruppo di comando e stato On/Off, di solito DPT `1.001`. |
+| Serratura | Un GA comando DPT `1.xxx` invoca `lockDoor` con `true` e `unlockDoor` con `false`; un GA di stato separato riceve soltanto gli stati non ambigui Bloccata/Sbloccata. Se richiesto dall'endpoint, salva il PIN per operazioni remote nel campo credential. I comandi non annunciati dall'endpoint vengono rifiutati. |
+| Altri endpoint | Prese, attuatori On/Off, tapparelle, termostati, ventilatori, sensori ambientali/contatto/presenza, batteria, potenza ed energia usano il profilo multi-purpose. La TAB **Mappature** contiene soltanto le funzioni supportate dai cluster, attributi e comandi annunciati dall'endpoint; lascia vuoto un GA per disabilitarlo. |
 | Controlli luce | Per gli endpoint luce viene usata la stessa UI luce completa: DIM relativo (DPT `3.007`), luminosità %, RGB/HSV, bianco dinamico, luminosità/temperatura all'accensione, modalità giorno/notte, livello min/max e velocità dimmer. Le sezioni non supportate restano nascoste. |
 | Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
 | Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Bianco regolabile",
       "rgb_hsv": "RGB/HSV",
       "effects": "Effetti",
+      "mappings": "Mappature",
       "behaviour": "Comportamento"
     },
     "control": "Comando",
     "status": "Stato",
+    "door_lock_command": "Blocca / sblocca",
+    "door_lock_status": "Stato serratura",
+    "door_lock_pin": "PIN operazione remota",
+    "door_lock_pin_required": "La serratura indica che per le operazioni remote è richiesto un PIN.",
+    "door_lock_commands_missing": "L'endpoint non annuncia entrambi i comandi di blocco e sblocco. I comandi mancanti saranno rifiutati.",
+    "mapped": {
+      "onoff_command": "Comando On / Off", "onoff_state": "Stato On / Off", "cover_updown": "Tapparella su / giù", "cover_stop": "Stop tapparella", "cover_position_command": "Comando posizione tapparella", "cover_position_state": "Stato posizione tapparella", "heating_command": "Comando setpoint riscaldamento", "heating_state": "Stato setpoint riscaldamento", "cooling_command": "Comando setpoint raffrescamento", "cooling_state": "Stato setpoint raffrescamento", "local_temperature": "Temperatura locale", "fan_command": "Comando velocità ventilatore", "fan_state": "Stato velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Stato booleano / contatto", "battery": "Batteria", "active_power": "Potenza attiva", "imported_energy": "Energia importata"
+    },
     "night_lighting": "Illuminazione notturna",
     "no_night_lighting": "Nessuna illuminazione notturna",
     "get_current": "Ottieni corrente",
@@ -82,6 +91,7 @@
     "effect_native_label": "Effetti nativi HUE",
     "matter_controller": "Controller Matter",
     "matter_device": "Dispositivo Matter",
+    "device_type": "Tipo dispositivo",
     "matter_section": "Dispositivo Matter"
   },
   "common": {

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

@@ -15,6 +15,8 @@
 | Matter controller | 设备已在其中配网的 Matter Controller 配置节点。 |
 | Matter device | 从已配对设备中选择的 Matter endpoint。UI 会根据真实能力重新构建。 |
 | Switch / 插座 / 灯 On-Off | On/Off 命令和状态组地址，通常使用 DPT `1.001`。 |
+| 门锁 | DPT `1.xxx` 命令组地址以 `true` 调用 `lockDoor`、以 `false` 调用 `unlockDoor`；独立状态组地址仅接收明确的已上锁/已解锁状态。如端点要求，远程操作 PIN 保存在凭据字段中。端点未声明的命令会被拒绝。 |
+| 其他端点 | 插座、开关执行器、窗帘、恒温器、风扇、环境/接点/占用传感器以及电池、功率和电能端点使用多用途映射配置。专用的 **映射** 选项卡仅包含端点实际声明的集群、属性和命令；组地址留空即可禁用。 |
 | 灯光控制 | 对灯光 endpoint 使用完整灯光 UI：相对调光（DPT `3.007`）、亮度百分比、RGB/HSV、色温、开灯亮度/温度、日/夜模式、最小/最大调光等级和调光速度。不支持的部分会隐藏。 |
 | 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
 | Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |

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

@@ -17,10 +17,19 @@
       "tunable_white": "可调白光",
       "rgb_hsv": "RGB/HSV",
       "effects": "效果",
+      "mappings": "映射",
       "behaviour": "行为"
     },
     "control": "控制",
     "status": "状态",
+    "door_lock_command": "上锁 / 解锁",
+    "door_lock_status": "门锁状态",
+    "door_lock_pin": "远程操作 PIN",
+    "door_lock_pin_required": "此门锁报告远程操作需要 PIN。",
+    "door_lock_commands_missing": "此端点未声明完整的上锁和解锁命令；缺失的命令将被拒绝。",
+    "mapped": {
+      "onoff_command": "开/关命令", "onoff_state": "开/关状态", "cover_updown": "窗帘上/下", "cover_stop": "窗帘停止", "cover_position_command": "窗帘位置命令", "cover_position_state": "窗帘位置状态", "heating_command": "制热设定值命令", "heating_state": "制热设定值状态", "cooling_command": "制冷设定值命令", "cooling_state": "制冷设定值状态", "local_temperature": "本地温度", "fan_command": "风扇速度命令", "fan_state": "风扇速度状态", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "布尔/接点状态", "battery": "电池", "active_power": "有功功率", "imported_energy": "输入电能"
+    },
     "night_lighting": "夜间照明",
     "no_night_lighting": "无夜间照明",
     "get_current": "获取当前",
@@ -74,6 +83,7 @@
     "effect_native_label": "Hue 原生效果",
     "matter_controller": "Matter 控制器",
     "matter_device": "Matter 设备",
+    "device_type": "设备类型",
     "matter_section": "Matter 设备"
   },
   "common": {

package/nodes/utils/matterControllerProfiles/doorLock.js

@@ -0,0 +1,210 @@
+'use strict'
+
+const dptlib = require('knxultimate').dptlib
+
+const DOOR_LOCK_CLUSTER_ID = 0x0101
+const LOCK_STATE = {
+  NOT_FULLY_LOCKED: 0,
+  LOCKED: 1,
+  UNLOCKED: 2,
+  UNLATCHED: 3
+}
+
+const decodeKnxBoolean = (msg, dpt) => {
+  if (msg && msg.knx && Buffer.isBuffer(msg.knx.rawValue)) {
+    return !!dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(dpt || '1.001'))
+  }
+  return !!(msg && msg.payload)
+}
+
+const lockStateName = (value) => {
+  switch (Number(value)) {
+    case LOCK_STATE.LOCKED: return 'locked'
+    case LOCK_STATE.UNLOCKED: return 'unlocked'
+    case LOCK_STATE.NOT_FULLY_LOCKED: return 'notFullyLocked'
+    case LOCK_STATE.UNLATCHED: return 'unlatched'
+    default: return 'unknown'
+  }
+}
+
+const lockStateToBoolean = (value) => {
+  if (Number(value) === LOCK_STATE.LOCKED) return true
+  if (Number(value) === LOCK_STATE.UNLOCKED) return false
+  return undefined
+}
+
+const setupDoorLockProfile = (RED, node, config) => {
+  node.name = config.name || node.matterDeviceName || 'Control Matter door lock from KNX'
+  node.topic = node.name
+  node.notifyreadrequest = true
+  node.notifyreadrequestalsorespondtobus = 'false'
+  node.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized = ''
+  node.notifyresponse = false
+  node.notifywrite = true
+  node.initialread = true
+  node.listenallga = true
+  node.outputtype = 'write'
+  node.outputRBE = 'false'
+  node.inputRBE = 'false'
+  node.passthrough = 'no'
+  node.currentLockState = undefined
+  node.knxUltimateAcceptedGAs = [config.GALightSwitch, config.GALightState]
+    .map((ga) => String(ga || '').trim())
+    .filter((ga) => ga !== '')
+
+  const setStatus = (fill, shape, text) => node.status({ fill, shape, text })
+
+  const commandArgs = () => {
+    const pin = String(node.credentials?.doorLockPin || '')
+    return pin === '' ? {} : { pinCode: Buffer.from(pin, 'utf8') }
+  }
+
+  const sendFlow = (source, state, rawState) => {
+    if (config.enableNodePINS !== 'yes') return
+    node.send({
+      topic: node.topic,
+      payload: state,
+      matter: {
+        source,
+        nodeId: node.matterNodeId,
+        endpointId: node.matterEndpointId,
+        clusterId: DOOR_LOCK_CLUSTER_ID,
+        lockState: rawState,
+        lockStateName: rawState === undefined ? (state ? 'locked' : 'unlocked') : lockStateName(rawState)
+      }
+    })
+  }
+
+  const writeKnxState = (state, outputtype = 'write') => {
+    const ga = String(config.GALightState || '').trim()
+    if (ga === '' || !node.serverKNX) return
+    node.serverKNX.sendKNXTelegramToKNXEngine({
+      grpaddr: ga,
+      payload: state,
+      dpt: config.dptLightState || '1.001',
+      outputtype,
+      nodecallerid: node.id
+    })
+  }
+
+  const publishMatterState = (rawState, source = 'matter') => {
+    node.currentLockState = Number(rawState)
+    const state = lockStateToBoolean(rawState)
+    const name = lockStateName(rawState)
+    if (state !== undefined) writeKnxState(state)
+    sendFlow(source, state, rawState)
+    setStatus(state === undefined ? 'yellow' : 'blue', state === undefined ? 'ring' : 'dot', `Matter: ${name}`)
+  }
+
+  const queueCommand = (locked, source = 'knx') => {
+    const manager = node.serverMatter?.matterManager
+    if (!manager) throw new Error('Matter controller not ready')
+    const capabilities = (() => {
+      try { return JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { return {} }
+    })()
+    if (locked && capabilities.lockDoor === false) throw new Error('The Matter endpoint does not expose lockDoor')
+    if (!locked && capabilities.unlockDoor === false) throw new Error('The Matter endpoint does not expose unlockDoor')
+    const queued = manager.writeMatterQueueAdd({
+      nodeId: node.matterNodeId,
+      endpointId: node.matterEndpointId,
+      clusterId: DOOR_LOCK_CLUSTER_ID,
+      kind: 'command',
+      name: locked ? 'lockDoor' : 'unlockDoor',
+      args: commandArgs()
+    })
+    if (queued && typeof queued.catch === 'function') {
+      queued.catch((error) => {
+        RED.log.error(`knxUltimateMatterControllerDevice DoorLock command: ${error.message}`)
+        setStatus('red', 'ring', error.message)
+      })
+    }
+    sendFlow(source, locked)
+    setStatus('green', 'dot', `KNX→Matter: ${locked ? 'lock' : 'unlock'}`)
+  }
+
+  node.handleSend = (msg) => {
+    try {
+      if (!msg?.knx || !node.knxUltimateAcceptedGAs.includes(String(msg.knx.destination || '').trim())) return
+      if (msg.knx.event === 'GroupValue_Read') {
+        if (String(msg.knx.destination) === String(config.GALightState)) {
+          const state = lockStateToBoolean(node.currentLockState)
+          if (state !== undefined) writeKnxState(state, 'response')
+        }
+        return
+      }
+      if (String(msg.knx.destination) !== String(config.GALightSwitch)) return
+      queueCommand(decodeKnxBoolean(msg, config.dptLightSwitch), 'knx')
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock KNX: ${error.message}`)
+      setStatus('red', 'ring', error.message)
+    }
+  }
+
+  node.handleSendMatter = (event) => {
+    try {
+      if (String(event?.nodeId) !== String(node.matterNodeId)) return
+      if (Number(event?.endpointId) !== Number(node.matterEndpointId)) return
+      if (Number(event?.clusterId) !== DOOR_LOCK_CLUSTER_ID || event.attributeName !== 'lockState') return
+      publishMatterState(event.value)
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock Matter: ${error.message}`)
+    }
+  }
+  node.handleMatterClusterEvent = () => {}
+  node.handleMatterNodeInitialized = () => {
+    try {
+      const value = node.serverMatter?.matterManager?.getCachedAttribute(
+        node.matterNodeId,
+        node.matterEndpointId,
+        DOOR_LOCK_CLUSTER_ID,
+        'lockState'
+      )
+      if (value !== undefined && value !== null) publishMatterState(value, 'initial')
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock initial state: ${error.message}`)
+    }
+  }
+  node.setNodeStatusMatter = (status) => {
+    if (status && status.text) setStatus(status.fill || 'grey', status.shape || 'ring', status.text)
+  }
+
+  if (node.serverKNX) {
+    node.serverKNX.removeClient(node)
+    node.serverKNX.addClient(node)
+  } else {
+    setStatus('yellow', 'ring', 'No KNX gateway selected')
+  }
+  if (node.serverMatter) {
+    node.serverMatter.removeClient(node)
+    node.serverMatter.addClient(node)
+  }
+
+  node.on('input', (msg, send, done) => {
+    try {
+      const value = typeof msg.payload === 'object' && msg.payload !== null && msg.payload.locked !== undefined
+        ? msg.payload.locked
+        : msg.payload
+      if (typeof value !== 'boolean') throw new Error('Door Lock input requires msg.payload boolean or { locked: boolean }')
+      queueCommand(value, 'flow')
+      if (done) done()
+    } catch (error) {
+      setStatus('red', 'ring', error.message)
+      if (done) done(error)
+      else node.error(error, msg)
+    }
+  })
+
+  node.on('close', (done) => {
+    try { if (node.serverKNX) node.serverKNX.removeClient(node) } catch (error) { /* empty */ }
+    try { if (node.serverMatter) node.serverMatter.removeClient(node) } catch (error) { /* empty */ }
+    done()
+  })
+}
+
+module.exports = {
+  DOOR_LOCK_CLUSTER_ID,
+  LOCK_STATE,
+  lockStateName,
+  lockStateToBoolean,
+  setupDoorLockProfile
+}

package/nodes/utils/matterControllerProfiles/index.js

@@ -0,0 +1,21 @@
+'use strict'
+
+const { setupDoorLockProfile } = require('./doorLock')
+const { setupMappedEndpointProfile } = require('./mappedEndpoint')
+
+// Controller-side Matter device profiles live behind this registry.  Keep profile
+// selection capability-driven: the editor records the profile only after inspecting
+// the endpoint's actual device types, clusters, attributes and supported commands.
+const PROFILE_SETUPS = Object.freeze({
+  doorLock: setupDoorLockProfile,
+  mapped: setupMappedEndpointProfile
+})
+
+const setupMatterControllerProfile = (profile, RED, node, config) => {
+  const setup = PROFILE_SETUPS[profile]
+  if (typeof setup !== 'function') return false
+  setup(RED, node, config)
+  return true
+}
+
+module.exports = { PROFILE_SETUPS, setupMatterControllerProfile }

package/nodes/utils/matterControllerProfiles/mappedEndpoint.js

@@ -0,0 +1,148 @@
+'use strict'
+
+const dptlib = require('knxultimate').dptlib
+const { knxToMatter, matterToKnx } = require('../matterKnxConverter')
+
+const isValidGroupAddress = (value) => {
+  const parts = String(value || '').trim().split('/')
+  if (parts.length !== 3 || parts.some((part) => !/^\d+$/.test(part))) return false
+  const [main, middle, sub] = parts.map(Number)
+  return main >= 0 && main <= 31 && middle >= 0 && middle <= 7 && sub >= 0 && sub <= 255
+}
+
+const parseMappings = (value) => {
+  try {
+    const parsed = Array.isArray(value) ? value : JSON.parse(value || '[]')
+    return parsed.filter((mapping) => {
+      if (!mapping || !isValidGroupAddress(mapping.ga) || !mapping.target || !mapping.dpt) return false
+      try { dptlib.resolve(mapping.dpt); return true } catch (error) { return false }
+    })
+  } catch (error) {
+    return []
+  }
+}
+
+const setupMappedEndpointProfile = (RED, node, config) => {
+  node.name = config.name || node.matterDeviceName || 'Control Matter from KNX'
+  node.topic = node.name
+  node.mappings = parseMappings(config.matterMappings)
+  node.knxUltimateAcceptedGAs = [...new Set(node.mappings.map((mapping) => String(mapping.ga).trim()))]
+  node.notifyreadrequest = true
+  node.notifyreadrequestalsorespondtobus = 'false'
+  node.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized = ''
+  node.notifyresponse = false
+  node.notifywrite = true
+  node.initialread = true
+  node.listenallga = true
+  node.outputtype = 'write'
+  node.outputRBE = 'false'
+  node.inputRBE = 'false'
+  node.passthrough = 'no'
+  const enablePins = config.enableNodePINS === 'yes'
+  let lastInitialReadTs = 0
+
+  const status = (fill, shape, text) => node.status({ fill, shape, text })
+  const manager = () => node.serverMatter?.matterManager
+  const sendKnx = (mapping, payload, outputtype = 'write') => {
+    if (payload === undefined || !node.serverKNX) return false
+    node.serverKNX.sendKNXTelegramToKNXEngine({
+      grpaddr: mapping.ga,
+      payload,
+      dpt: mapping.dpt,
+      outputtype,
+      nodecallerid: node.id
+    })
+    return true
+  }
+  const sendCached = (mapping, outputtype) => {
+    const currentManager = manager()
+    if (!currentManager) return false
+    const value = currentManager.getCachedAttribute(node.matterNodeId, mapping.endpointId, mapping.clusterId, mapping.target)
+    return sendKnx(mapping, matterToKnx(mapping.clusterId, mapping.target, value), outputtype)
+  }
+  const enqueue = (mapping, value) => {
+    const currentManager = manager()
+    if (!currentManager) throw new Error('Matter controller not ready')
+    const action = knxToMatter(mapping, value)
+    if (!action) return
+    const queued = currentManager.writeMatterQueueAdd({
+      nodeId: node.matterNodeId,
+      endpointId: mapping.endpointId,
+      clusterId: mapping.clusterId,
+      kind: action.kind,
+      name: action.name,
+      args: action.args
+    })
+    if (queued && typeof queued.catch === 'function') queued.catch((error) => status('red', 'ring', error.message))
+  }
+
+  node.handleSend = (msg) => {
+    try {
+      if (!msg?.knx || !node.knxUltimateAcceptedGAs.includes(String(msg.knx.destination || '').trim())) return
+      const matches = node.mappings.filter((mapping) => mapping.ga === msg.knx.destination)
+      if (msg.knx.event === 'GroupValue_Read') {
+        matches.filter((mapping) => mapping.direction === 'status').forEach((mapping) => sendCached(mapping, 'response'))
+        return
+      }
+      matches.filter((mapping) => mapping.direction === 'command').forEach((mapping) => {
+        const value = dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(mapping.dpt))
+        enqueue(mapping, value)
+      })
+      status('green', 'dot', 'KNX→Matter')
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice mapped KNX: ${error.message}`)
+      status('red', 'ring', error.message)
+    }
+  }
+  node.handleSendMatter = (event) => {
+    try {
+      if (String(event?.nodeId) !== String(node.matterNodeId) || Number(event?.endpointId) !== Number(node.matterEndpointId)) return
+      node.mappings.filter((mapping) => mapping.direction === 'status' && Number(mapping.clusterId) === Number(event.clusterId) && mapping.target === event.attributeName).forEach((mapping) => {
+        sendKnx(mapping, matterToKnx(event.clusterId, event.attributeName, event.value))
+      })
+      if (enablePins) node.send({ topic: `${event.clusterId}.${event.attributeName}`, payload: event.value, matter: event })
+      status('blue', 'dot', `Matter→KNX: ${event.attributeName}`)
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice mapped Matter: ${error.message}`)
+      status('red', 'ring', error.message)
+    }
+  }
+  node.handleMatterClusterEvent = (event) => {
+    if (enablePins && String(event?.nodeId) === String(node.matterNodeId) && Number(event?.endpointId) === Number(node.matterEndpointId)) {
+      node.send({ topic: `${event.clusterId}.${event.eventName}`, payload: event.events, matter: event })
+    }
+  }
+  node.handleMatterNodeInitialized = () => {
+    if (config.readStatusAtStartup === 'no' || Date.now() - lastInitialReadTs < 5000) return
+    let sent = 0
+    node.mappings.filter((mapping) => mapping.direction === 'status').forEach((mapping) => { if (sendCached(mapping, 'write')) sent += 1 })
+    if (sent > 0) lastInitialReadTs = Date.now()
+  }
+  node.setNodeStatusMatter = (value) => { if (value?.text) status(value.fill || 'grey', value.shape || 'ring', value.text) }
+
+  if (node.serverKNX) { node.serverKNX.removeClient(node); node.serverKNX.addClient(node) } else status('yellow', 'ring', 'No KNX gateway selected')
+  if (node.serverMatter) { node.serverMatter.removeClient(node); node.serverMatter.addClient(node) }
+  node.on('input', (msg, send, done) => {
+    try {
+      const payload = msg.payload || {}
+      const mapping = {
+        endpointId: payload.endpointId ?? node.matterEndpointId,
+        clusterId: payload.clusterId,
+        targetKind: payload.command !== undefined ? 'command' : 'attribute',
+        target: payload.command ?? payload.attribute
+      }
+      if (!mapping.target || mapping.clusterId === undefined) throw new Error('Matter input requires clusterId and command or attribute')
+      enqueue(mapping, payload.args ?? payload.value)
+      if (done) done()
+    } catch (error) {
+      if (done) done(error); else node.error(error, msg)
+    }
+  })
+  node.on('close', (done) => {
+    try { if (node.serverKNX) node.serverKNX.removeClient(node) } catch (error) { /* empty */ }
+    try { if (node.serverMatter) node.serverMatter.removeClient(node) } catch (error) { /* empty */ }
+    done()
+  })
+}
+
+module.exports = { isValidGroupAddress, parseMappings, setupMappedEndpointProfile }

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.0.6",
+  "version": "6.0.7",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",
@@ -99,7 +99,11 @@
     "smarthome",
     "routing"
   ],
-  "author": "Massimo Saccani (Supergiovane)",
+  "author": {
+    "name": "Massimo Saccani",
+    "email": "maxsupergiovane@icloud.com",
+    "url": "https://youtube.com/@maxsupervibe"
+  },
   "license": "MIT",
   "scripts": {
     "build": "npm run knx-ai:build && npm run knx-viewer:build",