@vitormnm/node-red-instructions-ladder-iec-61131-3 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vitor Mião
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# @vitormnm/node-red-instructions-ladder-IEC-61131-3
+
+A Node-RED node that provides common **IEC 61131-3 Ladder Logic instructions** for building PLC-style logic flows directly inside Node-RED.
+
+## Features
+
+### Contacts
+
+| Instruction | Description                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| NO          | Normally Open contact. Passes execution when the source value is `true`.    |
+| NC          | Normally Closed contact. Passes execution when the source value is `false`. |
+
+### Comparison Instructions
+
+| Instruction | Description                  |
+| ----------- | ---------------------------- |
+| EQ          | Equal (`==`)                 |
+| NEQ         | Not Equal (`!=`)             |
+| GT          | Greater Than (`>`)           |
+| GE          | Greater Than or Equal (`>=`) |
+| LT          | Less Than (`<`)              |
+| LE          | Less Than or Equal (`<=`)    |
+
+### Math Instructions
+
+| Instruction | Description    |
+| ----------- | -------------- |
+| ADD         | Addition       |
+| SUB         | Subtraction    |
+| MUL         | Multiplication |
+| DIV         | Division       |
+| MOD         | Modulus        |
+| ABS         | Absolute value |
+| SQR         | Square root    |
+| MOV         | Move value     |
+
+### Output Instructions
+
+| Instruction | Description                              |
+| ----------- | ---------------------------------------- |
+| SET         | Sets the destination variable to `true`  |
+| RESET       | Sets the destination variable to `false` |
+
+---
+
+## Supported Data Sources
+
+Input values can be read from:
+
+* `msg`
+* `flow`
+* `global`
+* Numeric constants
+* Boolean constants
+* String constants
+
+Output values can be written to:
+
+* `msg`
+* `flow`
+* `global`
+
+---
+
+## Status Display
+
+The node provides a compact real-time status display similar to PLC ladder diagnostics.
+
+Examples:
+
+```text
+NO motor_run(true)→TRUE
+
+GT temp(85)>limit(80)→TRUE
+
+ADD a(10)+b(5)→result=15
+
+DIV x(9)/y(0)→÷0ERR
+
+SET →motor=TRUE
+
+RST →alarm=FALSE
+```
+
+The status indicator also changes color:
+
+* Green = instruction result is TRUE
+* Gray = instruction result is FALSE
+* Red = execution error
+
+---
+
+## Example
+
+### Greater Than Comparison
+
+```text
+Source A: msg.temperature
+Source B: msg.limit
+
+Instruction: GT
+```
+
+Input:
+
+```json
+{
+  "temperature": 85,
+  "limit": 80
+}
+```
+
+Result:
+
+```json
+{
+  "ladder": {
+    "func": "GT",
+    "result": true
+  }
+}
+```
+
+---
+
+### Addition
+
+```text
+Source A: msg.value1
+Source B: msg.value2
+
+Instruction: ADD
+Destination: msg.result
+```
+
+Input:
+
+```json
+{
+  "value1": 10,
+  "value2": 5
+}
+```
+
+Output:
+
+```json
+{
+  "value1": 10,
+  "value2": 5,
+  "result": 15
+}
+```
+
+---
+
+## IEC 61131-3 Inspired
+
+This node is inspired by the instruction set commonly found in PLC programming environments implementing the IEC 61131-3 standard.
+
+It allows Node-RED users to create ladder-style logic using familiar industrial automation instructions without requiring a PLC.
+
+---
+
+## Installation
+
+```bash
+npm install node-red-contrib-iec61131-ladder
+```
+
+Restart Node-RED after installation.
+
+---
+
+## License
+
+MIT

package/icons/ladder-climb-icon.svg

