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

package/CHANGELOG.md

@@ -6,6 +6,11 @@
 
 # CHANGELOG
 
+**Version 6.1.1** - July 2026<br/>
+
+- **Control Matter from KNX — contextual flow PIN help**: **Node Input/Output PINs** now reveals the capability-driven **Flow input** section directly below the selector instead of adding a separate editor tab. The section remains hidden while the pins are disabled. Light endpoints now receive contextual, copyable examples for their supported top-level `msg.on`, `msg.dimming`, `msg.color_temperature` and `msg.color` contracts, while non-light endpoints retain their advertised simple and advanced Matter examples.<br/>
+- **Matter Bridge — contextual flow PIN help**: **Node Input/Output PINs** now sits outside the editor tabs and, when enabled, reveals a contextual **Flow input/output** section directly below it. Copyable Flow → Matter and Matter → Flow examples are filtered to the selected device type, covering lights, covers, thermostats, fans, sensors, alarms and the flow-only robot vacuum while documenting only the message contracts already accepted or emitted by the runtime.<br/>
+
 **Version 6.1.0** - July 2026<br/>
 
 - **Matter Controller — QR pairing-code reader**: the pairing editor can now fill the existing `MT:…` field by scanning a QR code with the local webcam or reading it from a selected image, including inverted white-on-dark QR codes used by some device web interfaces. Decoding remains entirely in the browser and never uploads the image or video; after a valid QR is read, pairing starts automatically, while manually typed codes still require **PAIR**. The optional device name is positioned before the scanner, the decoded code remains visible underneath it and fabric backup controls have moved to the bottom of the editor. A prominent blocking progress overlay prevents further editor interactions until commissioning succeeds or fails. When live camera access is unavailable because the editor is not open over HTTPS/`localhost`, permission was denied or the browser lacks camera support, the editor explains the reason and keeps image loading available.<br/>
@@ -17,6 +22,7 @@
 - **Matter editor/help cleanup**: decorative animated light icons and duplicate localized help headings were removed from the Matter Controller, Matter Bridge and shared light editor where applicable.<br/>
 - **Matter Bridge — editor tab orientation**: the device editor now uses the same left-hand vertical tab layout as Matter Controller, keeping Mappings and Advanced options visually consistent without changing saved configuration.<br/>
 - **Control Matter from KNX — simple flow input and capability help**: non-light endpoints now accept the same human-readable `msg.payload = { function, value }` contract used by Matter Bridge. The selected node and endpoint are implicit; percentages, temperatures and measurements use human units, while omitting `value` reads a supported state. A capability-driven **Flow input** tab, consistent with the node's existing editor tabs, replaces the modal help button and provides copyable simple examples plus every advertised readable/writable attribute, command, cluster ID and advanced message. It remains available for flow-only nodes without a KNX gateway. Existing top-level `clusterId`/`command`/`attribute` inputs remain compatible, and Door Lock also accepts `{function:"lock",value:true|false}`.<br/>
+- **Examples — Matter semantic flow input**: added an importable, non-destructive Matter Controller example with manual Inject nodes for On/Off, level, cover position, thermostat setpoint, temperature read and Identify. It deliberately creates no `matter-config`, sends nothing automatically and directs users to select an existing fabric/endpoint and use only functions advertised in the **Flow input** tab.<br/>
 - **Control Matter from KNX — dedicated controller profiles**: Window Covering (`0x0102`), Thermostat (`0x0201`), Fan Control (`0x0202`) and Switch (`0x003B`) endpoints are now selected into explicit capability-driven profiles instead of the anonymous mapped fallback. They share the guarded mapping lifecycle while presenting semantic canvas status; Switch initial/long/multi-press events are filtered to the selected endpoint and exposed on the optional flow output. Simple actuators and sensors remain on the generic mapped profile.<br/>
 - **Control Matter from KNX — flow attribute reads and persistent Door Lock status**: mapped endpoints now use an unambiguous top-level flow contract: `msg.clusterId` plus `msg.attribute` reads an attribute, `msg.value` makes it an attribute write, and `msg.command` plus `msg.args` invokes a command. Reads return the value in `msg.payload`, may force a remote request with `msg.requestFromRemote = true`, and accept numeric attribute ID `0`. Door Lock nodes now retain their last `locked`/`unlocked` canvas status when generic Matter or KNX notifications arrive.<br/>
 

package/examples/Matter Controller - Semantic Flow Input.json

@@ -0,0 +1,248 @@
+[
+  {
+    "id": "matter_semantic_tab",
+    "type": "tab",
+    "label": "Matter Controller - Flow input",
+    "disabled": false,
+    "info": "Example of the semantic msg.payload = { function, value } contract for Control Matter from KNX (BETA).\n\nAfter importing:\n1. Open the example Matter Controller node.\n2. Select your existing Matter Controller configuration and a commissioned non-light endpoint.\n3. Enable Node Input/Output PINs.\n4. In the Flow input section shown below the PIN selector, use only the Inject nodes matching functions advertised by the device.\n\nThis example creates no matter-config and sends no command automatically."
+  },
+  {
+    "id": "matter_semantic_instructions",
+    "type": "comment",
+    "z": "matter_semantic_tab",
+    "name": "1. Open the Controller, select matter-config + endpoint, then enable the flow PINs",
+    "info": "The Inject nodes are alternative examples: one endpoint normally does not support every function shown. Use only functions listed in the Controller node's Flow input section.",
+    "x": 520,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "matter_semantic_supported",
+    "type": "comment",
+    "z": "matter_semantic_tab",
+    "name": "2. Trigger only Inject nodes supported by the selected endpoint",
+    "info": "No Inject is configured to run automatically. Reads omit value; writes include value.",
+    "x": 340,
+    "y": 110,
+    "wires": []
+  },
+  {
+    "id": "matter_semantic_on",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "On: {onoff, true}",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"onoff\",\"value\":true}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 180,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_off",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Off: {onoff, false}",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"onoff\",\"value\":false}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 230,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_level",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Level 50%",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"level\",\"value\":50}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 180,
+    "y": 280,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_position",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Cover position 35%",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"position\",\"value\":35}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 330,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_setpoint",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Setpoint 21,5 °C",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"setpoint\",\"value\":21.5}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 380,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_temperature",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Read temperature",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"temperature\"}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 430,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_identify",
+    "type": "inject",
+    "z": "matter_semantic_tab",
+    "name": "Identify",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"function\":\"identify\"}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 170,
+    "y": 480,
+    "wires": [
+      [
+        "matter_semantic_controller"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_controller",
+    "type": "knxUltimateMatterControllerDevice",
+    "z": "matter_semantic_tab",
+    "server": "",
+    "serverMatter": "",
+    "matterControllerMode": "single",
+    "universalService": "batteryMonitor",
+    "matterNodeId": "",
+    "matterEndpointId": 1,
+    "matterDeviceName": "",
+    "matterDeviceCapabilities": "",
+    "matterMappings": "[]",
+    "name": "SELECT A MATTER ENDPOINT",
+    "readStatusAtStartup": "no",
+    "enableNodePINS": "yes",
+    "updateLocalStateFromKNXWrite": true,
+    "inputs": 1,
+    "outputs": 1,
+    "x": 570,
+    "y": 330,
+    "wires": [
+      [
+        "matter_semantic_debug"
+      ]
+    ]
+  },
+  {
+    "id": "matter_semantic_debug",
+    "type": "debug",
+    "z": "matter_semantic_tab",
+    "name": "Complete Matter response",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "payload",
+    "statusType": "auto",
+    "x": 850,
+    "y": 330,
+    "wires": []
+  }
+]

package/nodes/knxUltimateMatterBridge.html

@@ -67,6 +67,28 @@
       robotvacuum: [] // Flow-only: no GA fields, controlled via the node PINs
     };
     const TYPE_ORDER = ['onofflight', 'dimmablelight', 'rgblight', 'colortemperaturelight', 'onoffplug', 'windowcovering', 'thermostat', 'fan', 'temperaturesensor', 'humiditysensor', 'lightsensor', 'occupancysensor', 'contactsensor', 'smokecoalarm', 'waterleakdetector', 'airqualitysensor', 'robotvacuum'];
+    const FLOW_HELP = {
+      onofflight: { input: [['onoff', true]], output: [['onoff', true]] },
+      onoffplug: { input: [['onoff', true]], output: [['onoff', true]] },
+      dimmablelight: { input: [['onoff', true], ['level', 50]], output: [['onoff', true], ['level', 50]] },
+      rgblight: { input: [['onoff', true], ['level', 50], ['rgb', { red: 255, green: 80, blue: 20 }]], output: [['onoff', true], ['level', 50], ['rgb', { red: 255, green: 80, blue: 20 }]] },
+      colortemperaturelight: { input: [['onoff', true], ['level', 50], ['colortemp', 3000]], output: [['onoff', true], ['level', 50], ['colortemp', 3000]] },
+      temperaturesensor: { input: [['temperature', 21.5]], output: [] },
+      humiditysensor: { input: [['humidity', 45]], output: [] },
+      lightsensor: { input: [['illuminance', 500]], output: [] },
+      occupancysensor: { input: [['occupancy', true]], output: [] },
+      contactsensor: { input: [['contact', true]], output: [] },
+      windowcovering: { input: [['position', 35]], output: [['updown', false], ['position', 35], ['stop', true]] },
+      thermostat: { input: [['currenttemp', 21.5], ['setpoint', 21], ['coolingsetpoint', 24]], output: [['setpoint', 21], ['coolingsetpoint', 24]] },
+      smokecoalarm: { input: [['smoke', true], ['co', true]], output: [] },
+      waterleakdetector: { input: [['leak', true]], output: [] },
+      airqualitysensor: { input: [['co2', 850]], output: [] },
+      fan: { input: [['fanspeed', 60]], output: [['fanspeed', 60]] },
+      robotvacuum: {
+        input: [['rvcstate', 'charging'], ['rvcmode', 'idle']],
+        output: [['rvccommand', 'gohome'], ['rvccommand', 'pause'], ['rvccommand', 'resume'], ['rvcmode', 'cleaning']]
+      }
+    };
 
     // Every GA/DPT key across all types, used to declare the node defaults.
     const ALL_KEYS = [];
@@ -167,6 +189,25 @@
                 border-top: 1px solid #ccc;
                 margin: 8px 0;
               }
