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

package/CHANGELOG.md

@@ -6,8 +6,13 @@
 
 # CHANGELOG
 
-**Version 6.0.6** - July 2026<br/>
+**Version 6.0.8** - July 2026<br/>
 
+- **Control Matter from KNX — profile deploy crash**: Door Lock and multi-purpose profiles now expose the KNX status callback before registering with `knxUltimate-config`, preventing `_Node.setNodeStatus is not a function` during deploy.<br/>
+- **Control Matter from KNX — flow PIN persistence**: the **Node Input/Output PINs** selection is no longer overwritten from the KNX gateway presence when reopening the editor. The saved choice remains authoritative and `inputs`/`outputs` are updated coherently on save.<br/>
+- **Matter terminology cleanup**: removed leftover Philips Hue wording from Matter controller labels, notifications, runtime status, localized strings and help. Backward-compatible saved configuration keys remain unchanged.<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",
@@ -215,7 +219,7 @@
           ensureVerticalTabsStyle();
           const $knxServerInput = $("#node-input-server");
           const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
-          // Variable names kept from the Hue-born code; they now point to the Matter widgets.
+          // Historical variable names are retained for saved-flow compatibility; they point to Matter widgets.
           const $hueServerInput = $("#node-input-serverMatter");
           const $hueDeviceInput = $("#node-input-matterNodeId");
           const $deviceNameInput = $("#node-input-matterDeviceName");
@@ -283,8 +287,8 @@
               $icon.removeClass('fa-stop fa-play').addClass(locateSessionActive ? 'fa fa-stop' : 'fa fa-play');
             }
             const title = locateSessionActive
-              ? (node._('knxUltimateMatterControllerDevice.locate_stop_title') || 'Stop Hue locate')
-              : (node._('knxUltimateMatterControllerDevice.locate_start_title') || 'Locate selected Hue device');
+              ? (node._('knxUltimateMatterControllerDevice.locate_stop_title') || 'Stop Matter locate')
+              : (node._('knxUltimateMatterControllerDevice.locate_start_title') || 'Locate selected Matter device');
             $locateDeviceButton.attr('title', title);
           };
 