@@ -0,0 +1,23 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="512.000000pt" height="512.000000pt" viewBox="0 0 512.000000 512.000000"
+ preserveAspectRatio="xMidYMid meet">
+
+<g transform="translate(0.000000,512.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M4200 5111 c-65 -20 -131 -74 -161 -131 -7 -14 -60 -216 -118 -450
+-98 -394 -108 -426 -131 -437 -32 -16 -1633 -19 -1674 -3 -55 20 -54 32 29
+371 83 338 87 375 50 453 -86 181 -349 195 -449 24 -33 -56 -1149 -4606 -1149
+-4683 0 -108 73 -207 176 -241 116 -39 251 17 307 126 9 19 66 235 125 480 92
+379 112 448 132 467 l24 23 825 0 c543 0 832 -3 844 -10 45 -24 44 -32 -46
+-402 -92 -379 -96 -413 -59 -492 86 -181 349 -195 449 -24 33 56 1149 4606
+1149 4683 0 106 -72 206 -171 239 -48 17 -110 19 -152 7z m-534 -1527 c17 -25
+15 -35 -56 -327 -101 -418 -93 -394 -138 -407 -25 -8 -288 -10 -848 -8 -782 3
+-813 4 -833 22 -12 11 -21 29 -21 41 0 18 136 592 156 657 15 50 -26 48 879
+48 l845 0 16 -26z m-321 -1220 c40 -16 36 -43 -51 -401 -48 -193 -93 -356
+-101 -365 -15 -17 -69 -18 -855 -18 -825 0 -838 0 -858 20 -11 11 -20 29 -20
+39 0 35 162 686 176 709 l14 22 839 0 c462 0 847 -3 856 -6z"/>
+</g>
+</svg>

package/icons/ladder.svg

@@ -0,0 +1,20 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="512.000000pt" height="512.000000pt" viewBox="0 0 512.000000 512.000000"
+ preserveAspectRatio="xMidYMid meet">
+
+<g transform="translate(0.000000,512.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M1347 5098 c-22 -13 -45 -38 -57 -63 -20 -41 -20 -60 -18 -2488 l3
+-2446 21 -28 c11 -15 41 -38 66 -51 55 -28 104 -23 149 15 57 48 59 60 59 328
+l0 245 990 0 990 0 0 -246 c0 -271 4 -294 62 -335 72 -52 179 -25 217 55 l21
+43 -2 2446 -3 2446 -21 28 c-11 15 -41 38 -66 51 -55 28 -104 23 -149 -15 -57
+-48 -59 -59 -59 -333 l0 -250 -990 0 -990 0 0 251 c0 211 -3 256 -16 285 -36
+75 -135 105 -207 62z m2203 -1193 l0 -295 -990 0 -990 0 0 295 0 295 990 0
+990 0 0 -295z m0 -895 l0 -300 -990 0 -990 0 0 300 0 300 990 0 990 0 0 -300z
+m0 -900 l0 -300 -990 0 -990 0 0 300 0 300 990 0 990 0 0 -300z m0 -900 l0
+-300 -990 0 -990 0 0 300 0 300 990 0 990 0 0 -300z"/>
+</g>
+</svg>

package/instructions_ladder_IEC_61131_3.html

