node-red-contrib-knx-ultimate 6.0.11 → 6.1.0

package/nodes/knxUltimateMatterControllerDevice.html

@@ -14,6 +14,16 @@
         //buttonState: {value: true},
         server: { type: "knxUltimate-config", required: false },
         serverMatter: { type: "matter-config", required: true },
+        matterControllerMode: { value: "single" },
+        universalService: { value: "batteryMonitor" },
+        universalBatteryThreshold: { value: 20, validate: RED.validators.number() },
+        universalLowBatteryGA: { value: "" },
+        universalLowBatteryGAName: { value: "" },
+        universalLowBatteryTextGA: { value: "" },
+        universalLowBatteryTextGAName: { value: "" },
+        universalBatteryOnlyLow: { value: true },
+        universalEmitInitialState: { value: true },
+        universalIncludeRawEvent: { value: true },
         matterNodeId: { value: "" },
         matterEndpointId: { value: 1 },
         matterDeviceName: { value: "" },
@@ -142,6 +152,14 @@
 
 
         var node = this; // Starting from v 4.1.31
+        if (node.id) {
+          $.ajax({
+            url: "KNXUltimateMatterControllerEnable",
+            type: "POST",
+            contentType: "application/json",
+            data: JSON.stringify({ nodeId: node.id })
+          });
+        }
         $("#node-input-updateLocalStateFromKNXWrite").prop("checked", node.updateLocalStateFromKNXWrite === true || node.updateLocalStateFromKNXWrite === "true"); // Starting from v 4.1.31
         const ensureConfigSelection = (selector) => {
           if ($(selector).val() !== "_ADD_") return;
@@ -211,6 +229,31 @@
                 border-top: 1px solid #ccc;
                 margin: 8px 0;
               }
