node-red-contrib-modbus-tcp-full-avd 1.0.0 → 1.1.0

package/README.md

@@ -1,26 +1,32 @@
 # node-red-contrib-modbus-tcp-full-avd
 
-Volledige MODBUS TCP node voor Node-RED met ondersteuning voor alle MODBUS functies en het volledige adresbereik (0-65535).
+Volledige MODBUS TCP node voor Node-RED met ondersteuning voor alle MODBUS functies en het volledige adresbereik (0-65535). Node-naam bevat initialen AVD voor unieke herkenbaarheid.
+
+**Versie:** 1.1.0
 
 ## Features
 
-- ✅ **TCP Client en Server modes** - Verbind als client of luister als server
-- ✅ **MODBUS Client en Server modes** - Verzend requests of reageer op requests
-- ✅ **Alle MODBUS functies** - Ondersteuning voor functie codes 01-24
-- ✅ **Volledige adresbereik** - 0-65535 voor alle data types
-- ✅ **Automatische reconnect** - Herverbind automatisch bij verbindingsverlies
-- ✅ **Retry mechanisme** - Configureerbare retries bij fouten
-- ✅ **Exception handling** - Volledige ondersteuning voor MODBUS exception codes
+- ✅ **TCP Client en Server modes** – Verbind als client of luister als server
+- ✅ **MODBUS Client en Server modes** – Verzend requests of reageer op requests
+- ✅ **Alle MODBUS functies** – Ondersteuning voor functie codes 01, 02, 03, 04, 05, 06, 15, 16
+- ✅ **Volledige adresbereik** – 0-65535 voor coils, discrete inputs, holding registers en input registers
+- ✅ **Automatische reconnect** – Herverbind automatisch bij verbindingsverlies
+- ✅ **Retry mechanisme** – Configureerbare retries bij fouten
+- ✅ **Exception handling** – Ondersteuning voor MODBUS exception codes
+- ✅ **Dataweergave** – Toon registerdata in node-status en/of debug panel
+- ✅ **Testdata (Server)** – Vul registers automatisch of handmatig met testdata (incrementing, random, sine, square, alternating)
+- ✅ **Speciale acties** – `readData`, `showData`, `generateTestData` via message
+- ✅ **Accept Any Unit ID (Server)** – Optioneel accepteren van elke Unit ID
 
 ## Installatie
 
 ### Via Node-RED Palette Manager
 
 1. Open Node-RED
-2. Ga naar Menu → Manage palette
-3. Klik op "Install" tab
-4. Zoek naar "node-red-contrib-modbus-tcp-full-avd"
-5. Klik op "Install"
+2. Ga naar **Menu** → **Manage palette**
+3. Klik op de **Install** tab
+4. Zoek naar **node-red-contrib-modbus-tcp-full-avd**
+5. Klik op **Install**
 
 ### Via NPM
 
@@ -28,193 +34,176 @@ Volledige MODBUS TCP node voor Node-RED met ondersteuning voor alle MODBUS funct
 npm install node-red-contrib-modbus-tcp-full-avd
 ```
 
-### Handmatige Installatie
+### Via upload (.tgz)
+
+1. Download of maak het package: `npm pack` (creëert `node-red-contrib-modbus-tcp-full-avd-1.1.0.tgz`)
+2. In Node-RED: **Menu** → **Manage palette** → **Install** tab → **upload**
+3. Selecteer het `.tgz` bestand en wacht op installatie
+4. Herstart Node-RED indien nodig
+
+### Handmatige installatie
 
-1. Download of clone deze repository
-2. Navigeer naar de Node-RED user directory (meestal `~/.node-red`)
-3. Kopieer de bestanden naar `~/.node-red/node_modules/node-red-contrib-modbus-tcp-full-avd`
-4. Herstart Node-RED
+1. Kopieer de package naar `~/.node-red/node_modules/node-red-contrib-modbus-tcp-full-avd`
+2. Voer uit: `npm install` in die directory
+3. Herstart Node-RED
 
 ## Gebruik
 
-### TCP Client + MODBUS Client (Meest Voorkomend)
+### TCP Client + MODBUS Client
 
-Deze combinatie wordt gebruikt om data te lezen/schrijven van een MODBUS TCP server.
+Gebruik om data te lezen/schrijven van een MODBUS TCP server.
 
-#### Configuratie
-- **TCP Mode**: Client
-- **Host**: IP-adres van de MODBUS server
-- **Port**: Poort van de MODBUS server (standaard 502)
-- **MODBUS Mode**: Client
-- **Unit ID**: MODBUS Unit ID (standaard 1)
+**Configuratie:** TCP Mode = Client, Host = IP van server, Port = 502, MODBUS Mode = Client, Unit ID = 1.
 
-#### Voorbeeld: Read Holding Registers
+#### Read Holding Registers
 
 ```javascript
