node-red-contrib-multiplexer 1.0.0

package/README.md

@@ -0,0 +1,33 @@
+# node-red-contrib-rpo-multiplexer
+
+A Node-RED node: **Multiplexer**
+
+Routes one of 8 input channels (ch0–ch7) to a single output. Switch the active channel by sending a message with topic `select` and payload `ch0`–`ch7`.
+
+## Install
+
+```bash
+npm install node-red-contrib-rpo-multiplexer
+```
+
+Or via the Node-RED Palette Manager.
+
+## Inputs
+
+- **topic=ch0..ch7**: Value update for that channel
+- **topic=select, payload=ch0..ch7**: Switch active channel
+
+## Outputs
+
+- **Output 1**: Value of the currently selected channel
+
+## Configuration
+
+| Parameter | Description |
+|-----------|-------------|
+| Active channel | Initially selected channel (ch0–ch7) |
+| Pass-through mode | Forward all channels or only the active one |
+
+## License
+
+MIT

package/locales/de/multiplexer.json

@@ -0,0 +1,19 @@
+{
+  "multiplexer": {
+    "label": "Multiplexer",
+    "channel": "Eingangskanäle",
+    "selectedChannel": "Aktiver Kanal",
+    "passthroughAll": "Durchleitungsmodus",
+    "passthroughAll_opt": {
+      "false": "Nur aktiver Kanal",
+      "true": "Alle Kanäle"
+    },
+    "tip": "Topic 'select' mit Payload ch0–ch7 sendet um den Kanal zu wechseln.",
+    "input": {
+      "payload": "Wert für den adressierten Kanal (topic=ch0..ch7) oder Kanalauswahl (topic=select, payload=ch0..ch7)"
+    },
+    "output": {
+      "payload": "Wert des aktuell aktiven Kanals"
+    }
+  }
+}

package/locales/en/multiplexer.json

@@ -0,0 +1,19 @@
+{
+  "multiplexer": {
+    "label": "Multiplexer",
+    "channel": "Input channels",
+    "selectedChannel": "Active channel",
+    "passthroughAll": "Pass-through mode",
+    "passthroughAll_opt": {
+      "false": "Active channel only",
+      "true": "All channels"
+    },
+    "tip": "Send topic 'select' with payload ch0–ch7 to switch channel.",
+    "input": {
+      "payload": "Value for the addressed channel (topic=ch0..ch7) or channel selector (topic=select, payload=ch0..ch7)"
+    },
+    "output": {
+      "payload": "Value of the currently active channel"
+    }
+  }
+}

package/locales/es/multiplexer.json

@@ -0,0 +1,19 @@
+{
+  "multiplexer": {
+    "label": "Multiplexor",
+    "channel": "Canales de entrada",
+    "selectedChannel": "Canal activo",
+    "passthroughAll": "Modo paso completo",
+    "passthroughAll_opt": {
+      "false": "Solo canal activo",
+      "true": "Todos los canales"
+    },
+    "tip": "Envíe topic 'select' con payload ch0–ch7 para cambiar canal.",
+    "input": {
+      "payload": "Valor para el canal direccionado (topic=ch0..ch7) o selector de canal (topic=select, payload=ch0..ch7)"
+    },
+    "output": {
+      "payload": "Valor del canal activo actualmente"
+    }
+  }
+}

package/multiplexer.html

