node-red-contrib-modbus-modpackqt 3.1.1 → 3.2.1

package/CHANGELOG.md

@@ -4,6 +4,47 @@ 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.2.1] — 2026-05-10
+
+### Changed — Picker-first node UI
+
+- **"My Profiles" / "My Slaves" dropdown is now the primary input** on
+  master-read, master-write, master-probe and slave-probe. Pick a saved
+  device from your modpackqt.com account and the node is configured.
+- **Runtime config + manual Host/Port/Unit/Timeout fields are now
+  hidden** under a small **▸ Advanced — runtime config & manual entry**
+  toggle. Auto-expanded for first-time setup (no runtime configured),
+  collapsed once you have a runtime + Account Key set up.
+- No behaviour change for existing flows — fields, defaults and
+  validation are identical to v3.2.0.
+
+## [3.2.0] — 2026-05-10
+
+### Added — Cloud profile pickers
+
+- **"My Profiles" dropdown** on `modpackqt-master-read`,
+  `modpackqt-master-write` and `modpackqt-master-probe`. Picks one of
+  your saved Modbus TCP profiles from your modpackqt.com account and
+  auto-fills `targetHost`, `targetPort` and `unitId`. No more retyping
+  IPs across nodes.
+- **"My Slaves" dropdown** on `modpackqt-slave-probe`. Picks one of
+  your saved slave configs and auto-fills `bindPort` + `unitId`.
+- **Account Key** field on the runtime config (renamed from "API Key").
+  Paste your tunnel key from
+  [modpackqt.com → Settings → Cloud Gateways](https://modpackqt.com/settings)
+  to enable the dropdowns. Same key the Electron gateway uses — no new
+  signup, no new mechanism.
+- **Hidden admin proxy** (`/modpackqt/connections`, `/modpackqt/slaves`)
+  on the Node-RED admin port. Calls modpackqt.com server-side from the
+  Node-RED process so the Account Key never reaches the browser.
+
+### Changed
+
+- Manual `targetHost` / `targetPort` / `unitId` fields stay as a fallback
+  on every node — existing v3.1.x flows keep working untouched.
+- Runtime config `apiKey` credential is unchanged on disk — only the
+  label and helper text in the editor were updated.
+
 ## [3.1.1] — 2026-05-10
 
 ### Fixed

package/README.md

@@ -16,6 +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.
 - **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/cloud-client.js

@@ -0,0 +1,58 @@
+/**
+ * ModPackQT Cloud Client — minimal HTTPS reader for the user's saved
+ * Modbus profiles & slaves at modpackqt.com.
+ *
+ * Reuses the existing X-Tunnel-Key auth that the Electron gateway already
+ * uses. The user's "Account Key" is the same tunnel key they generate at
+ * modpackqt.com → Settings → Cloud Gateways. No new auth, no new dep.
+ *
+ * All requests are read-only GETs. The Node-RED admin endpoint in
+ * modpackqt-config.js wraps these so the editor never sees the key
+ * (proxied server-side from the Node-RED process).
+ */
+const https = require('https');
+const http  = require('http');
+const { URL } = require('url');
+
+const ORIGIN = process.env.MODPACKQT_CLOUD_ORIGIN || 'https://modpackqt.com';
+const TIMEOUT_MS = 10000;
+
+function fetchJson(path, key, callback) {
+  let u;
+  try { u = new URL(path, ORIGIN); }
+  catch (e) { return callback(new Error('Invalid cloud URL: ' + e.message)); }
+
+  const lib = u.protocol === 'https:' ? https : http;
+  const req = lib.request({
+    method:   'GET',
+    hostname: u.hostname,
+    port:     u.port || (u.protocol === 'https:' ? 443 : 80),
+    path:     u.pathname + (u.search || ''),
+    headers: {
+      'X-Tunnel-Key': key,
+      'Accept':       'application/json',
+      'User-Agent':   'node-red-contrib-modbus-modpackqt'
+    },
+    timeout: TIMEOUT_MS
+  }, (res) => {
+    let body = '';
+    res.setEncoding('utf8');
+    res.on('data',  (c) => { body += c; });
+    res.on('end',   () => {
+      if (res.statusCode >= 400) {
+        return callback(new Error('Cloud HTTP ' + res.statusCode + ': ' + body.slice(0, 200)));
+      }
+      try { callback(null, JSON.parse(body)); }
+      catch (e) { callback(new Error('Invalid JSON from cloud: ' + e.message)); }
+    });
+  });
+  req.on('error',   (err) => callback(err));
+  req.on('timeout', () => { req.destroy(new Error('Cloud request timed out after ' + TIMEOUT_MS + 'ms')); });
+  req.end();
+}
+
+module.exports = {
+  origin: () => ORIGIN,
+  fetchConnections: (key, cb) => fetchJson('/api/connections', key, cb),
+  fetchSlaves:      (key, cb) => fetchJson('/api/slaves',      key, cb),
+};

package/nodes/lib/probe-runtime.js

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

@@ -102,10 +102,15 @@
     <input type="number" id="node-config-input-slavePort" placeholder="1502">
   </div>
 
-  <h4 style="margin-top:18px">API Key (optional — reserved for future cloud features)</h4>
+  <h4 style="margin-top:18px">ModPackQT Account Key (optional — for cloud profile sync)</h4>
   <div class="form-row">
-    <label for="node-config-input-apiKey"><i class="fa fa-key"></i> API Key</label>
-    <input type="password" id="node-config-input-apiKey" placeholder="Optional — leave blank for local-only use">
+    <label for="node-config-input-apiKey"><i class="fa fa-key"></i> Account Key</label>
+    <input type="password" id="node-config-input-apiKey" placeholder="Optional — paste your tunnel key for profile pickers">
+  </div>
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin-top:-6px">
+    With a key set, master &amp; probe nodes show a dropdown of your saved Modbus profiles
+    and slaves from <a href="https://modpackqt.com/settings" target="_blank" rel="noopener">modpackqt.com → Settings → Cloud Gateways</a>.
+    All Modbus runs locally — the key is only used for read-only profile sync.
   </div>
 
   <div class="form-tips">
@@ -143,9 +148,13 @@
     last wrote.
   </p>
 
-  <h3>API key (optional)</h3>
+  <h3>ModPackQT Account Key (optional)</h3>
   <p>
-    Reserved for future cloud features (profile sync, remote console). Leave blank
-    for local-only use — all Modbus functionality works without a key.
+    Same tunnel key the Electron gateway uses — generate one at
+    <a href="https://modpackqt.com/settings" target="_blank" rel="noopener">modpackqt.com → Settings → Cloud Gateways</a>.
+    With a key set, the master and probe nodes show a dropdown of your saved Modbus
+    profiles &amp; slaves so you don't have to retype IPs and unit IDs. All Modbus traffic
+    still runs locally — the key is only used for a read-only HTTPS call from this
+    Node-RED process to load your profile list.
   </p>
 </script>

package/nodes/modpackqt-config.js

@@ -8,6 +8,31 @@
 module.exports = function (RED) {
   const ModbusRTU = require('modbus-serial');
   const { EventEmitter } = require('events');
+  const cloudClient = require('./lib/cloud-client');
+
+  // ── Admin proxy endpoints — let the editor read the user's saved profiles
+  // and slaves from modpackqt.com without ever exposing the Account Key to
+  // the browser. Same X-Tunnel-Key the Electron gateway already uses.
+  // Registered once per Node-RED process.
+  if (!RED._modpackqtAdminRoutesRegistered) {
+    RED._modpackqtAdminRoutesRegistered = true;
+    function makeProxy(fetchFn) {
+      return function (req, res) {
+        const configId = req.query && req.query.config;
+        if (!configId) return res.status(400).json({ error: 'config query param required' });
+        const cfg = RED.nodes.getNode(configId);
+        if (!cfg) return res.status(404).json({ error: 'Runtime config not found (deploy first?)' });
+        const key = cfg.credentials && cfg.credentials.apiKey;
+        if (!key) return res.status(400).json({ error: 'No Account Key set on the runtime config — paste it in the modpackqt-config node first.' });
+        fetchFn(key, function (err, data) {
+          if (err) return res.status(502).json({ error: err.message });
+          res.json(data);
+        });
+      };
+    }
+    RED.httpAdmin.get('/modpackqt/connections', RED.auth.needsPermission('flows.read'), makeProxy(cloudClient.fetchConnections));
+    RED.httpAdmin.get('/modpackqt/slaves',      RED.auth.needsPermission('flows.read'), makeProxy(cloudClient.fetchSlaves));
+  }
 
   function ModPackQTConfigNode(config) {
     RED.nodes.createNode(this, config);

package/nodes/modpackqt-master-probe.html

@@ -4,6 +4,7 @@
     color: '#7c3aed',
     defaults: {
       name:        { value: '' },
+      server:      { value: '', type: 'modpackqt-config' },
       targetHost:  { value: '192.168.1.10', required: true },
       targetPort:  { value: 502, required: true, validate: RED.validators.number() },
       unitId:      { value: 1, required: true, validate: RED.validators.number() },
@@ -18,6 +19,8 @@
     paletteLabel: 'modbus master probe',
     oneditprepare: function () {
       const node = this;
+      if (window.ModPackQTMasterPicker) ModPackQTMasterPicker.attach(this);
+      if (window.ModPackQTAdvancedToggle) ModPackQTAdvancedToggle.attach('modpackqt-master-probe');
       const buildLink = (info) => {
         const probeHost = (info && info.host) || '127.0.0.1';
         const probePort = (info && info.port) || 8502;
@@ -47,22 +50,41 @@
     <input type="text" id="node-input-name" placeholder="(optional, e.g. Inverter A)">
   </div>
   <div class="form-row">
-    <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
-    <input type="text" id="node-input-targetHost" placeholder="192.168.1.10">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
   </div>
-  <div class="form-row">
-    <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
-    <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Pick a saved Modbus profile from your modpackqt.com account — auto-fills host/port/unit. Set up your Account Key under <b>Advanced</b> below.
   </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 class="form-row" style="margin:14px 0 4px 0;border-top:1px solid #e5e7eb;padding-top:10px">
+    <a href="#" class="modpackqt-advanced-toggle" style="font-size:12px;color:#6b7280;text-decoration:none;cursor:pointer">▸ Advanced — runtime config &amp; manual entry</a>
   </div>
-  <div class="form-row">
-    <label for="node-input-timeoutMs"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
-    <input type="number" id="node-input-timeoutMs" placeholder="3000">
+  <div class="modpackqt-advanced" style="display:none">
+    <div class="form-row">
+      <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+      <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
+      <input type="text" id="node-input-targetHost" placeholder="192.168.1.10">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
+      <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
+    </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>
+    <div class="form-row">
+      <label for="node-input-timeoutMs"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
+      <input type="number" id="node-input-timeoutMs" placeholder="3000">
+    </div>
   </div>
-  <div class="form-tips">
+
+  <div class="form-tips" style="margin-top:14px">
     <b>One probe = one device.</b> Drop additional master-probe nodes for additional devices —
     the web console aggregates them all into a unified sidebar.
   </div>

package/nodes/modpackqt-master-read.html

@@ -19,31 +19,93 @@
     label: function () {
       return this.name || `Master Read FC${this.functionCode} @${this.address}`;
     },
-    paletteLabel: 'modbus master read'
+    paletteLabel: 'modbus master read',
+    oneditprepare: function () {
+      ModPackQTMasterPicker.attach(this);
+      if (window.ModPackQTAdvancedToggle) ModPackQTAdvancedToggle.attach('modpackqt-master-read');
+    }
   });
 </script>
 
+<!-- Shared picker helper — loaded once per editor session -->
+<script type="text/javascript">
+  if (!window.ModPackQTMasterPicker) {
+    window.ModPackQTMasterPicker = {
+      attach: function (node) {
+        const $sel = $('#node-input-modpackqt-picker');
+        if (!$sel.length) return;
+        const reload = function () {
+          const cfgId = $('#node-input-server').val();
+          $sel.empty().append('<option value="">— Loading… —</option>');
+          if (!cfgId || cfgId === '_ADD_') {
+            $sel.empty().append('<option value="">— Set up runtime &amp; Account Key under Advanced —</option>');
+            return;
+          }
+          $.getJSON('modpackqt/connections?config=' + encodeURIComponent(cfgId))
+            .done(function (rows) {
+              $sel.empty().append('<option value="">— Manual entry (see Advanced) —</option>');
+              (rows || [])
+                .filter(function (c) { return c && (c.connectionType === 'tcp' || !c.connectionType); })
+                .forEach(function (c) {
+                  const label = (c.name || '(unnamed)') + ' — ' + (c.host || '?') + ':' + (c.port || 502) + ' #' + (c.unitId || 1);
+                  $('<option>').val(c.id).text(label).data('row', c).appendTo($sel);
+                });
+            })
+            .fail(function (xhr) {
+              const msg = (xhr.responseJSON && xhr.responseJSON.error) || ('HTTP ' + xhr.status);
+              $sel.empty().append($('<option>').val('').text('— ' + msg + ' —'));
+            });
+        };
+        $('#node-input-server').on('change', reload);
+        $('#modpackqt-picker-refresh').on('click', function (e) { e.preventDefault(); reload(); });
+        $sel.on('change', function () {
+          const row = $(this).find('option:selected').data('row');
+          if (!row) return;
+          $('#node-input-targetHost').val(row.host || '');
+          $('#node-input-targetPort').val(row.port || 502);
+          $('#node-input-unitId').val(row.unitId || 1);
+        });
+        reload();
+      }
+    };
+  }
+  if (!window.ModPackQTAdvancedToggle) {
+    window.ModPackQTAdvancedToggle = {
+      attach: function (/* nodeType */) {
+        const $adv = $('.modpackqt-advanced');
+        const $tog = $('.modpackqt-advanced-toggle');
+        if (!$adv.length || !$tog.length) return;
+        const setOpen = function (open) {
+          $adv.toggle(open);
+          $tog.html((open ? '▾ Hide advanced' : '▸ Advanced — runtime config &amp; manual entry'));
+        };
+        // Auto-expand if runtime not yet configured
+        const cfgId = $('#node-input-server').val();
+        const needsSetup = !cfgId || cfgId === '' || cfgId === '_ADD_';
+        setOpen(needsSetup);
+        $tog.off('click.modpackqt').on('click.modpackqt', function (e) {
+          e.preventDefault();
+          setOpen($adv.is(':hidden'));
+        });
+      }
+    };
+  }
+</script>
+
 <script type="text/html" data-template-name="modpackqt-master-read">
   <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="Name">
   </div>
   <div class="form-row">
-    <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
-    <input type="text" id="node-input-server">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
   </div>
-  <div class="form-row">
-    <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
-    <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">
-  </div>
-  <div class="form-row">
-    <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
-    <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
-  </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 class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Pick a saved Modbus profile from your modpackqt.com account — auto-fills host/port/unit. Set up your Account Key under <b>Advanced</b> below.
   </div>
+
   <div class="form-row">
     <label for="node-input-functionCode"><i class="fa fa-list"></i> Function Code</label>
     <select id="node-input-functionCode">
@@ -65,7 +127,30 @@
     <label for="node-input-pollInterval"><i class="fa fa-clock-o"></i> Poll Interval (ms)</label>
     <input type="number" id="node-input-pollInterval" min="0" placeholder="0 = disabled">
   </div>
-  <div class="form-tips">
+
+  <div class="form-row" style="margin:14px 0 4px 0;border-top:1px solid #e5e7eb;padding-top:10px">
+    <a href="#" class="modpackqt-advanced-toggle" style="font-size:12px;color:#6b7280;text-decoration:none;cursor:pointer">▸ Advanced — runtime config &amp; manual entry</a>
+  </div>
+  <div class="modpackqt-advanced" style="display:none">
+    <div class="form-row">
+      <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+      <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
+      <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
+      <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
+    </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>
+  </div>
+
+  <div class="form-tips" style="margin-top:14px">
     <b>Output:</b> <code>msg.payload</code> = raw register array. To decode int / float / string,
     pair with <a href="https://www.npmjs.com/package/node-red-contrib-bytes-modpackqt" target="_blank">node-red-contrib-bytes-modpackqt</a>.
   </div>

package/nodes/modpackqt-master-write.html

@@ -17,7 +17,11 @@
     label: function () {
       return this.name || `Master Write FC${this.functionCode} @${this.address}`;
     },
-    paletteLabel: 'modbus master write'
+    paletteLabel: 'modbus master write',
+    oneditprepare: function () {
+      if (window.ModPackQTMasterPicker) ModPackQTMasterPicker.attach(this);
+      if (window.ModPackQTAdvancedToggle) ModPackQTAdvancedToggle.attach('modpackqt-master-write');
+    }
   });
 </script>
 
@@ -27,21 +31,14 @@
     <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>
-    <input type="text" id="node-input-server">
+    <label for="node-input-modpackqt-picker"><i class="fa fa-cloud-download"></i> My Profiles</label>
+    <select id="node-input-modpackqt-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
   </div>
-  <div class="form-row">
-    <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
-    <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">
-  </div>
-  <div class="form-row">
-    <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
-    <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
-  </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 class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Pick a saved Modbus profile from your modpackqt.com account — auto-fills host/port/unit. Set up your Account Key under <b>Advanced</b> below.
   </div>
+
   <div class="form-row">
     <label for="node-input-functionCode"><i class="fa fa-list"></i> Function Code</label>
     <select id="node-input-functionCode">
@@ -55,7 +52,30 @@
     <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-tips">
+
+  <div class="form-row" style="margin:14px 0 4px 0;border-top:1px solid #e5e7eb;padding-top:10px">
+    <a href="#" class="modpackqt-advanced-toggle" style="font-size:12px;color:#6b7280;text-decoration:none;cursor:pointer">▸ Advanced — runtime config &amp; manual entry</a>
+  </div>
+  <div class="modpackqt-advanced" style="display:none">
+    <div class="form-row">
+      <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+      <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetHost"><i class="fa fa-plug"></i> Target Host</label>
+      <input type="text" id="node-input-targetHost" placeholder="Modbus device IP/hostname (TCP only)">
+    </div>
+    <div class="form-row">
+      <label for="node-input-targetPort"><i class="fa fa-hashtag"></i> Target Port</label>
+      <input type="number" id="node-input-targetPort" min="1" max="65535" placeholder="502">
+    </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>
+  </div>
+
+  <div class="form-tips" style="margin-top:14px">
     <b>Input:</b> <code>msg.payload</code> = number (FC5/FC6) or array of numbers (FC15/FC16).
     Encode multi-register values upstream with
     <a href="https://www.npmjs.com/package/node-red-contrib-bytes-modpackqt" target="_blank">node-red-contrib-bytes-modpackqt</a>.

package/nodes/modpackqt-slave-probe.html

@@ -4,6 +4,7 @@
     color: '#7c3aed',
     defaults: {
       name:     { value: '' },
+      server:   { value: '', type: 'modpackqt-config' },
       bindHost: { value: '0.0.0.0' },
       bindPort: { value: 1502, required: true, validate: RED.validators.number() },
       unitId:   { value: 1, required: true, validate: RED.validators.number() }
@@ -17,6 +18,8 @@
     paletteLabel: 'modbus slave probe',
     oneditprepare: function () {
       const node = this;
+      if (window.ModPackQTSlavePicker) ModPackQTSlavePicker.attach(this);
+      if (window.ModPackQTAdvancedToggle) ModPackQTAdvancedToggle.attach('modpackqt-slave-probe');
       const buildLink = (info) => {
         const probeHost = (info && info.host) || '127.0.0.1';
         const probePort = (info && info.port) || 8502;
@@ -38,24 +41,86 @@
   });
 </script>
 
+<!-- Shared slave-picker helper — loaded once per editor session -->
+<script type="text/javascript">
+  if (!window.ModPackQTSlavePicker) {
+    window.ModPackQTSlavePicker = {
+      attach: function (node) {
+        const $sel = $('#node-input-modpackqt-slave-picker');
+        if (!$sel.length) return;
+        const reload = function () {
+          const cfgId = $('#node-input-server').val();
+          $sel.empty().append('<option value="">— Loading… —</option>');
+          if (!cfgId || cfgId === '_ADD_') {
+            $sel.empty().append('<option value="">— Set up runtime &amp; Account Key under Advanced —</option>');
+            return;
+          }
+          $.getJSON('modpackqt/slaves?config=' + encodeURIComponent(cfgId))
+            .done(function (rows) {
+              $sel.empty().append('<option value="">— Manual entry (see Advanced) —</option>');
+              (rows || [])
+                .filter(function (s) { return s && (s.protocol === 'tcp' || !s.protocol); })
+                .forEach(function (s) {
+                  const label = (s.name || '(unnamed)') + ' — :' + (s.port || 1502) + ' #' + (s.unitId || 1);
+                  $('<option>').val(s.id).text(label).data('row', s).appendTo($sel);
+                });
+            })
+            .fail(function (xhr) {
+              const msg = (xhr.responseJSON && xhr.responseJSON.error) || ('HTTP ' + xhr.status);
+              $sel.empty().append($('<option>').val('').text('— ' + msg + ' —'));
+            });
+        };
+        $('#node-input-server').on('change', reload);
+        $('#modpackqt-slave-picker-refresh').on('click', function (e) { e.preventDefault(); reload(); });
+        $sel.on('change', function () {
+          const row = $(this).find('option:selected').data('row');
+          if (!row) return;
+          $('#node-input-bindPort').val(row.port  || 1502);
+          $('#node-input-unitId').val(row.unitId || 1);
+        });
+        reload();
+      }
+    };
+  }
+</script>
+
 <script type="text/html" data-template-name="modpackqt-slave-probe">
   <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, e.g. Fake Inverter)">
   </div>
   <div class="form-row">
-    <label for="node-input-bindHost"><i class="fa fa-globe"></i> Bind Host</label>
-    <input type="text" id="node-input-bindHost" placeholder="0.0.0.0 (all interfaces)">
+    <label for="node-input-modpackqt-slave-picker"><i class="fa fa-cloud-download"></i> My Slaves</label>
+    <select id="node-input-modpackqt-slave-picker" style="width:65%"></select>
+    <button type="button" id="modpackqt-slave-picker-refresh" class="red-ui-button" title="Reload from modpackqt.com" style="margin-left:4px"><i class="fa fa-refresh"></i></button>
   </div>
-  <div class="form-row">
-    <label for="node-input-bindPort"><i class="fa fa-hashtag"></i> Listen Port</label>
-    <input type="number" id="node-input-bindPort" min="1" max="65535" placeholder="1502">
+  <div class="form-tips" style="font-size:11px;color:#6b7280;margin:-8px 0 12px 105px">
+    Pick a saved slave config from your modpackqt.com account — auto-fills port/unit. Set up your Account Key under <b>Advanced</b> below.
   </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 class="form-row" style="margin:14px 0 4px 0;border-top:1px solid #e5e7eb;padding-top:10px">
+    <a href="#" class="modpackqt-advanced-toggle" style="font-size:12px;color:#6b7280;text-decoration:none;cursor:pointer">▸ Advanced — runtime config &amp; manual entry</a>
   </div>
-  <div class="form-tips">
+  <div class="modpackqt-advanced" style="display:none">
+    <div class="form-row">
+      <label for="node-input-server"><i class="fa fa-cog"></i> Runtime</label>
+      <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+      <label for="node-input-bindHost"><i class="fa fa-globe"></i> Bind Host</label>
+      <input type="text" id="node-input-bindHost" placeholder="0.0.0.0 (all interfaces)">
+    </div>
+    <div class="form-row">
+      <label for="node-input-bindPort"><i class="fa fa-hashtag"></i> Listen Port</label>
+      <input type="number" id="node-input-bindPort" min="1" 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>
+  </div>
+
+  <div class="form-tips" style="margin-top:14px">
     <b>One probe = one fake slave.</b> For multiple slaves, drop one node per
     port. The web console aggregates all slave probes into a unified register
     editor — switch between them with one click.

package/package.json

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