node-red-contrib-modbus-modpackqt 3.3.7 → 3.3.9

package/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to **node-red-contrib-modbus-modpackqt** are documented
 here. This project follows [Semantic Versioning](https://semver.org/) — pin a
 major version (`^2.0.0`) in production.
 
+## [3.3.9] — 2026-05-10
+
+### Added
+
+- **Master Write** now has a **Quantity** field — fixes how many registers
+  the write covers. Payload arrays longer than this are truncated; shorter
+  ones are padded with the last value (or 0 if empty). For FC5 / FC6
+  (single-register writes) Quantity is forced to 1.
+
+## [3.3.8] — 2026-05-10
+
+### Changed
+
+- **Plain-language labels in master nodes.** The dropdown that selects a
+  config is now labelled **Target Device** (was "Runtime") in master-read,
+  master-write, and master-probe, with clearer helper text.
+- **Config dialog: "Device" section renamed to "Target Device".**
+- **Config dialog: Host field renamed to "IP Address"** with an example
+  placeholder (`e.g. 192.168.1.10`) and an inline hint explaining what to
+  enter. Port and Unit ID placeholders also clarified.
+
 ## [3.3.7] — 2026-05-10
 
 ### Added

package/nodes/lib/probe-runtime.js

@@ -18,7 +18,7 @@
 const http = require('http');
 const { URL } = require('url');
 
-const PALETTE_VERSION = '3.3.7';
+const PALETTE_VERSION = '3.3.9';
 const DEFAULT_PORT = parseInt(process.env.MODPACKQT_PROBE_PORT, 10) || 8502;
 const BIND_HOST    = process.env.MODPACKQT_PROBE_HOST || '127.0.0.1';
 const PORT_RETRY   = 5;

package/nodes/modpackqt-config.html

@@ -127,18 +127,21 @@
     Picks a saved connection from modpackqt.com — auto-fills Host, Port, and Unit ID below.
   </div>
 
-  <h4 style="margin-top:18px">Device</h4>
+  <h4 style="margin-top:18px">Target Device</h4>
   <div class="form-row modpackqt-tcp-only">
-    <label for="node-config-input-targetHost"><i class="fa fa-plug"></i> Host</label>
-    <input type="text" id="node-config-input-targetHost" placeholder="Modbus device IP/hostname">
+    <label for="node-config-input-targetHost"><i class="fa fa-plug"></i> IP Address</label>
+    <input type="text" id="node-config-input-targetHost" placeholder="e.g. 192.168.1.10 — IP/hostname of the Modbus device">
+  </div>
+  <div class="form-tips modpackqt-tcp-only" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    The IP address (or hostname) of the target Modbus device on your network.
   </div>
   <div class="form-row modpackqt-tcp-only">
     <label for="node-config-input-targetPort"><i class="fa fa-hashtag"></i> Port</label>
-    <input type="number" id="node-config-input-targetPort" min="1" max="65535" placeholder="502">
+    <input type="number" id="node-config-input-targetPort" min="1" max="65535" placeholder="502 (Modbus TCP default)">
   </div>
   <div class="form-row">
     <label for="node-config-input-unitId"><i class="fa fa-id-card"></i> Unit ID</label>
-    <input type="number" id="node-config-input-unitId" min="1" max="247" placeholder="1">
+    <input type="number" id="node-config-input-unitId" min="1" max="247" placeholder="1 (slave address on the bus)">
   </div>
 
   <h4 style="margin-top:18px">Transport</h4>

package/nodes/modpackqt-master-probe.html

@@ -56,11 +56,11 @@
     <input type="text" id="node-input-name" placeholder="(optional, e.g. Inverter A)">
   </div>
   <div class="form-row">
-    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+    <label for="node-input-server"><i class="fa fa-plug"></i> Target Device</label>
     <input type="text" id="node-input-server">
   </div>
   <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
-    The runtime config carries the device target — the probe deep-links the web tester to it.
+    Pick the Modbus device this probe should attach to — the web tester deep-links to it.
   </div>
 
   <div class="form-row">

package/nodes/modpackqt-master-read.html

@@ -31,11 +31,11 @@
     <input type="text" id="node-input-name" placeholder="Name">
   </div>
   <div class="form-row">
-    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+    <label for="node-input-server"><i class="fa fa-plug"></i> Target Device</label>
     <input type="text" id="node-input-server">
   </div>
   <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
-    The runtime config carries Host / Port / Unit. To talk to a different device, create another runtime config (pencil → +).
+    Pick the Modbus device this node should read from. Each target device carries its own Host / Port / Unit ID — to talk to a different device, click the pencil → + to add one.
   </div>
 
   <div class="form-row">

package/nodes/modpackqt-master-write.html

@@ -9,7 +9,8 @@
       targetPort:   { value: 0,   validate: function (v) { return v === '' || v === 0 || RED.validators.number()(v); } },
       unitId:       { value: 0,   validate: function (v) { return v === '' || v === 0 || RED.validators.number()(v); } },
       functionCode: { value: '6', required: true },
-      address:      { value: 0,   required: true, validate: RED.validators.number() }
+      address:      { value: 0,   required: true, validate: RED.validators.number() },
+      quantity:     { value: 1,   required: true, validate: RED.validators.number() }
     },
     inputs: 1,
     outputs: 1,
