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

package/nodes/modpackqt-master-write.js

@@ -1,57 +1,80 @@
-module.exports = function(RED) {
+/**
+ * ModPackQT Master Write — embedded Modbus TCP/RTU write.
+ * Accepts raw register values. Encode multi-register values upstream
+ * with node-red-contrib-bytes-modpackqt if needed.
+ */
+module.exports = function (RED) {
   function ModPackQTMasterWriteNode(config) {
     RED.nodes.createNode(this, config);
     const node = this;
     const server = RED.nodes.getNode(config.server);
 
     node.targetHost   = config.targetHost   || 'localhost';
-    node.targetPort   = parseInt(config.targetPort)   || 502;
-    node.unitId       = parseInt(config.unitId)       || 1;
-    node.functionCode = parseInt(config.functionCode) || 6;
-    node.address      = parseInt(config.address)      || 0;
+    node.targetPort   = parseInt(config.targetPort,   10) || 502;
+    node.unitId       = parseInt(config.unitId,       10) || 1;
+    node.functionCode = parseInt(config.functionCode, 10) || 6;
+    node.address      = parseInt(config.address,      10) || 0;
 
-    const FC_TO_REGISTER_TYPE = { 5: 'coil', 6: 'holding', 15: 'coil', 16: 'holding' };
-
-    node.on('input', async function(msg) {
+    node.on('input', async function (msg) {
       if (!server) {
         node.status({ fill: 'red', shape: 'ring', text: 'no config' });
         return;
       }
       try {
-        // Accept string JSON (e.g. "[100,200,300]" from inject string type),
-        // plain number, or actual array/number from inject JSON type.
         let raw = msg.payload;
         if (typeof raw === 'string') {
           try { raw = JSON.parse(raw); } catch (_) { raw = Number(raw); }
         }
+        // Booleans accepted for FC5/FC15 (coils) — pass through; otherwise require integers.
+        const isCoilWrite = (node.functionCode === 5 || node.functionCode === 15);
+        const arr = Array.isArray(raw) ? raw : [raw];
+        const values = arr.map((v) => {
+          if (isCoilWrite) return v ? 1 : 0;
+          const n = Number(v);
+          if (!Number.isFinite(n)) {
+            throw new Error(
+              `Invalid value: "${v}". Modbus registers must be integers in range 0..65535. ` +
+              `If you're trying to write a float or 32-bit value, encode it first with the bytes palette ` +
+              `(e.g. encode-float32 → modbus-master-write FC16).`
+            );
+          }
+          if (!Number.isInteger(n)) {
+            throw new Error(
+              `Cannot write non-integer ${n} as a Modbus register. ` +
+              `Use encode-float32 / encode-int32 from the bytes palette to convert it to register values first.`
+            );
+          }
+          if (n < -32768 || n > 65535) {
+            throw new Error(
+              `Value ${n} out of 16-bit register range (-32768..65535). ` +
+              `For larger numbers use encode-int32 / encode-uint32 from the bytes palette.`
+            );
+          }
+          // Normalize signed → unsigned 16-bit for the wire
+          return n < 0 ? (n + 0x10000) : (n & 0xFFFF);
+        });
 
-        // Always convert every value to an integer to avoid byte-encoding corruption.
-        const values = Array.isArray(raw)
-          ? raw.map(v => parseInt(v, 10))
-          : [parseInt(raw, 10)];
-
-        if (values.some(v => isNaN(v))) {
-          throw new Error(`Invalid payload — expected number or array of numbers, got: ${msg.payload}`);
-        }
-
-        const registerType = FC_TO_REGISTER_TYPE[node.functionCode] || 'holding';
-        node.status({ fill: 'blue', shape: 'ring', text: `writing ${values.length} value(s)…` });
-
-        await server.request('POST', '/api/modbus/tcp/write', {
+        node.status({ fill: 'blue', shape: 'ring', text: `writing ${values.length}…` });
+        await server.write({
           host:         node.targetHost,
           port:         node.targetPort,
           unitId:       node.unitId,
-          registerType,
+          functionCode: node.functionCode,
           address:      node.address,
           values
         });
 
-        node.status({ fill: 'green', shape: 'dot', text: `wrote ${values.length} @ addr ${node.address}` });
+        const ts = new Date().toLocaleTimeString();
+        const ops = server.opsToday();
+        node.status({
+          fill: 'green', shape: 'dot',
+          text: server.brandStatus(`wrote ${values.length} @${node.address} · ${ts} · ${ops} ops`)
+        });
         msg.success = true;
         msg.valuesWritten = values;
         node.send(msg);
       } catch (err) {
-        node.status({ fill: 'red', shape: 'dot', text: err.message });
+        node.status({ fill: 'red', shape: 'dot', text: err.message.slice(0, 60) });
         node.error(err.message, msg);
       }
     });

package/nodes/modpackqt-slave-read.html

@@ -1,11 +1,10 @@
 <script type="text/javascript">
   RED.nodes.registerType('modpackqt-slave-read', {
     category: 'ModPackQT',
-    color: '#7c3aed',
+    color: '#15803d',
     defaults: {
       name:         { value: '' },
       server:       { value: '', type: 'modpackqt-config', required: true },
-      slaveId:      { value: '' },
       registerType: { value: 'holding', required: true },
       address:      { value: 0,  required: true, validate: RED.validators.number() },
       quantity:     { value: 1,  required: true, validate: RED.validators.number() },
@@ -14,10 +13,10 @@
     inputs: 1,
     outputs: 1,
     icon: 'font-awesome/fa-server',
-    label: function() {
+    label: function () {
       return this.name || ('Slave Read ' + (this.registerType || 'holding') + ' @' + this.address);
     },
-    paletteLabel: 'slave read'
+    paletteLabel: 'modbus slave read'
   });
 </script>
 
@@ -27,18 +26,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> Gateway</label>
+    <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-slaveId"><i class="fa fa-id-card"></i> Slave ID</label>
-    <input type="text" id="node-input-slaveId" placeholder="e.g. 42  (or leave blank, set via msg.slaveId)">
-  </div>
   <div class="form-row">
     <label for="node-input-registerType"><i class="fa fa-list"></i> Register Type</label>
     <select id="node-input-registerType">
       <option value="holding">Holding Registers</option>
-      <option value="coil">Coils</option>
+      <option value="coils">Coils</option>
       <option value="input">Input Registers</option>
       <option value="discrete">Discrete Inputs</option>
     </select>
@@ -56,89 +51,21 @@
     <input type="number" id="node-input-pollInterval" min="0" placeholder="0 = trigger only">
   </div>
   <div class="form-tips">
-    <b>Tip:</b> Override at runtime via <code>msg.slaveId</code>, <code>msg.address</code>,
+    <b>Reads from the local slave register store.</b> Enable the embedded slave server
+    in the runtime config first. Override at runtime via <code>msg.address</code>,
     <code>msg.quantity</code>, or <code>msg.registerType</code>.
   </div>
 </script>
 
 <script type="text/html" data-help-name="modpackqt-slave-read">
   <p>
-    Reads the current register values from a <b>ModPackQT Slave</b>. Use this to monitor or
-    verify what your slave is currently serving to external Modbus masters.
+    Reads from the embedded slave's local register store. Useful for verifying what
+    external Modbus masters connecting to your slave port will see.
   </p>
-
-  <h3>Quick Setup — 4 steps</h3>
-  <ol>
-    <li>
-      <b>Create a free account</b> at
-      <a href="https://modpackqt.com" target="_blank">modpackqt.com</a>
-      (slave feature requires a paid plan — see below).
-    </li>
-    <li>
-      <b>Download and run the Gateway app.</b>
-      The gateway exposes a local REST API (default port <code>8502</code>).
-      Open the ModPackQT app and click <em>Download Gateway</em>.
-    </li>
-    <li>
-      <b>Create a Slave</b> in the ModPackQT app:
-      go to <em>Slave Simulator</em> → <em>New Slave</em>, set a Modbus port (e.g. <code>502</code>),
-      then click <em>Start</em>. Copy the <b>Slave ID</b> shown in the app.
-    </li>
-    <li>
-      <b>Add a ModPackQT Config node</b> (click the pencil next to Gateway above),
-      set Host to <code>localhost</code> and Port to <code>8502</code>.
-      Paste your API key from <em>ModPackQT → Settings → API Keys</em>.
-    </li>
-  </ol>
-
-  <h3>Plan requirement</h3>
-  <p>
-    The Slave Simulator is a <b>paid-plan feature</b>.
-    Free accounts cannot use slave nodes. If you receive a <code>403</code> error,
-    upgrade your plan first.
-    <a href="https://modpackqt.com/#pricing" target="_blank">View plans &amp; upgrade →</a>
-  </p>
-
-  <h3>Inputs</h3>
-  <dl class="message-properties">
-    <dt>payload <span class="property-type">any</span></dt>
-    <dd>Any message triggers a read (when Poll Interval is 0 or disabled).</dd>
-    <dt class="optional">slaveId <span class="property-type">string | number</span></dt>
-    <dd>Overrides the Slave ID configured in the node.</dd>
-    <dt class="optional">address <span class="property-type">number</span></dt>
-    <dd>Overrides the start address.</dd>
-    <dt class="optional">quantity <span class="property-type">number</span></dt>
-    <dd>Overrides how many registers to read.</dd>
-    <dt class="optional">registerType <span class="property-type">string</span></dt>
-    <dd>Overrides the register type: <code>holding</code>, <code>coil</code>, <code>input</code>, or <code>discrete</code>.</dd>
-  </dl>
-
+  <p>Enable the slave server in the <b>modpackqt-config</b> node first.</p>
   <h3>Outputs</h3>
   <dl class="message-properties">
-    <dt>payload.values <span class="property-type">array</span></dt>
-    <dd>Array of register values (integers for holding/input, booleans for coil/discrete).</dd>
-    <dt>payload.registerType <span class="property-type">string</span></dt>
-    <dd>Register type that was read.</dd>
-    <dt>payload.address <span class="property-type">number</span></dt>
-    <dd>Start address that was read.</dd>
-    <dt>payload.quantity <span class="property-type">number</span></dt>
-    <dd>Number of values returned.</dd>
-    <dt>payload.slaveId <span class="property-type">string</span></dt>
-    <dd>The Slave ID that was queried.</dd>
-    <dt>topic <span class="property-type">string</span></dt>
-    <dd><code>slave/{slaveId}/{registerType}/{address}</code></dd>
+    <dt>payload <span class="property-type">array</span></dt>
+    <dd>Raw register values (integers for holding/input, booleans for coils/discrete).</dd>
   </dl>
-
-  <h3>Status messages</h3>
-  <ul>
-    <li><b>yellow ring</b> — polling active, waiting for first response</li>
-    <li><b>green dot</b> — last read succeeded, shows register info + timestamp</li>
-    <li><b>red dot</b> — error (check API key / plan / gateway)</li>
-    <li><i>slave not found</i> — Slave ID is wrong or slave was deleted</li>
-    <li><i>gateway not running</i> — Gateway app is not started</li>
-  </ul>
-
-  <p>
-    <a href="https://modpackqt.com/node-red" target="_blank">Full documentation &amp; example flows →</a>
-  </p>
 </script>

package/nodes/modpackqt-slave-read.js

@@ -1,10 +1,14 @@
-module.exports = function(RED) {
+/**
+ * ModPackQT Slave Read — read from the embedded slave's local register store.
+ * The slave server itself runs in the modpackqt-config node (when enabled).
+ * Outputs raw register values.
+ */
+module.exports = function (RED) {
   function ModPackQTSlaveReadNode(config) {
     RED.nodes.createNode(this, config);
     const node = this;
     const server = RED.nodes.getNode(config.server);
 
-    node.slaveId      = config.slaveId      || '';
     node.registerType = config.registerType || 'holding';
     node.address      = parseInt(config.address,      10) || 0;
     node.quantity     = parseInt(config.quantity,     10) || 1;
@@ -12,51 +16,34 @@ module.exports = function(RED) {
 
     let timer = null;
 
-    async function doRead(msg) {
+    function doRead(msg) {
       if (!server) {
-        node.status({ fill: 'red', shape: 'ring', text: 'no config — add a ModPackQT Config node' });
+        node.status({ fill: 'red', shape: 'ring', text: 'no config' });
         return;
       }
-
-      const slaveId = (msg && msg.slaveId) || node.slaveId;
-      if (!slaveId) {
-        node.status({ fill: 'red', shape: 'ring', text: 'slave ID required' });
-        node.error('No Slave ID set. Configure it in the node or send msg.slaveId.', msg);
+      if (!server.slaveEnabled) {
+        node.status({ fill: 'red', shape: 'ring', text: 'slave server disabled in config' });
+        node.error('Embedded slave is disabled — enable it in the modpackqt-config node.', msg);
         return;
       }
-
-      const registerType = (msg && msg.registerType) || node.registerType;
-      const address      = (msg && msg.address !== undefined) ? parseInt(msg.address, 10) : node.address;
-      const quantity     = (msg && msg.quantity !== undefined) ? parseInt(msg.quantity, 10) : node.quantity;
-
       try {
-        const result = await server.request(
-          'GET',
-          `/api/slaves/${encodeURIComponent(slaveId)}/registers?type=${registerType}&offset=${address}&limit=${quantity}`
-        );
-
-        const values = result.values || [];
-        const now    = new Date().toLocaleTimeString();
-        const pollTxt = node.pollInterval > 0 ? ` (poll ${node.pollInterval}ms)` : '';
-        node.status({ fill: 'green', shape: 'dot', text: `${registerType} @${address} [${values.length}] · ${now}${pollTxt}` });
-
+        const registerType = (msg && msg.registerType) || node.registerType;
+        const address  = (msg && msg.address  !== undefined) ? parseInt(msg.address,  10) : node.address;
+        const quantity = (msg && msg.quantity !== undefined) ? parseInt(msg.quantity, 10) : node.quantity;
+
+        const values = server.slaveGet(registerType, address, quantity);
+        const now = new Date().toLocaleTimeString();
+        node.status({
+          fill: 'green', shape: 'dot',
+          text: server.brandStatus(`slave ${registerType} @${address} [${values.length}] · ${now}`)
+        });
         node.send({
-          payload: {
-            values,
-            registerType,
-            address,
-            quantity: values.length,
-            total:    result.total,
-            slaveId
-          },
-          topic: `slave/${slaveId}/${registerType}/${address}`
+          payload: values,
+          topic: `modpackqt/slave/${registerType}/${address}`,
+          modpackqt: { registerType, address, quantity: values.length }
         });
       } catch (err) {
-        const hint = err.message.includes('403') ? 'check API key / plan limit'
-          : err.message.includes('404') ? 'slave not found — check Slave ID'
-          : err.message.includes('ECONNREFUSED') ? 'gateway not running'
-          : err.message;
-        node.status({ fill: 'red', shape: 'dot', text: hint });
+        node.status({ fill: 'red', shape: 'dot', text: err.message.slice(0, 60) });
         node.error(err.message, msg);
       }
     }
@@ -66,8 +53,8 @@ module.exports = function(RED) {
       timer = setInterval(() => doRead(null), node.pollInterval);
     }
 
-    node.on('input', async function(msg) { await doRead(msg); });
-    node.on('close', function() { if (timer) clearInterval(timer); });
+    node.on('input', function (msg) { doRead(msg); });
+    node.on('close', function () { if (timer) clearInterval(timer); });
   }
   RED.nodes.registerType('modpackqt-slave-read', ModPackQTSlaveReadNode);
 };

package/nodes/modpackqt-slave-write.html

@@ -1,21 +1,20 @@
 <script type="text/javascript">
   RED.nodes.registerType('modpackqt-slave-write', {
     category: 'ModPackQT',
-    color: '#7c3aed',
+    color: '#15803d',
     defaults: {
       name:         { value: '' },
       server:       { value: '', type: 'modpackqt-config', required: true },
-      slaveId:      { value: '' },
       registerType: { value: 'holding', required: true },
       address:      { value: 0, required: true, validate: RED.validators.number() }
     },
     inputs: 1,
     outputs: 1,
     icon: 'font-awesome/fa-hdd-o',
-    label: function() {
+    label: function () {
       return this.name || ('Slave Write ' + (this.registerType || 'holding') + ' @' + this.address);
     },
-    paletteLabel: 'slave write'
+    paletteLabel: 'modbus slave write'
   });
 </script>
 
@@ -25,18 +24,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> Gateway</label>
+    <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-slaveId"><i class="fa fa-id-card"></i> Slave ID</label>
-    <input type="text" id="node-input-slaveId" placeholder="e.g. 42  (or leave blank, set via msg.slaveId)">
-  </div>
   <div class="form-row">
     <label for="node-input-registerType"><i class="fa fa-list"></i> Register Type</label>
     <select id="node-input-registerType">
-      <option value="holding">Holding Registers (FC16)</option>
-      <option value="coil">Coils (FC15)</option>
+      <option value="holding">Holding Registers</option>
+      <option value="coils">Coils</option>
       <option value="input">Input Registers</option>
       <option value="discrete">Discrete Inputs</option>
     </select>
@@ -46,93 +41,17 @@
     <input type="number" id="node-input-address" min="0" max="65535" placeholder="0">
   </div>
   <div class="form-tips">
-    <b>Tip:</b> Send <code>msg.slaveId</code> to override the Slave ID at runtime.<br>
-    Send <code>msg.address</code> to override the start address.<br>
-    Payload: number, array, or JSON string <code>"[100,200,300]"</code>
+    <b>Pushes values into the embedded slave register store.</b> Any Modbus master that
+    connects to your slave port will read whatever was last written here.
+    Send <code>msg.payload</code> as a number, array, or JSON string.
   </div>
 </script>
 
 <script type="text/html" data-help-name="modpackqt-slave-write">
   <p>
-    Push values into a <b>ModPackQT Slave</b> register table. Any external Modbus master that
-    connects to that slave will read whatever values you last wrote here.
-  </p>
-
-  <h3>Quick Setup — 4 steps</h3>
-  <ol>
-    <li>
-      <b>Create a free account</b> at
-      <a href="https://modpackqt.com" target="_blank">modpackqt.com</a>
-      (slave feature requires a paid plan — see below).
-    </li>
-    <li>
-      <b>Download and run the Gateway app.</b>
-      The gateway exposes a local REST API (default port <code>8502</code>) that this
-      node talks to. Open the ModPackQT app and click <em>Download Gateway</em>.
-    </li>
-    <li>
-      <b>Create a Slave</b> in the ModPackQT app:
-      go to <em>Slave Simulator</em> → <em>New Slave</em>, set a Modbus port (e.g. <code>502</code>),
-      then click <em>Start</em>. Copy the <b>Slave ID</b> shown in the app.
-    </li>
-    <li>
-      <b>Add a ModPackQT Config node</b> (click the pencil next to Gateway above),
-      set Host to <code>localhost</code> and Port to <code>8502</code>.
-      Paste your API key from <em>ModPackQT → Settings → API Keys</em>.
-    </li>
-  </ol>
-
-  <h3>Plan requirement</h3>
-  <p>
-    The Slave Simulator is a <b>paid-plan feature</b>.
-    Free accounts cannot create slaves. If you receive a <code>403</code> error,
-    your plan does not include slaves or you have reached your slave limit.
-    <a href="https://modpackqt.com/#pricing" target="_blank">View plans &amp; upgrade →</a>
-  </p>
-
-  <h3>Inputs</h3>
-  <dl class="message-properties">
-    <dt>payload <span class="property-type">number | array | string</span></dt>
-    <dd>
-      Value(s) to write. Accepts: a single number (<code>42</code>),
-      an array (<code>[10, 20, 30]</code>), or a JSON string (<code>"[10,20,30]"</code>).
-      All values are converted to integers automatically.
-    </dd>
-    <dt class="optional">slaveId <span class="property-type">string | number</span></dt>
-    <dd>Overrides the Slave ID configured in the node editor.</dd>
-    <dt class="optional">address <span class="property-type">number</span></dt>
-    <dd>Overrides the start address configured in the node editor.</dd>
-    <dt class="optional">registerType <span class="property-type">string</span></dt>
-    <dd>Overrides the register type: <code>holding</code>, <code>coil</code>, <code>input</code>, or <code>discrete</code>.</dd>
-  </dl>
-
-  <h3>Outputs</h3>
-  <dl class="message-properties">
-    <dt>payload <span class="property-type">any</span></dt>
-    <dd>Original message passed through unchanged.</dd>
-    <dt>success <span class="property-type">boolean</span></dt>
-    <dd><code>true</code> when the write succeeded.</dd>
-    <dt>valuesWritten <span class="property-type">array</span></dt>
-    <dd>The integer values that were written.</dd>
-  </dl>
-
-  <h3>Status messages</h3>
-  <ul>
-    <li><b>blue ring</b> — write in progress</li>
-    <li><b>green dot</b> — write succeeded, shows count + timestamp</li>
-    <li><b>red dot</b> — error (check API key / plan / gateway)</li>
-    <li><i>slave not found</i> — Slave ID is wrong or slave was deleted</li>
-    <li><i>gateway not running</i> — Gateway app is not started</li>
-  </ul>
-
-  <h3>Example use case</h3>
-  <p>
-    Read temperature from an MQTT topic → convert to integer → send to this node.
-    Any PLC or SCADA system on the network can then read that temperature via
-    standard Modbus TCP from the ModPackQT slave port.
-  </p>
-
-  <p>
-    <a href="https://modpackqt.com/node-red" target="_blank">Full documentation &amp; example flows →</a>
+    Writes into the embedded slave's local register store. External Modbus masters
+    that connect to your configured slave port (default <code>1502</code>) will read
+    these values.
   </p>
+  <p>Enable the slave server in the <b>modpackqt-config</b> node first.</p>
 </script>

package/nodes/modpackqt-slave-write.js

@@ -1,61 +1,53 @@
-module.exports = function(RED) {
+/**
+ * ModPackQT Slave Write — write into the embedded slave's local register store.
+ * External Modbus masters connecting to the slave port (configured in
+ * modpackqt-config) will read whatever was last written here.
+ */
+module.exports = function (RED) {
   function ModPackQTSlaveWriteNode(config) {
     RED.nodes.createNode(this, config);
     const node = this;
     const server = RED.nodes.getNode(config.server);
 
-    node.slaveId      = config.slaveId      || '';
     node.registerType = config.registerType || 'holding';
     node.address      = parseInt(config.address, 10) || 0;
 
-    node.on('input', async function(msg) {
+    node.on('input', function (msg) {
       if (!server) {
-        node.status({ fill: 'red', shape: 'ring', text: 'no config — add a ModPackQT Config node' });
+        node.status({ fill: 'red', shape: 'ring', text: 'no config' });
         return;
       }
-
-      const slaveId = msg.slaveId || node.slaveId;
-      if (!slaveId) {
-        node.status({ fill: 'red', shape: 'ring', text: 'slave ID required' });
-        node.error('No Slave ID set. Configure it in the node or send msg.slaveId.', msg);
+      if (!server.slaveEnabled) {
+        node.status({ fill: 'red', shape: 'ring', text: 'slave server disabled in config' });
+        node.error('Embedded slave is disabled — enable it in the modpackqt-config node.', msg);
         return;
       }
-
       try {
-        // Accept string JSON ("[100,200]"), plain number string, actual array, or number
         let raw = msg.payload;
         if (typeof raw === 'string') {
           try { raw = JSON.parse(raw); } catch (_) { raw = Number(raw); }
         }
-
-        // Always convert every value to an integer to avoid encoding corruption
+        const registerType = msg.registerType || node.registerType;
+        const isBool = (registerType === 'coils' || registerType === 'discrete');
         const values = Array.isArray(raw)
-          ? raw.map(v => parseInt(v, 10))
-          : [parseInt(raw, 10)];
-
-        if (values.some(v => isNaN(v))) {
-          throw new Error(`Invalid payload — expected number or array of numbers, got: ${JSON.stringify(msg.payload)}`);
+          ? 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;
 
-        node.status({ fill: 'blue', shape: 'ring', text: `writing ${values.length} value(s)…` });
-
-        await server.request('PATCH', `/api/slaves/${encodeURIComponent(slaveId)}/registers`, {
-          registerType: msg.registerType || node.registerType,
-          address:      msg.address      !== undefined ? parseInt(msg.address, 10) : node.address,
-          values
-        });
-
+        server.slaveSet(registerType, address, values);
         const now = new Date().toLocaleTimeString();
-        node.status({ fill: 'green', shape: 'dot', text: `wrote ${values.length} @ addr ${node.address} · ${now}` });
+        node.status({
+          fill: 'green', shape: 'dot',
+          text: server.brandStatus(`slave wrote ${values.length} @${address} · ${now}`)
+        });
         msg.success = true;
         msg.valuesWritten = values;
         node.send(msg);
       } catch (err) {
-        const hint = err.message.includes('403') ? 'check API key / plan limit'
-          : err.message.includes('404') ? 'slave not found — check Slave ID'
-          : err.message.includes('ECONNREFUSED') ? 'gateway not running'
-          : err.message;
-        node.status({ fill: 'red', shape: 'dot', text: hint });
+        node.status({ fill: 'red', shape: 'dot', text: err.message.slice(0, 60) });
         node.error(err.message, msg);
       }
     });