node-red-contrib-knx-ultimate 6.0.10 → 6.0.12

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: "" },
@@ -221,6 +231,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 +241,9 @@
           const $refreshDevicesButton = $(".hue-refresh-devices");
           const $locateDeviceButton = $(".hue-locate-device");
           const $hueDevicesLoading = $(".hue-devices-loading");
+          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 +304,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 +358,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 +441,7 @@
             }).always(() => {
               locatePendingRequest = null;
               if ($locateDeviceButton.length) {
-                $locateDeviceButton.prop('disabled', false);
+                $locateDeviceButton.prop('disabled', isUniversalMode());
               }
             });
             return request;
@@ -554,6 +576,11 @@
             }
             const isMatterLight = deviceTypes.some((type) => /(?:onoff|dimmable|colortemperature|extendedcolor)light/.test(type));
             if (!isMatterLight) {
+              const specializedProfile = getMatterCluster(ep, 258) ? 'windowCovering'
+                : getMatterCluster(ep, 513) ? 'thermostat'
+                  : getMatterCluster(ep, 514) ? 'fan'
+                    : getMatterCluster(ep, 59) ? 'switch'
+                      : 'mapped';
               const mappedTargets = [];
               const addCommand = (clusterId, target, label, dpt) => {
                 const cluster = getMatterCluster(ep, clusterId);
@@ -584,47 +611,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: 'mapped', 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 };
             }
             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 }.
@@ -737,13 +796,22 @@
 
 
           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();
+          }
           $tabs.addClass('hue-vertical-tabs');
           $tabs.tabs(); // Tabs gestione KNX
           $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
@@ -830,7 +898,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."]);
 
@@ -986,7 +1096,7 @@
           };
 
           const applyMatterCapabilities = (capabilities) => {
-            currentMatterCapabilities = capabilities || null;
+            currentMatterCapabilities = normalizeMatterCapabilities(capabilities) || null;
             const caps = getEffectiveMatterCapabilities();
             const hasHueDevice = getHueDeviceValue() !== '';
             const supportsSwitch = hasHueDevice && caps.onOff !== false;
@@ -995,15 +1105,19 @@
             const supportsColor = hasHueDevice && caps.color === true;
             const hasRichBehaviour = supportsDim && (supportsTemperature || supportsColor);
             const isDoorLock = caps.profile === 'doorLock';
-            const isMapped = caps.profile === 'mapped';
+            const isMapped = ['mapped', 'windowCovering', 'thermostat', 'fan', 'switch'].includes(caps.profile);
+            const isUniversal = caps.profile === 'universal' || isUniversalMode();
             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 && supportsSwitch);
