node-red-contrib-velbus-2026 0.8.1

package/lib/dimmer-types-20.js

@@ -0,0 +1,120 @@
+'use strict';
+
+/**
+ * dimmer-types-20.js
+ * Registry of V2 (-20 series) Velbus dimmer/output module types.
+ * Original series modules are in dimmer-types.js.
+ *
+ * ALL THREE MODULES SHARE IDENTICAL PACKET STRUCTURE.
+ * The only behavioural difference is the dim curve:
+ *   linear      — VMB2DC-20, VMB8DC-20 (0-10V DC output)
+ *   exponential — VMB4LEDPWM-20 (PWM LED output, perceptual curve)
+ *
+ * WHAT THESE MODULES OUTPUT:
+ *   VMB2DC-20 / VMB8DC-20:  0-10V DC control voltage per channel.
+ *     No mains load. Drives dimmer packs (Finder, Mode Lighting etc.),
+ *     linear actuators, variable valves, any 0-10V compatible input.
+ *   VMB4LEDPWM-20: Direct PWM per channel for LED strips/drivers.
+ *
+ * VMB4LEDPWM-20 OUTPUT GROUPING MODES:
+ *   The four PWM channels can be grouped in three ways. This is a
+ *   hardware/memory configuration decision made at commissioning time.
+ *   The mode must match the physical wiring.
+ *
+ *   'single'  — 4 independent single-colour channels (default)
+ *               CH1, CH2, CH3, CH4 each drive separate LED circuits.
+ *               Use cmd: 'set' per channel.
+ *
+ *   'rgb'     — CH1=Red, CH2=Green, CH3=Blue form one RGB group.
+ *               CH4 remains independent.
+ *               Use cmd: 'rgbw' for the group (W byte ignored).
+ *               Use cmd: 'set' for CH4.
+ *
+ *   'rgbw'    — All four channels form one RGBW group.
+ *               CH1=Red, CH2=Green, CH3=Blue, CH4=White.
+ *               Use cmd: 'rgbw' for all colour control.
+ *
+ *   RESOLVED (protocol PDF ed.2, 01/07/2025): there is no single "mode byte".
+ *   The mode is the emergent result of each channel's per-channel "Device Type"
+ *   setting (settings index 25). Channel 1 = 0x08 (RGBW control) means the
+ *   module is in 'rgbw' mode; channel 1 = 0xF0 (RGB control) means 'rgb' mode;
+ *   any single-lamp type (typically 0x06, LED module) on every channel means
+ *   'single' mode. See DEVICE_TYPE_NAMES below for the full value table.
+ *
+ *   Read via the settings API: 0xE7 [channel, 0x00, 25] request →
+ *   0xE8 [channel, 25, device_type] reply. This node's 'get_device_type'
+ *   input command performs this read and reports the detected mode on
+ *   output 1, warning on output 2 if it disagrees with the configured
+ *   ledMode. Direct memory addresses also exist (0x066C/0x06D0/0x0734/0x0798,
+ *   0x64-byte stride per channel) but are for VLP-level analysis only —
+ *   this node always uses the settings API, never a raw memory write.
+ *
+ *   This node exposes the mode as a config property so the correct command
+ *   set can be applied and documented. It does NOT write the mode to the
+ *   module — that remains a deliberate commissioning-time decision, made by
+ *   the installer or the VelbusAI commissioning agent, never automatically.
+ *
+ *   CRITICAL: Sending individual channel dim commands to a module
+ *   configured as 'rgb' or 'rgbw' bypasses colour coordination.
+ *   The result will look wrong. Always confirm mode before commissioning.
+ *
+ * KEY PROTOCOL NOTES:
+ *   Status packet:  0xEE (NOT 0xFB or 0xB8)
+ *   Dim value:      0-254 raw (NOT 0-100%)
+ *   Dim value pkt:  0xA5 (up to 4 channels packed per packet)
+ *   Set dim:        0x07 + channel + value(0-254) + fade_mode
+ *                   fade_mode: 0=direct, 1=rate, 2=time
+ *   RGBW:           0x1E + group + R + G + B + W + fade_mode
+ *   Scenes:         16 scenes (S0-S15), command 0x1D
+ *   0xFF response:  8 bytes (properties byte: CAN FD, terminator, HW ver)
+ *   Channel 0xFF:   broadcast to all channels
+ *
+ * NOTE: VMB2DC-20, VMB8DC-20 and VMB4LEDPWM-20 PDFs contain DALI-referencing
+ *   commands. These are documentation bleed-over from the shared VMBDALI
+ *   codebase and are INVALID for all three modules. Ignore all DALI references.
+ *
+ * Confirmed on Toulouse site (26/06/2026):
+ *   VMB8DC-20 type 0x4B — present on site, channels 1/4/8 verified live.
+ *
+ * Fields:
+ *   name                - Human-readable module name
+ *   channels            - Number of output channels
+ *   outputType          - '0-10V' or 'PWM'
+ *   dimCurve            - 'linear' or 'exponential'
+ *   ledMode             - VMB4LEDPWM-20 only: 'single'|'rgb'|'rgbw'|null
+ *                         null = not applicable (VMB2DC-20, VMB8DC-20)
+ *   minMemoryMapVersion - minimum map version required (null = unverified)
+ */
+const DIMMER_TYPES_20 = {
+  0x24: { name: 'VMB2DC-20',     channels: 2,  outputType: '0-10V', dimCurve: 'linear',      ledMode: null, minMemoryMapVersion: null },
+  0x4B: { name: 'VMB8DC-20',     channels: 8,  outputType: '0-10V', dimCurve: 'linear',      ledMode: null, minMemoryMapVersion: null },
+  0x06: { name: 'VMB4LEDPWM-20', channels: 4,  outputType: 'PWM',   dimCurve: 'exponential', ledMode: 'single', minMemoryMapVersion: null },
+};
+
+const DIMMER_TYPE_IDS_20 = new Set(Object.keys(DIMMER_TYPES_20).map(Number));
+
+// Type bytes for which ledMode configuration is applicable
+const LEDPWM_TYPE_IDS = new Set([0x06]);
+
+/**
+ * VMB4LEDPWM-20 per-channel "Device Type" setting (settings index 25).
+ * Read via 0xE7/0xE8 settings API — see doc comment above.
+ * Source: VMB4LEDPWM-20 protocol PDF ed.2 (01/07/2025).
+ */
+const DEVICE_TYPE_NAMES = {
+  0x00: 'Fluorescent lamps',
+  0x01: 'Emergency lamps',
+  0x02: 'Discharge lamps',
+  0x03: 'Low voltage lamps',
+  0x04: 'Dimmer for incandescent lamps',
+  0x05: 'Conversion to DC voltage (1-10V)',
+  0x06: 'LED module',
+  0x07: 'Switching device (relay)',
+  0x08: 'RGBW control (consumes all 4 channels)',
+  0x09: 'Sequencer',
+  0xF0: 'RGB control (consumes channels 1-3, channel 4 independent)',
+  0xFE: 'Device present but type unknown',
+  0xFF: 'Device not present (factory default)'
+};
+
+module.exports = { DIMMER_TYPES_20, DIMMER_TYPE_IDS_20, LEDPWM_TYPE_IDS, DEVICE_TYPE_NAMES };

