node-red-contrib-modbus-modpackqt 1.1.84 → 2.0.0

package/examples/basic-flow.json

@@ -2,193 +2,138 @@
   {
     "id": "tab-modpackqt-demo",
     "type": "tab",
-    "label": "ModPackQT Demo",
-    "disabled": false,
-    "info": "Demonstrates ModPackQT Node-RED nodes against the ModPackQT Gateway app (default port 8502).\n\nBefore deploying:\n1. Download and start the ModPackQT Gateway app from modpackqt.com/download\n2. Update the config node if the gateway runs on a different host/port\n3. For slave-read/slave-write: update slaveId to match a slave ID from your ModPackQT app"
+    "label": "ModPackQT — Modbus + Bytes Demo",
+    "info": "End-to-end demo combining node-red-contrib-modbus-modpackqt with node-red-contrib-bytes-modpackqt.\n\nMake sure BOTH palettes are installed:\n  npm install node-red-contrib-modbus-modpackqt node-red-contrib-bytes-modpackqt\n\nUpdate Target Host on the master nodes to your real PLC, OR just deploy as-is — the bottom slave-loop section works without any external device.\n\nFlows included:\n  1) Read float32 temperature from a PLC, decode, debug\n  2) Inject a setpoint, encode float32, write to PLC\n  3) Read a 16-bit status register, expand to 8 booleans\n  4) Read an 8-register UTF-8 serial number string\n  5) Embedded slave loop — encode int32 → write to local slave → read back → decode\n  6) Passive Modbus traffic monitor (free, no PLC needed)"
   },
   {
-    "id": "config-modpackqt-local",
+    "id": "config-modpackqt-runtime",
     "type": "modpackqt-config",
-    "name": "ModPackQT Gateway (localhost:8502)",
-    "host": "localhost",
-    "port": 8502,
-    "z": "tab-modpackqt-demo"
+    "name": "ModPackQT runtime",
+    "masterMode": "tcp",
+    "serialPort": "",
+    "baudRate": 9600,
+    "parity": "none",
+    "dataBits": 8,
+    "stopBits": 1,
+    "timeoutMs": 3000,
+    "slaveEnabled": true,
+    "slaveHost": "0.0.0.0",
+    "slavePort": 1502
   },