+              .matter-bridge-flow-help-table {
+                width: 100%;
+                border-collapse: collapse;
+                margin-bottom: 12px;
+              }
+              .matter-bridge-flow-help-table th,
+              .matter-bridge-flow-help-table td {
+                border-bottom: 1px solid #ddd;
+                padding: 7px 6px;
+                text-align: left;
+                vertical-align: top;
+              }
+              .matter-bridge-flow-help-table code {
+                white-space: pre-wrap;
+                word-break: break-word;
+              }
+              .matter-bridge-flow-help-copy {
+                white-space: nowrap;
+              }
             </style>`);
         }
         const $tabs = $('#mb-tabs');
@@ -217,6 +258,9 @@
         const $commandAdvancedRows = $('.mb-command-advanced-row');
         const $dimmerAdvancedRows = $('.mb-dimmer-advanced-row');
         const $coverAdvancedRows = $('.mb-cover-advanced-row');
+        const $pinSelect = $('#node-input-enableNodePINS');
+        const $flowHelp = $('#matter-bridge-flow-help');
+        const $nameInput = $('#node-input-name');
         const gaInputs = {};
 
         function createLabeledField(row, element, options = {}) {
@@ -272,6 +316,51 @@
           gaInputs[key] = { wrapper, $ga, $dpt, $labelSpan };
         });
 
+        const inputMessageCode = (fn, value) => `msg.payload = ${JSON.stringify({ function: fn, value }, null, 2)};\nreturn msg;`;
+        const outputMessageCode = (fn, value) => JSON.stringify({
+          topic: ($nameInput.val() || node.name || 'Matter device').toString(),
+          payload: value,
+          matter: { fn, value }
+        }, null, 2);
+        const appendFlowHelpRow = ($body, fn, code) => {
+          const $row = $('<tr></tr>');
+          $('<td><code></code></td>').find('code').text(fn).end().appendTo($row);
+          $('<td><code></code></td>').find('code').text(code).end().appendTo($row);
+          $('<td></td>').append(
+            $('<button type="button" class="red-ui-button matter-bridge-flow-help-copy"><i class="fa fa-copy"></i></button>')
+              .attr('title', node._('knxUltimateMatterBridge.flow_help.copy') || 'Copy')
+              .data('copy-text', code)
+          ).appendTo($row);
+          $body.append($row);
+        };
+        const copyFlowHelpText = (value) => {
+          const copied = () => RED.notify(node._('knxUltimateMatterBridge.flow_help.copied') || 'Message copied', 'success');
+          if (navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+            navigator.clipboard.writeText(value).then(copied).catch(() => {
+              const $temporary = $('<textarea></textarea>').val(value).appendTo('body').select();
+              try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
+            });
+            return;
+          }
+          const $temporary = $('<textarea></textarea>').val(value).appendTo('body').select();
+          try { document.execCommand('copy'); copied(); } finally { $temporary.remove(); }
+        };
+        const renderFlowHelp = () => {
+          const examples = FLOW_HELP[$type.val()] || { input: [], output: [] };
+          const $inputBody = $('#matter-bridge-flow-help-input-body').empty();
+          const $outputBody = $('#matter-bridge-flow-help-output-body').empty();
+          examples.input.forEach(([fn, value]) => appendFlowHelpRow($inputBody, fn, inputMessageCode(fn, value)));
+          examples.output.forEach(([fn, value]) => appendFlowHelpRow($outputBody, fn, outputMessageCode(fn, value)));
+          $('#matter-bridge-flow-help-input-empty').toggle(examples.input.length === 0);
+          $('#matter-bridge-flow-help-output-empty').toggle(examples.output.length === 0);
+          $('#matter-bridge-flow-help-output-table').toggle(examples.output.length > 0);
+        };
+        const updateFlowHelpVisibility = () => {
+          const visible = $pinSelect.val() === 'yes';
+          $flowHelp.toggle(visible);
+          if (visible) renderFlowHelp();
+        };
+
         function updateTypePresentation() {
           const selected = $type.val();
           const active = TYPE_FIELDS[selected] || [];
@@ -295,6 +384,7 @@
           $commandAdvancedRows.toggle(hasCommand);
           $dimmerAdvancedRows.toggle(hasLevel);
           $coverAdvancedRows.toggle(isCover);
+          updateFlowHelpVisibility();
         }
         $type.on('change', updateTypePresentation);
         updateTypePresentation();
@@ -312,7 +402,15 @@
         $('#node-input-coverUpdateMode').val(node.coverUpdateMode || 'optimistic');
         $('#node-input-coverStatusTimeoutMs').val(node.coverStatusTimeoutMs === undefined ? 3000 : node.coverStatusTimeoutMs);
         $('#node-input-readStatusAtStartup').val(node.readStatusAtStartup || 'yes');
-        $('#node-input-enableNodePINS').val(node.enableNodePINS || 'no');
+        $pinSelect.val(node.enableNodePINS || 'no');
+        $pinSelect.on('change.knxUltimateMatterBridge', updateFlowHelpVisibility);
+        $nameInput.on('change.knxUltimateMatterBridge input.knxUltimateMatterBridge', () => {
+          if ($flowHelp.is(':visible')) renderFlowHelp();
+        });
+        $flowHelp.off('click.knxUltimateMatterBridge').on('click.knxUltimateMatterBridge', '.matter-bridge-flow-help-copy', function () {
+          copyFlowHelpText($(this).data('copy-text') || '');
+        });
+        updateFlowHelpVisibility();
       },
       oneditsave() {
         try { RED.sidebar.show('info'); } catch (error) { /* empty */ }
@@ -479,18 +577,52 @@
         </select>
       </div>
 
-      <div class="form-row">
-        <label for="node-input-enableNodePINS" style="width:260px;">
-          <i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.node_pins"></span>
-        </label>
-        <select id="node-input-enableNodePINS" style="width:220px;">
-          <option value="no" data-i18n="knxUltimateMatterBridge.node_pins_hide"></option>
-          <option value="yes" data-i18n="knxUltimateMatterBridge.node_pins_show"></option>
-        </select>
-      </div>
     </div>
   </div>
 
+  <div class="form-row" style="margin-top:12px;">
+    <label for="node-input-enableNodePINS" style="width:260px;">
+      <i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.node_pins"></span>
+    </label>
+    <select id="node-input-enableNodePINS" style="width:220px;">
+      <option value="no" data-i18n="knxUltimateMatterBridge.node_pins_hide"></option>
+      <option value="yes" data-i18n="knxUltimateMatterBridge.node_pins_show"></option>
+    </select>
+  </div>
+
+  <div id="matter-bridge-flow-help" style="display:none; width:900px; margin-top:12px;">
+    <h4><i class="fa fa-code"></i> <span data-i18n="knxUltimateMatterBridge.flow_help.title"></span></h4>
+    <p data-i18n="knxUltimateMatterBridge.flow_help.intro"></p>
+
+    <h4 data-i18n="knxUltimateMatterBridge.flow_help.input_title"></h4>
+    <p data-i18n="knxUltimateMatterBridge.flow_help.input_hint"></p>
+    <table class="matter-bridge-flow-help-table">
+      <thead>
+        <tr>
+          <th data-i18n="knxUltimateMatterBridge.flow_help.function"></th>
+          <th data-i18n="knxUltimateMatterBridge.flow_help.message"></th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody id="matter-bridge-flow-help-input-body"></tbody>
+    </table>
+    <p id="matter-bridge-flow-help-input-empty" style="display:none;" data-i18n="knxUltimateMatterBridge.flow_help.no_input"></p>
+
+    <h4 data-i18n="knxUltimateMatterBridge.flow_help.output_title"></h4>
+    <p data-i18n="knxUltimateMatterBridge.flow_help.output_hint"></p>
+    <table id="matter-bridge-flow-help-output-table" class="matter-bridge-flow-help-table">
+      <thead>
+        <tr>
+          <th data-i18n="knxUltimateMatterBridge.flow_help.function"></th>
+          <th data-i18n="knxUltimateMatterBridge.flow_help.message"></th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody id="matter-bridge-flow-help-output-body"></tbody>
+    </table>
+    <p id="matter-bridge-flow-help-output-empty" style="display:none;" data-i18n="knxUltimateMatterBridge.flow_help.no_output"></p>
+  </div>
+
   <br/>
   <br/>
   <br/>
@@ -518,7 +650,8 @@ The advanced compatibility options are intentionally type-specific:
 
 The **KNX gateway is optional**: without it, enable the node PINs and drive the device from the flow.
 
-If you enable the **node PINs**:
+The PIN selector sits outside the tabs. Enabling it reveals a contextual **Flow input/output**
+section directly below, with copyable examples filtered to the selected device type:
 
 - input: `msg.payload = { function: "onoff", value: true }` updates the Matter state without the KNX bus
 - output: every command from a Matter controller is forwarded as `msg` (topic = device name, payload = value, `msg.matter` = raw command)

package/nodes/knxUltimateMatterControllerDevice.html

@@ -274,7 +274,7 @@
           const $refreshDevicesButton = $(".hue-refresh-devices");
           const $locateDeviceButton = $(".hue-locate-device");
           const $hueDevicesLoading = $(".hue-devices-loading");
-          const $inputHelpPanel = $("#tabs-input");
+          const $inputHelpPanel = $("#matter-flow-input-help");
           const UNIVERSAL_NODE_ID = '__UNIVERSAL__';
           const isUniversalMode = () => $matterControllerModeInput.val() === 'universal';
           $matterControllerModeInput.val(node.matterControllerMode || 'single');
@@ -921,9 +921,25 @@
             const caps = getEffectiveMatterCapabilities();
             const structure = inputStructureFor(caps);
             const endpointId = structure ? structure.endpointId : Number($matterEndpointInput.val() || node.matterEndpointId || 1);
+            const isMatterLight = !caps.profile;
             $('#matter-input-help-endpoint').text(String(endpointId));
             const $simpleBody = $('#matter-input-help-simple-body').empty();
-            if (caps.profile === 'doorLock') {
+            if (isMatterLight) {
+              const writeLabel = node._('knxUltimateMatterControllerDevice.input_help_write') || 'Write';
+              if (caps.onOff !== false) {
+                appendInputHelpRow($simpleBody, writeLabel, node._('knxUltimateMatterControllerDevice.input_functions.on') || 'On', 'msg.on = { on: true };\nreturn msg;');
+                appendInputHelpRow($simpleBody, writeLabel, node._('knxUltimateMatterControllerDevice.input_functions.off') || 'Off', 'msg.on = { on: false };\nreturn msg;');
+              }
+              if (caps.level !== false) {
+                appendInputHelpRow($simpleBody, writeLabel, node._('knxUltimateMatterControllerDevice.input_functions.brightness') || 'Brightness', 'msg.dimming = { brightness: 50 };\nreturn msg;');
+              }
+              if (caps.colorTemperature === true) {
+                appendInputHelpRow($simpleBody, writeLabel, node._('knxUltimateMatterControllerDevice.input_functions.color_temperature') || 'Colour temperature', 'msg.color_temperature = { mirek: 370 };\nreturn msg;');
+              }
+              if (caps.color === true) {
+                appendInputHelpRow($simpleBody, writeLabel, node._('knxUltimateMatterControllerDevice.input_functions.xy_color') || 'XY colour', 'msg.color = { xy: { x: 0.675, y: 0.322 } };\nreturn msg;');
+              }
+            } else 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 {
@@ -949,9 +965,19 @@
               });
             }
             $('#matter-input-help-simple-empty').toggle($simpleBody.children().length === 0);
+            $('#matter-input-help-simple-hint').attr(
+              'data-i18n',
+              isMatterLight
+                ? 'knxUltimateMatterControllerDevice.input_help_light_hint'
+                : 'knxUltimateMatterControllerDevice.input_help_simple_hint'
+            ).text(node._(
+              isMatterLight
+                ? 'knxUltimateMatterControllerDevice.input_help_light_hint'
+                : 'knxUltimateMatterControllerDevice.input_help_simple_hint'
+            ) || '');
 
             const $advancedBody = $('#matter-input-help-advanced-body').empty();
-            if (structure) {
+            if (structure && !isMatterLight) {
               structure.clusters.forEach((cluster) => {
                 (cluster.attributes || []).forEach((attribute) => {
                   const prefix = `${cluster.name || 'Cluster'} (${cluster.id}) · ${attribute.name} (${attribute.id})`;
@@ -967,6 +993,7 @@
               });
             }
             $('#matter-input-help-advanced-empty').toggle($advancedBody.children().length === 0);
+            $('#matter-input-help-advanced-details').toggle(!isMatterLight);
           };
           const copyInputHelpText = (text) => {
             const copied = () => RED.notify(node._('knxUltimateMatterControllerDevice.input_help_copied') || 'Message copied', 'success');
@@ -985,11 +1012,6 @@
           });
           $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');
@@ -1300,7 +1322,6 @@
             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);
@@ -1316,7 +1337,9 @@
             $('#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();
+            const showInputHelp = !isUniversal && hasHueDevice && $pinSelect.val() === 'yes';
+            $inputHelpPanel.toggle(showInputHelp);
+            if (showInputHelp) renderInputHelp();
             $('#matter-selected-device-type-value').text(deviceTypeDisplay);
             $('#matter-selected-device-type').toggle(hasHueDevice && deviceTypeDisplay !== '');
             try { $tabs.tabs('refresh'); } catch (error) { /* empty */ }
@@ -1440,6 +1463,7 @@
           });
 
           $hueDeviceInput.on('change.knxUltimateMatterControllerDevice input.knxUltimateMatterControllerDevice', updateTabsVisibility);
+          $pinSelect.on('change.knxUltimateMatterControllerDevice', updateTabsVisibility);
 
           if (($deviceNameInput.val() || '').trim() !== '') {
             applyHueDevicesPlaceholder(true);
@@ -2134,7 +2158,6 @@
         <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">
@@ -2142,46 +2165,6 @@
           <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">
@@ -2623,6 +2606,46 @@
         <option value="yes" data-i18n="knxUltimateMatterControllerDevice.node_pins_show"></option>
       </select>
     </div>
+    <div id="matter-flow-input-help" style="display:none; width:900px; margin-top:12px;">
+      <h4><i class="fa-solid fa-code"></i> <span data-i18n="knxUltimateMatterControllerDevice.input_help_label"></span></h4>
+      <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 id="matter-input-help-simple-hint" 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 id="matter-input-help-advanced-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>
 
   <br/>
@@ -2647,9 +2670,11 @@ optional flow output; simpler endpoints continue through the generic mapped fall
 
 **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.
+Enable **Node Input/Output PINs** to reveal the **Flow input** section directly below
+the selector. Lights show copyable examples for supported top-level properties such as
+`msg.on`, `msg.dimming`, `msg.color_temperature` and `msg.color`. For non-light
+endpoints the section shows 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
@@ -2779,7 +2804,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, 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}`. |
+| Node Input/Output PINs | Reveals the **Flow input** section below the selector. Lights use the supported top-level state properties shown there (`msg.on`, `msg.dimming`, `msg.color_temperature`, `msg.color`). Mapped endpoints use `msg.payload = {function,value}` or the advanced Matter selectors. 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. |

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Diese Optionen werden nur angezeigt, wenn sie zum gewählten Typ passen. Dimmbar
 
 ## Node-PINs
 