package/lib/dimmer-types.js

@@ -0,0 +1,34 @@
+'use strict';
+
+/**
+ * dimmer-types.js
+ * Registry of ORIGINAL SERIES Velbus dimmer module types.
+ * V2 (-20) modules are in dimmer-types-20.js.
+ *
+ * KEY PROTOCOL NOTES:
+ *   Status packet:  0xB8 (NOT 0xEE or 0xFB)
+ *   Dim value:      0-100% (NOT 0-254)
+ *   Dimspeed:       16-bit seconds
+ *   0xFF response:  7 bytes (no properties byte — original series)
+ *   Channel:        0x01 fixed for VMBDMI/VMBDMI-R, bitmask for VMB4DC
+ *
+ * STATUS BYTE DIFFERENCES:
+ *   VMBDMI / VMBDMI-R:  mode(2b) + error(2b) + loadType(1b) + tempBand(3b)
+ *   VMB4DC:             mode(2b) only
+ *
+ * Fields:
+ *   name              - Human-readable module name
+ *   channels          - Number of dimmer channels
+ *   hasThermal        - true if thermal status in 0xB8 byte3 (VMBDMI/R only)
+ *   channelModel      - 'single' (fixed 0x01) or 'bitmask'
+ *   minMemoryMapVersion - minimum map version required (null = unverified)
+ */
+const DIMMER_TYPES = {
+  0x15: { name: 'VMBDMI',   channels: 1, hasThermal: true,  channelModel: 'single',  minMemoryMapVersion: null },
+  0x2F: { name: 'VMBDMI-R', channels: 1, hasThermal: true,  channelModel: 'single',  minMemoryMapVersion: null },
+  0x12: { name: 'VMB4DC',   channels: 4, hasThermal: false, channelModel: 'bitmask', minMemoryMapVersion: null },
+};
+
+const DIMMER_TYPE_IDS = new Set(Object.keys(DIMMER_TYPES).map(Number));
+
+module.exports = { DIMMER_TYPES, DIMMER_TYPE_IDS };

