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

package/README.md

@@ -0,0 +1,229 @@
+# 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).
+
+## 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
+
+## 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"
+
+### Via NPM
+
+```bash
+npm install node-red-contrib-modbus-tcp-full-avd
+```
+
+### 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
+
+## Gebruik
+
+### TCP Client + MODBUS Client (Meest Voorkomend)
+
+Deze combinatie wordt gebruikt 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)
+
+#### Voorbeeld: Read Holding Registers
+
+```javascript
+msg = {
+    function: 3,
+    address: 0,
+    quantity: 10
+}
+```
+
+#### Voorbeeld: Write Single Register
+
+```javascript
+msg = {
+    function: 6,
+    address: 0,
+    value: 1234
+}
+```
+
+#### Voorbeeld: Write Multiple Coils
+
+```javascript
+msg = {
+    function: 15,
+    address: 0,
+    values: [true, false, true, false]
+}
+```
+
+### TCP Server + MODBUS Server
+
+Deze combinatie wordt gebruikt 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
+
+#### Data Update
+
+```javascript
+msg = {
+    type: "holdingRegisters",  // coils, discreteInputs, holdingRegisters, inputRegisters
+    address: 0,
+    value: 1234                 // Single value
+}
+```
+
+Of voor meerdere waarden:
+
+```javascript
+msg = {
+    type: "holdingRegisters",
+    address: 0,
+    values: [1, 2, 3, 4, 5]    // Array van waarden
+}
+```
+
+## Ondersteunde MODBUS Functies
+
+| 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 | ✅ |
+
+## Configuratie Opties
+
+### TCP Instellingen
+
+- **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 Instellingen
+
+- **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)
+
+### Client Instellingen
+
+- **Request Timeout**: Timeout voor requests (ms)
+- **Retry Count**: Aantal retries bij fouten
+- **Retry Interval**: Interval tussen retries (ms)
+
+## Input/Output Format
+
+### Input (Client Mode)
+
+```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
+}
+```
+
+### Output (Client Mode)
+
+```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
+}
+```
+
+### Error Output
+
+```javascript
+{
+    error: {
+        code: 2,                 // Exception code
+        message: "Illegal Data Address",
+        function: 3,             // Requested functie
+        address: 0               // Requested adres
+    }
+}
+```
+
+## Adresbereik
+
+- **Coils**: 0 - 65535
+- **Discrete Inputs**: 0 - 65535
+- **Holding Registers**: 0 - 65535
+- **Input Registers**: 0 - 65535
+
+## Troubleshooting
+
+### Verbindingsproblemen
+
+- Controleer of de host en poort correct zijn geconfigureerd
+- Controleer firewall instellingen
+- Controleer of de MODBUS server actief is
+
+### Timeout Errors
+
+- Verhoog de request timeout waarde
+- Controleer netwerk latency
+- Controleer of de MODBUS server reageert
+
+### Exception Codes
+
+- **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
+
+## Licentie
+
+MIT
+
+## Auteur
+
+ModBUSTester Project
+
+## Versie
+
+1.0.0

package/modbus-tcp.html

