node-red-contrib-velbus-2026 0.8.1

package/nodes/velbus-blind-20/velbus-blind-20.html

@@ -0,0 +1,179 @@
+<script type="text/javascript">
+(function() {
+
+  const BLIND_TYPES_20 = {
+    0x61: { name: 'VMB2BLE-20', channels: 2 },
+  };
+
+  RED.nodes.registerType('velbus-blind-20', {
+    category:  'Velbus (outputs)',
+    color:     '#4A90D9',
+    defaults: {
+      name:       { value: '' },
+      bridge:     { value: '', type: 'velbus-bridge', required: true },
+      address:    { value: '', required: true, validate: function(v) { return /^(0x)?[0-9a-fA-F]{1,2}$/.test(v); } },
+      channel:    { value: 1, required: true },
+      moduleName: { value: '' },
+      typeId:     { value: '' },
+    },
+    inputs:  1,
+    outputs: 1,
+    outputLabels: ['blind status'],
+    icon:    'font-awesome/fa-arrows-v',
+    paletteLabel: 'blind-20',
+
+    label: function() {
+      const t = this.typeId ? BLIND_TYPES_20[parseInt(this.typeId, 16)] : null;
+      const n = this.name || this.moduleName || (t ? t.name : 'blind-20');
+      return n + ' ch' + this.channel + ' 0x' +
+        (parseInt(this.address) || 0).toString(16).padStart(2,'0').toUpperCase();
+    },
+
+    oneditprepare: function() {
+      const savedAddr = this.address;
+      const savedCh   = this.channel;
+      $('#node-input-typeId').prop('readonly', true).css('background', '#f0f0f0');
+
+      function populateDropdown(bridgeId) {
+        if (!bridgeId) return;
+        $.getJSON('velbus/scan-results?bridge=' + bridgeId, function(results) {
+          const modules = (results && results.modules) ? results.modules : [];
+          const $addr = $('#node-input-address');
+          $addr.empty().append($('<option>').val('').text('— select address —'));
+
+          const typeIds = Object.keys(BLIND_TYPES_20).map(k => parseInt(k));
+          const filtered = modules.filter(m => typeIds.includes(parseInt(m.typeId, 16)));
+
+          if (!filtered.length) {
+            $addr.append($('<option>').val('').text('No VMB2BLE-20 modules found on bus'));
+            return;
+          }
+          filtered.forEach(function(m) {
+            const tid   = parseInt(m.typeId, 16);
+            const label = m.address + ' — ' + m.module;
+            const $opt  = $('<option>').val(m.addressDec).text(label).data('typeid', tid);
+            if (m.addressDec === parseInt(savedAddr)) $opt.attr('selected', true);
+            $addr.append($opt);
+          });
+        });
+      }
+
+      function updateChannelSelect(typeId) {
+        const t = BLIND_TYPES_20[typeId];
+        const $ch = $('#node-input-channel');
+        $ch.empty();
+        if (t) {
+          for (let i = 1; i <= t.channels; i++) {
+            $ch.append($('<option>').val(i).text('Channel ' + i));
+          }
+          $ch.val(savedCh || 1);
+          $('#node-input-typeId').val('0x' + typeId.toString(16).padStart(2,'0').toUpperCase());
+          $('#blind20-type-hint').text(t.name + ' · V2 · 2ch · position + CAN FD').show();
+        }
+      }
+
+      $('#node-input-bridge').on('change', function() { populateDropdown($(this).val()); });
+      $('#node-input-address').on('change', function() {
+        const tid = $(this).find(':selected').data('typeid');
+        if (tid) updateChannelSelect(tid);
+      });
+      // Deferred load — TypedInput sets value async after oneditprepare
+
+      $('#node-input-bridge').trigger('change');
+
+      setTimeout(function() { $('#node-input-bridge').trigger('change'); }, 150);
+    },
+
+    oneditsave: function() {
+      this.address = parseInt($('#node-input-address').val()) || 0;
+      this.channel = parseInt($('#node-input-channel').val()) || 1;
+      const tid = $('#node-input-typeId').val();
+      this.typeId = tid || '';
+      if (tid) {
+        const t = BLIND_TYPES_20[parseInt(tid, 16)];
+        if (t) this.moduleName = t.name;
+      }
+    },
+  });
+
+})();
+</script>
+
+<script type="text/html" data-template-name="velbus-blind-20">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Optional label">
+  </div>
+  <div class="form-row">
+    <label for="node-input-bridge"><i class="fa fa-plug"></i> Bridge</label>
+    <input type="text" id="node-input-bridge">
+  </div>
+  <div class="form-row">
+    <label for="node-input-address"><i class="fa fa-map-marker"></i> Address</label>
+    <select id="node-input-address" style="width:70%">
+      <option value="">— select bridge first —</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-channel"><i class="fa fa-arrows-v"></i> Channel</label>
+    <select id="node-input-channel" style="width:70%">
+      <option value="1">Channel 1</option>
+      <option value="2">Channel 2</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label></label>
+    <span id="blind20-type-hint" style="color:#888; font-size:0.9em; display:none;"></span>
+  </div>
+  <div class="form-row" style="display:none">
+    <input type="text" id="node-input-typeId">
+    <input type="text" id="node-input-moduleName">
+  </div>
+</script>
+
+<script type="text/html" data-help-name="velbus-blind-20">
+    <p style="background:#fff3cd; border-left:4px solid #ffc107; padding:8px 12px; margin-bottom:12px; font-size:0.85em;">
+    <strong>&#9888; Testing status:</strong> This node was generated with Claude.ai and is in
+    need of extensive field testing before being deployed into a commercial project.
+    It is presented "as is" &mdash; any use beyond testing is entirely at your own risk and liability.
+    Constructive feedback is welcomed, accompanied by as many examples and debug captures as possible.
+    <a href="https://github.com/MDAR/node-red-contrib-velbus-2026/issues" target="_blank">File an issue on GitHub</a>.
+    </p>
+  <p>V2 blind/shutter motor controller — VMB2BLE-20 (0x61).</p>
+  <p>Full V2 redesign with CAN FD support, firmware check on startup, and name
+  auto-retrieval. Status packet covers both channels simultaneously.
+  For older BLE/BLS modules use <strong>velbus-blind-s</strong>.</p>
+
+  <h3>Output — Blind status (0xEC)</h3>
+  <pre>{ "type": "blind_status", "channel": 1, "on": true,
+  "status": "up", "position": 25, "lockState": "normal",
+  "autoMode": 0, "progDisabled": false,
+  "program": "none", "alarms": { "alarm1Active": false, "alarm2Active": false } }</pre>
+  <p>position: 0=fully up, 100=fully down.</p>
+  <p>lockState: normal, inhibited, inhibit_preset_down, inhibit_preset_up,
+  forced_down, forced_up, locked.</p>
+  <p>Note: 0xFFFFFF (permanent) is NOT allowed for up/down timeout on this module.</p>
+
+  <h3>Input commands</h3>
+  <dl>
+    <dt><code>{ "cmd": "stop" }</code></dt><dd>Stop movement.</dd>
+    <dt><code>{ "cmd": "up", "timeout": 0 }</code></dt><dd>Move up. 0=default timeout. Max 0xFFFFFE.</dd>
+    <dt><code>{ "cmd": "down", "timeout": 0 }</code></dt><dd>Move down.</dd>
+    <dt><code>{ "cmd": "position", "position": 50 }</code></dt><dd>Set position 0-100%.</dd>
+    <dt><code>{ "cmd": "lock", "duration": 3600 }</code></dt><dd>Lock. 0xFFFFFF=permanent.</dd>
+    <dt><code>{ "cmd": "unlock" }</code></dt><dd>Unlock.</dd>
+    <dt><code>{ "cmd": "forced_up", "duration": 3600 }</code></dt><dd>Force up.</dd>
+    <dt><code>{ "cmd": "cancel_forced_up" }</code></dt><dd>Cancel forced up.</dd>
+    <dt><code>{ "cmd": "forced_down", "duration": 3600 }</code></dt><dd>Force down.</dd>
+    <dt><code>{ "cmd": "cancel_forced_down" }</code></dt><dd>Cancel forced down.</dd>
+    <dt><code>{ "cmd": "inhibit", "duration": 3600 }</code></dt><dd>Inhibit all movement.</dd>
+    <dt><code>{ "cmd": "cancel_inhibit" }</code></dt><dd>Cancel inhibit.</dd>
+    <dt><code>{ "cmd": "inhibit_preset_up", "duration": 3600 }</code></dt><dd>Inhibit with preset up.</dd>
+    <dt><code>{ "cmd": "inhibit_preset_down", "duration": 3600 }</code></dt><dd>Inhibit with preset down.</dd>
+    <dt><code>{ "cmd": "auto_mode", "mode": 1 }</code></dt><dd>Select auto mode (0=disabled, 1-3).</dd>
+    <dt><code>{ "cmd": "enable_program" }</code></dt><dd>Enable channel program.</dd>
+    <dt><code>{ "cmd": "disable_program", "duration": 3600 }</code></dt><dd>Disable channel program.</dd>
+    <dt><code>{ "cmd": "get_status" }</code></dt><dd>Request module status.</dd>
+    <dt><code>{ "cmd": "get_name" }</code></dt><dd>Request channel name from VelbusLink.</dd>
+  </dl>
+</script>