package/lib/glass-panel-types.js

@@ -0,0 +1,296 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Glass panel type registry — full VMBEL / VMBGP family
+// Single velbus-glass-panel node handles all entries in this table.
+//
+// hasOled:      module has OLED display — DATABYTE8 of 0xED is page number,
+//               0xAC memo text and 0xBE counter status are also emitted
+// hasPir:       module has PIR sensor — 0xA9 raw light value emitted
+// hasOc:        module has open collector output (channel 18 in protocol)
+//               Confirmed from PDF: VMBEL1/2/4 and -20 variants, VMBELO/-20,
+//               VMBGPO/-20, VMBELPIR/-20, VMBEL2PIR/-20, VMBGP4PIR/-20.
+//               VMBGP1/2/4 original and -2/-20 series: OC NOT confirmed from
+//               PDF — VMBGP1-2/2-2/4-2 protocol doc has no OC commands.
+//               TO VERIFY ON HARDWARE (UK, post July 4th 2026).
+//               hasOc: null = unverified, treat as false until confirmed.
+// pirChannels:  channel meanings for PIR variants (1-indexed)
+//               keys: channel number, value: semantic label
+// channels:     number of physical button channels
+// minMapVer:    minimum memory map version required (null = unverified/unknown)
+// series:       'original' | 'v2'
+// ─────────────────────────────────────────────────────────────────────────────
+
+const GLASS_PANEL_TYPES = {
+
+  // ── Original series ───────────────────────────────────────────────────────
+
+  0x1E: {
+    name: 'VMBGP1',
+    channels: 1,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — no PDF read for original VMBGP1
+    minMapVer: null,
+    series: 'original',
+  },
+  0x1F: {
+    name: 'VMBGP2',
+    channels: 2,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — no PDF read for original VMBGP2
+    minMapVer: null,
+    series: 'original',
+  },
+  0x20: {
+    name: 'VMBGP4',
+    channels: 4,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — no PDF read, was incorrectly labelled VMB6PB-20
+    minMapVer: null,
+    series: 'original',
+  },
+  0x21: {
+    name: 'VMBGPO',
+    channels: 32,
+    hasOled: true,
+    hasPir: false,
+    hasOc: true,        // OLED/output variant — OC confirmed by protocol family
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x2D: {
+    name: 'VMBGP4PIR',
+    channels: 8,
+    hasOled: false,
+    hasPir: true,
+    hasOc: null,        // TO VERIFY on hardware
+    pirChannels: {
+      1: 'button1', 2: 'button2', 3: 'button3', 4: 'button4',
+      5: 'virtual',  6: 'dark',    7: 'light',   8: 'motion',
+    },
+    minMapVer: null,
+    series: 'original',
+  },
+  0x34: {
+    name: 'VMBEL1',
+    channels: 1,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x35: {
+    name: 'VMBEL2',
+    channels: 2,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x36: {
+    name: 'VMBEL4',
+    channels: 4,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x37: {
+    name: 'VMBELO',
+    channels: 4,
+    hasOled: true,
+    hasPir: false,
+    hasOc: true,        // OLED/output variant — OC confirmed by protocol family
+    minMapVer: 4,
+    series: 'original',
+  },
+  0x38: {
+    name: 'VMBELPIR',
+    channels: 8,
+    hasOled: false,
+    hasPir: true,
+    hasOc: true,        // PIR variant of VMBEL family — OC present
+    pirChannels: {
+      1: 'button1', 2: 'button2', 3: 'button3', 4: 'button4',
+      5: 'virtual',  6: 'dark',    7: 'light',   8: 'motion',
+    },
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x3A: {
+    name: 'VMBGP1-2',
+    channels: 1,
+    hasOled: false,
+    hasPir: false,
+    hasOc: false,       // VMBGP1-2/2-2/4-2 PDF has no OC commands — TO VERIFY on hardware
+    minMapVer: null,
+    series: 'original',
+  },
+  0x3B: {
+    name: 'VMBGP2-2',
+    channels: 2,
+    hasOled: false,
+    hasPir: false,
+    hasOc: false,       // VMBGP1-2/2-2/4-2 PDF has no OC commands — TO VERIFY on hardware
+    minMapVer: null,
+    series: 'original',
+  },
+  0x3C: {
+    name: 'VMBGP4-2',
+    channels: 4,
+    hasOled: false,
+    hasPir: false,
+    hasOc: false,       // VMBGP1-2/2-2/4-2 PDF has no OC commands — TO VERIFY on hardware
+    minMapVer: null,
+    series: 'original',
+  },
+  0x3D: {
+    name: 'VMBGPOD-2',
+    channels: 4,
+    hasOled: true,
+    hasPir: false,
+    hasOc: null,        // OLED variant of GP series — TO VERIFY on hardware
+    minMapVer: 2,
+    series: 'original',
+  },
+  0x47: {
+    name: 'VMBEL2PIR',
+    channels: 6,
+    hasOled: false,
+    hasPir: true,
+    hasOc: true,        // PIR variant of VMBEL family — OC present
+    pirChannels: {
+      1: 'button1', 2: 'button2',
+      3: 'virtual',  4: 'dark',    5: 'light',   6: 'motion',
+    },
+    minMapVer: null,
+    series: 'original',
+  },
+
+  // ── V2 series ─────────────────────────────────────────────────────────────
+
+  0x4F: {
+    name: 'VMBEL1-20',
+    channels: 1,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024 covers -20 variants
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x50: {
+    name: 'VMBEL2-20',
+    channels: 2,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024 covers -20 variants
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x51: {
+    name: 'VMBEL4-20',
+    channels: 4,
+    hasOled: false,
+    hasPir: false,
+    hasOc: true,        // Confirmed: VMBEL1/2/4 protocol PDF ed2 Nov 2024 covers -20 variants
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x52: {
+    name: 'VMBELO-20',
+    channels: 4,
+    hasOled: true,
+    hasPir: false,
+    hasOc: true,        // OLED/output variant — OC confirmed by protocol family
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x53: {
+    name: 'VMBELPIR-20',  // Official list shows VMBBEL1PIR-20 — TO VERIFY via VelbusLink
+    channels: 8,
+    hasOled: false,
+    hasPir: true,
+    hasOc: true,        // PIR variant of VMBEL family — OC present
+    pirChannels: {
+      1: 'button1', 2: 'button2', 3: 'button3', 4: 'button4',
+      5: 'virtual',  6: 'dark',    7: 'light',   8: 'motion',
+    },
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x54: {
+    name: 'VMBGP1-20',
+    channels: 1,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — GP series OC status unconfirmed
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x55: {
+    name: 'VMBGP2-20',
+    channels: 2,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — GP series OC status unconfirmed
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x56: {
+    name: 'VMBGP4-20',
+    channels: 4,
+    hasOled: false,
+    hasPir: false,
+    hasOc: null,        // TO VERIFY — GP series OC status unconfirmed
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x57: {
+    name: 'VMBGPO-20',
+    channels: 32,
+    hasOled: true,
+    hasPir: false,
+    hasOc: true,        // OLED/output variant — OC confirmed by protocol family
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x5C: {
+    name: 'VMBEL2PIR-20',  // Official list shows VMBBEL2PIR-20 / VMBEL4PIR-20 conflict — TO VERIFY via VelbusLink
+    channels: 6,
+    hasOled: false,
+    hasPir: true,
+    hasOc: true,        // PIR variant of VMBEL family — OC present
+    pirChannels: {
+      1: 'button1', 2: 'button2',
+      3: 'virtual',  4: 'dark',    5: 'light',   6: 'motion',
+    },
+    minMapVer: null,
+    series: 'v2',
+  },
+  0x5F: {
+    name: 'VMBGP4PIR-20',
+    channels: 8,
+    hasOled: false,
+    hasPir: true,
+    hasOc: null,        // TO VERIFY — GP4PIR OC status unconfirmed
+    pirChannels: {
+      1: 'button1', 2: 'button2', 3: 'button3', 4: 'button4',
+      5: 'virtual',  6: 'dark',    7: 'light',   8: 'motion',
+    },
+    minMapVer: null,
+    series: 'v2',
+  },
+};
+
+// Flat set of all type byte values — used for quick membership test in scan node
+const GLASS_PANEL_TYPE_IDS = new Set(
+  Object.keys(GLASS_PANEL_TYPES).map(k => parseInt(k))
+);
+
+module.exports = { GLASS_PANEL_TYPES, GLASS_PANEL_TYPE_IDS };

package/lib/pir-types-20.js

@@ -0,0 +1,51 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// PIR module type registry — V2 (-20) series
+// Covered by velbus-pir-20 node.
+//
+// hasTempSensor:  module has temperature sensor — 0xE6 emitted, 0xE8 part1
+//                 is full glass-panel-style multi-part format (only calibration
+//                 and alarm fields meaningful — no thermostat presets).
+//                 Temp alarm bits replace absence in 0x00 bitmask.
+// lockStyle:      'number' — DB2 of lock/unlock is channel number 1-N
+// channels:       named channel numbers (1-indexed), keyed by channel number
+// minMapVer:      minimum memory map version (null = unverified)
+// series:         'v2'
+// ─────────────────────────────────────────────────────────────────────────────
+
+const PIR_TYPES_20 = {
+  0x4D: {
+    name: 'VMBPIR-20',
+    hasTempSensor: false,
+    lockStyle: 'number',
+    // Channels 1-7 by number; bitmask uses bit0=dark...bit6=absence
+    channels: {
+      1: 'dark', 2: 'light', 3: 'motion1', 4: 'ldMotion1',
+      5: 'motion2', 6: 'ldMotion2', 7: 'absence',
+    },
+    // 0x00 bitmask: bit0-bit6 as above, bit7 unused
+    bitmask: ['dark', 'light', 'motion1', 'ldMotion1', 'motion2', 'ldMotion2', 'absence'],
+    minMapVer: 1,
+    series: 'v2',
+  },
+  0x59: {
+    name: 'VMBPIRO-20',
+    hasTempSensor: true,
+    lockStyle: 'number',
+    // Channels 1-6 lockable; bits 6-7 are temp alarms (read-only, not lockable)
+    channels: {
+      1: 'dark', 2: 'light', 3: 'motion1', 4: 'ldMotion1',
+      5: 'motion2', 6: 'ldMotion2',
+    },
+    // 0x00 bitmask: bits 0-5 motion channels, bit6=lowTempAlarm, bit7=highTempAlarm
+    bitmask: ['dark', 'light', 'motion1', 'ldMotion1', 'motion2', 'ldMotion2',
+              'lowTempAlarm', 'highTempAlarm'],
+    minMapVer: null,
+    series: 'v2',
+  },
+};
+
+const PIR_TYPE_IDS_20 = new Set(Object.keys(PIR_TYPES_20).map(k => parseInt(k)));
+
+module.exports = { PIR_TYPES_20, PIR_TYPE_IDS_20 };

package/lib/pir-types.js

@@ -0,0 +1,61 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// PIR module type registry — original and -10 series
+// Covered by velbus-pir node.
+//
+// hasTempSensor:  module has temperature sensor — 0xE6 emitted, 0xE8 settings
+//                 compact format (7 bytes). Alarms replace absence in bitmask.
+// lockStyle:      'bitmask' — DB2 of lock/unlock/enable/disable is channel bitmask
+// channels:       named channel bits in bitmask order (bit0=index0)
+// minMapVer:      minimum memory map version (null = unverified)
+// series:         'original' | '-10'
+// ─────────────────────────────────────────────────────────────────────────────
+
+const CHANNEL_BITS_WITH_ABSENCE = [
+  'dark', 'light', 'motion1', 'ldMotion1', 'motion2', 'ldMotion2', 'absence',
+];
+
+const CHANNEL_BITS_WITH_TEMP = [
+  'dark', 'light', 'motion1', 'ldMotion1', 'motion2', 'ldMotion2',
+  'lowTempAlarm', 'highTempAlarm',
+];
+
+const PIR_TYPES = {
+  0x2A: {
+    name: 'VMBPIRM',
+    hasTempSensor: false,
+    lockStyle: 'bitmask',
+    channels: CHANNEL_BITS_WITH_ABSENCE,
+    minMapVer: null,
+    series: 'original',
+  },
+  0x2B: {
+    name: 'VMBPIRC',
+    hasTempSensor: false,
+    lockStyle: 'bitmask',
+    channels: CHANNEL_BITS_WITH_ABSENCE,
+    minMapVer: null,
+    series: 'original',
+  },
+  0x2C: {
+    name: 'VMBPIRO',
+    hasTempSensor: true,
+    lockStyle: 'bitmask',
+    channels: CHANNEL_BITS_WITH_TEMP,
+    minMapVer: null,
+    series: 'original',
+  },
+  0x23: {
+    name: 'VMBPIRO-10',
+    hasTempSensor: true,
+    lockStyle: 'bitmask',
+    channels: CHANNEL_BITS_WITH_TEMP,
+    minMapVer: null,
+    series: '-10',
+  },
+};
+
+const PIR_TYPE_IDS = new Set(Object.keys(PIR_TYPES).map(k => parseInt(k)));
+
+module.exports = { PIR_TYPES, PIR_TYPE_IDS };

package/lib/relay-types-20.js

@@ -0,0 +1,43 @@
+'use strict';
+
+/**
+ * relay-types-20.js
+ * Registry of V2 (-20 series) Velbus relay module types.
+ * Original series modules are in relay-types.js.
+ *
+ * KEY PROTOCOL DIFFERENCES FROM ORIGINAL SERIES:
+ *   0xFF response: 8 bytes (byte 8 = properties: CAN FD, terminator, HW ver)
+ *   0xFB status:   One packet = full module state (bitmask per byte, not per-channel)
+ *     byte 2: channel 1-8 on/off status bitmask
+ *     byte 3: channel 1-8 inhibited bitmask
+ *     byte 4: channel 1-8 forced_on bitmask
+ *     byte 5: channel 1-8 forced_off (locked) bitmask
+ *     byte 6: channel 1-8 program disabled bitmask
+ *     byte 7: channel 1-8 interval timer running bitmask
+ *     byte 8: alarm & program selection
+ *   Commands use channel NUMBER (1-8) or 0xFF for all — NOT bitmask
+ *   Full scheduling engine: programs, alarms, sunrise/sunset
+ *   CAN FD support (flag in 0xFF properties byte)
+ *   Program steps: 122 (original series: 72)
+ *
+ * Fields:
+ *   name              - Human-readable module name
+ *   channels          - Number of physical relay channels
+ *   virtual           - Number of virtual channels
+ *   hasInput          - true if module has physical input channel (VMB1RYS-20 ch8)
+ *   minMemoryMapVersion - minimum map version required (null = unverified)
+ *
+ * Confirmed type bytes (25/06/2026, from PDF edition 3 Jun 2025):
+ *   VMB1RYS-20: 0x0D  (previously TBD — now confirmed)
+ *   VMB4RYLD-20: 0x26
+ *   VMB4RYNO-20: 0x27
+ */
+const RELAY_TYPES_20 = {
+  0x0D: { name: 'VMB1RYS-20',   channels: 1, virtual: 0, hasInput: true,  minMemoryMapVersion: null },
+  0x26: { name: 'VMB4RYLD-20',  channels: 4, virtual: 4, hasInput: false, minMemoryMapVersion: null },
+  0x27: { name: 'VMB4RYNO-20',  channels: 4, virtual: 4, hasInput: false, minMemoryMapVersion: null },
+};
+
+const RELAY_TYPE_IDS_20 = new Set(Object.keys(RELAY_TYPES_20).map(Number));
+
+module.exports = { RELAY_TYPES_20, RELAY_TYPE_IDS_20 };

package/lib/relay-types.js

@@ -0,0 +1,39 @@
+'use strict';
+
+/**
+ * relay-types.js
+ * Registry of ORIGINAL SERIES Velbus relay module types only.
+ * V2 (-20) modules are in relay-types-20.js.
+ *
+ * Fields:
+ *   name              - Human-readable module name
+ *   channels          - Number of physical relay channels
+ *   virtual           - Number of virtual channels
+ *   hexSwitch         - true if address set by physical hex switches
+ *   hasForcedInhibit  - true | 'build1105' | false
+ *   hasInput          - true if module has physical input button (VMB1RYS)
+ *   minMemoryMapVersion - minimum map version required (null = unverified)
+ *
+ * Confirmed map versions (Toulouse, 25/06/2026):
+ *   VMB1RYS 0x41: map version 0, build 2436
+ *   All other original series assumed 0 pending confirmation.
+ *
+ * NOTE: Build number bytes in 0xFF response are NOT year/week.
+ *   They are build number high byte and low byte.
+ *   (byte6_decimal * 100) + byte7_decimal = build number as shown in VelbusLink.
+ */
+const RELAY_TYPES = {
+  0x02: { name: 'VMB1RY',      channels: 1, virtual: 0, hexSwitch: true,  hasForcedInhibit: false,       hasInput: false, minMemoryMapVersion: 0 },
+  0x08: { name: 'VMB4RY',      channels: 4, virtual: 0, hexSwitch: true,  hasForcedInhibit: 'build1105', hasInput: false, minMemoryMapVersion: 0 },
+  0x10: { name: 'VMB4RYLD',    channels: 4, virtual: 1, hexSwitch: false, hasForcedInhibit: 'build1105', hasInput: false, minMemoryMapVersion: 0 },
+  0x11: { name: 'VMB4RYNO',    channels: 4, virtual: 1, hexSwitch: false, hasForcedInhibit: 'build1105', hasInput: false, minMemoryMapVersion: 0 },
+  0x1B: { name: 'VMB1RYNO',    channels: 1, virtual: 4, hexSwitch: false, hasForcedInhibit: 'build1105', hasInput: false, minMemoryMapVersion: 0 },
+  0x29: { name: 'VMB1RYNOS',   channels: 1, virtual: 4, hexSwitch: false, hasForcedInhibit: true,        hasInput: false, minMemoryMapVersion: 0 },
+  0x41: { name: 'VMB1RYS',     channels: 1, virtual: 4, hexSwitch: false, hasForcedInhibit: true,        hasInput: true,  minMemoryMapVersion: 0 },
+  0x48: { name: 'VMB4RYLD-10', channels: 4, virtual: 1, hexSwitch: false, hasForcedInhibit: true,        hasInput: false, minMemoryMapVersion: 0 },
+  0x49: { name: 'VMB4RYNO-10', channels: 4, virtual: 1, hexSwitch: false, hasForcedInhibit: true,        hasInput: false, minMemoryMapVersion: 0 },
+};
+
+const RELAY_TYPE_IDS = new Set(Object.keys(RELAY_TYPES).map(Number));
+
+module.exports = { RELAY_TYPES, RELAY_TYPE_IDS };

package/lib/sensor-types-20.js

@@ -0,0 +1,29 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Sensor/input module type registry — V2 series
+// Covered by velbus-sensor-20 node.
+//
+// VMB8IN-20 (0x4E): 8 digital inputs + 8 energy counters + up to 24 alarm
+//   channels via 3 subaddresses (channels 9-16, 17-24, 25-32)
+//   lockStyle: 'number' — DB2 of lock/unlock is channel number 1-32
+//   nameStyle: 'number' — DB2 of 0xF0/F1/F2 is channel number 1-32
+//   hasCounter: true — 0xA4 energy counter on all 8 channels (Wh / litres / ml)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const SENSOR_TYPES_20 = {
+  0x4E: {
+    name:        'VMB8IN-20',
+    channels:    8,        // primary digital input channels
+    alarmCh:     24,       // additional alarm channels via subaddresses (9-32)
+    hasCounter:  true,
+    lockStyle:   'number',
+    nameStyle:   'number',
+    minMapVer:   null,
+    series:      'v2',
+  },
+};
+
+const SENSOR_TYPE_IDS_20 = new Set(Object.keys(SENSOR_TYPES_20).map(k => parseInt(k)));
+
+module.exports = { SENSOR_TYPES_20, SENSOR_TYPE_IDS_20 };