-Wenn du die Input/Output-PINs des Nodes aktivierst:
+Der PIN-Selektor befindet sich außerhalb der Editor-Tabs. Nach dem Aktivieren erscheint direkt darunter ein kontextbezogener Bereich **Flow-Eingang/-Ausgang** mit kopierbaren Beispielen für den ausgewählten Gerätetyp:
 
 - **Input**: aktualisiere den Matter-Zustand aus dem Flow, ohne den KNX-Bus: `msg.payload = { function: "onoff", value: true }` (`function` ist eine von `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Nützlich, um im Flow berechnete Werte (z.B. einen virtuellen Sensor) für Alexa & Co. bereitzustellen.
 - **Output**: Jeder von einem Matter-Controller empfangene Befehl wird an den Flow weitergeleitet: `msg.topic` = Gerätename, `msg.payload` = Wert, `msg.matter` = der rohe Befehl. Ein Gerät ohne Befehls-GAs wird zum **Nur-Flow-Gerät**.

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "KNX-Zuordnungen",
       "advanced": "Erweiterte Optionen"
     },
+    "flow_help": {
+      "title": "Flow-Eingang/-Ausgang",
+      "intro": "Diese Beispiele entsprechen dem ausgewählten Gerätetyp und sind verfügbar, solange die Ein-/Ausgangs-PINs aktiviert sind.",
+      "input_title": "Flow → Matter (Node-Eingang)",
+      "input_hint": "Sende eine dieser Nachrichten, um den bereitgestellten Matter-Zustand ohne KNX-Schreibvorgang zu aktualisieren.",
+      "output_title": "Matter → Flow (Node-Ausgang)",
+      "output_hint": "Befehle eines Matter-Controllers werden mit dem Wert in msg.payload und den Rohdetails in msg.matter ausgegeben.",
+      "function": "Funktion",
+      "message": "Beispielnachricht",
+      "copy": "Kopieren",
+      "copied": "Nachricht kopiert",
+      "no_input": "Für diesen Gerätetyp gibt es keine Beispiele für Flow-Zustandsupdates.",
+      "no_output": "Dieser Gerätetyp gibt keine Controller-Befehle aus; sein Ausgang bleibt inaktiv."
+    },
     "functions": {
       "fn_onoff_cmd": "Ein/Aus Befehls-GA",
       "fn_onoff_status": "Ein/Aus Status-GA",

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 | Sensoren | Sensor-Endpunkte zeigen ihre Mess-/Status-GA nur bei Unterstützung: Temperatur, Feuchte, Helligkeit, Präsenz, Kontakt und Batterie. |
 | Read at startup | Veröffentlicht den gecachten Matter-Wert beim Deploy/Start oder wenn sich das Gerät erneut verbindet. |
 | Update local state from KNX write | Aktualisiert den lokalen Matter/KNX-Cache, wenn ein Telegramm auf eine konfigurierte KNX-GA geschrieben wird. |
-| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Nicht-Licht-Endpunkte akzeptieren das einfache `{function,value}`-Format und die erweiterten Matter-Felder; der Ausgang sendet Statusupdates. |
+| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins und direkt darunter den Bereich **Flow-Eingang**. Für Leuchten werden die unterstützten Lichtzustands-Nachrichten auf oberster Ebene angezeigt; andere Endpunkte zeigen das einfache `{function,value}`-Format und die erweiterten Matter-Felder. |
 
 ## Flow-Eingang
 
-Öffne bei einem ausgewählten Nicht-Licht-Endpunkt den Tab **Flow-Eingang**. Der Tab wird aus der angekündigten Endpunktstruktur aufgebaut und zeigt kopierbare Beispiele, die Endpoint ID sowie alle lesbaren/schreibbaren Attribute und akzeptierten Befehle. Er bleibt auch verfügbar, wenn der Knoten ohne KNX-Gateway nur im Flow verwendet wird.
+Aktiviere **Node Input/Output PINs**, um den Bereich **Flow-Eingang** direkt unter dem Auswahlfeld einzublenden. Für Leuchten zeigt er kopierbare Beispiele der unterstützten Eigenschaften auf oberster Ebene, etwa `msg.on`, `msg.dimming`, `msg.color_temperature` und `msg.color`. Für andere Endpunkte wird er aus der angekündigten Struktur aufgebaut und zeigt Endpoint ID sowie alle lesbaren/schreibbaren Attribute und akzeptierten Befehle. Er bleibt auch ohne KNX-Gateway verfügbar.
 
 Einfache Schreibvorgänge verwenden `msg.payload = {function:"position",value:35}`. Ohne `value` wird ein unterstützter Zustand gelesen, zum Beispiel `{function:"temperature"}`; die Ausgabe verwendet verständliche Einheiten und enthält Rohdetails in `msg.matter`. Funktionen wie `onoff`, `level`, `position`, `open`, `close`, `stop`, Sollwerte, Lüfter und Sensoren erscheinen nur bei Unterstützung. Türschlösser akzeptieren `{function:"lock",value:true|false}`.
 

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "Der Knoten kennt Node ID und Endpoint ID bereits; einfache Nachrichten benötigen sie nicht.",
     "input_help_simple_title": "Einfache Nachrichten",
     "input_help_simple_hint": "Diese Funktionen verwenden verständliche Einheiten und werden in den Matter-Cluster, Befehl oder das Attribut des ausgewählten Endpunkts übersetzt.",
+    "input_help_light_hint": "Licht-Endpunkte akzeptieren Lichtzustands-Eigenschaften direkt in msg (nicht in msg.payload). Es werden nur die von der ausgewählten Leuchte unterstützten Steuerungen angezeigt.",
     "input_help_advanced_title": "Erweiterte Matter-Details",
     "input_help_advanced_hint": "Es werden nur angekündigte Attribute und Befehle aufgelistet. Schreibbeispiele verwenden 0 als Platzhalter; Befehlsargumente müssen eventuell an den Matter-Datentyp angepasst werden.",
     "input_help_operation": "Operation",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Dieser Endpunkt besitzt keine bekannte einfache Eingangsfunktion.",
     "input_help_no_structure": "Die Matter-Struktur ist nicht verfügbar. Aktualisiere die Geräteliste, während der Endpunkt online ist.",
     "input_functions": {
-      "onoff": "Ein / Aus", "level": "Stufe", "position": "Rollladenposition", "tiltposition": "Lamellenposition", "open": "Öffnen", "close": "Schließen", "stop": "Stopp", "setpoint": "Heizsollwert", "coolingsetpoint": "Kühlsollwert", "currenttemp": "Aktuelle Temperatur", "fanspeed": "Lüftergeschwindigkeit", "temperature": "Temperatur", "humidity": "Luftfeuchtigkeit", "illuminance": "Beleuchtungsstärke", "occupancy": "Belegung", "contact": "Kontakt", "battery": "Batterie", "activepower": "Wirkleistung", "importedenergy": "Bezogene Energie", "identify": "Identifizieren", "lock": "Verriegeln", "unlock": "Entriegeln"
+      "onoff": "Ein / Aus", "on": "Ein", "off": "Aus", "level": "Stufe", "brightness": "Helligkeit", "color_temperature": "Farbtemperatur", "xy_color": "XY-Farbe", "position": "Rollladenposition", "tiltposition": "Lamellenposition", "open": "Öffnen", "close": "Schließen", "stop": "Stopp", "setpoint": "Heizsollwert", "coolingsetpoint": "Kühlsollwert", "currenttemp": "Aktuelle Temperatur", "fanspeed": "Lüftergeschwindigkeit", "temperature": "Temperatur", "humidity": "Luftfeuchtigkeit", "illuminance": "Beleuchtungsstärke", "occupancy": "Belegung", "contact": "Kontakt", "battery": "Batterie", "activepower": "Wirkleistung", "importedenergy": "Bezogene Energie", "identify": "Identifizieren", "lock": "Verriegeln", "unlock": "Entriegeln"
     },
     "tabs": {
       "switch": "Schalten",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ These options are hidden unless they apply to the selected type. Dimmable device
 
 ## Node PINs
 
-If you enable the node input/output PINs:
+The PIN selector is outside the editor tabs. Enabling it reveals a contextual **Flow input/output** section directly below, with copyable examples filtered to the selected device type:
 
 - **Input**: update the Matter state from the flow, without the KNX bus: `msg.payload = { function: "onoff", value: true }` (`function` is one of `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Useful to expose flow-computed values (e.g. a virtual sensor) to Alexa & Co.
 - **Output**: every command received from a Matter controller is forwarded to the flow: `msg.topic` = device name, `msg.payload` = value, `msg.matter` = the raw command. A device without command GAs becomes a **flow-only device**.

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "KNX mappings",
       "advanced": "Advanced options"
     },