-msg = {
-    function: 3,
-    address: 0,
-    quantity: 10
-}
+msg.payload = { function: 3, address: 0, quantity: 10 };
 ```
 
-#### Voorbeeld: Write Single Register
+#### Write Single Register
 
 ```javascript
-msg = {
-    function: 6,
-    address: 0,
-    value: 1234
-}
+msg.payload = { function: 6, address: 0, value: 1234 };
+```
+
+#### Write Multiple Coils
+
+```javascript
+msg.payload = { function: 15, address: 0, values: [true, false, true, false] };
 ```
 
-#### Voorbeeld: Write Multiple Coils
+#### Lees en toon data (actie readData)
 
 ```javascript
-msg = {
-    function: 15,
+msg.payload = {
+    action: "readData",
+    readType: "holdingRegisters",  // coils, discreteInputs, holdingRegisters, inputRegisters
     address: 0,
-    values: [true, false, true, false]
-}
+    quantity: 10
+};
 ```
 
 ### TCP Server + MODBUS Server
 
-Deze combinatie wordt gebruikt om MODBUS data aan te bieden aan clients.
+Gebruik om MODBUS data aan te bieden aan clients.
 
-#### Configuratie
-- **TCP Mode**: Server
-- **Port**: Poort om op te luisteren (standaard 502)
-- **MODBUS Mode**: Server
-- **Unit ID**: MODBUS Unit ID (standaard 1)
-- **Max Connections**: Maximum aantal gelijktijdige verbindingen
+**Configuratie:** TCP Mode = Server, Port = 502, MODBUS Mode = Server, Unit ID = 1. Optioneel: **Accept Any Unit ID** om elke Unit ID te accepteren.
 
-#### Data Update
+#### Data bijwerken
 
 ```javascript
-msg = {
+msg.payload = {
     type: "holdingRegisters",  // coils, discreteInputs, holdingRegisters, inputRegisters
     address: 0,
-    value: 1234                 // Single value
-}
+    value: 1234
+};
 ```
 
-Of voor meerdere waarden:
+Meerdere waarden:
 
 ```javascript