@@ -0,0 +1,218 @@
+<!-- ═══════════════════════════════════════════════════════════════════════
+     Node Registration
+     ═══════════════════════════════════════════════════════════════════════ -->
+<script type="text/javascript">
+
+    var LADDER_META = {
+        NO:   { srcA: true,  srcB: false, dest: false, category: 'Contact'    },
+        NC:   { srcA: true,  srcB: false, dest: false, category: 'Contact'    },
+        EQ:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        NEQ:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        GT:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        GE:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        LT:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        LE:   { srcA: true,  srcB: true,  dest: false, category: 'Compare'    },
+        ADD:   { srcA: true,  srcB: true,  dest: true,  category: 'Math'       },
+        SUB:   { srcA: true,  srcB: true,  dest: true,  category: 'Math'       },
+        MUL:   { srcA: true,  srcB: true,  dest: true,  category: 'Math'       },
+        DIV:   { srcA: true,  srcB: true,  dest: true,  category: 'Math'       },
+        MOD:   { srcA: true,  srcB: true,  dest: true,  category: 'Math'       },
+        MOV:   { srcA: true,  srcB: false, dest: true,  category: 'Math'       },
+        ABS:   { srcA: true,  srcB: false, dest: true,  category: 'Math'       },
+        SQR:   { srcA: true,  srcB: false, dest: true,  category: 'Math'       },
+        SET:   { srcA: false, srcB: false, dest: true,  category: 'Coil'       },
+        RESET: { srcA: false, srcB: false, dest: true,  category: 'Coil'       }
+    };
+
+    RED.nodes.registerType('instructions-ladder-IEC-61131-3', {
+        category:  'function',
+        color:     '#C0392B',
+        defaults: {
+            name:       { value: '' },
+            ladderFunc: { value: 'NO' },
+            srcA:       { value: 'payload', validate: function(v) {
+                var meta = LADDER_META[$('#node-input-ladderFunc').val()] || {};
+                return !meta.srcA || (v !== undefined && v !== '');
+            }},
+            srcAType:   { value: 'msg' },
+            srcB:       { value: 'payload', validate: function(v) {
+                var meta = LADDER_META[$('#node-input-ladderFunc').val()] || {};
+                return !meta.srcB || (v !== undefined && v !== '');
+            }},
+            srcBType:   { value: 'msg' },
+            dest:       { value: 'payload', validate: function(v) {
+                var meta = LADDER_META[$('#node-input-ladderFunc').val()] || {};
+                return !meta.dest || (v !== undefined && v !== '');
+            }},
+            destType:   { value: 'msg' }
+        },
+        inputs:  1,
+        outputs: 1,
+        icon:    'ladder.svg',
+        paletteLabel: 'ladder iec',
+
+        label: function () {
+            return this.name || (this.ladderFunc);
+        },
+
+        labelStyle: function () {
+            return this.name ? 'node_label_italic' : '';
+        },
+
+        oneditprepare: function () {
+            $('#node-input-srcA').typedInput({
+                typeField: '#node-input-srcAType',
+                types: ['msg', 'flow', 'global', 'num', 'bool', 'str']
+            });
+            $('#node-input-srcB').typedInput({
+                typeField: '#node-input-srcBType',
+                types: ['msg', 'flow', 'global', 'num', 'bool', 'str']
+            });
+            $('#node-input-dest').typedInput({
+                typeField: '#node-input-destType',
+                types: ['msg', 'flow', 'global']
+            });
+
+            function updateFields() {
+                var fn   = $('#node-input-ladderFunc').val();
+                var meta = LADDER_META[fn] || {};
+                $('#row-srcA').toggle(!!meta.srcA);
+                $('#row-srcB').toggle(!!meta.srcB);
+                $('#row-dest').toggle(!!meta.dest);
+                $('#ladder-category').text(meta.category ? '[' + meta.category + ']' : '');
+            }
+
+            $('#node-input-ladderFunc').on('change', updateFields);
+            updateFields();
+        }
+    });
+</script>
+
+<!-- ═══════════════════════════════════════════════════════════════════════
+     Edit Dialog
+     ═══════════════════════════════════════════════════════════════════════ -->
+<script type="text/html" data-template-name="instructions-ladder-IEC-61131-3">
+
+    <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 (optional)">
+    </div>
+
+    <hr/>
+
+    <div class="form-row">
+        <label for="node-input-ladderFunc"><i class="fa fa-microchip"></i> Instruction</label>
+        <select id="node-input-ladderFunc" style="width:70%;">
+            <optgroup label="── Contacts ──">
+                <option value="NO">-||- Normally Open Contact </option>
+                <option value="NC">-|/|- Normally Closed Contact</option>
+            </optgroup>
+            <optgroup label="── Comparators ──">
+                <option value="EQ">EQ – EQal            (A == B)</option>
+                <option value="NEQ">NEQ – Not EQal        (A != B)</option>
+                <option value="GT">GT – Greater Than     (A &gt; B)</option>
+                <option value="GE">GE – Greater or EQal (A &gt;= B)</option>
+                <option value="LT">LT – LTs Than        (A &lt; B)</option>
+                <option value="LE">LE – LTs or EQal    (A &lt;= B)</option>
+            </optgroup>
+            <optgroup label="── Math ──">
+                <option value="ADD">ADD – Add              (A + B → dest)</option>
+                <option value="SUB">SUB – Subtract         (A - B → dest)</option>
+                <option value="MUL">MUL – Multiply         (A * B → dest)</option>
+                <option value="DIV">DIV – Divide           (A / B → dest)</option>
+                <option value="MOD">MOD – Modulo           (A % B → dest)</option>
+                <option value="MOV">MOV – Move             (A → dest)</option>
+                <option value="ABS">ABS – Absolute Value   (|A| → dest)</option>
+                <option value="SQR">SQR – Square Root      (√A → dest)</option>
+            </optgroup>
+            <optgroup label="── Output Coils ──">
+                <option value="SET">-(S)- Set/Latch</option>
+                <option value="RESET">-(R)- Reset/Unlatch</option>
+            </optgroup>
+        </select>
+        <span id="ladder-category" style="margin-left:8px; color:#999; font-size:0.85em;"></span>
+    </div>
+
+    <hr/>
+
+    <div class="form-row" id="row-srcA">
+        <label for="node-input-srcA"><i class="fa fa-arrow-right"></i> Source A</label>
+        <input type="hidden" id="node-input-srcAType">
+        <input type="text"   id="node-input-srcA" style="width:60%;">
+    </div>
+
+    <div class="form-row" id="row-srcB">
+        <label for="node-input-srcB"><i class="fa fa-arrow-right"></i> Source B</label>
+        <input type="hidden" id="node-input-srcBType">
+        <input type="text"   id="node-input-srcB" style="width:60%;">
+    </div>
+
+    <div class="form-row" id="row-dest">
+        <label for="node-input-dest"><i class="fa fa-arrow-left"></i> Destination</label>
+        <input type="hidden" id="node-input-destType">
+        <input type="text"   id="node-input-dest" style="width:60%;">
+    </div>
+
+    <hr/>
+
+    <div class="form-row" style="color:#888; font-size:0.85em;">
+        <i class="fa fa-info-circle"></i>
+        Result is sent in <code>msg.payload</code> (true/false) and <code>msg.ladder</code>.<br>
+        <i class="fa fa-exclamation-triangle" style="color:#e67e22;"></i>
+        Contacts &amp; comparators only forward the message when the condition is <strong>TRUE</strong>.
+    </div>
+
+</script>
+
+<!-- ═══════════════════════════════════════════════════════════════════════
+     Help Panel
+     ═══════════════════════════════════════════════════════════════════════ -->
+<script type="text/html" data-help-name="instructions-ladder-IEC-61131-3">
+    <p>
+        Simulates <strong>Ladder Logic</strong> instructions from
+        <em>Studio 5000 Logix Designer</em> (Rockwell Automation) inside Node-RED.
+    </p>
+
+    <h3>Contacts</h3>
+    <dl>
+        <dt>NO – Examine If Closed</dt><dd>TRUE when Source A is non-zero/truthy. Message forwarded only when TRUE.</dd>
+        <dt>NC – Examine If Open</dt><dd>TRUE when Source A is zero/falsy. Message forwarded only when TRUE.</dd>
+    </dl>
+
+    <h3>Comparators</h3>
+    <dl>
+        <dt>EQ / NEQ</dt><dd>EQal / Not EQal. Message forwarded only when TRUE.</dd>
+        <dt>GT / GE</dt><dd>Greater Than / Greater or EQal.</dd>
+        <dt>LT / LE</dt><dd>LTs Than / LTs or EQal.</dd>
+    </dl>
+
+    <h3>Math</h3>
+    <dl>
+        <dt>ADD / SUB / MUL / DIV / MOD</dt><dd>Arithmetic, result written to Destination. Always forwards message.</dd>
+        <dt>MOV</dt><dd>Copies Source A to Destination.</dd>
+        <dt>ABS</dt><dd>Absolute value of Source A → Destination.</dd>
+        <dt>SQR</dt><dd>Square root of Source A → Destination.</dd>
+    </dl>
+
+    <h3>Output Coils</h3>
+    <dl>
+        <dt>SET</dt><dd>Writes <code>true</code> to Destination.</dd>
+        <dt>RESET</dt><dd>Writes <code>false</code> to Destination.</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <ul>
+        <li><code>msg.payload</code> – boolean result.</li>
+        <li><code>msg.ladder.func</code> – instruction name.</li>
+        <li><code>msg.ladder.result</code> – same as payload.</li>
+        <li><code>msg.ladder.status</code> – status string shown on node.</li>
+    </ul>
+
+    <h3>Node Status</h3>
+    <p>
+        Status is displayed in two logical parts separated by  <strong>‖</strong>:<br>
+        <em>Left</em>: instruction + variable names.<br>
+        <em>Right</em>: resolved values + result.<br><br>
+        🟢 Green dot = TRUE &nbsp;|&nbsp; ⚫ Grey ring = FALSE &nbsp;|&nbsp; 🔴 Red = Error
+    </p>
+</script>

