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

package/CHANGELOG.md

@@ -4,6 +4,39 @@ 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.7] — 2026-05-10
+
+### Added
+
+- **Slave Write** now has a **Quantity** field — fixes how many registers
+  the node writes. Payload arrays longer than this are truncated; shorter
+  ones are padded with the last value (or 0 if empty).
+- **Slave Write** now has an **Update Interval (ms)** field — when set,
+  the node re-writes the most recently received `msg.payload` at this
+  interval. Useful for keeping a value fresh against external readers.
+
+## [3.3.6] — 2026-05-10
+
+### Added
+
+- **Account Key + My Connections picker on the runtime config node.**
+  Paste your ModPackQT tunnel key into the config dialog — the
+  **My Connections** dropdown loads your saved devices from
+  modpackqt.com and auto-fills Host, Port, and Unit ID. Manual entry
+  still works as a fallback.
+- Config node credentials are now registered so the admin proxy
+  (`/modpackqt/connections`) can look up the key without exposing it
+  to the browser.
+
+## [3.3.5] — 2026-05-10
+
+### Changed
+
+- **Port and Unit ID fields removed from slave server dialog.** They are now
+  hidden — the only way to set them is by picking from the **My Slaves**
+  profile picker. This enforces the cloud-driven config workflow and removes
+  manual entry that could conflict with the saved profile.
+
 ## [3.3.4] — 2026-05-10
 
 ### Changed

package/README.md