package/nodes/velbus-blind-20/velbus-blind-20.js

@@ -0,0 +1,300 @@
+'use strict';
+
+const { pkt, rtrPkt, parsePkt } = require('../../lib/velbus-utils');
+const { BLIND_TYPES_20, BLIND_TYPE_IDS_20 } = require('../../lib/blind-types-20');
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+const BLIND_STATUS = { 0: 'off', 1: 'up', 2: 'down' };
+
+const LOCK_STATUS = {
+  0: 'normal', 1: 'inhibited', 2: 'inhibit_preset_down',
+  3: 'inhibit_preset_up', 4: 'forced_down', 5: 'forced_up', 6: 'locked',
+};
+
+function make24(duration) {
+  return [(duration >> 16) & 0xFF, (duration >> 8) & 0xFF, duration & 0xFF];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Node
+// ─────────────────────────────────────────────────────────────────────────────
+
+module.exports = function(RED) {
+
+  function VelbusBlind20Node(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    node.bridge     = RED.nodes.getNode(config.bridge);
+    node.address    = typeof config.address === 'number'
+      ? config.address  // legacy saves stored decimal numbers
+      : (parseInt(config.address, 16) || 0);  // editor stores hex strings
+    node.moduleName = config.moduleName || '';
+    node.typeId     = config.typeId ? parseInt(config.typeId) : null;
+    node.channel    = parseInt(config.channel) || 1;
+
+    if (!node.bridge) {
+      node.status({ fill: 'red', shape: 'ring', text: 'no bridge' });
+      node.error('velbus-blind-20: no bridge configured');
+      return;
+    }
+    if (!node.address || node.address < 1 || node.address > 254) {
+      node.status({ fill: 'red', shape: 'ring', text: 'invalid address' });
+      node.error('velbus-blind-20: invalid address ' + node.address);
+      return;
+    }
+
+    const _addrHex = '0x' + node.address.toString(16).padStart(2, '0').toUpperCase();
+
+    // Name retrieval
+    let _nameParts = {};
+    let _nameTimer = null;
+
+    function assembleName() {
+      if (_nameTimer) { clearTimeout(_nameTimer); _nameTimer = null; }
+      const bytes = [
+        ...(_nameParts[0] || []),
+        ...(_nameParts[1] || []),
+        ...(_nameParts[2] || []),
+      ].filter(b => b !== 0 && b !== 0xFF);
+      const name = String.fromCharCode(...bytes).trim();
+      if (name) node.moduleName = name;
+    }
+
+    function setStatus(text, fill, shape) {
+      const label = node.moduleName
+        ? node.moduleName + ' ch' + node.channel + ' (' + _addrHex + ')'
+        : _addrHex + ' ch' + node.channel;
+      node.status({ fill: fill || 'green', shape: shape || 'dot', text: label + ' ' + text });
+    }
+
+    // ── Firmware check ────────────────────────────────────────────────────
+
+    function handleModuleType(body) {
+      if (body.length < 8) return;
+      const typeId = body[1];
+      const build  = body[5] * 100 + body[6];
+      const canFD  = !!(body[7] & 0x20);
+
+      const desc = BLIND_TYPES_20[typeId];
+      if (!desc) {
+        node.status({ fill: 'red', shape: 'ring',
+          text: 'unknown type 0x' + typeId.toString(16) });
+        return;
+      }
+      node.moduleName = node.moduleName || desc.name;
+      setStatus('build ' + build + (canFD ? ' CAN FD' : ''), 'grey', 'dot');
+
+      // Request name for this channel
+      setTimeout(() => {
+        node.bridge.send(pkt(0xF8, node.address, [0xEF, node.channel]));
+        _nameTimer = setTimeout(assembleName, 2000);
+      }, 100);
+    }
+
+    // ── Packet handler ────────────────────────────────────────────────────
+
+    function onPacket(raw) {
+      const p = parsePkt(raw);
+      if (!p || p.rtr) return;
+      if (p.addr !== node.address) return;
+
+      const { cmd, body } = p;
+
+      switch (cmd) {
+
+        // ── 0xFF  Module type ─────────────────────────────────────────────
+        case 0xFF: {
+          handleModuleType(body);
+          break;
+        }
+
+        // ── 0xEC  Module status — both channels in one packet ─────────────
+        case 0xEC: {
+          if (body.length < 8) return;
+          // body[0]=0xEC
+          // body[1]=DB2: bits0-3=ch1 status, bits4-7=ch2 status
+          // body[2]=DB3: ch1 position (0-100%)
+          // body[3]=DB4: ch2 position (0-100%)
+          // body[4]=DB5: lock state bits0-3=ch1, bits4-7=ch2
+          // body[5]=DB6: auto mode bits0-3=ch1, bits4-7=ch2
+          // body[6]=DB7: program disabled bit0=ch1, bit4=ch2
+          // body[7]=DB8: alarm & program selection (global)
+
+          const ch = node.channel;
+          const statusNibble = ch === 1 ? (body[1] & 0x0F) : ((body[1] >> 4) & 0x0F);
+          const position     = ch === 1 ? body[2] : body[3];
+          const lockNibble   = ch === 1 ? (body[4] & 0x0F) : ((body[4] >> 4) & 0x0F);
+          const autoMode     = ch === 1 ? (body[5] & 0x0F) : ((body[5] >> 4) & 0x0F);
+          const progDisabled = ch === 1 ? !!(body[6] & 0x01) : !!(body[6] & 0x10);
+
+          const blindStatus = BLIND_STATUS[statusNibble] || 'unknown';
+          const lockState   = LOCK_STATUS[lockNibble] || 'unknown';
+
+          const alarmByte = body[7];
+          const program        = ['none','summer','winter','holiday'][alarmByte & 0x03];
+          const alarm1Active   = !!(alarmByte & 0x04);
+          const alarm2Active   = !!(alarmByte & 0x10);
+          const sunriseEnabled = !!(alarmByte & 0x40);
+          const sunsetEnabled  = !!(alarmByte & 0x80);
+
+          const on = blindStatus !== 'off';
+          setStatus(blindStatus + ' ' + position + '%');
+
+          const payload = {
+            type:         'blind_status',
+            channel:      ch,
+            on,
+            status:       blindStatus,
+            position,
+            lockState,
+            autoMode,
+            progDisabled,
+            program,
+            alarms: { alarm1Active, alarm2Active },
+            sunrise: sunriseEnabled,
+            sunset:  sunsetEnabled,
+          };
+          node.send([{ payload }]);
+          break;
+        }
+
+        // ── 0xF0/F1/F2  Channel name parts ───────────────────────────────
+        case 0xF0:
+        case 0xF1:
+        case 0xF2: {
+          // body[0]=cmd, body[1]=channel number (1 or 2), body[2..]=chars
+          if (body[1] !== node.channel) return;
+          const part = cmd - 0xF0;
+          _nameParts[part] = Array.from(body).slice(2);
+          if (part === 2) assembleName();
+          break;
+        }
+
+        default:
+          break;
+      }
+    }
+
+    node.bridge.register(node.address, onPacket);
+
+    // Startup RTR
+    setTimeout(function() {
+      node.bridge.send(rtrPkt(node.address), true);
+    }, 500);
+
+    // ── Input commands ────────────────────────────────────────────────────
+
+    node.on('input', function(msg) {
+      const cmd = msg.payload && msg.payload.cmd;
+      if (!cmd) return;
+
+      const ch = node.channel; // 1, 2, or caller can override via msg.payload.channel
+
+      if (cmd === 'get_status') {
+        node.bridge.send(pkt(0xFB, node.address, [0xFA, 0x00]));
+        return;
+      }
+      if (cmd === 'stop') {
+        node.bridge.send(pkt(0xF8, node.address, [0x04, ch]));
+        return;
+      }
+      if (cmd === 'up') {
+        // Note: 0xFFFFFF NOT allowed for timeout on VMB2BLE-20
+        const timeout = Math.min(parseInt(msg.payload.timeout) || 0, 0xFFFFFE);
+        node.bridge.send(pkt(0xF8, node.address, [0x05, ch, ...make24(timeout)]));
+        return;
+      }
+      if (cmd === 'down') {
+        const timeout = Math.min(parseInt(msg.payload.timeout) || 0, 0xFFFFFE);
+        node.bridge.send(pkt(0xF8, node.address, [0x06, ch, ...make24(timeout)]));
+        return;
+      }
+      if (cmd === 'position') {
+        const pos = Math.max(0, Math.min(100, parseInt(msg.payload.position) || 0));
+        node.bridge.send(pkt(0xF8, node.address, [0x1C, ch, pos]));
+        return;
+      }
+      if (cmd === 'lock') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x1A, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'unlock') {
+        node.bridge.send(pkt(0xF8, node.address, [0x1B, ch]));
+        return;
+      }
+      if (cmd === 'forced_up') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x12, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'cancel_forced_up') {
+        node.bridge.send(pkt(0xF8, node.address, [0x13, ch]));
+        return;
+      }
+      if (cmd === 'forced_down') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x14, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'cancel_forced_down') {
+        node.bridge.send(pkt(0xF8, node.address, [0x15, ch]));
+        return;
+      }
+      if (cmd === 'inhibit') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x16, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'cancel_inhibit') {
+        node.bridge.send(pkt(0xF8, node.address, [0x17, ch]));
+        return;
+      }
+      if (cmd === 'inhibit_preset_up') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x18, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'inhibit_preset_down') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0x19, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'auto_mode') {
+        const mode = parseInt(msg.payload.mode) || 0;
+        node.bridge.send(pkt(0xF8, node.address, [0xB3, ch, mode]));
+        return;
+      }
+      if (cmd === 'enable_program') {
+        node.bridge.send(pkt(0xF8, node.address, [0xB2, ch]));
+        return;
+      }
+      if (cmd === 'disable_program') {
+        const duration = parseInt(msg.payload.duration) || 0xFFFFFF;
+        node.bridge.send(pkt(0xF8, node.address, [0xB1, ch, ...make24(duration)]));
+        return;
+      }
+      if (cmd === 'get_name') {
+        node.bridge.send(pkt(0xF8, node.address, [0xEF, ch]));
+        return;
+      }
+
+      node.warn('velbus-blind-20: unknown cmd: ' + cmd);
+    });
+
+    // ── Cleanup ───────────────────────────────────────────────────────────
+
+    node.on('close', function() {
+      if (_nameTimer) { clearTimeout(_nameTimer); _nameTimer = null; }
+      node.bridge.deregister(node.address, onPacket);
+    });
+
+    setStatus('ready', 'grey', 'dot');
+  }
+
+  RED.nodes.registerType('velbus-blind-20', VelbusBlind20Node);
+};