+              .matter-input-help-table {
+                width: 100%;
+                border-collapse: collapse;
+                margin: 8px 0 18px;
+              }
+              .matter-input-help-table th,
+              .matter-input-help-table td {
+                border-bottom: 1px solid #ddd;
+                padding: 7px 6px;
+                text-align: left;
+                vertical-align: top;
+              }
+              .matter-input-help-table code {
+                white-space: pre-wrap;
+                word-break: break-word;
+              }
+              .matter-input-help-copy {
+                white-space: nowrap;
+              }
+              .matter-input-help-advanced {
+                max-height: 310px;
+                overflow: auto;
+                border: 1px solid #ddd;
+                padding: 0 8px;
+              }
             </style>`;
           $('head').append(style);
         }
@@ -221,6 +264,8 @@
           const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
           // Historical variable names are retained for saved-flow compatibility; they point to Matter widgets.
           const $hueServerInput = $("#node-input-serverMatter");
+          const $matterControllerModeInput = $("#node-input-matterControllerMode");
+          const $universalServiceInput = $("#node-input-universalService");
           const $hueDeviceInput = $("#node-input-matterNodeId");
           const $deviceNameInput = $("#node-input-matterDeviceName");
           const $matterEndpointInput = $("#node-input-matterEndpointId");
@@ -229,6 +274,10 @@
           const $refreshDevicesButton = $(".hue-refresh-devices");
           const $locateDeviceButton = $(".hue-locate-device");
           const $hueDevicesLoading = $(".hue-devices-loading");
+          const $inputHelpPanel = $("#tabs-input");
+          const UNIVERSAL_NODE_ID = '__UNIVERSAL__';
+          const isUniversalMode = () => $matterControllerModeInput.val() === 'universal';
+          $matterControllerModeInput.val(node.matterControllerMode || 'single');
           let cachedHueDevices = Array.isArray(node._cachedHueLightDevices) ? node._cachedHueLightDevices : [];
           node._cachedHueLightDevices = cachedHueDevices;
           const defaultHueDevicePlaceholder = $deviceNameInput.attr('placeholder') || '';
@@ -289,7 +338,10 @@
             const title = locateSessionActive
               ? (node._('knxUltimateMatterControllerDevice.locate_stop_title') || 'Stop Matter locate')
               : (node._('knxUltimateMatterControllerDevice.locate_start_title') || 'Locate selected Matter device');
-            $locateDeviceButton.attr('title', title);
+            $locateDeviceButton.attr('title', isUniversalMode()
+              ? (node._('knxUltimateMatterControllerDevice.universal_mode_locate_disabled') || 'Locate is unavailable in Universal Mode.')
+              : title);
+            $locateDeviceButton.prop('disabled', isUniversalMode());
           };
 
           const removeNodeRemovalListener = () => {
@@ -340,6 +392,10 @@
           };
 
           const performLocateRequest = ({ silent = false, allowStoredContext = false, action } = {}) => {
+            if (isUniversalMode()) {
+              if (!silent) RED.notify(node._('knxUltimateMatterControllerDevice.universal_mode_locate_disabled') || 'Locate is unavailable in Universal Mode.', 'warning');
+              return null;
+            }
             const context = buildLocateContext({ allowStored: allowStoredContext });
             if (!context) {
               if (!silent) {
@@ -419,7 +475,7 @@
             }).always(() => {
               locatePendingRequest = null;
               if ($locateDeviceButton.length) {
-                $locateDeviceButton.prop('disabled', false);
+                $locateDeviceButton.prop('disabled', isUniversalMode());
               }
             });
             return request;
@@ -527,6 +583,19 @@
             return !!cluster && (cluster.commands || []).some((cmd) => wanted.has(normalizeMatterToken(cmd.name)));
           };
           const matterCapabilitiesFromEndpoint = (ep) => {
+            const inputStructure = {
+              endpointId: Number(ep.endpointId),
+              clusters: (ep.clusters || []).map((cluster) => ({
+                id: Number(cluster.id),
+                name: cluster.name || '',
+                attributes: (cluster.attributes || []).map((attribute) => ({
+                  id: Number(attribute.id),
+                  name: attribute.name,
+                  writable: attribute.writable === true
+                })),
+                commands: (cluster.commands || []).map((command) => ({ name: command.name }))
+              }))
+            };
             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);
@@ -546,6 +615,7 @@
                 color: false,
                 lockDoor: hasMatterCommand(doorLockCluster, ['lockDoor']),
                 unlockDoor: hasMatterCommand(doorLockCluster, ['unlockDoor']),
+                inputStructure,
                 requirePinForRemoteOperation: (() => {
                   const attribute = (doorLockCluster.attributes || []).find((item) => normalizeMatterToken(item.name) === 'requirepinforremoteoperation');
                   return attribute ? attribute.value === true : false;
@@ -589,47 +659,79 @@
               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: specializedProfile, deviceTypeDisplay, onOff: false, level: false, colorTemperature: false, color: false, mappedTargets };
+              return { known: true, profile: specializedProfile, deviceTypeDisplay, onOff: false, level: false, colorTemperature: false, color: false, mappedTargets, inputStructure };
             }
             const hasColorTemperatureType = /colortemperature|extendedcolor/.test(typeText);
             const hasColorType = /extendedcolor/.test(typeText);
+            const isTunableWhiteOnly = hasColorTemperatureType && !hasColorType;
             const hasLevelType = /dimmable|colortemperature|extendedcolor/.test(typeText);
+            const colorFeatureMapAttribute = (colorCluster?.attributes || []).find((attribute) => normalizeMatterToken(attribute.name) === 'featuremap');
+            const colorFeatureMap = Number(colorFeatureMapAttribute?.value);
+            const hasColorFeatureMap = Number.isFinite(colorFeatureMap);
             const hasColorTemperature = !!colorCluster && (
-              hasColorTemperatureType ||
-              hasMatterAttribute(colorCluster, ['colorTemperatureMireds', 'colorTempPhysicalMinMireds', 'colorTempPhysicalMaxMireds']) ||
-              hasMatterCommand(colorCluster, ['moveToColorTemperature'])
+              hasColorFeatureMap
+                ? (colorFeatureMap & 0x10) !== 0
+                : (
+                    hasColorTemperatureType ||
+                    hasMatterAttribute(colorCluster, ['colorTemperatureMireds', 'colorTempPhysicalMinMireds', 'colorTempPhysicalMaxMireds']) ||
+                    hasMatterCommand(colorCluster, ['moveToColorTemperature'])
+                  )
             );
             const hasColor = !!colorCluster && (
-              hasColorType ||
-              hasMatterCommand(colorCluster, ['moveToColor', 'moveToHue', 'moveToSaturation', 'moveToHueAndSaturation'])
+              !isTunableWhiteOnly && (
+                hasColorFeatureMap
+                  ? (colorFeatureMap & 0x09) !== 0
+                  : (
+                      hasColorType ||
+                      hasMatterCommand(colorCluster, ['moveToColor', 'moveToHue', 'moveToSaturation', 'moveToHueAndSaturation'])
+                    )
+              )
             );
             return {
               known: true,
               deviceTypeDisplay,
-              colorDetectionVersion: 2,
+              matterLightType: isTunableWhiteOnly ? 'colorTemperature' : (hasColorType ? 'extendedColor' : 'other'),
+              colorDetectionVersion: 3,
               onOff: !!onOffCluster || /onoff|dimmable|colortemperature|extendedcolor/.test(typeText),
               level: !!levelCluster || hasLevelType,
               colorTemperature: hasColorTemperature,
               color: hasColor
             };
           };
+          const normalizeMatterCapabilities = (capabilities) => {
+            if (!capabilities || typeof capabilities !== 'object') return capabilities;
+            const normalized = Object.assign({}, capabilities);
+            const displayType = normalizeMatterToken(normalized.deviceTypeDisplay);
+            const tunableWhiteOnly = normalized.matterLightType === 'colorTemperature' ||
+              displayType === 'tunablewhite' ||
+              displayType === 'colortemperaturelight';
+            if (tunableWhiteOnly) {
+              normalized.colorTemperature = true;
+              normalized.color = false;
+              normalized.colorDetectionVersion = 3;
+            } else if (normalized.known === true && normalized.color === true &&
+              normalized.colorDetectionVersion !== 2 && normalized.colorDetectionVersion !== 3) {
+              normalized.color = false;
+            }
+            return normalized;
+          };
           const parseMatterCapabilities = (raw) => {
             if (raw && typeof raw === 'object') {
-              if (raw.known === true && raw.color === true && raw.colorDetectionVersion !== 2) raw.color = false;
-              return raw;
+              return normalizeMatterCapabilities(raw);
             }
             if (typeof raw !== 'string' || raw.trim() === '') return null;
             try {
-              const parsed = JSON.parse(raw);
-              if (parsed && parsed.known === true && parsed.color === true && parsed.colorDetectionVersion !== 2) {
-                parsed.color = false;
-              }
-              return parsed;
+              return normalizeMatterCapabilities(JSON.parse(raw));
             } catch (error) {
               return null;
             }
           };
           const serializeMatterCapabilities = (capabilities) => JSON.stringify(capabilities || {});
+          const universalMatterCapabilities = () => ({
+            known: true,
+            profile: 'universal',
+            deviceTypeDisplay: node._('knxUltimateMatterControllerDevice.universal_mode') || 'Universal Mode'
+          });
           const getJSONPromise = (url) => new Promise((resolve, reject) => { $.getJSON(url, resolve).fail(reject); });
 
           // Filters Matter items shaped as { value, matterNodeId, matterEndpointId }.
@@ -742,13 +844,158 @@
 
 
           const $tabs = $("#tabs");
+          const $universalTabs = $("#matter-universal-tabs");
           const $pinSectionRow = $("#node-input-enableNodePINS").closest('.form-row');
           const $pinSelect = $("#node-input-enableNodePINS");
           let currentMatterCapabilities = parseMatterCapabilities($matterCapabilitiesInput.val() || node.matterDeviceCapabilities);
+          if (currentMatterCapabilities) {
+            $matterCapabilitiesInput.val(serializeMatterCapabilities(currentMatterCapabilities));
+            node.matterDeviceCapabilities = $matterCapabilitiesInput.val();
+          }
+
+          const semanticInputDefinitions = [
+            {
+              fn: 'onoff',
+              label: 'On / Off',
+              read: [6, ['onOff']],
+              writes: [
+                { descriptor: [6, ['on']], value: true },
+                { descriptor: [6, ['off']], value: false },
+                { descriptor: [6, ['toggle']], value: 'toggle' }
+              ]
+            },
+            { fn: 'level', label: 'Level', read: [8, ['currentLevel']], write: [8, ['moveToLevelWithOnOff', 'moveToLevel']], value: 50 },
+            { fn: 'position', label: 'Cover position', read: [258, ['currentPositionLiftPercent100ths', 'currentPositionLiftPercentage']], write: [258, ['goToLiftPercentage']], value: 35 },
+            { fn: 'tiltposition', label: 'Cover tilt', read: [258, ['currentPositionTiltPercent100ths', 'currentPositionTiltPercentage']], write: [258, ['goToTiltPercentage']], value: 35 },
+            { fn: 'open', label: 'Open', write: [258, ['upOrOpen']], omitValue: true },
+            { fn: 'close', label: 'Close', write: [258, ['downOrClose']], omitValue: true },
+            { fn: 'stop', label: 'Stop', write: [258, ['stopMotion']], omitValue: true },
+            { fn: 'setpoint', label: 'Heating setpoint', read: [513, ['occupiedHeatingSetpoint']], writeAttribute: [513, ['occupiedHeatingSetpoint']], value: 21.5 },
+            { fn: 'coolingsetpoint', label: 'Cooling setpoint', read: [513, ['occupiedCoolingSetpoint']], writeAttribute: [513, ['occupiedCoolingSetpoint']], value: 24 },
+            { fn: 'currenttemp', label: 'Current temperature', read: [513, ['localTemperature']] },
+            { fn: 'fanspeed', label: 'Fan speed', read: [514, ['percentCurrent', 'percentSetting']], writeAttribute: [514, ['percentSetting']], value: 60 },
+            { fn: 'temperature', label: 'Temperature', read: [1026, ['measuredValue']] },
+            { fn: 'humidity', label: 'Humidity', read: [1029, ['measuredValue']] },
+            { fn: 'illuminance', label: 'Illuminance', read: [1024, ['measuredValue']] },
+            { fn: 'occupancy', label: 'Occupancy', read: [1030, ['occupancy']] },
+            { fn: 'contact', label: 'Contact', read: [69, ['stateValue']] },
+            { fn: 'battery', label: 'Battery', read: [47, ['batPercentRemaining']] },
+            { fn: 'activepower', label: 'Active power', read: [144, ['activePower']] },
+            { fn: 'importedenergy', label: 'Imported energy', read: [145, ['cumulativeEnergyImported']] },
+            { fn: 'identify', label: 'Identify', write: [3, ['identify']], omitValue: true }
+          ];
+          const inputStructureFor = (caps) => caps && caps.inputStructure && Array.isArray(caps.inputStructure.clusters)
+            ? caps.inputStructure
+            : null;
+          const structureMember = (structure, targetKind, descriptor, writableOnly = false) => {
+            if (!structure || !descriptor) return null;
+            const cluster = structure.clusters.find((item) => Number(item.id) === Number(descriptor[0]));
+            if (!cluster) return null;
+            const collection = targetKind === 'command' ? cluster.commands : cluster.attributes;
+            if (!Array.isArray(collection)) return null;
+            const wanted = descriptor[1].map(normalizeMatterToken);
+            return collection.find((item) =>
+              wanted.includes(normalizeMatterToken(item.name)) &&
+              (!writableOnly || item.writable === true)
+            ) || null;
+          };
+          const functionCode = (payload) => `msg.payload = ${JSON.stringify(payload, null, 2)};\nreturn msg;`;
+          const advancedCode = (kind, clusterId, name) => {
+            if (kind === 'read') return `msg.clusterId = ${Number(clusterId)};\nmsg.attribute = ${JSON.stringify(name)};\nreturn msg;`;
+            if (kind === 'write') return `msg.clusterId = ${Number(clusterId)};\nmsg.attribute = ${JSON.stringify(name)};\nmsg.value = 0;\nreturn msg;`;
+            return `msg.clusterId = ${Number(clusterId)};\nmsg.command = ${JSON.stringify(name)};\nmsg.args = {};\nreturn msg;`;
+          };
+          const appendInputHelpRow = ($body, operation, label, code) => {
+            const $row = $('<tr></tr>');
+            $('<td></td>').text(operation).appendTo($row);
+            $('<td></td>').text(label).appendTo($row);
+            $('<td><code></code></td>').find('code').text(code).end().appendTo($row);
+            $('<td></td>').append(
+              $('<button type="button" class="red-ui-button matter-input-help-copy"><i class="fa fa-copy"></i></button>')
+                .attr('title', node._('knxUltimateMatterControllerDevice.input_help_copy') || 'Copy')
+                .data('copy-text', code)
+            ).appendTo($row);
+            $body.append($row);
+          };
+          const renderInputHelp = () => {
+            const caps = getEffectiveMatterCapabilities();
+            const structure = inputStructureFor(caps);
+            const endpointId = structure ? structure.endpointId : Number($matterEndpointInput.val() || node.matterEndpointId || 1);
+            $('#matter-input-help-endpoint').text(String(endpointId));
+            const $simpleBody = $('#matter-input-help-simple-body').empty();
+            if (caps.profile === 'doorLock') {
+              if (caps.lockDoor !== false) appendInputHelpRow($simpleBody, node._('knxUltimateMatterControllerDevice.input_help_write') || 'Write', node._('knxUltimateMatterControllerDevice.input_functions.lock') || 'Lock', functionCode({ function: 'lock', value: true }));
+              if (caps.unlockDoor !== false) appendInputHelpRow($simpleBody, node._('knxUltimateMatterControllerDevice.input_help_write') || 'Write', node._('knxUltimateMatterControllerDevice.input_functions.unlock') || 'Unlock', functionCode({ function: 'lock', value: false }));
+            } else {
+              semanticInputDefinitions.forEach((definition) => {
+                const readTarget = structureMember(structure, 'attribute', definition.read);
+                const writeVariants = definition.writes || [{
+                  descriptor: definition.write || definition.writeAttribute,
+                  targetKind: definition.write ? 'command' : 'attribute',
+                  value: definition.value,
+                  omitValue: definition.omitValue
+                }];
+                writeVariants.forEach((variant) => {
+                  const targetKind = variant.targetKind || 'command';
+                  const writeTarget = structureMember(structure, targetKind, variant.descriptor, targetKind === 'attribute');
+                  if (!writeTarget) return;
+                  const payload = { function: definition.fn };
+                  if (!variant.omitValue) payload.value = variant.value;
+                  appendInputHelpRow($simpleBody, node._('knxUltimateMatterControllerDevice.input_help_write') || 'Write', node._(`knxUltimateMatterControllerDevice.input_functions.${definition.fn}`) || definition.label, functionCode(payload));
+                });
+                if (readTarget) {
+                  appendInputHelpRow($simpleBody, node._('knxUltimateMatterControllerDevice.input_help_read') || 'Read', node._(`knxUltimateMatterControllerDevice.input_functions.${definition.fn}`) || definition.label, functionCode({ function: definition.fn }));
+                }
+              });
+            }
+            $('#matter-input-help-simple-empty').toggle($simpleBody.children().length === 0);
+
+            const $advancedBody = $('#matter-input-help-advanced-body').empty();
+            if (structure) {
+              structure.clusters.forEach((cluster) => {
+                (cluster.attributes || []).forEach((attribute) => {
+                  const prefix = `${cluster.name || 'Cluster'} (${cluster.id}) · ${attribute.name} (${attribute.id})`;
+                  appendInputHelpRow($advancedBody, node._('knxUltimateMatterControllerDevice.input_help_read') || 'Read', prefix, advancedCode('read', cluster.id, attribute.name));
+                  if (attribute.writable === true) {
+                    appendInputHelpRow($advancedBody, node._('knxUltimateMatterControllerDevice.input_help_write') || 'Write', prefix, advancedCode('write', cluster.id, attribute.name));
+                  }
+                });
+                (cluster.commands || []).forEach((command) => {
+                  const prefix = `${cluster.name || 'Cluster'} (${cluster.id}) · ${command.name}`;
+                  appendInputHelpRow($advancedBody, node._('knxUltimateMatterControllerDevice.input_help_command') || 'Command', prefix, advancedCode('command', cluster.id, command.name));
+                });
+              });
+            }
+            $('#matter-input-help-advanced-empty').toggle($advancedBody.children().length === 0);
+          };
+          const copyInputHelpText = (text) => {
+            const copied = () => RED.notify(node._('knxUltimateMatterControllerDevice.input_help_copied') || 'Message copied', 'success');
+            if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+              navigator.clipboard.writeText(text).then(copied).catch(() => {
+                const $temporary = $('<textarea></textarea>').val(text).appendTo('body').select();
+                try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
+              });
+              return;
+            }
+            const $temporary = $('<textarea></textarea>').val(text).appendTo('body').select();
+            try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
+          };
+          $inputHelpPanel.off('click.matterInputHelp').on('click.matterInputHelp', '.matter-input-help-copy', function () {
+            copyInputHelpText($(this).data('copy-text') || '');
+          });
           $tabs.addClass('hue-vertical-tabs');
           $tabs.tabs(); // Tabs gestione KNX
+          $tabs.off('tabsactivate.matterInputHelp').on('tabsactivate.matterInputHelp', (event, ui) => {
+            if (ui && ui.newPanel && ui.newPanel.attr('id') === 'tabs-input') {
+              renderInputHelp();
+            }
+          });
           $tabs.find('ul').addClass('ui-tabs-nav');
           $tabs.find('li').removeClass('ui-corner-top').addClass('ui-corner-left');
+          $universalTabs.addClass('hue-vertical-tabs');
+          $universalTabs.tabs();
+          $universalTabs.find('ul').addClass('ui-tabs-nav');
+          $universalTabs.find('li').removeClass('ui-corner-top').addClass('ui-corner-left');
 
           function getDPT(_dpt, _destinationWidget) {
             // DPT Switch command
@@ -835,7 +1082,49 @@
             } catch (e) { }
           }
 
+          function getFixedDptGroupAddress(_sourceWidgetAutocomplete, _destinationWidgetName, _dptPrefix) {
+            const $source = $(_sourceWidgetAutocomplete);
+            if ($source.data('ui-autocomplete')) {
+              try { $source.autocomplete('destroy'); } catch (error) { /* empty */ }
+            }
+            $source.autocomplete({
+              minLength: 0,
+              source: function (request, response) {
+                if (!hasKnxServerSelected()) {
+                  response([]);
+                  return;
+                }
+                const serverId = resolveKnxServerValue();
+                $.getJSON(`knxUltimatecsv?nodeID=${serverId}&_=${Date.now()}`, (data) => {
+                  response($.map(data, function (value) {
+                    const searchable = `${value.ga} (${value.devicename}) DPT${value.dpt}`;
+                    if (!htmlUtilsfullCSVSearch(searchable, `${request.term || ''} ${_dptPrefix}`)) return null;
+                    return {
+                      label: `${value.ga} # ${value.devicename} # ${value.dpt}`,
+                      value: value.ga,
+                      deviceName: value.devicename
+                    };
+                  }));
+                });
+              },
+              select: function (event, ui) {
+                $(_destinationWidgetName).val(ui.item.deviceName || '');
+              }
+            }).focus(function () {
+              $(this).autocomplete('search', `${$(this).val()}exactmatch`);
+            });
+            try {
+              if (hasKnxServerSelected()) {
+                const srv = RED.nodes.node(resolveKnxServerValue());
+                if (srv && srv.id) KNX_enableSecureFormatting($source, srv.id);
+              }
+            } catch (error) { /* empty */ }
+          }
+
           const refreshKnxBindings = () => {
+            getFixedDptGroupAddress("#node-input-universalLowBatteryGA", "#node-input-universalLowBatteryGAName", "1.");
+            getFixedDptGroupAddress("#node-input-universalLowBatteryTextGA", "#node-input-universalLowBatteryTextGAName", "16.");
+
             getDPT("1.", "#node-input-dptLightSwitch");
             getGroupAddress("#node-input-GALightSwitch", "#node-input-nameLightSwitch", "#node-input-dptLightSwitch", ["1."]);
 
@@ -939,8 +1228,9 @@
 
           const ensureVisibleMatterTabSelected = () => {
             const $active = $tabs.find('ul.ui-tabs-nav li.ui-tabs-active');
-            if ($active.length && $active.is(':visible')) return;
-            const $firstVisible = $tabs.find('ul.ui-tabs-nav li:visible').first();
+            const isTabAvailable = function () { return $(this).css('display') !== 'none'; };
+            if ($active.length && $active.filter(isTabAvailable).length) return;
+            const $firstVisible = $tabs.find('ul.ui-tabs-nav li').filter(isTabAvailable).first();
             if (!$firstVisible.length) return;
             const visibleIndex = $tabs.find('ul.ui-tabs-nav li').index($firstVisible);
             if (visibleIndex >= 0) {
@@ -991,7 +1281,7 @@
           };
 
           const applyMatterCapabilities = (capabilities) => {
-            currentMatterCapabilities = capabilities || null;
+            currentMatterCapabilities = normalizeMatterCapabilities(capabilities) || null;
             const caps = getEffectiveMatterCapabilities();
             const hasHueDevice = getHueDeviceValue() !== '';
             const supportsSwitch = hasHueDevice && caps.onOff !== false;
@@ -1001,14 +1291,20 @@
             const hasRichBehaviour = supportsDim && (supportsTemperature || supportsColor);
             const isDoorLock = caps.profile === 'doorLock';
             const isMapped = ['mapped', 'windowCovering', 'thermostat', 'fan', 'switch'].includes(caps.profile);
+            const isUniversal = caps.profile === 'universal' || isUniversalMode();
+            const knxSelected = hasKnxServerSelected();
             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);
+            setMatterTabVisible('tabs-1', !isUniversal && knxSelected && supportsSwitch);
+            setMatterTabVisible('tabs-2', !isUniversal && knxSelected && supportsDim);
+            setMatterTabVisible('tabs-3', !isUniversal && knxSelected && supportsTemperature);
+            setMatterTabVisible('tabs-4', !isUniversal && knxSelected && supportsColor);
+            setMatterTabVisible('tabs-mapped', !isUniversal && knxSelected && isMapped);
+            setMatterTabVisible('tabs-input', !isUniversal && hasHueDevice && (isMapped || isDoorLock));
+            setMatterTabVisible('tabs-6', !isUniversal && knxSelected && hasHueDevice);
+            $('#matter-universal-description').toggle(isUniversal);
+            $pinSelect.val(isUniversal ? 'yes' : $pinSelect.val()).prop('disabled', isUniversal);
+            updateLocateButtonState(false);
             $('#matter-door-lock-options').toggle(isDoorLock);
             $('#matter-switch-command-label').text(isDoorLock
               ? (node._('knxUltimateMatterControllerDevice.door_lock_command') || 'Lock / unlock')
@@ -1020,6 +1316,7 @@
             $('#matter-door-lock-pin-required').toggle(isDoorLock && caps.requirePinForRemoteOperation === true);
             $('#matter-mapped-profile').toggle(isMapped);
             if (isMapped) renderMappedProfile(caps.mappedTargets || []);
+            if (hasHueDevice && !isUniversal && (isMapped || isDoorLock)) renderInputHelp();
             $('#matter-selected-device-type-value').text(deviceTypeDisplay);
             $('#matter-selected-device-type').toggle(hasHueDevice && deviceTypeDisplay !== '');
             try { $tabs.tabs('refresh'); } catch (error) { /* empty */ }
@@ -1077,9 +1374,12 @@
           };
 
           const updateTabsVisibility = () => {
-            const knxSelected = hasKnxServerSelected();
             const hueDeviceSelected = getHueDeviceValue() !== '';
-            const shouldShowTabs = knxSelected && hueDeviceSelected;
+            applyMatterCapabilities(currentMatterCapabilities);
+            const hasVisibleTab = $tabs.find('ul.ui-tabs-nav li').filter(function () {
+              return $(this).css('display') !== 'none';
+            }).length > 0;
+            const shouldShowTabs = !isUniversalMode() && hueDeviceSelected && hasVisibleTab;
 
             if (shouldShowTabs) {
               $tabs.show();
@@ -1087,13 +1387,52 @@
             } else {
               $tabs.hide();
             }
-            applyMatterCapabilities(currentMatterCapabilities);
 
             if ($pinSectionRow.length) {
               $pinSectionRow.show();
             }
           };
+
+          const refreshUniversalServiceVisibility = () => {
+            const universal = $matterControllerModeInput.val() === 'universal';
+            $('#matter-universal-options').toggle(universal);
+            $universalTabs.toggle(universal && $universalServiceInput.val() === 'batteryMonitor');
+            if ($universalTabs.is(':visible')) {
+              try { $universalTabs.tabs('refresh'); } catch (error) { /* empty */ }
+            }
+          };
+
+          const applyControllerMode = () => {
+            const universal = $matterControllerModeInput.val() === 'universal';
+            $('#matter-device-section-title, #matter-device-row').toggle(!universal);
+            if (universal) {
+              const universalName = node._('knxUltimateMatterControllerDevice.universal_mode') || 'Universal Mode';
+              currentMatterCapabilities = universalMatterCapabilities();
+              selectedMatterDeviceName = universalName;
+              $deviceNameInput.val(universalName);
+              $hueDeviceInput.val(UNIVERSAL_NODE_ID);
+              $matterEndpointInput.val('');
+              $matterCapabilitiesInput.val(serializeMatterCapabilities(currentMatterCapabilities));
+              $nodeNameInput.val(node._('knxUltimateMatterControllerDevice.universal_controller_name') || 'Matter Universal Controller');
+              $pinSelect.val('yes');
+            } else if (String($hueDeviceInput.val() || '') === UNIVERSAL_NODE_ID) {
+              currentMatterCapabilities = null;
+              selectedMatterDeviceName = '';
+              $deviceNameInput.val('');
+              $hueDeviceInput.val('');
+              $matterEndpointInput.val('');
+              $matterCapabilitiesInput.val('');
+            }
+            refreshUniversalServiceVisibility();
+            applyMatterCapabilities(currentMatterCapabilities);
+            updateTabsVisibility();
+          };
+
           updateTabsVisibility();
+          applyControllerMode();
+
+          $matterControllerModeInput.on('change.knxUltimateMatterControllerDevice', applyControllerMode);
+          $universalServiceInput.on('change.knxUltimateMatterControllerDevice', refreshUniversalServiceVisibility);
 
           $knxServerInput.on('change.knxUltimateMatterControllerDevice', () => {
             refreshKnxBindings();
@@ -1417,9 +1756,12 @@
         } catch (error) { }
 
         //RED.sidebar.removeTab("tabNRColor");
-        if ($("#node-input-enableNodePINS").val() === "yes") {
+        const universalMode = $("#node-input-matterControllerMode").val() === 'universal';
+        this.matterControllerMode = universalMode ? 'universal' : 'single';
+        if (universalMode || $("#node-input-enableNodePINS").val() === "yes") {
           this.outputs = 1;
           this.inputs = 1;
+          this.enableNodePINS = 'yes';
         } else {
           this.outputs = 0;
           this.inputs = 0;
@@ -1428,7 +1770,7 @@
         this.updateLocalStateFromKNXWrite = $("#node-input-updateLocalStateFromKNXWrite").is(":checked"); // Starting from v 4.1.31
         this.matterDeviceName = ($("#node-input-matterDeviceName").val() || '').trim();
         this.matterNodeId = ($("#node-input-matterNodeId").val() || '').trim();
-        this.matterEndpointId = Number($("#node-input-matterEndpointId").val() || 1);
+        this.matterEndpointId = universalMode ? '' : Number($("#node-input-matterEndpointId").val() || 1);
         this.matterDeviceCapabilities = ($("#node-input-matterDeviceCapabilities").val() || '').trim();
         const mappedMappings = [];
         const $mappedRows = $('#matter-mapped-profile-body .matter-mapped-row');
@@ -1444,7 +1786,9 @@
           ? JSON.stringify(mappedMappings)
           : ($('#node-input-matterMappings').val() || this.matterMappings || '[]');
         $('#node-input-matterMappings').val(this.matterMappings);
-        this.name = this.matterDeviceName || this.name || '';
+        this.name = universalMode
+          ? ($("#node-input-name").val() || this._('knxUltimateMatterControllerDevice.universal_controller_name') || 'Matter Universal Controller')
+          : (this.matterDeviceName || this.name || '');
         $("#node-input-name").val(this.name);
         const parseSavedMatterCapabilities = (raw) => {
           if (typeof raw !== 'string' || raw.trim() === '') return null;
@@ -1631,10 +1975,6 @@
         target="_blank" href="https://youtu.be/jjEUI1J8bkA"><u><span data-i18n="common.youtube_sample"></span></u></a>
       <br />
       <br />
-      <p align="center">
-        <i class="fa-regular fa-lightbulb fa-bounce fa-2x"></i>
-      </p>
-      <br />
       <label for="node-input-server">
         <img
           src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAKnRFWHRDcmVhdGlvbiBUaW1lAEZyIDYgQXVnIDIwMTAgMjE6NTI6MTkgKzAxMDD84aS8AAAAB3RJTUUH3gYYCicNV+4WIQAAAAlwSFlzAAALEgAACxIB0t1+/AAAAARnQU1BAACxjwv8YQUAAACUSURBVHjaY2CgFZg5c+Z/ZEyWAZ8+f/6/ZsWs/xoamqMGkGrA6Wla/1+fVARjEBuGsSoGmY4eZSCNL59d/g8DIDbIAHR14OgFGQByKjIGKX5+6/T///8gGMQGiV1+/B0Fg70GIkD+RMYgxf/O5/7//2MSmAZhkBi6OrgB6Bg5DGB4ajr3f2xqsYYLSDE2THJUDg0AAAqyDVd4tp4YAAAAAElFTkSuQmCC"></img>
@@ -1651,12 +1991,116 @@
       <input type="text" id="node-input-serverMatter" />
     </div>
 
+    <div class="form-row">
+      <label for="node-input-matterControllerMode">
+        <i class="fa fa-list"></i>
+        <span data-i18n="knxUltimateMatterControllerDevice.controller_mode"></span>
+      </label>
+      <select id="node-input-matterControllerMode">
+        <option value="single" data-i18n="knxUltimateMatterControllerDevice.single_mode"></option>
+        <option value="universal" data-i18n="knxUltimateMatterControllerDevice.universal_mode"></option>
+      </select>
+    </div>
+
+    <div id="matter-universal-description" class="form-tips" style="display:none; margin:8px 0;"
+      data-i18n="knxUltimateMatterControllerDevice.universal_mode_description"></div>
+
+    <div id="matter-universal-options" style="display:none;">
+      <div class="form-row">
+        <label for="node-input-universalService">
+          <i class="fa fa-bell"></i>
+          <span data-i18n="knxUltimateMatterControllerDevice.universal_service"></span>
+        </label>
+        <select id="node-input-universalService">
+          <option value="batteryMonitor" data-i18n="knxUltimateMatterControllerDevice.universal_service_battery_monitor"></option>
+          <option value="allEvents" data-i18n="knxUltimateMatterControllerDevice.universal_service_all_events"></option>
+        </select>
+      </div>
+      <div id="matter-universal-tabs" style="display:none; width:900px;">
+        <ul>
+          <li>
+            <a href="#matter-universal-battery-options">
+              <i class="fa fa-battery-quarter"></i>
+              <span data-i18n="knxUltimateMatterControllerDevice.universal_service_battery_monitor"></span>
+            </a>
+          </li>
+        </ul>
+        <div id="matter-universal-battery-options">
+        <div class="form-row">
+          <label for="node-input-universalBatteryThreshold">
+            <i class="fa fa-battery-quarter"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_battery_threshold"></span>
+          </label>
+          <input type="number" id="node-input-universalBatteryThreshold" min="0" max="100" step="1" style="width:100px;" />
+          <span style="margin-left:5px;">%</span>
+        </div>
+        <div class="form-row" style="display:flex; align-items:center; flex-wrap:nowrap; gap:5px;">
+          <label for="node-input-universalLowBatteryGA" style="width:155px; flex:0 0 155px; margin:0;">
+            <i class="fa fa-bell"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_low_battery_ga"></span>
+          </label>
+
+          <label for="node-input-universalLowBatteryGA" style="width:25px; flex:0 0 25px; margin:0;"><span data-i18n="common.ga"></span></label>
+          <input type="text" id="node-input-universalLowBatteryGA" placeholder="Ex: 1/1/1"
+            style="width:70px; flex:0 0 70px; margin:0; text-align:left;" />
+
+          <label for="node-input-universalLowBatteryDPT" style="width:38px; flex:0 0 38px; margin:0; text-align:right;"><span data-i18n="common.dpt"></span></label>
+          <input type="text" id="node-input-universalLowBatteryDPT" value="1.005" readonly
+            style="width:75px; flex:0 0 75px; margin:0;" />
+
+          <label for="node-input-universalLowBatteryGAName" style="width:45px; flex:0 0 45px; margin:0; text-align:right;"><span data-i18n="common.name"></span></label>
+          <input type="text" id="node-input-universalLowBatteryGAName"
+            style="width:auto; min-width:90px; flex:1 1 auto; margin:0; text-align:left;" />
+        </div>
+        <div class="form-row" style="display:flex; align-items:center; flex-wrap:nowrap; gap:5px;">
+          <label for="node-input-universalLowBatteryTextGA" style="width:155px; flex:0 0 155px; margin:0;">
+            <i class="fa fa-font"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_low_battery_text_ga"></span>
+          </label>
+
+          <label for="node-input-universalLowBatteryTextGA" style="width:25px; flex:0 0 25px; margin:0;"><span data-i18n="common.ga"></span></label>
+          <input type="text" id="node-input-universalLowBatteryTextGA" placeholder="Ex: 1/1/1"
+            style="width:70px; flex:0 0 70px; margin:0; text-align:left;" />
+
+          <label for="node-input-universalLowBatteryTextDPT" style="width:38px; flex:0 0 38px; margin:0; text-align:right;"><span data-i18n="common.dpt"></span></label>
+          <input type="text" id="node-input-universalLowBatteryTextDPT" value="16.001" readonly
+            style="width:75px; flex:0 0 75px; margin:0;" />
+
+          <label for="node-input-universalLowBatteryTextGAName" style="width:45px; flex:0 0 45px; margin:0; text-align:right;"><span data-i18n="common.name"></span></label>
+          <input type="text" id="node-input-universalLowBatteryTextGAName"
+            style="width:auto; min-width:90px; flex:1 1 auto; margin:0; text-align:left;" />
+        </div>
+        <div class="form-row">
+          <label for="node-input-universalBatteryOnlyLow" style="width:260px;">
+            <i class="fa fa-filter"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_battery_only_low"></span>
+          </label>
+          <input type="checkbox" id="node-input-universalBatteryOnlyLow" style="display:inline-block; width:auto;" />
+        </div>
+        <div class="form-row">
+          <label for="node-input-universalEmitInitialState" style="width:260px;">
+            <i class="fa fa-camera"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_emit_initial"></span>
+          </label>
+          <input type="checkbox" id="node-input-universalEmitInitialState" style="display:inline-block; width:auto;" />
+        </div>
+        <div class="form-row">
+          <label for="node-input-universalIncludeRawEvent" style="width:260px;">
+            <i class="fa fa-code"></i>
+            <span data-i18n="knxUltimateMatterControllerDevice.universal_include_raw"></span>
+          </label>
+          <input type="checkbox" id="node-input-universalIncludeRawEvent" style="display:inline-block; width:auto;" />
+        </div>
+        </div>
+      </div>
+    </div>
+
     <br />
-    <p>
+    <p id="matter-device-section-title">
       <b><span data-i18n="knxUltimateMatterControllerDevice.matter_section"></span></b>
     </p>
 
-    <div class="form-row">
+    <div class="form-row" id="matter-device-row">
       <label for="node-input-matterDeviceName">
         <i class="fa fa-play-circle"></i> <span data-i18n="knxUltimateMatterControllerDevice.matter_device"></span>
       </label>
@@ -1690,6 +2134,7 @@
         <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-input"><i class="fa-solid fa-code"></i> <span data-i18n="knxUltimateMatterControllerDevice.input_help_label"></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">
@@ -1697,6 +2142,46 @@
           <div id="matter-mapped-profile-body"></div>
         </div>
       </div>
+      <div id="tabs-input">
+        <p class="form-tips" data-i18n="knxUltimateMatterControllerDevice.input_help_pin_hint"></p>
+        <p>
+          <strong data-i18n="knxUltimateMatterControllerDevice.input_help_endpoint"></strong>:
+          <code id="matter-input-help-endpoint"></code>.
+          <span data-i18n="knxUltimateMatterControllerDevice.input_help_endpoint_hint"></span>
+        </p>
+        <h4 data-i18n="knxUltimateMatterControllerDevice.input_help_simple_title"></h4>
+        <p data-i18n="knxUltimateMatterControllerDevice.input_help_simple_hint"></p>
+        <table class="matter-input-help-table">
+          <thead>
+            <tr>
+              <th data-i18n="knxUltimateMatterControllerDevice.input_help_operation"></th>
+              <th data-i18n="knxUltimateMatterControllerDevice.input_help_function"></th>
+              <th data-i18n="knxUltimateMatterControllerDevice.input_help_message"></th>
+              <th></th>
+            </tr>
+          </thead>
+          <tbody id="matter-input-help-simple-body"></tbody>
+        </table>
+        <p id="matter-input-help-simple-empty" style="display:none;" data-i18n="knxUltimateMatterControllerDevice.input_help_no_simple"></p>
+        <details>
+          <summary><strong data-i18n="knxUltimateMatterControllerDevice.input_help_advanced_title"></strong></summary>
+          <p data-i18n="knxUltimateMatterControllerDevice.input_help_advanced_hint"></p>
+          <div class="matter-input-help-advanced">
+            <table class="matter-input-help-table">
+              <thead>
+                <tr>
+                  <th data-i18n="knxUltimateMatterControllerDevice.input_help_operation"></th>
+                  <th data-i18n="knxUltimateMatterControllerDevice.input_help_target"></th>
+                  <th data-i18n="knxUltimateMatterControllerDevice.input_help_message"></th>
+                  <th></th>
+                </tr>
+              </thead>
+              <tbody id="matter-input-help-advanced-body"></tbody>
+            </table>
+            <p id="matter-input-help-advanced-empty" style="display:none;" data-i18n="knxUltimateMatterControllerDevice.input_help_no_structure"></p>
+          </div>
+        </details>
+      </div>
       <div id="tabs-1">
         <p>
         <div class="form-row">
@@ -2125,18 +2610,19 @@
           </div>
           <br/>
         </div>
-        <div class="form-row">
-          <label for="node-input-enableNodePINS" style="width:260px;">
-            <i class="fa fa-circle"></i> <span data-i18n="knxUltimateMatterControllerDevice.node_pins"></span>
-          </label>
-          <select id="node-input-enableNodePINS">
-            <option value="no" data-i18n="knxUltimateMatterControllerDevice.node_pins_hide"></option>
-            <option value="yes" data-i18n="knxUltimateMatterControllerDevice.node_pins_show"></option>
-          </select>
-        </div>
         </p>
       </div>
     </div>
+
+    <div class="form-row" style="margin-top:12px;">
+      <label for="node-input-enableNodePINS" style="width:260px;">
+        <i class="fa fa-circle"></i> <span data-i18n="knxUltimateMatterControllerDevice.node_pins"></span>
+      </label>
+      <select id="node-input-enableNodePINS">
+        <option value="no" data-i18n="knxUltimateMatterControllerDevice.node_pins_hide"></option>
+        <option value="yes" data-i18n="knxUltimateMatterControllerDevice.node_pins_show"></option>
+      </select>
+    </div>
   </div>
 
   <br/>
@@ -2159,6 +2645,57 @@ the device picker. Door Lock, Window Covering, Thermostat, Fan and Switch endpoi
 dedicated profiles. Switch press, long-press and multi-press events are emitted on the
 optional flow output; simpler endpoints continue through the generic mapped fallback.
 
+**Flow input**
+
+For a selected non-light endpoint, open the **Flow input** tab in the editor.
+The capability-driven tab shows copyable simple examples plus the selected endpoint,
+all advertised readable/writable attributes and all accepted commands.
+
+Use `msg.payload = {function:"position", value:35}` for a simple write. Omit `value`
+to read a supported state, for example `{function:"temperature"}`. Values use human
+units and read output includes raw Matter details in `msg.matter`. The available
+functions are filtered by the endpoint and can include `onoff`, `level`, `position`,
+`tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`,
+`fanspeed`, sensor readings and `identify`. Door Lock accepts
+`{function:"lock", value:true|false}`.
+
+The advanced top-level fields remain supported: `msg.clusterId` with
+`msg.command`/`msg.args`, or `msg.attribute` with optional `msg.value`. Node ID and
+Endpoint ID are already selected by this node; `msg.endpointId` is only an override.
+
+**Device isolation**
+
+Commands use a separate ordered queue for every commissioned device. An offline,
+timing-out or removed device cannot delay other Matter devices sharing the same KNX
+group address. A Controller node that still points to a removed device rejects the
+command immediately and shows **Device no longer commissioned** in red.
+
+An unavailable-device error is latched. Further KNX and flow commands are ignored and
+cannot repaint the red status. The node resumes automatically when its Matter device
+reports `connected`; opening the node editor also clears the latch for a manual retry.
+
+**Universal Mode**
+
+Select **Universal Mode** in the **Mode** selector to listen to every attribute report,
+cluster event and device initialization from this controller. It always exposes one input
+and one output, does not require a KNX gateway, and does not use endpoint KNX mappings.
+Output values are in `msg.payload`; routing metadata is in `msg.matter`, including
+`source`, `nodeId`, `endpointId`, `clusterId` and the attribute/event name.
+The **Universal Battery Monitor** scans every node and endpoint for Power Source,
+emits an initial snapshot, and maintains complete battery state. It can emit only
+batteries below the configured threshold or every battery update. `msg.payload`
+contains normalized percent, charge level, replacement state, replaceability and
+voltage; raw Matter metadata remains in `msg.matter`. Send
+`{payload:{action:"getAllBatteries"}}` to retrieve the cached inventory.
+
+Use `msg.nodeId`, `msg.endpointId`, `msg.clusterId` and either `msg.command` plus
+`msg.args`, or `msg.attribute`. Add `msg.value` for an attribute write; omit it for a
+read. The same selectors may be placed under `msg.matter`. For example, read battery
+with `{nodeId:"100", endpointId:1, clusterId:47, attribute:"batPercentRemaining"}` or
+switch on with `{nodeId:"100", endpointId:1, clusterId:6, command:"on", args:{}}`.
+Battery is emitted in Matter's raw half-percent units and can be divided by two in a
+Function node.
+
 |Property|Description|
 |--|--|
 | KNX GW | Select the KNX gateway to be used |
@@ -2242,7 +2779,7 @@ _Basic Matter effects_
 | 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. |
-| Node Input/Output PINs | For mapped endpoints, all Matter selectors belong directly to `msg`. Read an attribute with `msg.clusterId` and `msg.attribute`; add `msg.requestFromRemote = true` to force a device read instead of using the subscribed value. The result is emitted as `msg.payload`. Add `msg.value` to write an attribute, or use `msg.clusterId`, `msg.command` and `msg.args` to invoke a command. Attribute IDs such as `0` are accepted. Door Lock input accepts `msg.payload = true` to lock and `false` to unlock. |
+| Node Input/Output PINs | For mapped endpoints, use the simple `msg.payload = {function,value}` contract shown in the **Flow input** tab, or the advanced top-level Matter selectors. Read an attribute with `msg.clusterId` and `msg.attribute`; add `msg.requestFromRemote = true` to force a device read. Add `msg.value` to write, or use `msg.command` and `msg.args`. Door Lock accepts both `msg.payload = true/false` and `{function:"lock",value:true/false}`. |
 | 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. |