+    "flow_help": {
+      "title": "Flow input/output",
+      "intro": "These examples match the selected device type and are available while the node input/output PINs are enabled.",
+      "input_title": "Flow → Matter (node input)",
+      "input_hint": "Send one of these messages to update the exposed Matter state without writing to KNX.",
+      "output_title": "Matter → Flow (node output)",
+      "output_hint": "Commands received from a Matter controller are emitted with the value in msg.payload and raw routing details in msg.matter.",
+      "function": "Function",
+      "message": "Example message",
+      "copy": "Copy",
+      "copied": "Message copied",
+      "no_input": "This device type has no flow state-update examples.",
+      "no_output": "This device type does not emit controller commands; its output remains silent."
+    },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 | Sensors | Sensor endpoints expose their measurement/status GA only when supported: temperature, humidity, illuminance, occupancy, contact and battery. |
 | Read at startup | Publishes the cached Matter value at deploy/startup or when the device reconnects. |
 | Update local state from KNX write | Updates the local Matter/KNX cache when a telegram is written on a configured KNX GA. |
-| Node Input/Output PINs | Shows Node-RED input/output pins. Non-light endpoints accept the simple `{function,value}` contract below as well as the advanced Matter fields; output emits state updates. The selection is preserved when the editor is reopened. |
+| Node Input/Output PINs | Shows Node-RED input/output pins and reveals the **Flow input** section directly below this field. Lights show their supported top-level light-state messages; non-light endpoints show the simple `{function,value}` contract and advanced Matter fields. The selection is preserved when the editor is reopened. |
 
 ## Flow input
 