-  {
-    "id": "inject-poll-trigger",
-    "type": "inject",
-    "name": "Poll every 5s",
-    "props": [{ "p": "payload" }, { "p": "topic", "vt": "str" }],
-    "repeat": "5",
-    "crontab": "",
-    "once": true,
-    "onceDelay": 0,
-    "topic": "",
-    "payload": "",
-    "payloadType": "date",
-    "z": "tab-modpackqt-demo",
-    "x": 140,
-    "y": 80,
-    "wires": [["read-holding-regs"]]
-  },
-  {
-    "id": "read-holding-regs",
-    "type": "modpackqt-master-read",
-    "name": "Read FC3 Holding Regs",
-    "server": "config-modpackqt-local",
-    "targetHost": "192.168.1.10",
-    "targetPort": 502,
-    "unitId": 1,
-    "functionCode": "3",
-    "address": 0,
-    "quantity": 10,
-    "pollInterval": 0,
-    "z": "tab-modpackqt-demo",
-    "x": 380,
-    "y": 80,
-    "wires": [["debug-holding-regs"]]
-  },
-  {
-    "id": "debug-holding-regs",
-    "type": "debug",
-    "name": "Holding Reg Values",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "z": "tab-modpackqt-demo",
-    "x": 640,
-    "y": 80,
-    "wires": []
-  },
-  {
-    "id": "inject-write-reg",
-    "type": "inject",
-    "name": "Write value 1234",
-    "props": [{ "p": "payload", "v": "1234", "vt": "num" }],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "topic": "",
-    "z": "tab-modpackqt-demo",
-    "x": 140,
-    "y": 180,
-    "wires": [["write-single-reg"]]
-  },
-  {
-    "id": "write-single-reg",
-    "type": "modpackqt-master-write",
-    "name": "Write FC6 @100",
-    "server": "config-modpackqt-local",
-    "targetHost": "192.168.1.10",
-    "targetPort": 502,
-    "unitId": 1,
-    "functionCode": "6",
-    "address": 100,
-    "z": "tab-modpackqt-demo",
-    "x": 380,
-    "y": 180,
-    "wires": [["debug-write-result"]]
-  },
-  {
-    "id": "debug-write-result",
-    "type": "debug",
-    "name": "Write result",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "complete": "success",
-    "targetType": "msg",
-    "z": "tab-modpackqt-demo",
-    "x": 620,
-    "y": 180,
-    "wires": []
-  },
-  {
-    "id": "inject-slave-read",
-    "type": "inject",
-    "name": "Read slave registers",
-    "props": [{ "p": "payload" }],
-    "repeat": "2",
-    "crontab": "",
-    "once": true,
-    "onceDelay": 0,
-    "topic": "",
-    "payload": "",
-    "payloadType": "date",
-    "z": "tab-modpackqt-demo",
-    "x": 150,
-    "y": 280,
-    "wires": [["slave-read-node"]]
-  },
-  {
-    "id": "slave-read-node",
-    "type": "modpackqt-slave-read",
-    "name": "Slave Holding @0",
-    "server": "config-modpackqt-local",
-    "slaveId": "YOUR_SLAVE_ID",
-    "registerType": "holding",
-    "address": 0,
-    "quantity": 5,
-    "pollInterval": 0,
-    "z": "tab-modpackqt-demo",
-    "x": 400,
-    "y": 280,
-    "wires": [["debug-slave-read"]]
-  },
-  {
-    "id": "debug-slave-read",
-    "type": "debug",
-    "name": "Slave register values",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "complete": "payload",
-    "targetType": "msg",
-    "z": "tab-modpackqt-demo",
-    "x": 650,
-    "y": 280,
-    "wires": []
-  },
-  {
-    "id": "inject-slave-write",
-    "type": "inject",
-    "name": "Set slave regs [10,20,30]",
-    "props": [{ "p": "payload", "v": "[10,20,30]", "vt": "json" }],
-    "repeat": "",
-    "crontab": "",
-    "once": false,
-    "z": "tab-modpackqt-demo",
-    "x": 160,
-    "y": 380,
-    "wires": [["slave-write-node"]]
-  },
-  {
-    "id": "slave-write-node",
-    "type": "modpackqt-slave-write",
-    "name": "Slave Write Holding @0",
-    "server": "config-modpackqt-local",
-    "slaveId": "YOUR_SLAVE_ID",
-    "registerType": "holding",
-    "address": 0,
-    "z": "tab-modpackqt-demo",
-    "x": 420,
-    "y": 380,
-    "wires": [["debug-slave-write"]]
-  },
-  {
-    "id": "debug-slave-write",
-    "type": "debug",
-    "name": "Write success",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "complete": "success",
-    "targetType": "msg",
-    "z": "tab-modpackqt-demo",
-    "x": 650,
-    "y": 380,
-    "wires": []
-  }
+
+  { "id": "c1-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "1) Temperature: PLC float32 @100 → decode → debug",
+    "info": "Most common Modbus pattern. If the float looks wrong, try LE_SWAP on the decoder.",
+    "x": 220, "y": 40, "wires": [] },
+  { "id": "i-temp", "type": "inject", "z": "tab-modpackqt-demo",
+    "name": "Poll every 5s", "props": [{ "p": "payload" }], "repeat": "5",
+    "once": true, "payloadType": "date", "x": 130, "y": 80,
+    "wires": [["mr-temp"]] },
+  { "id": "mr-temp", "type": "modpackqt-master-read", "z": "tab-modpackqt-demo",
+    "name": "Read FC3 @100 qty=2", "server": "config-modpackqt-runtime",
+    "targetHost": "192.168.1.10", "targetPort": 502, "unitId": 1,
+    "functionCode": "3", "address": 100, "quantity": 2, "pollInterval": 0,
+    "x": 360, "y": 80, "wires": [["dec-temp"]] },
+  { "id": "dec-temp", "type": "decode-float32", "z": "tab-modpackqt-demo",
+    "name": "decode float32 BE", "endian": "BE", "sourceType": "registers",
+    "x": 600, "y": 80, "wires": [["d-temp"]] },
+  { "id": "d-temp", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Temperature (°C)", "active": true, "complete": "payload",
+    "x": 820, "y": 80, "wires": [] },
+
+  { "id": "c2-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "2) Setpoint: number → encode float32 → PLC write",
+    "info": "Click inject — sends 23.5 to PLC holding @200 (2 registers).",
+    "x": 230, "y": 160, "wires": [] },
+  { "id": "i-sp", "type": "inject", "z": "tab-modpackqt-demo",
+    "name": "Inject 23.5", "props": [{ "p": "payload", "v": "23.5", "vt": "num" }],
+    "x": 130, "y": 200, "wires": [["enc-sp"]] },
+  { "id": "enc-sp", "type": "encode-float32", "z": "tab-modpackqt-demo",
+    "name": "encode float32 BE", "endian": "BE",
+    "x": 360, "y": 200, "wires": [["mw-sp"]] },
+  { "id": "mw-sp", "type": "modpackqt-master-write", "z": "tab-modpackqt-demo",
+    "name": "Write FC16 @200", "server": "config-modpackqt-runtime",
+    "targetHost": "192.168.1.10", "targetPort": 502, "unitId": 1,
+    "functionCode": "16", "address": 200,
+    "x": 600, "y": 200, "wires": [["d-sp"]] },
+  { "id": "d-sp", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Setpoint result", "active": true, "complete": "true",
+    "x": 820, "y": 200, "wires": [] },
+
+  { "id": "c3-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "3) Status bits: 1 register → 8 booleans",
+    "info": "Wire to a switch node next to act on individual bits.",
+    "x": 200, "y": 280, "wires": [] },
+  { "id": "i-status", "type": "inject", "z": "tab-modpackqt-demo",
+    "name": "Read status", "props": [{ "p": "payload" }],
+    "x": 130, "y": 320, "wires": [["mr-status"]] },
+  { "id": "mr-status", "type": "modpackqt-master-read", "z": "tab-modpackqt-demo",
+    "name": "Read FC3 @50 qty=1", "server": "config-modpackqt-runtime",
+    "targetHost": "192.168.1.10", "targetPort": 502, "unitId": 1,
+    "functionCode": "3", "address": 50, "quantity": 1, "pollInterval": 0,
+    "x": 360, "y": 320, "wires": [["dec-status"]] },
+  { "id": "dec-status", "type": "decode-bitmask", "z": "tab-modpackqt-demo",
+    "name": "decode bitmask 8 bits", "sourceType": "registers", "bits": 8,
+    "x": 600, "y": 320, "wires": [["d-status"]] },
+  { "id": "d-status", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Status bits", "active": true, "complete": "payload",
+    "x": 820, "y": 320, "wires": [] },
+
+  { "id": "c4-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "4) Serial number: 8 registers → UTF-8 string",
+    "info": "Many devices store nameplate text starting at register 10.",
+    "x": 230, "y": 400, "wires": [] },
+  { "id": "i-sn", "type": "inject", "z": "tab-modpackqt-demo",
+    "name": "Read serial", "props": [{ "p": "payload" }],
+    "x": 130, "y": 440, "wires": [["mr-sn"]] },
+  { "id": "mr-sn", "type": "modpackqt-master-read", "z": "tab-modpackqt-demo",
+    "name": "Read FC3 @10 qty=8", "server": "config-modpackqt-runtime",
+    "targetHost": "192.168.1.10", "targetPort": 502, "unitId": 1,
+    "functionCode": "3", "address": 10, "quantity": 8, "pollInterval": 0,
+    "x": 360, "y": 440, "wires": [["dec-sn"]] },
+  { "id": "dec-sn", "type": "decode-string", "z": "tab-modpackqt-demo",
+    "name": "decode string utf8", "endian": "BE", "sourceType": "registers",
+    "encoding": "utf8", "trim": true,
+    "x": 600, "y": 440, "wires": [["d-sn"]] },
+  { "id": "d-sn", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Serial number", "active": true, "complete": "payload",
+    "x": 820, "y": 440, "wires": [] },
+
+  { "id": "c5-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "5) Local slave loop (no PLC needed): encode int32 → slave write → slave read → decode",
+    "info": "Demonstrates the embedded slave server. Connect any external Modbus master to <host>:1502, unit 1, FC3, address 0, qty 2 — you'll read the same value.",
+    "x": 360, "y": 520, "wires": [] },
+  { "id": "i-slave", "type": "inject", "z": "tab-modpackqt-demo",
+    "name": "Inject 1234567", "props": [{ "p": "payload", "v": "1234567", "vt": "num" }],
+    "x": 130, "y": 560, "wires": [["enc-slave"]] },
+  { "id": "enc-slave", "type": "encode-int32", "z": "tab-modpackqt-demo",
+    "name": "encode int32 BE", "endian": "BE",
+    "x": 340, "y": 560, "wires": [["sw-slave"]] },
+  { "id": "sw-slave", "type": "modpackqt-slave-write", "z": "tab-modpackqt-demo",
+    "name": "slave write @0", "server": "config-modpackqt-runtime",
+    "registerType": "holding", "address": 0,
+    "x": 540, "y": 560, "wires": [["sr-slave"]] },
+  { "id": "sr-slave", "type": "modpackqt-slave-read", "z": "tab-modpackqt-demo",
+    "name": "slave read @0 qty=2", "server": "config-modpackqt-runtime",
+    "registerType": "holding", "address": 0, "quantity": 2, "pollInterval": 0,
+    "x": 760, "y": 560, "wires": [["dec-slave"]] },
+  { "id": "dec-slave", "type": "decode-int32", "z": "tab-modpackqt-demo",
+    "name": "decode int32 BE", "endian": "BE", "sourceType": "registers",
+    "x": 980, "y": 560, "wires": [["d-slave"]] },
+  { "id": "d-slave", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Round-trip value", "active": true, "complete": "payload",
+    "x": 1180, "y": 560, "wires": [] },
+
+  { "id": "c6-comment", "type": "comment", "z": "tab-modpackqt-demo",
+    "name": "6) Traffic monitor — sees ALL Modbus ops above (free, no input wire)",
+    "info": "Wire to the Debug pane to watch every read/write happen in real time. Filter by direction, function code, or target.",
+    "x": 320, "y": 640, "wires": [] },
+  { "id": "traffic-mon", "type": "modpackqt-traffic", "z": "tab-modpackqt-demo",
+    "name": "All ops", "server": "config-modpackqt-runtime",
+    "filterDirection": "any", "filterKind": "any", "filterFc": "any",
+    "filterTarget": "", "format": "object", "alsoLog": false,
+    "x": 130, "y": 680, "wires": [["d-traffic"]] },
+  { "id": "d-traffic", "type": "debug", "z": "tab-modpackqt-demo",
+    "name": "Modbus traffic", "active": true, "complete": "payload",
+    "x": 360, "y": 680, "wires": [] }
 ]