@@ -340,8 +344,8 @@
             if (!context) {
               if (!silent) {
                 const message = !resolveHueServerValue({ allowStored: true })
-                  ? (node._('knxUltimateMatterControllerDevice.locate_no_bridge') || 'Select a Hue bridge first')
-                  : (node._('knxUltimateMatterControllerDevice.locate_no_device') || 'Select a Hue device first');
+                  ? (node._('knxUltimateMatterControllerDevice.locate_no_bridge') || 'Select a Matter controller first')
+                  : (node._('knxUltimateMatterControllerDevice.locate_no_device') || 'Select a Matter device first');
                 RED.notify(message, 'warning');
               }
               updateLocateButtonState(false);
@@ -410,7 +414,7 @@
               updateLocateButtonState(false);
               clearLocateAutoReset();
               if (!silent) {
-                RED.notify(message || (node._('knxUltimateMatterControllerDevice.locate_error') || 'Unable to locate Hue device'), 'error');
+                RED.notify(message || (node._('knxUltimateMatterControllerDevice.locate_error') || 'Unable to locate Matter device'), 'error');
               }
             }).always(() => {
               locatePendingRequest = null;
@@ -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,
@@ -568,7 +627,7 @@
           const serializeMatterCapabilities = (capabilities) => JSON.stringify(capabilities || {});
           const getJSONPromise = (url) => new Promise((resolve, reject) => { $.getJSON(url, resolve).fail(reject); });
 
-          // Same name/contract as the Hue filter, on Matter items { value, matterNodeId, matterEndpointId }.
+          // Filters Matter items shaped as { value, matterNodeId, matterEndpointId }.
           const filterHueDevices = (devices, term) => {
             const cleaned = (term || '').replace(/exactmatch/gi, '').trim();
             return $.map(devices, (item) => {
@@ -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);
@@ -697,11 +757,11 @@
             $.getJSON(`knxUltimateDpts?serverId=${serverId}&_=${Date.now()}`, (data) => {
               data.forEach((dpt) => {
                 if (prefixes.some((prefix) => prefix === "" || dpt.value.startsWith(prefix))) {
-                  // Adjustment for HUE Temperature
+                  // Adjustment for Matter color temperature
                   if (dpt.value.startsWith("7.600")) {
                     $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - KNX Kelvin range 2000-6535k (Homeassistant color_temperature_mode: absolute)"));
                   } else if (dpt.value.startsWith("9.002")) {
-                    $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - HUE Kelvin range 2000-6535k (Homeassistant color_temperature_mode: absolute_float)"));
+                    $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - Matter Kelvin range 2000-6535 K (Home Assistant color_temperature_mode: absolute_float)"));
                   } else if (dpt.value.startsWith("5.001")) {
                     $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - Homeassistant color_temperature_mode: relative"));
                   } else {
@@ -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() !== '';
@@ -973,13 +1084,6 @@
             }
             applyMatterCapabilities(currentMatterCapabilities);
 
-            if ($pinSelect.length) {
-              const desiredPins = knxSelected ? 'no' : 'yes';
-              if ($pinSelect.val() !== desiredPins) {
-                $pinSelect.val(desiredPins).trigger('change');
-              }
-            }
-
             if ($pinSectionRow.length) {
               $pinSectionRow.show();
             }
@@ -1125,7 +1229,7 @@
               .append($("<option>").val("temperature").text(node._("knxUltimateMatterControllerDevice.select_temperature_brightness")));
             $("#node-input-specifySwitchOnBrightness").val(node.specifySwitchOnBrightness);
             $("#node-input-enableDayNightLighting").val(node.enableDayNightLighting);
-            // "Get current" reads the state from the Hue bridge: not available on Matter.
+            // Live "Get current" reads are not available on this Matter path.
             $("#getColorAtSwitchOnDayTimeButton").hide();
             $("#getColorAtSwitchOnNightTimeButton").hide();
             applyMatterCapabilities(currentMatterCapabilities);
@@ -1150,8 +1254,8 @@
             if ($("#node-input-enableDayNightLighting").val() === "yes") blinkBackground("#colorPickerNight");
           });
 
-          // "Get current" (reading the live state from the Hue bridge) does not exist on
-          // Matter: the buttons are hidden by populateSwitchOnCombos above.
+          // Live "Get current" reads do not exist on this Matter path; the buttons are
+          // hidden by populateSwitchOnCombos above.
 
           // Fill options for minDimLevel and maxDimLevel and comboBrightnessAtSwitchOn (for color brightness at switch on, with temperature toghedher)
           for (let index = 100; index >= 0; index -= 5) {
@@ -1321,6 +1425,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 +1664,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 +1684,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 +1708,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 +1721,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">
@@ -2006,14 +2144,13 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-<p>This node controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
+<p>This node controls commissioned Matter endpoints and maps their commands and states to KNX.</p>
 
 **General**
 
-This node was born from the Hue Light node: same KNX group-address model and behaviour,
-with the Philips Hue engine replaced by the **Matter controller** engine. A Matter bridge
-(for example a Hue Bridge paired via Matter) is expanded into its lamps in the picker.
-Hue-only features (native effects, locate) are not available on Matter.
+The editor detects the selected endpoint capabilities and exposes only the corresponding
+Matter functions. Bridged Matter devices are expanded into their individual endpoints in
+the device picker.
 
 |Property|Description|
 |--|--|
@@ -2025,14 +2162,14 @@ Hue-only features (native effects, locate) are not available on Matter.
 
 **OPTIONS**
 
-Here you can link KNX Group Addresses to the available Hue commands/states.<br/>
+Here you can link KNX Group Addresses to the available Matter commands and states.<br/>
 Start typing in the GA field (name or Group Address); suggestions appear while you type.
 
 **Switch**
 
 |Property|Description|
 |--|--|
-| Control | This GA is used to turn on/off the Hue light via a boolean KNX value true/false|
+| Control | This GA turns the Matter light on or off via a boolean KNX value true/false. |
 | Status | Link this to the light's switch status group address|
 
 <br/>
@@ -2041,8 +2178,8 @@ Start typing in the GA field (name or Group Address); suggestions appear while y
 
 |Property|Description|
 |--|--|
-| Control dim | Relative DIM of the Hue light. You can set the dimming speed in the **Behaviour** tab. |
-| Control % | Changes the absolute Hue light's brightness (0-100%)|
+| Control dim | Relative DIM of the Matter light. You can set the dimming speed in the **Behaviour** tab. |
+| Control % | Changes the absolute Matter light brightness (0-100%). |
 | Status % | Link this to the light's brightness status KNX group address |
 | Dim Speed (ms) | Dimming speed in milliseconds. Applies to both the light brightness and the tunable-white datapoints. Calculated over the 0%→100% range. |
 | Min Dim brightness | Tha Minimum brightness that the lamp can reach. For example, if you are dimming the light down, the light will stop dimming at the specified brightness %. |
@@ -2057,8 +2194,8 @@ Start typing in the GA field (name or Group Address); suggestions appear while y
 | Control dim | Change white temperature using DPT 3.007 dimming. Speed is set in the **Behaviour** tab.|
 | Control % | Change white temperature using DPT 5.001. 0 = full warm, 100 = full cold.|
 | Status %| Temperature status GA. DPT 5.001 absolute value: 0 = full warm, 100 = full cold.|
-| Control kelvin | **DPT 7.600: ** set temperature in Kelvin using the KNX range 2000-6535 (converted to Hue mirek).<br/>**DPT 9.002:** set temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations.|
-| Status kelvin | **DPT 7.600: ** read temperature in Kelvin using KNX range 2000-6535 (converted from Hue).<br/>**DPT 9.002:** read temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations. |
+| Control kelvin | **DPT 7.600:** set the Matter color temperature in Kelvin in the supported endpoint range.<br/>**DPT 9.002:** set the temperature as a KNX floating-point value. Conversions may introduce small deviations. |
+| Status kelvin | **DPT 7.600:** read the Matter color temperature in Kelvin.<br/>**DPT 9.002:** read the temperature as a KNX floating-point value. |
 | Invert dim direction | Inverts the DIM direction. |
 <br/>
 
@@ -2082,12 +2219,12 @@ For controlling the HSV "V” (brightness), use the standard controls under the
 
 **Effects**
 
-_Non-Hue basic effects_
+_Basic Matter effects_
 
 |Property|Description|
 |--|--|
-| Blink | _true_ Blink the light, _false_ Stop blinking. Blinks the light on and off. Useful for signalling. Works with all Hue lights. |
-| Color Cycle | _true_ start cycle, _false_ Stop cycle. Randomly changes the Hue light's color at regular interval. Works with all Hue lights having color capabilities. The color effect will start 10 seconds after set. |
+| Blink | _true_ blinks the light, _false_ stops blinking. Useful for signalling and available on compatible Matter lights. |
+| Color Cycle | _true_ starts the cycle, _false_ stops it. Randomly changes the Matter light color at regular intervals when color control is supported. |
 
 <br/>
 
@@ -2095,16 +2232,16 @@ _Non-Hue basic effects_
 
 | Property | Description |
 | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Read status at startup | Read the Hue light status at node-red's startup or node-red's full deploy, and send that status to the KNX BUS |
-| KNX Brightness Status | Updates the KNX brightness group address status, whenever the Hue lamp is switched ON/OFF. The options are **When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour) ** and**Leave as is (default Hue behaviour) ** . If you have KNX dimmer with brightness status, like MDT, the suggested option is _**When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour)** _ |
-| Update local cached Hue state from KNX bus writes | Advanced option, enabled by default. When enabled, writes arriving from the KNX bus also update the node's local cached Hue state immediately, without waiting for feedback/events from the Hue bridge. This gives faster local reactions and more consistent immediate KNX read responses, especially while the light or grouped light is OFF. Disable it if you prefer the cache to follow only real feedback/events from the Hue bridge. |
+| Read status at startup | Read the Matter endpoint status at Node-RED startup or full deploy and send it to the KNX bus. |
+| KNX Brightness Status | Updates the KNX brightness status whenever the Matter light switches ON/OFF. It can send 0% while OFF and restore the previous value when ON, or leave the brightness status unchanged. |
+| Update local cached Matter state from KNX bus writes | When enabled, KNX writes immediately update the local Matter-state cache without waiting for the endpoint report. Disable it if the cache should follow only real Matter reports. |
 | Switch on behaviour | It sets the behaviour of your lights when switched on. You can choose from differents behaviours.<br/> **Select color: ** the light will be switched on with the color of your choice. To change color, just CLICK on the color selector (under the _Select color_ control).<br/>**Select temperature and brightness: ** the light will be switched on with the temperature (Kelvin) and brightness (0-100) of your choice.<br/>**None:** the light will retain its last status. In case you've enable the night lighting, after the night time ends, the lamp will resume the color/temperature/brightness state set at day time. |
 | Night Lighting | It allows to set a particular light color/brightness at nighttime. The options are the same as the daytime. You could select either a temperature/brightness or color. A cozy temperature of 2700 Kelvin, with a brightness of 10% or 20%, is a good choice for bathroom's night light.|
 | Day/Night | Select the group address used to set the day/night behaviour. The group address value is _true_ if daytime, _false_ if nighttime. |
 | Invert day/night value | Invert the values of _Day/Night_ group address. Default value is **unchecked** . |
 | Read status at startup | Read the status at startup and emit the event to the KNX bus at startup/reconnection. (Default "no")|
 | Force day mode | You can force the day mode by manually switching the light as described here: **Switch to DAY mode by rapid switching the ligth off then on (This light only) ** does what described and acts only on this light.**Switch to DAY mode by rapid switching the ligth off then on (apply yo ALL light nodes)** acts to ALL Light nodes, by setting the Day/Night group address to Day mode. |
-| Node Input/Output PINs | Hide or show the input/output PINs. Input/output PINS allow the node to accept msg input from the flow and send msg output to the flow. Input msg must follow the Hue API v.2 Standards. This is an example msg, that turns on the light: <code>msg.on = {"on":true}</code>. Please refer to the [official Hue Api page](https://developers.meethue.com/develop/hue-api-v2/api-reference/#resource_light__id__put) |
+| Node Input/Output PINs | Hide or show the flow input/output PINs. The input accepts supported Matter commands and the output emits validated Matter endpoint events. The selection is persisted with the node. |
 
 ### Note
 

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', {
@@ -110,8 +115,8 @@ module.exports = function (RED) {
       config.GADaylightSensor
     ].map((ga) => String(ga || '').trim()).filter((ga) => ga !== '')
     const isConfiguredKNXGA = (ga) => node.knxUltimateAcceptedGAs.includes(String(ga || '').trim())
-    // Synthetic "current device" in Hue shape, kept in sync from the Matter attribute
-    // reports. It lets the whole Hue-born logic below run untouched on a Matter light.
+    // Synthetic current-device compatibility state, kept in sync from Matter attribute
+    // reports. It lets the established light logic run untouched on a Matter light.
     node.currentHUEDevice = {
       id: node.matterNodeId,
       type: 'light',
@@ -216,14 +221,14 @@ module.exports = function (RED) {
         node.status({ fill, shape, text: (node.sHUENodeStatusText || '') + ' ' + (node.sKNXNodeStatusText || '') })
       } catch (error) { }
     }
-    // Used to call the status update from the HUE config node.
+    // Compatibility callback used to update the Matter node status.
     node.setNodeStatusHue = ({ fill, shape, text, payload }) => {
       try {
         if (node.currentHUEDevice?.on?.on === true) { fill = 'blue'; shape = 'dot' } else { fill = 'blue'; shape = 'ring' };
         if (payload === undefined) payload = ''
         const dDate = new Date()
         payload = typeof payload === 'object' ? JSON.stringify(payload) : payload.toString()
-        node.sHUENodeStatusText = `|HUE: ${text} ${payload} (${formatTs(dDate)})`
+        node.sHUENodeStatusText = `|Matter: ${text} ${payload} (${formatTs(dDate)})`
         node.status({ fill, shape, text: node.sHUENodeStatusText + ' ' + (node.sKNXNodeStatusText || '') })
       } catch (error) { }
     }
@@ -318,7 +323,7 @@ module.exports = function (RED) {
       return Math.floor(Math.random() * (max - min + 1) + min) // The maximum is inclusive and the minimum is inclusive
     }
 
-    // This function is called by the hue-config.js
+    // Compatibility callback invoked by the Matter controller adapter.
     node.handleSend = (msg) => {
       if (!msg || !msg.knx || !isConfiguredKNXGA(msg.knx.destination)) return
       if (node.currentHUEDevice === undefined && node.serverHue.linkStatus === 'connected') {
@@ -1161,7 +1166,7 @@ module.exports = function (RED) {
           node.setNodeStatusHue({
             fill: 'red',
             shape: 'ring',
-            text: "Rejected HUE light settings. I'm still not ready...",
+            text: "Rejected Matter light settings. I'm still not ready...",
             payload: ''
           })
           return

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -15,11 +15,13 @@ 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. |
 | Update local state from KNX write | Aktualisiert den lokalen Matter/KNX-Cache, wenn ein Telegramm auf eine konfigurierte KNX-GA geschrieben wird. |
-| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Der Eingang akzeptiert boolesche Payloads sowie Matter-ähnliche `msg.payload` oder `msg.on.on`; der Ausgang sendet Statusupdates. |
+| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Der Eingang akzeptiert boolesche Payloads sowie Matter-ähnliche `msg.payload` oder `msg.on.on`; der Ausgang sendet Statusupdates. Die Auswahl bleibt beim erneuten Öffnen des Editors erhalten. |
 
 ## Verhalten