-For a selected non-light endpoint, open the **Flow input** tab in the editor. The tab is built from the endpoint's advertised structure and provides copyable examples, the selected Endpoint ID, every readable/writable attribute and every accepted command. It remains available when the node is used only by a flow without a KNX gateway.
+Enable **Node Input/Output PINs** to reveal the **Flow input** section directly below the selector. For lights it shows copyable examples for the supported top-level properties, such as `msg.on`, `msg.dimming`, `msg.color_temperature` and `msg.color`. For non-light endpoints it is built from the advertised structure and provides the selected Endpoint ID, every readable/writable attribute and every accepted command. It remains available when the node is used only by a flow without a KNX gateway.
 
 Simple writes use `msg.payload = {function:"position",value:35}`. Omit `value` to read a supported state, for example `{function:"temperature"}`; the output uses human units and includes raw routing details in `msg.matter`. Supported functions include `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, sensor readings and `identify`, but only when advertised by that endpoint. Door Lock accepts `{function:"lock",value:true|false}`.
 

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "The node already knows the Node ID and Endpoint ID, so the simple messages do not need them.",
     "input_help_simple_title": "Simple messages",
     "input_help_simple_hint": "These functions use human units and are translated to the Matter cluster, command or attribute shown by the selected endpoint.",
+    "input_help_light_hint": "Light endpoints accept light-state properties directly on msg (not inside msg.payload). Only controls supported by the selected light are shown.",
     "input_help_advanced_title": "Advanced Matter details",
     "input_help_advanced_hint": "Only advertised attributes and commands are listed. Attribute write examples use 0 as a placeholder; command arguments may need to be adapted to the Matter data type.",
     "input_help_operation": "Operation",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "This endpoint has no known simple input functions.",
     "input_help_no_structure": "The Matter structure is unavailable. Refresh the device list while the endpoint is online.",
     "input_functions": {
-      "onoff": "On / Off", "level": "Level", "position": "Cover position", "tiltposition": "Cover tilt", "open": "Open", "close": "Close", "stop": "Stop", "setpoint": "Heating setpoint", "coolingsetpoint": "Cooling setpoint", "currenttemp": "Current temperature", "fanspeed": "Fan speed", "temperature": "Temperature", "humidity": "Humidity", "illuminance": "Illuminance", "occupancy": "Occupancy", "contact": "Contact", "battery": "Battery", "activepower": "Active power", "importedenergy": "Imported energy", "identify": "Identify", "lock": "Lock", "unlock": "Unlock"
+      "onoff": "On / Off", "on": "On", "off": "Off", "level": "Level", "brightness": "Brightness", "color_temperature": "Colour temperature", "xy_color": "XY colour", "position": "Cover position", "tiltposition": "Cover tilt", "open": "Open", "close": "Close", "stop": "Stop", "setpoint": "Heating setpoint", "coolingsetpoint": "Cooling setpoint", "currenttemp": "Current temperature", "fanspeed": "Fan speed", "temperature": "Temperature", "humidity": "Humidity", "illuminance": "Illuminance", "occupancy": "Occupancy", "contact": "Contact", "battery": "Battery", "activepower": "Active power", "importedenergy": "Imported energy", "identify": "Identify", "lock": "Lock", "unlock": "Unlock"
     },
     "tabs": {
       "switch": "Switch",

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Lo
 
 ## PINes del nodo
 
-Si habilitas los PINes de entrada/salida del nodo:
+El selector de PINes está fuera de las pestañas del editor. Al activarlo aparece justo debajo una sección contextual **Entrada/salida del flow**, con ejemplos copiables filtrados según el tipo de dispositivo:
 
 - **Entrada**: actualiza el estado Matter desde el flow, sin pasar por el bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` es una de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Útil para exponer a Alexa y cía. valores calculados en el flow (p.ej. un sensor virtual).
 - **Salida**: cada comando recibido de un controlador Matter se reenvía al flow: `msg.topic` = nombre del dispositivo, `msg.payload` = valor, `msg.matter` = el comando en bruto. Un dispositivo sin GA de comando se convierte en un **dispositivo solo-flow**.

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Asignaciones KNX",
       "advanced": "Opciones avanzadas"
     },