@@ -27,11 +28,11 @@
     <input type="text" id="node-input-name" placeholder="Name">
   </div>
   <div class="form-row">
-    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+    <label for="node-input-server"><i class="fa fa-plug"></i> Target Device</label>
     <input type="text" id="node-input-server">
   </div>
   <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
-    The runtime config carries Host / Port / Unit. To talk to a different device, create another runtime config (pencil → +).
+    Pick the Modbus device this node should write to. Each target device carries its own Host / Port / Unit ID — to talk to a different device, click the pencil → + to add one.
   </div>
 
   <div class="form-row">
@@ -47,6 +48,15 @@
     <label for="node-input-address"><i class="fa fa-map-marker"></i> Start Address</label>
     <input type="number" id="node-input-address" min="0" max="65535" placeholder="0">
   </div>
+  <div class="form-row">
+    <label for="node-input-quantity"><i class="fa fa-sort-numeric-asc"></i> Quantity</label>
+    <input type="number" id="node-input-quantity" min="1" max="125" placeholder="1">
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Number of registers to write. Payload arrays longer than this are truncated;
+    shorter ones are padded with the last value (or 0 if empty). For FC5 / FC6
+    (single-register writes) Quantity is forced to 1.
+  </div>
 
   <input type="hidden" id="node-input-targetHost">
   <input type="hidden" id="node-input-targetPort">

package/nodes/modpackqt-master-write.js

@@ -14,6 +14,7 @@ module.exports = function (RED) {
     node.unitId       = parseInt(config.unitId,     10) || 0;
     node.functionCode = parseInt(config.functionCode, 10) || 6;
     node.address      = parseInt(config.address,      10) || 0;
+    node.quantity     = parseInt(config.quantity,     10) || 1;
 
     node.on('input', async function (msg) {
       if (!server) {
@@ -26,7 +27,16 @@ module.exports = function (RED) {
           try { raw = JSON.parse(raw); } catch (_) { raw = Number(raw); }
         }
         const isCoilWrite = (node.functionCode === 5 || node.functionCode === 15);
-        const arr = Array.isArray(raw) ? raw : [raw];
+        const isSingle    = (node.functionCode === 5 || node.functionCode === 6);
+        const targetQty   = isSingle ? 1 : Math.max(1, node.quantity);
+        let arr = Array.isArray(raw) ? raw.slice() : [raw];
+        // Pad / truncate to targetQty
+        if (arr.length > targetQty) {
+          arr = arr.slice(0, targetQty);
+        } else if (arr.length < targetQty) {
+          const filler = arr.length ? arr[arr.length - 1] : (isCoilWrite ? 0 : 0);
+          while (arr.length < targetQty) arr.push(filler);
+        }
         const values = arr.map((v) => {
           if (isCoilWrite) return v ? 1 : 0;
           const n = Number(v);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-modbus-modpackqt",
-  "version": "3.3.7",
+  "version": "3.3.9",
   "description": "Modbus commissioning, testing & analysis tools for Node-RED. Embedded Modbus TCP/RTU master + slave server, FC1/FC2/FC3/FC4 reads, FC5/FC6/FC15/FC16 writes, built-in slave register store, and a passive traffic monitor for debugging. 100% free, MIT, no usage limits. By ModPackQT — open the matching web console at modpackqt.com for register decoding, simulation and AI assistance.",
   "keywords": [
     "node-red",