-msg = {
-    type: "holdingRegisters",
+msg.payload = { type: "holdingRegisters", address: 0, values: [1, 2, 3, 4, 5] };
+```
+
+#### Toon alle registerdata (actie showData)
+
+```javascript
+msg.payload = { action: "showData" };
+```
+
+#### Genereer testdata (actie generateTestData)
+
+```javascript
+msg.payload = {
+    action: "generateTestData",
+    pattern: "incrementing",      // incrementing, random, sine, square, alternating
+    dataType: "holdingRegisters", // coils, discreteInputs, holdingRegisters, inputRegisters
     address: 0,
-    values: [1, 2, 3, 4, 5]    // Array van waarden
-}
+    quantity: 100
+};
 ```
 
-## Ondersteunde MODBUS Functies
+## Configuratie-opties
 
-| Functie | Code | Beschrijving | Status |
-|---------|------|--------------|--------|
-| Read Coils | 01 | Leest discrete outputs | ✅ |
-| Read Discrete Inputs | 02 | Leest discrete inputs | ✅ |
-| Read Holding Registers | 03 | Leest holding registers | ✅ |
-| Read Input Registers | 04 | Leest input registers | ✅ |
-| Write Single Coil | 05 | Schrijft één coil | ✅ |
-| Write Single Register | 06 | Schrijft één register | ✅ |
-| Write Multiple Coils | 15 | Schrijft meerdere coils | ✅ |
-| Write Multiple Registers | 16 | Schrijft meerdere registers | ✅ |
+### TCP
 
-## Configuratie Opties
+- **TCP Mode** – Client of Server
+- **Host** – IP-adres (alleen bij Client)
+- **Port** – Standaard 502
+- **Reconnect Interval** – Interval bij verbindingsverlies (ms)
+- **Connection Timeout** – Timeout verbinding (ms)
+- **Max Connections** – Max. verbindingen (alleen Server)
 
-### TCP Instellingen
+### MODBUS
 
-- **TCP Mode**: Client of Server
-- **Host**: IP-adres (alleen Client mode)
-- **Port**: TCP poort (standaard 502)
-- **Reconnect Interval**: Interval voor reconnect bij verbindingsverlies (ms)
-- **Connection Timeout**: Timeout voor verbinding (ms)
-- **Max Connections**: Maximum aantal verbindingen (alleen Server mode)
+- **MODBUS Mode** – Client of Server
+- **Unit ID** – 0–255
+- **Accept Any Unit ID** – (alleen Server) Accepteer elke Unit ID
+- **Byte Order** – Big Endian of Little Endian
+- **Address Offset** – 0 (0-based) of 1 (1-based)
 
-### MODBUS Instellingen
+### Client
 
-- **MODBUS Mode**: Client of Server
-- **Unit ID**: MODBUS Unit ID (0-255)
-- **Byte Order**: Big Endian of Little Endian
-- **Address Offset**: 0 (0-based) of 1 (1-based addressing)
+- **Request Timeout** – Timeout per request (ms)
+- **Retry Count** – Aantal retries
+- **Retry Interval** – Interval tussen retries (ms)
 
-### Client Instellingen
+### Dataweergave
 
-- **Request Timeout**: Timeout voor requests (ms)
-- **Retry Count**: Aantal retries bij fouten
-- **Retry Interval**: Interval tussen retries (ms)
+- **Toon Data in Status** – Laatste waarden in node-status
+- **Debug Mode** – Log data naar debug panel
 
-## Input/Output Format
+### Testdata (alleen Server)
 
-### Input (Client Mode)
+- **Genereer Test Data bij Start** – Vul bij start automatisch holding- en inputregisters (0–99)
+- **Test Data Patroon** – incrementing, random, sine, square, alternating
 
-```javascript
-{
-    function: 1-24,              // MODBUS functie code
-    address: 0,                  // Start adres
-    quantity: 10,                // Aantal registers/coils (voor read)
-    value: 123,                  // Single value (voor write)
-    values: [1, 2, 3],           // Multiple values (voor write)
-    unitId: 1,                   // Optioneel: Unit ID override
-    timeout: 5000                // Optioneel: Timeout override
-}
-```
+## Ondersteunde MODBUS-functies
 
-### Output (Client Mode)
+| Functie                    | Code | Beschrijving              |
+|----------------------------|------|---------------------------|
+| Read Coils                 | 01   | Leest discrete outputs    |
+| Read Discrete Inputs       | 02   | Leest discrete inputs     |
+| Read Holding Registers     | 03   | Leest holding registers   |
+| Read Input Registers      | 04   | Leest input registers     |
+| Write Single Coil          | 05   | Schrijft één coil         |
+| Write Single Register      | 06   | Schrijft één register     |
+| Write Multiple Coils      | 15   | Schrijft meerdere coils   |
+| Write Multiple Registers  | 16   | Schrijft meerdere registers |
 
-```javascript
-{
-    function: 3,                 // MODBUS functie code
-    address: 0,                  // Start adres
-    quantity: 10,                // Aantal gelezen items
-    data: [1, 2, 3, ...],       // Gelezen data array
-    timestamp: Date,             // Response timestamp
-    responseTime: 45             // Response tijd in ms
-}
-```
+## Input/Output-formaat
 
-### Error Output
+### Input (Client – normale requests)
 
-```javascript
-{
-    error: {
-        code: 2,                 // Exception code
-        message: "Illegal Data Address",
-        function: 3,             // Requested functie
-        address: 0               // Requested adres
-    }
-}
-```
+`msg.payload` of top-level: `function`, `address`, `quantity` (read), `value` of `values` (write), optioneel `unitId`, `timeout`.
 
-## Adresbereik
+### Output (Client – succes)
 
-- **Coils**: 0 - 65535
-- **Discrete Inputs**: 0 - 65535
-- **Holding Registers**: 0 - 65535
-- **Input Registers**: 0 - 65535
+`msg.payload`: `function`, `address`, `quantity`, `data` (array), `timestamp`, `responseTime`.
 
-## Troubleshooting
+### Output (fout)
 
-### Verbindingsproblemen
+`msg.error`: `code`, `message`, `function`, `address`.
 
-- Controleer of de host en poort correct zijn geconfigureerd
-- Controleer firewall instellingen
-- Controleer of de MODBUS server actief is
+### Speciale acties – output
 
-### Timeout Errors
+- **readData** – `payload.action`, `payload.type`, `payload.address`, `payload.quantity`, `payload.data`, `payload.dataMap`
+- **showData** – `payload.action`, `payload.summary` (per type: coils, discreteInputs, holdingRegisters, inputRegisters)
+- **generateTestData** – `payload.action`, `payload.result` (pattern, dataType, startAddress, quantity, values sample)
+
+## Adresbereik
 
-- Verhoog de request timeout waarde
-- Controleer netwerk latency
-- Controleer of de MODBUS server reageert
+- Coils: 0–65535  
+- Discrete Inputs: 0–65535  
+- Holding Registers: 0–65535  
+- Input Registers: 0–65535  
 
-### Exception Codes
+## Troubleshooting
 
-- **01**: Illegal Function - Functie code niet ondersteund
-- **02**: Illegal Data Address - Adres buiten bereik
-- **03**: Illegal Data Value - Ongeldige waarde
-- **04**: Server Device Failure - Server fout
+- **Geen verbinding** – Controleer host, poort en firewall; controleer of de MODBUS server draait.
+- **Timeout** – Verhoog Request Timeout; controleer netwerk en server.
+- **Exception 01/02/03/04** – Controleer functiecode, adres en waarden; controleer Unit ID (of zet Accept Any Unit ID aan op de server).
 
 ## Licentie
 
@@ -222,8 +211,19 @@ MIT
 
 ## Auteur
 
-ModBUSTester Project
+ModBUSTester Project (AVD)
+
+## Changelog
+
+### 1.1.0
+
+- Dataweergave: Toon Data in Status, Debug Mode
+- Server: testdata (automatisch bij start + actie generateTestData), patronen: incrementing, random, sine, square, alternating
+- Speciale acties: readData, showData, generateTestData
+- Server: optie Accept Any Unit ID
+- Bufferfix voor Write Single Register/Coil (PDU 5 bytes)
+- Response-buffering voor incomplete TCP-frames
 
-## Versie
+### 1.0.0
 
-1.0.0
+- Eerste release: MODBUS TCP client/server, alle basis functies 01–16, volledig adresbereik

package/modbus-tcp.html

@@ -12,6 +12,7 @@
             maxConnections: { value: 10, required: true, validate: RED.validators.number() },
             modbusMode: { value: "client", required: true },
             unitId: { value: 1, required: true, validate: function(v) { return v >= 0 && v <= 255; } },
+            acceptAnyUnitId: { value: false, required: false },
             byteOrder: { value: "bigEndian", required: true },
             addressOffset: { value: 0, required: true, validate: RED.validators.number() },
             requestTimeout: { value: 5000, required: true, validate: RED.validators.number() },
@@ -33,6 +34,13 @@
         },
         oneditprepare: function() {
             // Show/hide fields based on TCP mode
+            function updateServerOnlyVisibility() {
+                var tcpMode = $("#node-input-tcpMode").val();
+                var modbusMode = $("#node-input-modbusMode").val();
+                var isServer = (tcpMode === "server" && modbusMode === "server");
+                $("#node-input-acceptAnyUnitId-row").toggle(isServer);
+            }
+            
             $("#node-input-tcpMode").on("change", function() {
                 var tcpMode = $(this).val();
                 if (tcpMode === "client") {
@@ -42,6 +50,7 @@
                     $("#node-input-host-row").hide();
                     $("#node-input-maxConnections-row").show();
                 }
+                updateServerOnlyVisibility();
             });
             
             // Show/hide fields based on MODBUS mode
@@ -56,6 +65,7 @@
                     $("#node-input-retryCount-row").hide();
                     $("#node-input-retryInterval-row").hide();
                 }
+                updateServerOnlyVisibility();
             });
             
             // Trigger initial visibility
@@ -125,6 +135,12 @@
         <input type="number" id="node-input-unitId" placeholder="1" min="0" max="255">
     </div>
     
+    <div class="form-row" id="node-input-acceptAnyUnitId-row">
+        <label for="node-input-acceptAnyUnitId"><i class="fa fa-check-circle"></i> Alle Unit IDs accepteren</label>
+        <input type="checkbox" id="node-input-acceptAnyUnitId" style="width: auto; vertical-align: top;">
+        <label for="node-input-acceptAnyUnitId" style="width: 70%; display: inline-block;">(Server) Accepteer elk Unit ID; anders alleen geconfigureerd Unit ID en 0</label>
+    </div>
+    
     <div class="form-row">
         <label for="node-input-byteOrder"><i class="fa fa-sort"></i> Byte Order</label>
         <select id="node-input-byteOrder">

package/modbus-tcp.js

@@ -379,7 +379,7 @@ module.exports = function(RED) {
 
                 socket.on('data', (data) => {
                     buffer = Buffer.concat([buffer, data]);
-                    this.processRequest(socket, buffer, clientId);
+                    buffer = this.processRequest(socket, buffer, clientId);
                 });
 
                 socket.on('error', (err) => {
@@ -410,7 +410,7 @@ module.exports = function(RED) {
                 const expectedLength = 7 + mbap.length - 1; // -1 because unitId is included in length
 
                 if (buffer.length < expectedLength) {
-                    return; // Wait for more data
+                    return buffer; // Wait for more data
                 }
 
                 const pdu = buffer.slice(7, expectedLength);
@@ -424,10 +424,11 @@ module.exports = function(RED) {
                     this.node.error(`Error processing request: ${err.message}`);
                 }
             }
+            return buffer;
         }
 
         handleModbusRequest(pdu, unitId) {
-            if (unitId !== this.config.unitId && unitId !== 0) {
+            if (!this.config.acceptAnyUnitId && unitId !== this.config.unitId && unitId !== 0) {
                 return this.buildExceptionResponse(pdu[0], 0x0A); // Gateway Target Device Failed
             }
 
@@ -807,6 +808,7 @@ module.exports = function(RED) {
             maxConnections: config.maxConnections || 10,
             modbusMode: config.modbusMode || "client",
             unitId: config.unitId || 1,
+            acceptAnyUnitId: config.acceptAnyUnitId === true,
             byteOrder: config.byteOrder || "bigEndian",
             addressOffset: config.addressOffset || 0,
             requestTimeout: config.requestTimeout || 5000,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-modbus-tcp-full-avd",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Volledige MODBUS TCP node voor Node-RED met ondersteuning voor alle functies en adresbereik",
   "main": "modbus-tcp.js",
   "scripts": {