+            setMatterTabVisible('tabs-2', !isUniversal && supportsDim);
+            setMatterTabVisible('tabs-3', !isUniversal && supportsTemperature);
+            setMatterTabVisible('tabs-4', !isUniversal && supportsColor);
+            setMatterTabVisible('tabs-mapped', !isUniversal && isMapped);
+            setMatterTabVisible('tabs-6', !isUniversal && 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')
@@ -1074,7 +1188,7 @@
           const updateTabsVisibility = () => {
             const knxSelected = hasKnxServerSelected();
             const hueDeviceSelected = getHueDeviceValue() !== '';
-            const shouldShowTabs = knxSelected && hueDeviceSelected;
+            const shouldShowTabs = !isUniversalMode() && knxSelected && hueDeviceSelected;
 
             if (shouldShowTabs) {
               $tabs.show();
@@ -1088,7 +1202,47 @@
               $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();
@@ -1412,9 +1566,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;
@@ -1423,7 +1580,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');
@@ -1439,7 +1596,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;
@@ -1626,10 +1785,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>
@@ -1646,12 +1801,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>
@@ -2120,18 +2379,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/>
@@ -2150,7 +2410,31 @@
 
 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.
+the device picker. Door Lock, Window Covering, Thermostat, Fan and Switch endpoints use
+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.
+
+**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|
 |--|--|
@@ -2235,6 +2519,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. |
 | 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. |

package/nodes/locales/de/knxUltimateMatterBridge.html

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

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-# Control Matter from KNX (BETA)
-
 > Dieser Knoten ist **BETA**: das Verhalten kann sich ändern, während die Matter-Implementierung weiter verfeinert wird.
 
 Dieser Knoten steuert einen bereits gekoppelten Matter-Endpunkt über KNX. Wähle das Matter-Gerät aus; der Editor erkennt die Fähigkeiten des Endpunkts und zeigt nur die passenden KNX-Zuordnungen.
@@ -23,6 +21,16 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 | 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. Die Auswahl bleibt beim erneuten Öffnen des Editors erhalten. |
 
+## Universeller Modus
+
+Wähle **Universeller Modus**, um alle Geräte zu überwachen. Der Node hat immer einen Eingang und einen Ausgang und verwendet keine Endpunkt-Zuordnungen. Ein KNX-Gateway ist optional und wird nur für die Alarm-/Text-GAs des Batteriemonitors benötigt.
+
+Der **Universelle Batteriemonitor** speichert den vollständigen Batteriestatus. Optionale KNX-GAs senden den Sammelalarm als DPT 1.005 und wechseln alle 2 Sekunden die Gerätenamen als DPT 16.001. `{payload:{action:"getAllBatteries"}}` liefert das Cache-Inventar.
+
+Ausgaben enthalten den Rohwert in `msg.payload` und Routingdaten in `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, Attribut-/Ereignisname). Eingaben verwenden `msg.nodeId`, `msg.endpointId`, `msg.clusterId` und entweder `msg.command` mit `msg.args` oder `msg.attribute`; `msg.value` schreibt, ohne `msg.value` wird gelesen. Die Felder können auch unter `msg.matter` stehen.
+
+Beispiele: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` schaltet ein; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` liest die Batterie. Batteriewerte bleiben in Matter-Halbprozenteinheiten und können in einem Function-Node durch zwei geteilt werden.
+
 ## Verhalten
 
 Der Knoten pflegt einen lokalen Cache aus Matter-Updates und KNX-Schreibtelegrammen, beantwortet KNX-Leseanfragen aus diesem Cache und kann Werte beim Start lesen/ausgeben. Er hört nur auf konfigurierte Gruppenadressen, daher wird fremder KNX-Verkehr ignoriert.

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -92,7 +92,23 @@
     "matter_controller": "Matter-Controller",
     "matter_device": "Matter-Gerät",
     "device_type": "Gerätetyp",
-    "matter_section": "Matter-Gerät"
+    "matter_section": "Matter-Gerät",
+    "controller_mode": "Modus",
+    "single_mode": "Einzelnes Gerät",
+    "universal_mode": "Universeller Modus (alle Matter-Geräte)",
+    "universal_mode_description": "Alle mit diesem Controller verbundenen Matter-Geräte überwachen und steuern. Der universelle Modus funktioniert ohne KNX-Zuordnungen.",
+    "universal_service": "Dienst",
+    "universal_service_battery_monitor": "Universeller Batteriemonitor",
+    "universal_service_all_events": "Alle Matter-Ereignisse",
+    "universal_battery_threshold": "Schwelle für niedrigen Batteriestand",
+    "universal_low_battery_ga": "GA Batteriealarm",
+    "universal_low_battery_text_ga": "GA Gerätename",
+    "universal_battery_only_low": "Nur niedrige Batteriestände ausgeben",
+    "universal_emit_initial": "Anfänglichen Batterie-Snapshot ausgeben",
+    "universal_include_raw": "Rohes Matter-Ereignis einschließen",
+    "universal_mode_status": "Universeller Matter-Modus",
+    "universal_mode_locate_disabled": "„Suchen“ ist im universellen Modus nicht verfügbar.",
+    "universal_controller_name": "Universeller Matter-Controller"
   },
   "common": {
     "ga": "GA",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Expose KNX to Matter (BETA)
-
 > This node is in **BETA**: it works, but details may still change between releases.
 
 ## Overview