package/nodes/modpackqt-config.html

@@ -2,15 +2,39 @@
   RED.nodes.registerType('modpackqt-config', {
     category: 'config',
     defaults: {
-      name:  { value: 'ModPackQT Gateway', required: false },
-      host:  { value: 'localhost', required: true },
-      port:  { value: 8502, required: true, validate: RED.validators.number() }
+      name:         { value: 'ModPackQT Gateway' },
+      masterMode:   { value: 'tcp', required: true },
+      serialPort:   { value: '' },
+      baudRate:     { value: 9600 },
+      parity:       { value: 'none' },
+      dataBits:     { value: 8 },
+      stopBits:     { value: 1 },
+      timeoutMs:    { value: 3000, validate: RED.validators.number() },
+      slaveEnabled: { value: false },
+      slaveHost:    { value: '0.0.0.0' },
+      slavePort:    { value: 1502, validate: RED.validators.number() }
     },
     credentials: {
       apiKey: { type: 'password' }
     },
-    label: function() {
-      return this.name || (this.host + ':' + this.port);
+    label: function () {
+      const m = this.masterMode === 'rtu' ? `RTU ${this.serialPort || '?'}` : 'TCP master';
+      const s = this.slaveEnabled ? ` + slave :${this.slavePort}` : '';
+      return this.name || `${m}${s}`;
+    },
+    oneditprepare: function () {
+      const toggleRtu = () => {
+        const isRtu = $('#node-config-input-masterMode').val() === 'rtu';
+        $('.modpackqt-rtu-only').toggle(isRtu);
+      };
+      const toggleSlave = () => {
+        const on = $('#node-config-input-slaveEnabled').is(':checked');
+        $('.modpackqt-slave-only').toggle(on);
+      };
+      $('#node-config-input-masterMode').on('change', toggleRtu);
+      $('#node-config-input-slaveEnabled').on('change', toggleSlave);
+      toggleRtu();
+      toggleSlave();
     }
   });
 </script>
@@ -20,109 +44,102 @@
     <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
     <input type="text" id="node-config-input-name" placeholder="ModPackQT Gateway">
   </div>
+
+  <h4 style="margin-top:18px">Master (outbound to remote devices)</h4>
   <div class="form-row">
-    <label for="node-config-input-host"><i class="fa fa-globe"></i> Host</label>
-    <input type="text" id="node-config-input-host" placeholder="localhost">
+    <label for="node-config-input-masterMode"><i class="fa fa-cogs"></i> Mode</label>
+    <select id="node-config-input-masterMode">
+      <option value="tcp">Modbus TCP</option>
+      <option value="rtu">Modbus RTU (Serial)</option>
+    </select>
+  </div>
+  <div class="form-row modpackqt-rtu-only">
+    <label for="node-config-input-serialPort"><i class="fa fa-plug"></i> Serial Port</label>
+    <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0  or  COM3">
+  </div>
+  <div class="form-row modpackqt-rtu-only">
+    <label for="node-config-input-baudRate"><i class="fa fa-tachometer"></i> Baud</label>
+    <input type="number" id="node-config-input-baudRate" placeholder="9600">
+  </div>
+  <div class="form-row modpackqt-rtu-only">
+    <label for="node-config-input-parity"><i class="fa fa-list"></i> Parity</label>
+    <select id="node-config-input-parity">
+      <option value="none">None</option>
+      <option value="even">Even</option>
+      <option value="odd">Odd</option>
+    </select>
+  </div>
+  <div class="form-row modpackqt-rtu-only">
+    <label for="node-config-input-dataBits"><i class="fa fa-hashtag"></i> Data Bits</label>
+    <select id="node-config-input-dataBits">
+      <option value="8">8</option><option value="7">7</option>
+    </select>
+  </div>
+  <div class="form-row modpackqt-rtu-only">
+    <label for="node-config-input-stopBits"><i class="fa fa-hashtag"></i> Stop Bits</label>
+    <select id="node-config-input-stopBits">
+      <option value="1">1</option><option value="2">2</option>
+    </select>
   </div>
   <div class="form-row">
-    <label for="node-config-input-port"><i class="fa fa-plug"></i> Port</label>
-    <input type="number" id="node-config-input-port" placeholder="8502" min="1" max="65535">
+    <label for="node-config-input-timeoutMs"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
+    <input type="number" id="node-config-input-timeoutMs" placeholder="3000">
   </div>
+
+  <h4 style="margin-top:18px">Slave Server (inbound — let other masters read from you)</h4>
+  <div class="form-row">
+    <label for="node-config-input-slaveEnabled" style="width:auto">
+      <input type="checkbox" id="node-config-input-slaveEnabled" style="width:auto;vertical-align:middle">
+      Enable embedded Modbus TCP slave server
+    </label>
+  </div>
+  <div class="form-row modpackqt-slave-only">
+    <label for="node-config-input-slaveHost"><i class="fa fa-globe"></i> Bind Host</label>
+    <input type="text" id="node-config-input-slaveHost" placeholder="0.0.0.0 (all interfaces)">
+  </div>
+  <div class="form-row modpackqt-slave-only">
+    <label for="node-config-input-slavePort"><i class="fa fa-hashtag"></i> Slave Port</label>
+    <input type="number" id="node-config-input-slavePort" placeholder="1502">
+  </div>
+
+  <h4 style="margin-top:18px">API Key (optional — for unlimited usage)</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="Paste your API key from ModPackQT → Settings">
+    <input type="password" id="node-config-input-apiKey" placeholder="Free trial — get one at modpackqt.com/nodered">
   </div>
+
   <div class="form-tips">
-    <b>Default setup:</b> Host <code>localhost</code>, Port <code>8502</code>.<br>
-    Get your API key from <b>ModPackQT app → Settings → API Keys</b>.
+    <b>No extra app needed.</b> Modbus runs inside Node-RED.<br>
+    <b>Free tier:</b> 1,000 ops/day. <a href="https://modpackqt.com/nodered" target="_blank">Get unlimited →</a>
   </div>
 </script>
 
 <script type="text/html" data-help-name="modpackqt-config">
   <p>
-    Shared connection settings for all ModPackQT nodes. Defines which
-    <b>ModPackQT Gateway</b> instance to communicate with and how to authenticate.
-  </p>
-
-  <h3>What is the ModPackQT Gateway?</h3>
-  <p>
-    The Gateway is a small app that runs on your local machine (or a server on your network).
-    It acts as a bridge between Node-RED and your Modbus devices, and also hosts the
-    Slave Simulator. All ModPackQT nodes talk to this Gateway's REST API.
+    Shared runtime for all <b>ModPackQT</b> nodes. The Modbus master client and the
+    optional slave server both run inside this Node-RED process — <b>no separate gateway
+    app required</b>.
   </p>
 
-  <h3>First-time setup</h3>
-  <ol>
-    <li>
-      <b>Sign up</b> at <a href="https://modpackqt.com" target="_blank">modpackqt.com</a>
-      — a free account lets you use the master read/write nodes.
-      Slave and advanced features require a paid plan.
-    </li>
-    <li>
-      <b>Download the Gateway app</b> — log in to ModPackQT, open
-      <em>Settings → Gateway</em> and download the installer for your OS (Windows/Mac/Linux).
-    </li>
-    <li>
-      <b>Run the Gateway</b> — it starts a local REST API on port <code>8502</code> by default.
-      You will see a <em>Running</em> status in the app when it is ready.
-    </li>
-    <li>
-      <b>Create an API Key</b> — in the ModPackQT web app, go to
-      <em>Settings → API Keys → New Key</em>. Copy the key and paste it into the
-      <em>API Key</em> field in this config node.
-    </li>
-    <li>
-      <b>Set Host and Port</b>:
-      <ul>
-        <li>If Node-RED runs on the same machine as the Gateway: <code>localhost</code> / <code>8502</code></li>
-        <li>If the Gateway is on another machine: use that machine's IP address</li>
-      </ul>
-    </li>
-  </ol>
-
-  <h3>Properties</h3>
-  <dl class="message-properties">
-    <dt>Host <span class="property-type">string</span></dt>
-    <dd>
-      Hostname or IP address of the machine running the ModPackQT Gateway.
-      Default: <code>localhost</code>.
-    </dd>
-    <dt>Port <span class="property-type">number</span></dt>
-    <dd>
-      TCP port the Gateway REST API listens on. Default: <code>8502</code>.
-      Change this only if you configured a custom port in the Gateway settings.
-    </dd>
-    <dt>API Key <span class="property-type">password</span></dt>
-    <dd>
-      Your ModPackQT API key. Required for authenticated operations.
-      Get it from <em>ModPackQT → Settings → API Keys</em>.
-    </dd>
-  </dl>
+  <h3>Master mode</h3>
+  <ul>
+    <li><b>Modbus TCP</b> — connects to remote devices via TCP. Each master node specifies its target host/port.</li>
+    <li><b>Modbus RTU</b> — opens the configured serial port and talks to RTU slaves on the bus. All RTU master nodes share this serial port.</li>
+  </ul>
 
-  <h3>Plan limits</h3>
-  <table>
-    <thead><tr><th>Feature</th><th>Free</th><th>Paid</th></tr></thead>
-    <tbody>
-      <tr><td>Master Read (modpackqt-master-read)</td><td>✓</td><td>✓</td></tr>
-      <tr><td>Master Write (modpackqt-master-write)</td><td>✓</td><td>✓</td></tr>
-      <tr><td>Slave Write (modpackqt-slave-write)</td><td>✗</td><td>✓</td></tr>
-      <tr><td>Slave Read (modpackqt-slave-read)</td><td>✗</td><td>✓</td></tr>
-      <tr><td>Number of Slaves</td><td>0</td><td>Plan dependent</td></tr>
-    </tbody>
-  </table>
+  <h3>Embedded slave server</h3>
   <p>
-    <a href="https://modpackqt.com/#pricing" target="_blank">View plans &amp; upgrade →</a>
+    When enabled, this config opens a Modbus TCP server on the configured port (default
+    <code>1502</code>). Use the <code>modpackqt-slave-write</code> node to push values into
+    its register store; external Modbus masters connecting to that port read whatever you
+    last wrote.
   </p>
 
-  <h3>Troubleshooting</h3>
-  <ul>
-    <li><b>ECONNREFUSED</b> — the Gateway app is not running. Start it from the ModPackQT app.</li>
-    <li><b>401 Unauthorized</b> — missing or invalid API key.</li>
-    <li><b>403 Forbidden</b> — your plan does not include this feature, or you have reached a limit.</li>
-    <li><b>404 Not Found</b> — the Slave ID or Connection Profile ID does not exist in your account.</li>
-  </ul>
-
+  <h3>API key (optional)</h3>
   <p>
-    <a href="https://modpackqt.com/node-red" target="_blank">Full Node-RED documentation →</a>
+    Leave blank for the free anonymous tier (1,000 ops/day per Node-RED instance,
+    branding visible in node status).
+    Add a key for unlimited use and clean status text — <a href="https://modpackqt.com/nodered" target="_blank">get a free 30-day trial key →</a>.
+    No credit card required.
   </p>
 </script>