package/instructions_ladder_IEC_61131_3.js

@@ -0,0 +1,246 @@
+module.exports = function (RED) {
+
+    // ─── Helpers ──────────────────────────────────────────────────────────────
+
+    function resolveValue(node, msg, type, key) {
+        if (key === undefined || key === '') return undefined;
+        switch (type) {
+            case 'msg': return RED.util.getMessageProperty(msg, key);
+            case 'flow': return node.context().flow.get(key);
+            case 'global': return node.context().global.get(key);
+            case 'num': return Number(key);
+            case 'bool': return key === 'true' || key === true;
+            case 'str': return String(key);
+            default: return key;
+        }
+    }
+
+
+    // Formats a value for status: rounds floats to 4 decimal places
+    function fmt(v) {
+        if (typeof v === 'number' && !Number.isInteger(v)) return +v.toFixed(4);
+        return v;
+    }
+
+    // ─── Status builder ───────────────────────────────────────────────────────
+    //
+    // Node-RED status text is a single string — no real newline.
+    // We simulate two logical lines with a  ‖  separator:
+    //   Line 1: instruction mnemonic + operand variable names
+    //   Line 2: resolved values + result/output
+    //
+    // ExampLT:
+    //   NO (payload)  ‖  val=true → TRUE
+    //   GT (temp) > (limit)  ‖  85 > 80 → TRUE
+    //   ADD (a) + (b) → (result)  ‖  10 + 5 = 15
+    //   SET → (motor)  ‖  (motor) = true
+
+    // ─── Status builder ───────────────────────────────────────────────────────
+    //
+    // Format: FN varA(valA)op varB(valB)→dest=result  (no spaces, max compact)
+    //
+    // Examples:
+    //   NO  motor_run(true)→TRUE
+    //   GT  temp(85)>limit(80)→TRUE
+    //   ADD a(10)+b(5)→result=15
+    //   DIV x(9)/y(0)→÷0ERR
+    //   MOV src(42)→dest
+    //   ABS |x(-7)|→out=7
+    //   SET →motor=TRUE
+    //   RST →alarm=FALSE
+
+    function buildStatus(fn, nameA, nameB, nameDest, valA, valB, result, computed) {
+        const nA = nameA || '?';
+        const nB = nameB || '?';
+        const nD = nameDest || '?';
+        const vA = fmt(valA);
+        const vB = fmt(valB);
+        const res = result ? 'TRUE' : 'FALSE';
+
+        // ── Contacts ─────────────────────────────────────────────────────────
+        // NO motor_run(true)→TRUE
+        if (fn === 'NO' || fn === 'NC')
+            return `${fn} ${nA}(${vA})→${res}`;
+
+        // ── Comparators ──────────────────────────────────────────────────────
+        // GT temp(85)>limit(80)→TRUE
+        const OPS = { EQ: '==', NEQ: '!=', GT: '>', GE: '>=', LT: '<', LE: '<=' };
+        if (OPS[fn])
+            return `${fn} ${nA}(${vA})${OPS[fn]}${nB}(${vB})→${res}`;
+
+        // ── Math (two operands) ───────────────────────────────────────────────
+        // ADD a(10)+b(5)→result=15
+        // DIV x(9)/y(0)→÷0ERR
+        const MATH2 = { ADD: '+', SUB: '-', MUL: '*', DIV: '/', MOD: '%' };
+        if (MATH2[fn]) {
+            if ((fn === 'DIV' || fn === 'MOD') && Number(valB) === 0)
+                return `${fn} ${nA}(${vA})${MATH2[fn]}${nB}(0)→÷0ERR`;
+            return `${fn} ${nA}(${vA})${MATH2[fn]}${nB}(${vB})→${nD}=${fmt(computed)}`;
+        }
+
+        // ── Math (one operand) ────────────────────────────────────────────────
+        // MOV src(42)→dest
+        // ABS |x(-7)|→out=7
+        // SQR √n(64)→root=8
+        if (fn === 'MOV') return `MOV ${nA}(${vA})→${nD}`;
+        if (fn === 'ABS') return `ABS |${nA}(${vA})|→${nD}=${fmt(computed)}`;
+        if (fn === 'SQR') return `SQR √${nA}(${vA})→${nD}=${fmt(computed)}`;
+
+        // ── Output Coils ──────────────────────────────────────────────────────
+        // SET →motor=TRUE   |   RST →alarm=FALSE
+        if (fn === 'SET') return `SET →${nD}=TRUE`;
+        if (fn === 'RESET') return `RST →${nD}=FALSE`;
+
+        return `${fn} executed`;
+    }
+
+    // ─── Instruction Execution ────────────────────────────────────────────────
+
+    function executeLadder(node, msg, config) {
+
+        const fn = config.ladderFunc;
+        const valA = resolveValue(node, msg, config.srcAType, config.srcA);
+        const valB = resolveValue(node, msg, config.srcBType, config.srcB);
+        const nameA = config.srcA || '';
+        const nameB = config.srcB || '';
+        const nameDest = config.dest || '';
+
+
+        let payload = null;
+        let result = false;
+        let sendMsg = true;
+        let Msg = true;
+        let computed; // for math instructions that produce a new value
+        var resultOperation = false
+
+        switch (fn) {
+
+            // ── Contacts ─────────────────────────────────────────────────────
+            case 'NO': result = !!valA; sendMsg = result; break;
+            case 'NC': result = !valA; sendMsg = result; break;
+
+            // ── Comparators ──────────────────────────────────────────────────
+            case 'EQ': result = Number(valA) === Number(valB); sendMsg = result; break;
+            case 'NEQ': result = Number(valA) !== Number(valB); sendMsg = result; break;
+            case 'GT': result = Number(valA) > Number(valB); sendMsg = result; break;
+            case 'GE': result = Number(valA) >= Number(valB); sendMsg = result; break;
+            case 'LT': result = Number(valA) < Number(valB); sendMsg = result; break;
+            case 'LE': result = Number(valA) <= Number(valB); sendMsg = result; break;
+
+            // ── Math (two operands) ───────────────────────────────────────────
+            case 'ADD':
+                computed = Number(valA) + Number(valB);
+                result = true;
+                resultOperation = true
+                break;
+            case 'SUB':
+                computed = Number(valA) - Number(valB);
+
+                result = true;
+                resultOperation = true
+                break;
+            case 'MUL':
+                computed = Number(valA) * Number(valB);
+                result = computed;
+                resultOperation = true
+                break;
+            case 'MOD':
+                if (Number(valB) === 0) { node.warn('MOD: Division by zero!'); result = false; break; }
+                computed = Number(valA) % Number(valB);
+
+                result = true;
+                resultOperation = true
+                break;
+            case 'DIV':
+                if (Number(valB) === 0) { node.warn('DIV: Division by zero!'); result = false; break; }
+                computed = Number(valA) / Number(valB);
+
+                result = true;
+                resultOperation = true
+                type = "Math"
+                break;
+
+            // ── Math (one operand) ────────────────────────────────────────────
+            case 'MOV':
+
+                result = true;
+                break;
+            case 'ABS': computed = Math.abs(Number(valA));  result = true; break;
+            case 'SQR': computed = Math.sqrt(Math.abs(Number(valA))); result = true; break;
+
+            // ── Output Coils ──────────────────────────────────────────────────
+            case 'SET':
+                resultOperation = true
+                result = true;
+                break;
+            case 'RESET':
+                resultOperation = true
+                result = false;
+                break;
+
+            default:
+                node.warn('Unknown instruction: ' + fn);
+                result = false;
+        }
+
+        const statusText = buildStatus(fn, nameA, nameB, nameDest, valA, valB, result, computed);
+        return { result, resultOperation, statusText, sendMsg };
+    }
+
+    function writeNode(node, msg, config, sendMsg, result, resultOperation) {
+        console.log(config)
+        const ladderFunc = config.ladderFunc;
+        const dest = config.dest;
+        const destType = config.destType;
+
+        switch (destType) {
+            case 'msg':
+                if (resultOperation) {
+                    msg[dest] = result
+                }
+                break;
+            case 'flow': node.context().flow.set(dest, result); break;
+            case 'global': node.context().global.set(dest, result); break;
+        }
+
+
+        if (sendMsg) {
+            node.send(msg);
+
+        }
+    }
+
+    // ─── Node Definition ──────────────────────────────────────────────────────
+
+    function instructions_ladder_IEC_61131_3(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.status({ fill: 'grey', shape: 'ring', text: 'waiting...' });
+
+        node.on('input', function (msg) {
+            try {
+                const { result, resultOperation, statusText, sendMsg } = executeLadder(node, msg, config);
+
+                node.status({
+                    fill: result ? 'green' : 'grey',
+                    shape: result ? 'dot' : 'ring',
+                    text: statusText
+                });
+
+                msg.ladder = { func: config.ladderFunc, result, status: statusText };
+                //Write payload and msg
+                writeNode(node, msg, config, sendMsg, result, resultOperation)
+
+
+            } catch (err) {
+                node.error('Ladder execution error: ' + err.message, msg);
+                node.status({ fill: 'red', shape: 'dot', text: 'Error: ' + err.message });
+            }
+        });
+
+        node.on('close', function () { node.status({}); });
+    }
+
+    RED.nodes.registerType('instructions-ladder-IEC-61131-3', instructions_ladder_IEC_61131_3);
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@vitormnm/node-red-instructions-ladder-iec-61131-3",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Node-RED instructions ladder IEC-61131-3",
+  "keywords": [
+    "node-red",
+    "ladder",
+    "IEC-61131-3",
+    "plc",
+    "codesys"
+  ],
+  "node-red": {
+    "nodes": {
+      "version": ">=2.0.0",
+      "instructions-ladder-IEC-61131-3": "instructions_ladder_IEC_61131_3.js"
+    }
+  },
+  "author": {
+    "name": "Vitor Mião",
+    "url": "https://github.com/vitormnm"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vitormnm/node-red-instructions-ladder-IEC-61131-3"
+  }
+}