@@ -16,7 +16,7 @@ By [ModPackQT](https://modpackqt.com).
 - **Modbus master** — read (FC1–FC4) and write (FC5/FC6/FC15/FC16) over **TCP** or **RTU (serial)**
 - **Embedded Modbus TCP slave server** — push values from any flow, let PLCs / SCADA / HMIs read them
 - **Passive traffic monitor** — see every Modbus op (timing, values, errors) in real time
-- **Optional cloud profile pickers** *(v3.2.0)* — paste your ModPackQT Account Key into the runtime config and master / probe nodes show a dropdown of your saved Modbus profiles. No more retyping IPs across nodes.
+- **Cloud profile pickers** — paste your ModPackQT Account Key into the runtime config and a **My Connections** dropdown loads your saved devices, auto-filling host / port / unit. The slave server node has a matching **My Slaves** picker. No more retyping IPs across nodes.
 - **Outputs raw register values** — pair with [`node-red-contrib-bytes-modpackqt`](https://www.npmjs.com/package/node-red-contrib-bytes-modpackqt) to decode int / float / string / bitmask
 - **Zero external dependencies** — Modbus runs inside the Node-RED process
 

package/nodes/lib/probe-runtime.js

@@ -18,7 +18,7 @@
 const http = require('http');
 const { URL } = require('url');
 
-const PALETTE_VERSION = '3.3.4';
+const PALETTE_VERSION = '3.3.7';
 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

@@ -1,6 +1,9 @@
 <script type="text/javascript">
   RED.nodes.registerType('modpackqt-config', {
     category: 'config',
+    credentials: {
+      apiKey: { type: 'password' }
+    },
     defaults: {
       name:         { value: 'ModPackQT Device' },
       targetHost:   { value: 'localhost' },
@@ -39,6 +42,49 @@
       toggleRtu();
       toggleSlave();
 
+      // ── My Connections picker
+      const nodeId = this.id;
+      const $sel = $('#node-config-input-modpackqt-conn-picker');
+      const loadConnections = function () {
+        $sel.empty().append('<option value="">— Loading… —</option>');
+        if (!nodeId) {
+          $sel.empty().append('<option value="">— Save this config first, then reopen —</option>');
+          return;
+        }
+        $.getJSON('modpackqt/connections?probe=' + encodeURIComponent(nodeId))
+          .done(function (rows) {
+            $sel.empty().append('<option value="">— Manual entry —</option>');
+            (rows || []).forEach(function (c) {
+              const label = (c.name || '(unnamed)') + (c.connectionType === 'rtu'
+                ? ' — RTU'
+                : ' — ' + (c.host || '?') + ':' + (c.port || 502) + ' #' + (c.unitId || 1));
+              $('<option>').val(c.id).text(label).data('conn', c).appendTo($sel);
+            });
+          })
+          .fail(function (xhr) {
+            const msg = (xhr.responseJSON && xhr.responseJSON.error) || ('HTTP ' + xhr.status);
+            $sel.empty().append($('<option>').val('').text('— ' + msg + ' —'));
+          });
+      };
+      $('#modpackqt-conn-picker-refresh').on('click', function (e) {
+        e.preventDefault();
+        loadConnections();
+      });
+      $sel.on('change', function () {
+        const c = $(this).find('option:selected').data('conn');
+        if (!c) return;
+        if (!$('#node-config-input-name').val() || $('#node-config-input-name').val() === 'ModPackQT Device') {
+          $('#node-config-input-name').val(c.name || '');
+        }
+        if (c.host)   $('#node-config-input-targetHost').val(c.host);
+        if (c.port)   $('#node-config-input-targetPort').val(c.port);
+        if (c.unitId) $('#node-config-input-unitId').val(c.unitId);
+        if (c.connectionType === 'rtu') {
+          $('#node-config-input-masterMode').val('rtu').trigger('change');
+        }
+      });
+      loadConnections();
+
       // ── Embedded slave server section (collapsed by default)
       const $slaveSection = $('.modpackqt-slave-section');
       const $slaveToggle  = $('.modpackqt-slave-section-toggle');
@@ -63,6 +109,24 @@
     <input type="text" id="node-config-input-name" placeholder="e.g. Inverter A">
   </div>
 
+  <div class="form-row">
+    <label for="node-config-input-apiKey"><i class="fa fa-key"></i> Account Key</label>
+    <input type="password" id="node-config-input-apiKey" placeholder="Paste your ModPackQT tunnel key">
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 4px 105px">
+    Generate at <a href="https://modpackqt.com/settings" target="_blank" rel="noopener">modpackqt.com → Settings → Cloud Gateways</a>.
+    Loads your saved connections in the picker below.
+  </div>
+
+  <div class="form-row">
+    <label for="node-config-input-modpackqt-conn-picker"><i class="fa fa-cloud-download"></i> My Connections</label>
+    <select id="node-config-input-modpackqt-conn-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-conn-picker-refresh" class="red-ui-button" title="Reload" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Picks a saved connection from modpackqt.com — auto-fills Host, Port, and Unit ID below.
+  </div>
+
   <h4 style="margin-top:18px">Device</h4>
   <div class="form-row modpackqt-tcp-only">
     <label for="node-config-input-targetHost"><i class="fa fa-plug"></i> Host</label>

package/nodes/modpackqt-config.js

@@ -335,5 +335,7 @@ module.exports = function (RED) {
     });
   }
 
-  RED.nodes.registerType('modpackqt-config', ModPackQTConfigNode);
+  RED.nodes.registerType('modpackqt-config', ModPackQTConfigNode, {
+    credentials: { apiKey: { type: 'password' } }
+  });
 };

package/nodes/modpackqt-slave-server.html

@@ -104,20 +104,13 @@
     <button type="button" id="modpackqt-slave-server-picker-refresh" class="red-ui-button" title="Reload" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
   </div>
   <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
-    Picks a saved slave from modpackqt.com — auto-fills port and unit.
+    Required — pick a saved slave to set the port and unit ID.
     Register layout and limits are managed from the web console.
   </div>
 
-  <div class="form-row">
-    <label for="node-input-bindPort"><i class="fa fa-hashtag"></i> Port</label>
-    <input type="number" id="node-input-bindPort" min="1024" max="65535" placeholder="1502">
-  </div>
-  <div class="form-row">
-    <label for="node-input-unitId"><i class="fa fa-id-card"></i> Unit ID</label>
-    <input type="number" id="node-input-unitId" min="1" max="247" placeholder="1">
-  </div>
-
   <input type="hidden" id="node-input-bindHost">
+  <input type="hidden" id="node-input-bindPort">
+  <input type="hidden" id="node-input-unitId">
 
   <div class="form-row" style="margin-top:18px;padding-top:14px;border-top:1px solid #e5e7eb;text-align:center;">
     <a id="modpackqt-slave-server-link" href="https://modpackqt.com" target="_blank" rel="noopener noreferrer"

package/nodes/modpackqt-slave-write.html

@@ -3,10 +3,12 @@
     category: 'ModPackQT',
     color: '#15803d',
     defaults: {
-      name:          { value: '' },
-      slaveServerId: { value: '' },   // ID of a modpackqt-slave-server node on the canvas
-      registerType:  { value: 'holding', required: true },
-      address:       { value: 0, required: true, validate: RED.validators.number() }
+      name:           { value: '' },
+      slaveServerId:  { value: '' },   // ID of a modpackqt-slave-server node on the canvas
+      registerType:   { value: 'holding', required: true },
+      address:        { value: 0, required: true, validate: RED.validators.number() },
+      quantity:       { value: 1, required: true, validate: RED.validators.number() },
+      updateInterval: { value: 0, validate: RED.validators.number() }
     },
     inputs: 1,
     outputs: 1,
@@ -53,6 +55,22 @@
     <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).
+  </div>
+  <div class="form-row">
+    <label for="node-input-updateInterval"><i class="fa fa-clock-o"></i> Update Interval (ms)</label>
+    <input type="number" id="node-input-updateInterval" min="0" placeholder="0 = trigger only">
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    If &gt; 0, re-writes the most recently received <code>msg.payload</code> at this
+    interval — useful for keeping a value fresh against external readers.
+  </div>
   <div class="form-tips">
     Pushes values into the slave server's register store. External Modbus masters
     connecting to that port will read whatever you last wrote.

package/nodes/modpackqt-slave-write.js

@@ -7,37 +7,67 @@ module.exports = function (RED) {
     RED.nodes.createNode(this, config);
     const node = this;
 
-    node.registerType = config.registerType || 'holding';
-    node.address      = parseInt(config.address, 10) || 0;
+    node.registerType   = config.registerType || 'holding';
+    node.address        = parseInt(config.address,        10) || 0;
+    node.quantity       = parseInt(config.quantity,       10) || 1;
+    node.updateInterval = parseInt(config.updateInterval, 10) || 0;
 
     function getSlave() {
       return RED.nodes.getNode(config.slaveServerId);
     }
 
-    node.on('input', function (msg) {
+    let lastValues = null;       // last array we wrote, used by the update timer
+    let lastAddress = node.address;
+    let lastRegisterType = node.registerType;
+    let timer = null;
+
+    function shapePayload(raw, registerType) {
+      const isBool = (registerType === 'coils' || registerType === 'discrete');
+      let arr;
+      if (Array.isArray(raw)) {
+        arr = raw.map((v) => isBool ? Boolean(v) : parseInt(v, 10));
+      } else {
+        arr = [isBool ? Boolean(raw) : parseInt(raw, 10)];
+      }
+      if (!isBool && arr.some((v) => isNaN(v))) {
+        throw new Error(`Invalid payload — expected number or array, got: ${JSON.stringify(raw)}`);
+      }
+      // Pad / truncate to node.quantity
+      if (arr.length > node.quantity) {
+        arr = arr.slice(0, node.quantity);
+      } else if (arr.length < node.quantity) {
+        const filler = arr.length ? arr[arr.length - 1] : (isBool ? false : 0);
+        while (arr.length < node.quantity) arr.push(filler);
+      }
+      return arr;
+    }
+
+    function writeOnce(values, registerType, address, msg) {
       const slave = getSlave();
       if (!slave || !slave.slaveEnabled) {
         node.status({ fill: 'red', shape: 'ring', text: 'no slave server' });
-        node.error('No slave server selected or it is not running.', msg);
-        return;
+        node.error('No slave server selected or it is not running.', msg || {});
+        return false;
       }
+      slave.slaveSet(registerType, address, values);
+      const now = new Date().toLocaleTimeString();
+      node.status({ fill: 'green', shape: 'dot', text: `wrote ${values.length} → ${registerType} @${address} · ${now}` });
+      return true;
+    }
+
+    node.on('input', function (msg) {
       try {
         let raw = msg.payload;
         if (typeof raw === 'string') {
           try { raw = JSON.parse(raw); } catch (_) { raw = Number(raw); }
         }
         const registerType = msg.registerType || node.registerType;
-        const isBool = (registerType === 'coils' || registerType === 'discrete');
-        const values = Array.isArray(raw)
-          ? raw.map((v) => isBool ? Boolean(v) : parseInt(v, 10))
-          : [isBool ? Boolean(raw) : parseInt(raw, 10)];
-        if (!isBool && values.some((v) => isNaN(v))) {
-          throw new Error(`Invalid payload — expected number or array, got: ${JSON.stringify(msg.payload)}`);
-        }
         const address = msg.address !== undefined ? parseInt(msg.address, 10) : node.address;
-        slave.slaveSet(registerType, address, values);
-        const now = new Date().toLocaleTimeString();
-        node.status({ fill: 'green', shape: 'dot', text: `wrote ${values.length} → ${registerType} @${address} · ${now}` });
+        const values = shapePayload(raw, registerType);
+        if (!writeOnce(values, registerType, address, msg)) return;
+        lastValues = values;
+        lastAddress = address;
+        lastRegisterType = registerType;
         msg.success = true;
         msg.valuesWritten = values;
         node.send(msg);
@@ -46,6 +76,18 @@ module.exports = function (RED) {
         node.error(err.message, msg);
       }
     });
+
+    if (node.updateInterval > 0) {
+      timer = setInterval(() => {
+        if (!lastValues) return; // nothing received yet
+        try { writeOnce(lastValues, lastRegisterType, lastAddress, null); }
+        catch (err) { node.status({ fill: 'red', shape: 'dot', text: err.message.slice(0, 60) }); }
+      }, node.updateInterval);
+    }
+
+    node.on('close', function () {
+      if (timer) clearInterval(timer);
+    });
   }
   RED.nodes.registerType('modpackqt-slave-write', ModPackQTSlaveWriteNode);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-modbus-modpackqt",
-  "version": "3.3.4",
+  "version": "3.3.7",
   "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",