@@ -0,0 +1,53 @@
+<script type="text/javascript">
+    RED.nodes.registerType('multiplexer', {
+        category: 'rpo',
+        color: '#D4600A',
+        defaults: {
+                "name": {
+                        "value": ""
+                },
+                "channels": {
+                        "value": 8
+                },
+                "initialChannel": {
+                        "value": 0
+                }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'font-awesome/fa-random',
+        label: function() { return this.name || 'multiplexer'; },
+        labelStyle: function() { return this.name ? 'node_label_italic' : ''; }
+    });
+</script>
+
+<script type="text/html" data-template-name="multiplexer">
+    <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">
+    </div>
+    <div class="form-row">
+        <label for="node-input-channels"><i class="fa fa-list"></i> Channels</label>
+        <select id="node-input-channels" style="width:70%">
+            <option value="2">2</option><option value="3">3</option><option value="4">4</option><option value="5">5</option><option value="6">6</option><option value="7">7</option><option value="8">8</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-initialChannel"><i class="fa fa-hand-o-right"></i> Initial Channel</label>
+        <input type="number" id="node-input-initialChannel" min="0" max="7" style="width:70%">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="multiplexer">
+    <p>8-channel multiplexer. Forwards the selected input channel to the output.</p>
+    <h3>Topics</h3>
+    <ul>
+        <li><code>select</code> + payload 0–7: select active channel</li>
+        <li><code>ch0</code>–<code>ch7</code>: store value for that channel</li>
+    </ul>
+    <h3>Output</h3>
+    <dl class="message-properties">
+        <dt>payload</dt><dd>Value of selected channel</dd>
+        <dt>multiplexer</dt><dd>{ selectedChannel, value, channels }</dd>
+    </dl>
+</script>

package/multiplexer.js

@@ -0,0 +1,69 @@
+module.exports = function(RED) {
+    function MultiplexerNode(config) {
+        RED.nodes.createNode(this, config);
+        var node = this;
+
+        node.numChannels      = parseInt(config.channels, 10) || 8;
+        node.selectedChannel  = parseInt(config.initialChannel, 10) || 0;
+        node.channelValues    = {};
+
+        updateStatus(node);
+
+        node.on('input', function(msg) {
+            if (msg.reset === true) {
+                node.channelValues   = {};
+                node.selectedChannel = parseInt(config.initialChannel, 10) || 0;
+                updateStatus(node);
+                return;
+            }
+
+            var topic = (msg.topic !== undefined) ? String(msg.topic) : '';
+
+            if (topic === 'select') {
+                var ch = parseInt(msg.payload, 10);
+                if (isNaN(ch) || ch < 0 || ch >= node.numChannels) {
+                    node.warn('Channel out of range: ' + msg.payload + ' (0–' + (node.numChannels - 1) + ')');
+                    return;
+                }
+                node.selectedChannel = ch;
+            } else if (/^ch[0-7]$/.test(topic)) {
+                var idx = parseInt(topic.slice(2), 10);
+                if (idx >= node.numChannels) {
+                    node.warn('Channel ' + topic + ' out of range (configured: ' + node.numChannels + ')');
+                    return;
+                }
+                node.channelValues[topic] = msg.payload;
+            } else {
+                node.warn('Unknown topic: ' + topic + ' (use "select" or "ch0"–"ch' + (node.numChannels - 1) + '")');
+                return;
+            }
+
+            var selKey = 'ch' + node.selectedChannel;
+            if (!(selKey in node.channelValues)) {
+                node.status({ fill:'grey', shape:'ring', text:'CH' + node.selectedChannel + ' → (no value yet)' });
+                return;
+            }
+
+            var val = node.channelValues[selKey];
+            msg.payload      = val;
+            msg.multiplexer  = {
+                selectedChannel: node.selectedChannel,
+                value:           val,
+                channels:        Object.assign({}, node.channelValues)
+            };
+            node.status({ fill:'green', shape:'dot', text:'CH' + node.selectedChannel + ' → ' + val });
+            node.send(msg);
+        });
+
+        function updateStatus(n) {
+            var selKey = 'ch' + n.selectedChannel;
+            if (selKey in n.channelValues) {
+                n.status({ fill:'green', shape:'dot', text:'CH' + n.selectedChannel + ' → ' + n.channelValues[selKey] });
+            } else {
+                n.status({ fill:'grey', shape:'ring', text:'CH' + n.selectedChannel + ' → (no value yet)' });
+            }
+        }
+    }
+
+    RED.nodes.registerType('multiplexer', MultiplexerNode);
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "node-red-contrib-multiplexer",
+  "version": "1.0.0",
+  "description": "8-channel multiplexer - selects and forwards one of N input channels",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wobi848/node-red-contrib-rpo-suite.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Wobi848/node-red-contrib-rpo-suite/issues"
+  },
+  "files": [
+    "multiplexer.js",
+    "multiplexer.html",
+    "locales",
+    "examples"
+  ],
+  "keywords": [
+    "node-red",
+    "multiplexer",
+    "selector",
+    "channel",
+    "mux"
+  ],
+  "author": "sr.rpo",
+  "license": "MIT",
+  "node-red": {
+    "version": "1.0.0",
+    "nodes": {
+      "multiplexer": "multiplexer.js"
+    }
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "scripts": {
+    "test": "mocha \"test/**/*_spec.js\" --exit"
+  },
+  "devDependencies": {
+    "mocha": "^10.2.0",
+    "node-red": "^3.1.0",
+    "node-red-node-test-helper": "^0.3.6"
+  }
+}