@@ -0,0 +1,312 @@
+<script type="text/javascript">
+    RED.nodes.registerType('modbus-tcp-avd', {
+        category: 'network',
+        color: '#E6E0F8',
+        defaults: {
+            name: { value: "" },
+            tcpMode: { value: "client", required: true },
+            host: { value: "127.0.0.1", required: false },
+            port: { value: 502, required: true, validate: RED.validators.number() },
+            reconnectInterval: { value: 5000, required: true, validate: RED.validators.number() },
+            connectionTimeout: { value: 10000, required: true, validate: RED.validators.number() },
+            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; } },
+            byteOrder: { value: "bigEndian", required: true },
+            addressOffset: { value: 0, required: true, validate: RED.validators.number() },
+            requestTimeout: { value: 5000, required: true, validate: RED.validators.number() },
+            retryCount: { value: 3, required: true, validate: RED.validators.number() },
+            retryInterval: { value: 1000, required: true, validate: RED.validators.number() },
+            showData: { value: false, required: false },
+            debugMode: { value: false, required: false },
+            generateTestData: { value: false, required: false },
+            testDataPattern: { value: "incrementing", required: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "bridge.png",
+        label: function() {
+            return this.name || "modbus-tcp-avd";
+        },
+        labelStyle: function() {
+            return this.name ? "node_label_italic" : "";
+        },
+        oneditprepare: function() {
+            // Show/hide fields based on TCP mode
+            $("#node-input-tcpMode").on("change", function() {
+                var tcpMode = $(this).val();
+                if (tcpMode === "client") {
+                    $("#node-input-host-row").show();
+                    $("#node-input-maxConnections-row").hide();
+                } else {
+                    $("#node-input-host-row").hide();
+                    $("#node-input-maxConnections-row").show();
+                }
+            });
+            
+            // Show/hide fields based on MODBUS mode
+            $("#node-input-modbusMode").on("change", function() {
+                var modbusMode = $(this).val();
+                if (modbusMode === "client") {
+                    $("#node-input-requestTimeout-row").show();
+                    $("#node-input-retryCount-row").show();
+                    $("#node-input-retryInterval-row").show();
+                } else {
+                    $("#node-input-requestTimeout-row").hide();
+                    $("#node-input-retryCount-row").hide();
+                    $("#node-input-retryInterval-row").hide();
+                }
+            });
+            
+            // Trigger initial visibility
+            $("#node-input-tcpMode").trigger("change");
+            $("#node-input-modbusMode").trigger("change");
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="modbus-tcp-avd">
+    <div class="form-row">
+        <label for="node-input-name"><i class="icon-tag"></i> Naam</label>
+        <input type="text" id="node-input-name" placeholder="Naam">
+    </div>
+    
+    <div class="form-tips">
+        <b>TCP Instellingen</b>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-tcpMode"><i class="fa fa-exchange"></i> TCP Mode</label>
+        <select id="node-input-tcpMode">
+            <option value="client">Client</option>
+            <option value="server">Server</option>
+        </select>
+    </div>
+    
+    <div class="form-row" id="node-input-host-row">
+        <label for="node-input-host"><i class="fa fa-server"></i> Host</label>
+        <input type="text" id="node-input-host" placeholder="127.0.0.1">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-port"><i class="fa fa-plug"></i> Poort</label>
+        <input type="number" id="node-input-port" placeholder="502" min="1" max="65535">
+    </div>
+    
+    <div class="form-row" id="node-input-reconnectInterval-row">
+        <label for="node-input-reconnectInterval"><i class="fa fa-refresh"></i> Reconnect Interval (ms)</label>
+        <input type="number" id="node-input-reconnectInterval" placeholder="5000" min="1000">
+    </div>
+    
+    <div class="form-row" id="node-input-connectionTimeout-row">
+        <label for="node-input-connectionTimeout"><i class="fa fa-clock-o"></i> Connection Timeout (ms)</label>
+        <input type="number" id="node-input-connectionTimeout" placeholder="10000" min="1000">
+    </div>
+    
+    <div class="form-row" id="node-input-maxConnections-row">
+        <label for="node-input-maxConnections"><i class="fa fa-users"></i> Max Verbindingen</label>
+        <input type="number" id="node-input-maxConnections" placeholder="10" min="1" max="100">
+    </div>
+    
+    <div class="form-tips">
+        <b>MODBUS Instellingen</b>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-modbusMode"><i class="fa fa-exchange"></i> MODBUS Mode</label>
+        <select id="node-input-modbusMode">
+            <option value="client">Client</option>
+            <option value="server">Server</option>
+        </select>
+    </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" placeholder="1" min="0" max="255">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-byteOrder"><i class="fa fa-sort"></i> Byte Order</label>
+        <select id="node-input-byteOrder">
+            <option value="bigEndian">Big Endian</option>
+            <option value="littleEndian">Little Endian</option>
+        </select>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-addressOffset"><i class="fa fa-map-marker"></i> Address Offset</label>
+        <input type="number" id="node-input-addressOffset" placeholder="0" min="0" max="1">
+        <span class="form-tips">0 = 0-based, 1 = 1-based addressing</span>
+    </div>
+    
+    <div class="form-tips">
+        <b>Client Instellingen</b>
+    </div>
+    
+    <div class="form-row" id="node-input-requestTimeout-row">
+        <label for="node-input-requestTimeout"><i class="fa fa-hourglass-half"></i> Request Timeout (ms)</label>
+        <input type="number" id="node-input-requestTimeout" placeholder="5000" min="1000">
+    </div>
+    
+    <div class="form-row" id="node-input-retryCount-row">
+        <label for="node-input-retryCount"><i class="fa fa-repeat"></i> Retry Count</label>
+        <input type="number" id="node-input-retryCount" placeholder="3" min="0" max="10">
+    </div>
+    
+    <div class="form-row" id="node-input-retryInterval-row">
+        <label for="node-input-retryInterval"><i class="fa fa-clock-o"></i> Retry Interval (ms)</label>
+        <input type="number" id="node-input-retryInterval" placeholder="1000" min="100">
+    </div>
+    
+    <div class="form-tips">
+        <b>Data Weergave</b>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-showData"><i class="fa fa-eye"></i> Toon Data in Status</label>
+        <input type="checkbox" id="node-input-showData" style="width: auto; vertical-align: top;">
+        <label for="node-input-showData" style="width: 70%; display: inline-block;">Toon laatste register waarden in node status</label>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-debugMode"><i class="fa fa-bug"></i> Debug Mode</label>
+        <input type="checkbox" id="node-input-debugMode" style="width: auto; vertical-align: top;">
+        <label for="node-input-debugMode" style="width: 70%; display: inline-block;">Log alle data naar debug panel</label>
+    </div>
+    
+    <div class="form-tips" id="node-input-testData-section" style="display: none;">
+        <b>Test Data (Server Mode)</b>
+    </div>
+    
+    <div class="form-row" id="node-input-generateTestData-row" style="display: none;">
+        <label for="node-input-generateTestData"><i class="fa fa-flask"></i> Genereer Test Data bij Start</label>
+        <input type="checkbox" id="node-input-generateTestData" style="width: auto; vertical-align: top;">
+        <label for="node-input-generateTestData" style="width: 70%; display: inline-block;">Vul registers automatisch met testdata</label>
+    </div>
+    
+    <div class="form-row" id="node-input-testDataPattern-row" style="display: none;">
+        <label for="node-input-testDataPattern"><i class="fa fa-chart-line"></i> Test Data Patroon</label>
+        <select id="node-input-testDataPattern">
+            <option value="incrementing">Incrementing (0, 1, 2, 3...)</option>
+            <option value="random">Random (0-65535)</option>
+            <option value="sine">Sine Wave</option>
+            <option value="square">Square Wave</option>
+            <option value="alternating">Alternating (0, 1, 0, 1...)</option>
+        </select>
+    </div>
+    
+    <script type="text/javascript">
+        // Show/hide test data options based on MODBUS mode
+        $("#node-input-modbusMode").on("change", function() {
+            var modbusMode = $(this).val();
+            if (modbusMode === "server") {
+                $("#node-input-testData-section").show();
+                $("#node-input-generateTestData-row").show();
+                $("#node-input-testDataPattern-row").show();
+            } else {
+                $("#node-input-testData-section").hide();
+                $("#node-input-generateTestData-row").hide();
+                $("#node-input-testDataPattern-row").hide();
+            }
+        });
+    </script>
+
+<script type="text/html" data-help-name="modbus-tcp-avd">
+    <p>Volledige MODBUS TCP node met ondersteuning voor alle MODBUS functies en het volledige adresbereik.</p>
+    
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object</span></dt>
+        <dd>MODBUS request object met de volgende eigenschappen:</dd>
+        <dd>
+            <ul>
+                <li><code>function</code> - MODBUS functie code (1-24)</li>
+                <li><code>address</code> - Start adres (0-65535)</li>
+                <li><code>quantity</code> - Aantal registers/coils (voor read operaties)</li>
+                <li><code>value</code> - Waarde (voor single write operaties)</li>
+                <li><code>values</code> - Array van waarden (voor multiple write operaties)</li>
+                <li><code>unitId</code> - Optioneel: Unit ID override</li>
+                <li><code>timeout</code> - Optioneel: Timeout override</li>
+            </ul>
+        </dd>
+    </dl>
+    
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object</span></dt>
+        <dd>MODBUS response object met de volgende eigenschappen:</dd>
+        <dd>
+            <ul>
+                <li><code>function</code> - MODBUS functie code</li>
+                <li><code>address</code> - Start adres</li>
+                <li><code>data</code> - Gelezen data array</li>
+                <li><code>error</code> - Error object indien fout opgetreden</li>
+            </ul>
+        </dd>
+    </dl>
+    
+    <h3>Details</h3>
+    <p>Deze node ondersteunt:</p>
+    <ul>
+        <li>TCP Client en Server modes</li>
+        <li>MODBUS Client en Server modes</li>
+        <li>Alle MODBUS functie codes (01-24)</li>
+        <li>Volledige adresbereik (0-65535)</li>
+        <li>Automatische reconnect en retry mechanismen</li>
+    </ul>
+    
+    <h3>Voorbeelden</h3>
+    <h4>Read Holding Registers</h4>
+    <pre><code>{
+    "function": 3,
+    "address": 0,
+    "quantity": 10
+}</code></pre>
+    
+    <h4>Write Single Register</h4>
+    <pre><code>{
+    "function": 6,
+    "address": 0,
+    "value": 1234
+}</code></pre>
+    
+    <h4>Write Multiple Coils</h4>
+    <pre><code>{
+    "function": 15,
+    "address": 0,
+    "values": [true, false, true, false]
+}</code></pre>
+    
+    <h4>Toon Alle Register Data (Server Mode)</h4>
+    <pre><code>{
+    "action": "showData"
+}</code></pre>
+    <p>Geeft een overzicht van alle register data in de server.</p>
+    
+    <h4>Lees en Toon Register Data (Client Mode)</h4>
+    <pre><code>{
+    "action": "readData",
+    "readType": "holdingRegisters",
+    "address": 0,
+    "quantity": 10
+}</code></pre>
+    <p>Leest register data en geeft deze terug met een dataMap. readType kan zijn: "coils", "discreteInputs", "holdingRegisters", of "inputRegisters".</p>
+    
+    <h4>Genereer Test Data (Server Mode)</h4>
+    <pre><code>{
+    "action": "generateTestData",
+    "pattern": "incrementing",
+    "dataType": "holdingRegisters",
+    "address": 0,
+    "quantity": 100
+}</code></pre>
+    <p>Genereert testdata in de server registers. Patronen: "incrementing", "random", "sine", "square", "alternating". Data types: "coils", "discreteInputs", "holdingRegisters", "inputRegisters".</p>
+    
+    <h3>Data Weergave</h3>
+    <p>De node kan register data op verschillende manieren zichtbaar maken:</p>
+    <ul>
+        <li><b>Status Weergave</b>: Schakel "Toon Data in Status" in om de laatste waarden in de node status te zien</li>
+        <li><b>Debug Mode</b>: Schakel "Debug Mode" in om alle data naar het debug panel te loggen</li>
+        <li><b>Show Data Actie</b>: Gebruik <code>{"action": "showData"}</code> om alle server register data te bekijken</li>
+    </ul>
+</script>