+    "flow_help": {
+      "title": "Entrada/salida del flow",
+      "intro": "Estos ejemplos corresponden al tipo de dispositivo seleccionado y están disponibles mientras los pines de entrada/salida del nodo están activados.",
+      "input_title": "Flow → Matter (entrada del nodo)",
+      "input_hint": "Envía uno de estos mensajes para actualizar el estado Matter expuesto sin escribir en KNX.",
+      "output_title": "Matter → Flow (salida del nodo)",
+      "output_hint": "Los comandos recibidos de un controlador Matter se emiten con el valor en msg.payload y los detalles raw en msg.matter.",
+      "function": "Función",
+      "message": "Mensaje de ejemplo",
+      "copy": "Copiar",
+      "copied": "Mensaje copiado",
+      "no_input": "Este tipo de dispositivo no tiene ejemplos de actualización de estado desde el flow.",
+      "no_output": "Este tipo de dispositivo no emite comandos del controlador; su salida permanece inactiva."
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA estado On/Off",

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Sustituye a los nodos Matter separados no publicados y conserva toda la UI de lu
 | Sensores | Los endpoints de sensor muestran su GA de medida/estado solo cuando está soportado: temperatura, humedad, iluminancia, ocupación, contacto y batería. |
 | Read at startup | Publica el valor Matter en caché al desplegar/iniciar o cuando el dispositivo se reconecta. |
 | Update local state from KNX write | Actualiza la caché local Matter/KNX cuando se escribe un telegrama en una GA KNX configurada. |
-| Node Input/Output PINs | Muestra pines de entrada/salida Node-RED. Los endpoints que no son luces aceptan el formato simple `{function,value}` y los campos Matter avanzados; la salida emite estados. |
+| Node Input/Output PINs | Muestra pines de entrada/salida Node-RED y la sección **Entrada del flow** justo debajo de este campo. Las luces muestran sus mensajes de estado compatibles en el nivel superior; los demás endpoints muestran el formato simple `{function,value}` y los campos Matter avanzados. |
 
 ## Entrada del flow
 
-Para un endpoint que no sea una luz, abre la pestaña **Entrada del flow**. La pestaña se construye con la estructura anunciada y muestra ejemplos copiables, el Endpoint ID, todos los atributos legibles/escribibles y los comandos aceptados. Sigue disponible cuando el nodo se usa solo desde el flow, sin gateway KNX.
+Activa **Node Input/Output PINs** para mostrar la sección **Entrada del flow** justo debajo del selector. Para una luz, muestra ejemplos copiables de las propiedades compatibles en el nivel superior, como `msg.on`, `msg.dimming`, `msg.color_temperature` y `msg.color`. Para los demás endpoints, se construye con la estructura anunciada y muestra el Endpoint ID, todos los atributos legibles/escribibles y los comandos aceptados. Sigue disponible sin gateway KNX.
 
 Una escritura simple usa `msg.payload = {function:"position",value:35}`. Omite `value` para leer un estado, por ejemplo `{function:"temperature"}`; la salida usa unidades comprensibles e incluye los detalles raw en `msg.matter`. Las funciones `onoff`, `level`, `position`, `open`, `close`, `stop`, consignas, ventilador y sensores solo aparecen si el endpoint las anuncia. Una cerradura acepta `{function:"lock",value:true|false}`.
 

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "El nodo ya conoce el Node ID y el Endpoint ID; los mensajes simples no los necesitan.",
     "input_help_simple_title": "Mensajes simples",
     "input_help_simple_hint": "Estas funciones usan unidades comprensibles y se traducen al clúster, comando o atributo Matter del endpoint seleccionado.",
+    "input_help_light_hint": "Los endpoints de luz aceptan propiedades de estado directamente en msg (no dentro de msg.payload). Solo se muestran los controles compatibles con la luz seleccionada.",
     "input_help_advanced_title": "Detalles Matter avanzados",
     "input_help_advanced_hint": "Solo se muestran atributos y comandos anunciados. Los ejemplos de escritura usan 0 como marcador; los argumentos de los comandos pueden requerir adaptación al tipo Matter.",
     "input_help_operation": "Operación",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Este endpoint no tiene funciones de entrada simples conocidas.",
     "input_help_no_structure": "La estructura Matter no está disponible. Actualiza la lista de dispositivos mientras el endpoint esté en línea.",
     "input_functions": {
-      "onoff": "Encender / Apagar", "level": "Nivel", "position": "Posición de persiana", "tiltposition": "Inclinación de persiana", "open": "Abrir", "close": "Cerrar", "stop": "Detener", "setpoint": "Consigna de calefacción", "coolingsetpoint": "Consigna de refrigeración", "currenttemp": "Temperatura actual", "fanspeed": "Velocidad del ventilador", "temperature": "Temperatura", "humidity": "Humedad", "illuminance": "Iluminancia", "occupancy": "Ocupación", "contact": "Contacto", "battery": "Batería", "activepower": "Potencia activa", "importedenergy": "Energía importada", "identify": "Identificar", "lock": "Bloquear", "unlock": "Desbloquear"
+      "onoff": "Encender / Apagar", "on": "Encender", "off": "Apagar", "level": "Nivel", "brightness": "Brillo", "color_temperature": "Temperatura de color", "xy_color": "Color XY", "position": "Posición de persiana", "tiltposition": "Inclinación de persiana", "open": "Abrir", "close": "Cerrar", "stop": "Detener", "setpoint": "Consigna de calefacción", "coolingsetpoint": "Consigna de refrigeración", "currenttemp": "Temperatura actual", "fanspeed": "Velocidad del ventilador", "temperature": "Temperatura", "humidity": "Humedad", "illuminance": "Iluminancia", "occupancy": "Ocupación", "contact": "Contacto", "battery": "Batería", "activepower": "Potencia activa", "importedenergy": "Energía importada", "identify": "Identificar", "lock": "Bloquear", "unlock": "Desbloquear"
     },
     "tabs": {
       "switch": "Cambiar",

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Ces options ne s'affichent que lorsqu'elles s'appliquent au type sélectionné.
 
 ## PIN du nœud
 
-Si vous activez les PIN entrée/sortie du nœud :
+Le sélecteur de PIN se trouve hors des onglets de l'éditeur. Son activation affiche juste dessous une section contextuelle **Entrée/sortie du flow**, avec des exemples copiables filtrés selon le type d'appareil :
 
 - **Entrée** : mettez à jour l'état Matter depuis le flux, sans passer par le bus KNX : `msg.payload = { function: "onoff", value: true }` (`function` est l'une de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flux (ex. un capteur virtuel).
 - **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flux : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Un appareil sans GA de commande devient un **appareil flow uniquement**.

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Mappages KNX",
       "advanced": "Options avancées"
     },
+    "flow_help": {
+      "title": "Entrée/sortie du flow",
+      "intro": "Ces exemples correspondent au type d'appareil sélectionné et sont disponibles lorsque les broches d'entrée/sortie du nœud sont activées.",
+      "input_title": "Flow → Matter (entrée du nœud)",
+      "input_hint": "Envoyez l'un de ces messages pour mettre à jour l'état Matter exposé sans écrire sur KNX.",
+      "output_title": "Matter → Flow (sortie du nœud)",
+      "output_hint": "Les commandes reçues d'un contrôleur Matter sont émises avec la valeur dans msg.payload et les détails bruts dans msg.matter.",
+      "function": "Fonction",
+      "message": "Message d'exemple",
+      "copy": "Copier",
+      "copied": "Message copié",
+      "no_input": "Ce type d'appareil ne possède aucun exemple de mise à jour d'état depuis le flow.",
+      "no_output": "Ce type d'appareil n'émet aucune commande de contrôleur ; sa sortie reste inactive."
+    },
     "functions": {
       "fn_onoff_cmd": "GA commande On/Off",
       "fn_onoff_status": "GA état On/Off",

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 | Capteurs | Les endpoints capteur affichent leur GA de mesure/état uniquement si elle est supportée : température, humidité, éclairement, occupation, contact et batterie. |
 | Read at startup | Publie la valeur Matter en cache au déploiement/démarrage ou quand le périphérique se reconnecte. |
 | Update local state from KNX write | Met à jour le cache local Matter/KNX lorsqu'un télégramme est écrit sur une GA KNX configurée. |
-| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. Les endpoints autres que lumière acceptent le format simple `{function,value}` et les champs Matter avancés ; la sortie émet les états. |
+| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED et la section **Entrée du flow** juste sous ce champ. Les lumières affichent leurs messages d'état pris en charge au premier niveau ; les autres endpoints affichent le format simple `{function,value}` et les champs Matter avancés. |
 
 ## Entrée du flow
 
-Pour un endpoint autre que lumière, ouvrez l'onglet **Entrée du flow**. L'onglet est construit depuis la structure annoncée et affiche des exemples copiables, l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Il reste disponible lorsque le nœud est utilisé uniquement par le flow, sans passerelle KNX.
+Activez **Node Input/Output PINs** pour afficher la section **Entrée du flow** juste sous le sélecteur. Pour une lumière, elle propose des exemples copiables des propriétés prises en charge au premier niveau, comme `msg.on`, `msg.dimming`, `msg.color_temperature` et `msg.color`. Pour les autres endpoints, elle est construite depuis la structure annoncée et affiche l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Elle reste disponible sans passerelle KNX.
 
 Une écriture simple utilise `msg.payload = {function:"position",value:35}`. Omettez `value` pour lire un état, par exemple `{function:"temperature"}` ; la sortie utilise des unités lisibles et place les détails bruts dans `msg.matter`. Les fonctions `onoff`, `level`, `position`, `open`, `close`, `stop`, consignes, ventilateur et capteurs ne sont proposées que si l'endpoint les annonce. Une serrure accepte `{function:"lock",value:true|false}`.
 

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "Le nœud connaît déjà le Node ID et l'Endpoint ID ; les messages simples n'en ont pas besoin.",
     "input_help_simple_title": "Messages simples",
     "input_help_simple_hint": "Ces fonctions utilisent des unités lisibles et sont traduites vers le cluster, la commande ou l'attribut Matter de l'endpoint sélectionné.",
+    "input_help_light_hint": "Les endpoints de type lumière acceptent les propriétés d'état directement dans msg (pas dans msg.payload). Seules les commandes prises en charge par la lumière sélectionnée sont affichées.",
     "input_help_advanced_title": "Détails Matter avancés",
     "input_help_advanced_hint": "Seuls les attributs et commandes annoncés sont affichés. Les exemples d'écriture utilisent 0 comme valeur provisoire ; les arguments des commandes peuvent devoir être adaptés au type Matter.",
     "input_help_operation": "Opération",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Cet endpoint ne possède aucune fonction d'entrée simple connue.",
     "input_help_no_structure": "La structure Matter est indisponible. Actualisez la liste des appareils lorsque l'endpoint est en ligne.",
     "input_functions": {
-      "onoff": "Marche / Arrêt", "level": "Niveau", "position": "Position du volet", "tiltposition": "Inclinaison du volet", "open": "Ouvrir", "close": "Fermer", "stop": "Arrêter", "setpoint": "Consigne chauffage", "coolingsetpoint": "Consigne refroidissement", "currenttemp": "Température actuelle", "fanspeed": "Vitesse du ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "Contact", "battery": "Batterie", "activepower": "Puissance active", "importedenergy": "Énergie importée", "identify": "Identifier", "lock": "Verrouiller", "unlock": "Déverrouiller"
+      "onoff": "Marche / Arrêt", "on": "Allumer", "off": "Éteindre", "level": "Niveau", "brightness": "Luminosité", "color_temperature": "Température de couleur", "xy_color": "Couleur XY", "position": "Position du volet", "tiltposition": "Inclinaison du volet", "open": "Ouvrir", "close": "Fermer", "stop": "Arrêter", "setpoint": "Consigne chauffage", "coolingsetpoint": "Consigne refroidissement", "currenttemp": "Température actuelle", "fanspeed": "Vitesse du ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "Contact", "battery": "Batterie", "activepower": "Puissance active", "importedenergy": "Énergie importée", "identify": "Identifier", "lock": "Verrouiller", "unlock": "Déverrouiller"
     },
     "tabs": {
       "switch": "Changer",

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Queste opzioni sono nascoste finché non servono al tipo selezionato. I disposit
 
 ## PIN del nodo
 
-Se abiliti i PIN input/output del nodo:
+Il selettore dei PIN si trova fuori dalle TAB dell'editor. Abilitandolo compare subito sotto una sezione contestuale **Input/output del flow**, con esempi copiabili filtrati per il tipo di dispositivo selezionato:
 
 - **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
 - **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. Un dispositivo senza GA di comando diventa un **dispositivo solo-flow**.

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Mappature KNX",
       "advanced": "Opzioni avanzate"
     },
+    "flow_help": {
+      "title": "Input/output del flow",
+      "intro": "Questi esempi corrispondono al tipo di dispositivo selezionato e sono disponibili quando i PIN input/output del nodo sono abilitati.",
+      "input_title": "Flow → Matter (input del nodo)",
+      "input_hint": "Invia uno di questi messaggi per aggiornare lo stato Matter esposto senza scrivere sul bus KNX.",
+      "output_title": "Matter → Flow (output del nodo)",
+      "output_hint": "I comandi ricevuti da un controller Matter vengono emessi con il valore in msg.payload e i dettagli raw in msg.matter.",
+      "function": "Funzione",
+      "message": "Messaggio di esempio",
+      "copy": "Copia",
+      "copied": "Messaggio copiato",
+      "no_input": "Questo tipo di dispositivo non ha esempi di aggiornamento stato dal flow.",
+      "no_output": "Questo tipo di dispositivo non emette comandi dal controller; il suo output rimane inattivo."
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -19,11 +19,11 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 | Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
 | Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |
 | Update local state from KNX write | Aggiorna la cache locale Matter/KNX quando arriva una scrittura su un GA KNX configurato. |
-| Node Input/Output PINs | Mostra i pin input/output Node-RED. Gli endpoint non luce accettano il formato semplice `{function,value}` descritto sotto e i campi Matter avanzati; l'output emette gli aggiornamenti di stato. La selezione viene mantenuta alla riapertura dell'editor. |
+| Node Input/Output PINs | Mostra i pin input/output Node-RED e la sezione **Input dal flow** subito sotto questo campo. Per le luci sono mostrati i messaggi di stato luce supportati al primo livello; per gli endpoint non luce sono mostrati il formato semplice `{function,value}` e i campi Matter avanzati. La selezione viene mantenuta alla riapertura dell'editor. |
 
 ## Input dal flow
 
-Per un endpoint non luce selezionato, apri la TAB **Input dal flow** nell'editor. La scheda viene costruita dalla struttura annunciata dall'endpoint e mostra esempi copiabili, l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
+Abilita **PIN di Input/Output del nodo** per mostrare la sezione **Input dal flow** subito sotto il selettore. Per le luci contiene esempi copiabili delle proprietà supportate al primo livello, come `msg.on`, `msg.dimming`, `msg.color_temperature` e `msg.color`. Per gli endpoint non luce viene costruita dalla struttura annunciata e mostra l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
 
 Le scritture semplici usano `msg.payload = {function:"position",value:35}`. Ometti `value` per leggere uno stato supportato, ad esempio `{function:"temperature"}`; l'output usa unità comprensibili e include i dettagli raw in `msg.matter`. Le funzioni comprendono `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, letture sensore e `identify`, ma soltanto se annunciate dall'endpoint. La serratura accetta `{function:"lock",value:true|false}`.
 

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "Il nodo conosce già Node ID ed Endpoint ID, quindi non servono nei messaggi semplici.",
     "input_help_simple_title": "Messaggi semplici",
     "input_help_simple_hint": "Queste funzioni usano unità comprensibili e vengono tradotte nel cluster, comando o attributo Matter esposto dall'endpoint selezionato.",
+    "input_help_light_hint": "Gli endpoint luce accettano le proprietà dello stato luce direttamente in msg (non dentro msg.payload). Sono mostrati solo i controlli supportati dalla luce selezionata.",
     "input_help_advanced_title": "Dettagli Matter avanzati",
     "input_help_advanced_hint": "Sono elencati soltanto attributi e comandi annunciati. Gli esempi di scrittura usano 0 come segnaposto; gli argomenti dei comandi possono richiedere un adattamento al tipo Matter.",
     "input_help_operation": "Operazione",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "Questo endpoint non espone funzioni semplici conosciute.",
     "input_help_no_structure": "La struttura Matter non è disponibile. Aggiorna la lista dei dispositivi mentre l'endpoint è online.",
     "input_functions": {
-      "onoff": "On / Off", "level": "Livello", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
+      "onoff": "On / Off", "on": "Accendi", "off": "Spegni", "level": "Livello", "brightness": "Luminosità", "color_temperature": "Temperatura colore", "xy_color": "Colore XY", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
     },
     "tabs": {
       "switch": "On/Off",

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

@@ -45,7 +45,7 @@
 
 ## 节点引脚
 
-如果启用节点的输入/输出引脚：
+引脚选择器位于编辑器选项卡之外。启用后，其下方会显示与所选设备类型匹配的 **Flow 输入/输出** 区域，并提供可复制示例：
 
 - **输入**：从 Flow 更新 Matter 状态，无需经过 KNX 总线：`msg.payload = { function: "onoff", value: true }`（`function` 为 `onoff`、`level`、`rgb`、`colortemp`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint`、`fanspeed`、`smoke`、`co`、`leak`、`co2`、`rvcstate`、`rvcmode` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
 - **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**。

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

@@ -36,6 +36,20 @@
       "mappings": "KNX 映射",
       "advanced": "高级选项"
     },
+    "flow_help": {
+      "title": "Flow 输入/输出",
+      "intro": "这些示例与所选设备类型匹配，并在启用节点输入/输出引脚时显示。",
+      "input_title": "Flow → Matter（节点输入）",
+      "input_hint": "发送以下消息之一，无需写入 KNX 即可更新所公开的 Matter 状态。",
+      "output_title": "Matter → Flow（节点输出）",
+      "output_hint": "Matter 控制器收到的命令会输出，值位于 msg.payload，原始路由详情位于 msg.matter。",
+      "function": "功能",
+      "message": "示例消息",
+      "copy": "复制",
+      "copied": "消息已复制",
+      "no_input": "此设备类型没有 Flow 状态更新示例。",
+      "no_output": "此设备类型不会输出控制器命令；其输出保持静默。"
+    },
     "functions": {
       "fn_onoff_cmd": "开/关 命令 GA",
       "fn_onoff_status": "开/关 状态 GA",

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

@@ -19,11 +19,11 @@
 | 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
 | Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |
 | Update local state from KNX write | 当配置的 KNX GA 收到写入 telegram 时，更新本地 Matter/KNX 缓存。 |
-| Node Input/Output PINs | 显示 Node-RED 输入/输出端口。非灯光端点接受简单的 `{function,value}` 格式和高级 Matter 字段；输出发送状态更新。 |
+| Node Input/Output PINs | 显示 Node-RED 输入/输出端口，并在该字段下方显示 **流程输入** 区域。灯光会显示其支持的顶层灯光状态消息；其他端点会显示简单的 `{function,value}` 格式和高级 Matter 字段。 |
 
 ## 流程输入
 
-选择非灯光端点后，打开 **流程输入** 选项卡。该选项卡根据端点公布的结构生成，并显示可复制示例、Endpoint ID、所有可读/可写属性以及接受的命令。节点仅用于 flow 且未选择 KNX 网关时，该选项卡仍然可用。
+启用 **Node Input/Output PINs** 后，**流程输入** 区域会直接显示在选择器下方。对于灯光，它提供所支持顶层属性的可复制示例，例如 `msg.on`、`msg.dimming`、`msg.color_temperature` 和 `msg.color`。对于其他端点，该区域根据公布的结构生成，并显示 Endpoint ID、所有可读/可写属性以及接受的命令。未选择 KNX 网关时仍然可用。
 
 简单写入使用 `msg.payload = {function:"position",value:35}`。省略 `value` 即可读取支持的状态，例如 `{function:"temperature"}`；输出使用易懂单位，并在 `msg.matter` 中保留原始详情。`onoff`、`level`、`position`、`open`、`close`、`stop`、设定点、风扇和传感器功能仅在端点公布支持时出现。门锁接受 `{function:"lock",value:true|false}`。
 

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

@@ -17,6 +17,7 @@
     "input_help_endpoint_hint": "节点已知 Node ID 和 Endpoint ID，因此简单消息无需提供它们。",
     "input_help_simple_title": "简单消息",
     "input_help_simple_hint": "这些功能使用易懂的单位，并自动转换为所选端点公开的 Matter 集群、命令或属性。",
+    "input_help_light_hint": "灯光端点直接在 msg 上接收灯光状态属性（而不是放在 msg.payload 中）。这里只显示所选灯具支持的控制项。",
     "input_help_advanced_title": "高级 Matter 详情",
     "input_help_advanced_hint": "仅列出设备公布的属性和命令。写入示例中的 0 是占位值；命令参数可能需要按 Matter 数据类型调整。",
     "input_help_operation": "操作",
@@ -31,7 +32,7 @@
     "input_help_no_simple": "此端点没有已知的简单输入功能。",
     "input_help_no_structure": "Matter 结构不可用。请在端点在线时刷新设备列表。",
     "input_functions": {
-      "onoff": "开 / 关", "level": "亮度", "position": "窗帘位置", "tiltposition": "百叶角度", "open": "打开", "close": "关闭", "stop": "停止", "setpoint": "制热设定点", "coolingsetpoint": "制冷设定点", "currenttemp": "当前温度", "fanspeed": "风扇速度", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "触点", "battery": "电池", "activepower": "有功功率", "importedenergy": "输入电能", "identify": "识别", "lock": "上锁", "unlock": "解锁"
+      "onoff": "开 / 关", "on": "打开", "off": "关闭", "level": "亮度", "brightness": "亮度", "color_temperature": "色温", "xy_color": "XY 颜色", "position": "窗帘位置", "tiltposition": "百叶角度", "open": "打开", "close": "关闭", "stop": "停止", "setpoint": "制热设定点", "coolingsetpoint": "制冷设定点", "currenttemp": "当前温度", "fanspeed": "风扇速度", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "触点", "battery": "电池", "activepower": "有功功率", "importedenergy": "输入电能", "identify": "识别", "lock": "上锁", "unlock": "解锁"
     },
     "tabs": {
       "switch": "开关",

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.1.0",
+  "version": "6.1.1",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",