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

package/CHANGELOG.md

@@ -6,14 +6,24 @@
 
 # CHANGELOG
 
-**Version 6.0.12** - July 2026<br/>
+**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/>
+- **Matter Controller — commissioned-device status**: fixed the connection-state import for the installed matter.js API, so the associated-devices table now reports `connected`, `disconnected`, `reconnecting` or `waitingfordiscovery` instead of misleading values such as `unknown (0)`. The table has also been regression-tested to preserve every row returned by the controller without collapsing equal Node IDs.<br/>
+- **Matter Controller — per-device command isolation**: commands now remain ordered inside an independent execution lane for each commissioned Node ID instead of sharing one blocking serial queue. An offline, timing-out or removed device can no longer delay other Matter Controller nodes that react to the same KNX group address. Removed Node IDs are rejected before queueing, every Matter operation has a bounded timeout and pending commands are purged on removal. An unavailable Controller node latches its red status and ignores subsequent KNX/flow commands instead of accepting them optimistically; it resumes automatically when that specific Matter device reports `connected`, while opening the node editor explicitly enables a manual retry.<br/>
 - **Control Matter from KNX — Universal Mode**: a dedicated **Mode** selector now switches between a single Matter device and controller-wide Universal Mode. Its **Universal Battery Monitor** scans every commissioned node and endpoint for battery Power Source clusters, maintains a normalized cache, publishes an optional aggregate KNX alarm as DPT 1.005, cycles low-battery device names every 2 seconds as DPT 16.001, and answers `getAllBatteries` flow queries. The alternative **All Matter events** service preserves the generic attribute/event stream and dynamic read/write/command input.<br/>
 - **Universal Battery Monitor — KNX editor and diagnostics**: battery options now use the same vertical-tab and ETS/CSV group-address selectors as single-device profiles. Alarm and text mappings are aligned as Function/GA/DPT/Name rows, support editable names and KNX read responses, ignore wired Power Source endpoints, and show an aggregate battery status instead of per-device `unknown` states.<br/>
 - **Matter light capability refresh**: Color Control `featureMap` and the endpoint device type now drive the Tunable White and RGB/HSV tabs. New selections, changed devices and previously saved nodes normalize stale capabilities so Tunable White lights no longer retain unsupported colour mappings.<br/>
 - **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 — 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 enforcing their native input/event cluster boundary and 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 — 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/>
 
 **Version 6.0.10** - July 2026<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)