package/nodes/velbus-blind-s/velbus-blind-s.html

@@ -0,0 +1,181 @@
+<script type="text/javascript">
+(function() {
+
+  const BLIND_TYPES_S = {
+    0x2E: { name: 'VMB1BLS', channels: 1 },
+    0x1D: { name: 'VMB2BLE', channels: 2 },
+    0x4A: { name: 'VMB2BLE-10', channels: 2 },
+  };
+
+  RED.nodes.registerType('velbus-blind-s', {
+    category:  'Velbus (outputs)',
+    color:     '#4A90D9',
+    defaults: {
+      name:       { value: '' },
+      bridge:     { value: '', type: 'velbus-bridge', required: true },
+      address:    { value: '', required: true, validate: function(v) { return /^(0x)?[0-9a-fA-F]{1,2}$/.test(v); } },
+      channel:    { value: 1, required: true },
+      moduleName: { value: '' },
+      typeId:     { value: '' },
+    },
+    inputs:  1,
+    outputs: 2,
+    outputLabels: ['relay events', 'blind status'],
+    icon:    'font-awesome/fa-arrows-v',
+    paletteLabel: 'blind-s',
+
+    label: function() {
+      const t = this.typeId ? BLIND_TYPES_S[parseInt(this.typeId, 16)] : null;
+      const n = this.name || this.moduleName || (t ? t.name : 'blind-s');
+      return n + ' ch' + this.channel + ' 0x' +
+        (parseInt(this.address) || 0).toString(16).padStart(2,'0').toUpperCase();
+    },
+
+    oneditprepare: function() {
+      const savedAddr = this.address;
+      const savedCh   = this.channel;
+      $('#node-input-typeId').prop('readonly', true).css('background', '#f0f0f0');
+
+      function populateDropdown(bridgeId) {
+        if (!bridgeId) return;
+        $.getJSON('velbus/scan-results?bridge=' + bridgeId, function(results) {
+          const modules = (results && results.modules) ? results.modules : [];
+          const $addr = $('#node-input-address');
+          $addr.empty().append($('<option>').val('').text('— select address —'));
+
+          const typeIds = Object.keys(BLIND_TYPES_S).map(k => parseInt(k));
+          const filtered = modules.filter(m => typeIds.includes(parseInt(m.typeId, 16)));
+
+          if (!filtered.length) {
+            $addr.append($('<option>').val('').text('No BLS/BLE blind modules found on bus'));
+            return;
+          }
+          filtered.forEach(function(m) {
+            const tid   = parseInt(m.typeId, 16);
+            const label = m.address + ' — ' + m.module;
+            const $opt  = $('<option>').val(m.addressDec).text(label).data('typeid', tid);
+            if (m.addressDec === parseInt(savedAddr)) $opt.attr('selected', true);
+            $addr.append($opt);
+          });
+        });
+      }
+
+      function updateChannelSelect(typeId) {
+        const t = BLIND_TYPES_S[typeId];
+        const $ch = $('#node-input-channel');
+        $ch.empty();
+        if (t) {
+          for (let i = 1; i <= t.channels; i++) {
+            $ch.append($('<option>').val(i).text('Channel ' + i));
+          }
+          $ch.val(savedCh || 1);
+          $('#node-input-typeId').val('0x' + typeId.toString(16).padStart(2,'0').toUpperCase());
+          $('#blinds-type-hint').text(t.name + ' · ' + t.channels + 'ch · position + lock/inhibit').show();
+        }
+      }
+
+      $('#node-input-bridge').on('change', function() { populateDropdown($(this).val()); });
+      $('#node-input-address').on('change', function() {
+        const tid = $(this).find(':selected').data('typeid');
+        if (tid) updateChannelSelect(tid);
+      });
+      // Deferred load — TypedInput sets value async after oneditprepare
+
+      $('#node-input-bridge').trigger('change');
+
+      setTimeout(function() { $('#node-input-bridge').trigger('change'); }, 150);
+    },
+
+    oneditsave: function() {
+      this.address = parseInt($('#node-input-address').val()) || 0;
+      this.channel = parseInt($('#node-input-channel').val()) || 1;
+      const tid = $('#node-input-typeId').val();
+      this.typeId = tid || '';
+      if (tid) {
+        const t = BLIND_TYPES_S[parseInt(tid, 16)];
+        if (t) this.moduleName = t.name;
+      }
+    },
+  });
+
+})();
+</script>
+
+<script type="text/html" data-template-name="velbus-blind-s">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" placeholder="Optional label">
+  </div>
+  <div class="form-row">
+    <label for="node-input-bridge"><i class="fa fa-plug"></i> Bridge</label>
+    <input type="text" id="node-input-bridge">
+  </div>
+  <div class="form-row">
+    <label for="node-input-address"><i class="fa fa-map-marker"></i> Address</label>
+    <select id="node-input-address" style="width:70%">
+      <option value="">— select bridge first —</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-channel"><i class="fa fa-arrows-v"></i> Channel</label>
+    <select id="node-input-channel" style="width:70%">
+      <option value="1">Channel 1</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label></label>
+    <span id="blinds-type-hint" style="color:#888; font-size:0.9em; display:none;"></span>
+  </div>
+  <div class="form-row" style="display:none">
+    <input type="text" id="node-input-typeId">
+    <input type="text" id="node-input-moduleName">
+  </div>
+</script>
+
+<script type="text/html" data-help-name="velbus-blind-s">
+    <p style="background:#fff3cd; border-left:4px solid #ffc107; padding:8px 12px; margin-bottom:12px; font-size:0.85em;">
+    <strong>&#9888; Testing status:</strong> This node was generated with Claude.ai and is in
+    need of extensive field testing before being deployed into a commercial project.
+    It is presented "as is" &mdash; any use beyond testing is entirely at your own risk and liability.
+    Constructive feedback is welcomed, accompanied by as many examples and debug captures as possible.
+    <a href="https://github.com/MDAR/node-red-contrib-velbus-2026/issues" target="_blank">File an issue on GitHub</a>.
+    </p>
+  <p>Full-featured blind/shutter motor controller — VMB1BLS (0x2E), VMB2BLE (0x1D).</p>
+  <p>Supports position (0-100%), lock, forced up/down, inhibit variants, auto modes,
+  sunrise/sunset. For older VMB1BL/VMB2BL use <strong>velbus-blind</strong>.</p>
+
+  <h3>Output 1 — Relay events (0x00)</h3>
+  <pre>{ "type": "blind_event", "channel": 1,
+  "upOn": true, "upOff": false, "downOn": false, "downOff": false,
+  "moving": "up" }</pre>
+
+  <h3>Output 2 — Blind status (0xEC)</h3>
+  <pre>{ "type": "blind_status", "channel": 1, "on": true,
+  "status": "up", "position": 25, "lockState": "normal",
+  "autoMode": 0, "alarms": { "alarm1Active": false, "alarm2Active": false },
+  "led": { "upOn": true, "downOn": false, ... } }</pre>
+  <p>position: 0=fully up, 100=fully down.</p>
+  <p>lockState: normal, inhibited, inhibit_preset_down, inhibit_preset_up,
+  forced_down, forced_up, locked.</p>
+
+  <h3>Input commands</h3>
+  <dl>
+    <dt><code>{ "cmd": "stop" }</code></dt><dd>Stop movement.</dd>
+    <dt><code>{ "cmd": "up", "timeout": 0 }</code></dt><dd>Move up. 0=default, 0xFFFFFF=permanent.</dd>
+    <dt><code>{ "cmd": "down", "timeout": 0 }</code></dt><dd>Move down.</dd>
+    <dt><code>{ "cmd": "position", "position": 50 }</code></dt><dd>Set position 0-100%.</dd>
+    <dt><code>{ "cmd": "lock", "duration": 3600 }</code></dt><dd>Lock channel. 0xFFFFFF=permanent.</dd>
+    <dt><code>{ "cmd": "unlock" }</code></dt><dd>Unlock channel.</dd>
+    <dt><code>{ "cmd": "forced_up", "duration": 3600 }</code></dt><dd>Force up.</dd>
+    <dt><code>{ "cmd": "cancel_forced_up" }</code></dt><dd>Cancel forced up.</dd>
+    <dt><code>{ "cmd": "forced_down", "duration": 3600 }</code></dt><dd>Force down.</dd>
+    <dt><code>{ "cmd": "cancel_forced_down" }</code></dt><dd>Cancel forced down.</dd>
+    <dt><code>{ "cmd": "inhibit", "duration": 3600 }</code></dt><dd>Inhibit all movement.</dd>
+    <dt><code>{ "cmd": "cancel_inhibit" }</code></dt><dd>Cancel inhibit.</dd>
+    <dt><code>{ "cmd": "inhibit_preset_up", "duration": 3600 }</code></dt><dd>Inhibit with preset up position.</dd>
+    <dt><code>{ "cmd": "inhibit_preset_down", "duration": 3600 }</code></dt><dd>Inhibit with preset down position.</dd>
+    <dt><code>{ "cmd": "auto_mode", "mode": 1 }</code></dt><dd>Select auto mode (0=disabled, 1-3).</dd>
+    <dt><code>{ "cmd": "get_status" }</code></dt><dd>Request blind status.</dd>
+    <dt><code>{ "cmd": "get_name" }</code></dt><dd>Request blind name from VelbusLink.</dd>
+  </dl>
+</script>