node-red-contrib-symi-modbus 1.0.0

package/examples/basic-flow.json

@@ -0,0 +1,188 @@
+[
+    {
+        "id": "modbus_master_1",
+        "type": "modbus-master",
+        "name": "Modbus主站",
+        "connectionType": "tcp",
+        "tcpHost": "127.0.0.1",
+        "tcpPort": "502",
+        "serialPort": "COM1",
+        "serialBaudRate": "9600",
+        "serialDataBits": "8",
+        "serialStopBits": "1",
+        "serialParity": "none",
+        "slaveStartAddress": "10",
+        "slaveCount": "1",
+        "coilStart": "0",
+        "coilEnd": "31",
+        "pollInterval": "100",
+        "enableMqtt": false,
+        "mqttBroker": "mqtt://localhost:1883",
+        "mqttUsername": "",
+        "mqttPassword": "",
+        "mqttBaseTopic": "modbus/relay",
+        "x": 320,
+        "y": 140,
+        "wires": [["debug_1"]]
+    },
+    {
+        "id": "debug_1",
+        "type": "debug",
+        "name": "轮询输出",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 520,
+        "y": 140,
+        "wires": []
+    },
+    {
+        "id": "inject_start",
+        "type": "inject",
+        "name": "启动轮询",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": true,
+        "onceDelay": "1",
+        "topic": "",
+        "payload": "{\"cmd\":\"start\"}",
+        "payloadType": "json",
+        "x": 130,
+        "y": 100,
+        "wires": [["modbus_master_1"]]
+    },
+    {
+        "id": "inject_stop",
+        "type": "inject",
+        "name": "停止轮询",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "0.1",
+        "topic": "",
+        "payload": "{\"cmd\":\"stop\"}",
+        "payloadType": "json",
+        "x": 130,
+        "y": 140,
+        "wires": [["modbus_master_1"]]
+    },
+    {
+        "id": "inject_write_coil",
+        "type": "inject",
+        "name": "打开线圈0",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "0.1",
+        "topic": "",
+        "payload": "{\"cmd\":\"writeCoil\",\"slave\":10,\"coil\":0,\"value\":true}",
+        "payloadType": "json",
+        "x": 130,
+        "y": 180,
+        "wires": [["modbus_master_1"]]
+    },
+    {
+        "id": "inject_write_coil_off",
+        "type": "inject",
+        "name": "关闭线圈0",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "0.1",
+        "topic": "",
+        "payload": "{\"cmd\":\"writeCoil\",\"slave\":10,\"coil\":0,\"value\":false}",
+        "payloadType": "json",
+        "x": 130,
+        "y": 220,
+        "wires": [["modbus_master_1"]]
+    },
+    {
+        "id": "switch_node_1",
+        "type": "modbus-slave-switch",
+        "name": "开关 10-0",
+        "masterNode": "modbus_master_1",
+        "slaveId": "10",
+        "coilNumber": "0",
+        "x": 320,
+        "y": 300,
+        "wires": [["debug_2"]]
+    },
+    {
+        "id": "debug_2",
+        "type": "debug",
+        "name": "开关状态",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 520,
+        "y": 300,
+        "wires": []
+    },
+    {
+        "id": "inject_switch_on",
+        "type": "inject",
+        "name": "开关ON",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "0.1",
+        "topic": "",
+        "payload": "true",
+        "payloadType": "bool",
+        "x": 130,
+        "y": 280,
+        "wires": [["switch_node_1"]]
+    },
+    {
+        "id": "inject_switch_off",
+        "type": "inject",
+        "name": "开关OFF",
+        "props": [
+            {
+                "p": "payload"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": "0.1",
+        "topic": "",
+        "payload": "false",
+        "payloadType": "bool",
+        "x": 130,
+        "y": 320,
+        "wires": [["switch_node_1"]]
+    }
+]
+

package/nodes/modbus-master.html

@@ -0,0 +1,348 @@
+<script type="text/javascript">
+    RED.nodes.registerType('modbus-master', {
+        category: 'modbus',
+        color: '#3FADB5',
+        defaults: {
+            name: {value: "Modbus主站"},
+            connectionType: {value: "tcp"},
+            // TCP配置
+            tcpHost: {value: "127.0.0.1"},
+            tcpPort: {value: 502},
+            // 串口配置
+            serialPort: {value: "COM1"},
+            serialBaudRate: {value: 9600},
+            serialDataBits: {value: 8},
+            serialStopBits: {value: 1},
+            serialParity: {value: "none"},
+            // 从站配置列表（数组）
+            slaves: {value: [{
+                address: 10,
+                coilStart: 0,
+                coilEnd: 31,
+                pollInterval: 200
+            }]},
+            // MQTT配置
+            enableMqtt: {value: false},
+            mqttBroker: {value: "mqtt://localhost:1883"},
+            mqttUsername: {value: ""},
+            mqttPassword: {value: ""},
+            mqttBaseTopic: {value: "modbus/relay"}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "bridge.png",
+        label: function() {
+            return this.name || "Modbus主站";
+        },
+        oneditprepare: function() {
+            var node = this;
+            
+            // 初始化从站列表
+            if (!node.slaves || node.slaves.length === 0) {
+                node.slaves = [{
+                    address: 10,
+                    coilStart: 0,
+                    coilEnd: 31,
+                    pollInterval: 200
+                }];
+            }
+            
+            // 渲染从站列表
+            function renderSlaveList() {
+                var container = $("#slave-list-container");
+                container.empty();
+                
+                node.slaves.forEach(function(slave, index) {
+                    var slaveRow = $('<div class="slave-row" style="padding: 10px; margin: 5px 0; border: 1px solid #ddd; border-radius: 4px; background: #f9f9f9;">');
+                    
+                    slaveRow.html(`
+                        <div style="display: flex; align-items: center; gap: 10px; margin-bottom: 8px;">
+                            <strong style="min-width: 80px;">从站 ${index + 1}:</strong>
+                            <label style="margin: 0 5px;">地址:</label>
+                            <input type="number" class="slave-address" data-index="${index}" value="${slave.address}" min="1" max="247" style="width: 60px;">
+                            <label style="margin: 0 5px;">线圈:</label>
+                            <input type="number" class="slave-coil-start" data-index="${index}" value="${slave.coilStart}" min="0" max="31" style="width: 50px;">
+                            <span>-</span>
+                            <input type="number" class="slave-coil-end" data-index="${index}" value="${slave.coilEnd}" min="0" max="31" style="width: 50px;">
+                            <label style="margin: 0 5px;">间隔(ms):</label>
+                            <input type="number" class="slave-poll-interval" data-index="${index}" value="${slave.pollInterval}" min="10" style="width: 60px;">
+                            <button type="button" class="btn-delete-slave" data-index="${index}" style="background: #d9534f; color: white; border: none; padding: 4px 8px; border-radius: 3px; cursor: pointer;">删除</button>
+                        </div>
+                    `);
+                    
+                    container.append(slaveRow);
+                });
+                
+                // 更新删除按钮状态（至少保留1个从站）
+                if (node.slaves.length === 1) {
+                    $(".btn-delete-slave").prop("disabled", true).css("opacity", "0.5");
+                }
+                
+                // 更新添加按钮状态（最多10个从站）
+                if (node.slaves.length >= 10) {
+                    $("#btn-add-slave").prop("disabled", true);
+                } else {
+                    $("#btn-add-slave").prop("disabled", false);
+                }
+            }
+            
+            // 添加从站
+            $("#btn-add-slave").on("click", function() {
+                if (node.slaves.length >= 10) {
+                    RED.notify("最多只能添加10个从站", "warning");
+                    return;
+                }
+                
+                // 计算下一个从站地址（递增）
+                var lastAddress = node.slaves[node.slaves.length - 1].address;
+                var nextAddress = lastAddress + 1;
+                if (nextAddress > 247) nextAddress = 1;
+                
+                node.slaves.push({
+                    address: nextAddress,
+                    coilStart: 0,
+                    coilEnd: 31,
+                    pollInterval: 200
+                });
+                
+                renderSlaveList();
+            });
+            
+            // 删除从站
+            $(document).on("click", ".btn-delete-slave", function() {
+                var index = parseInt($(this).data("index"));
+                if (node.slaves.length > 1) {
+                    node.slaves.splice(index, 1);
+                    renderSlaveList();
+                } else {
+                    RED.notify("至少需要保留一个从站", "warning");
+                }
+            });
+            
+            // 更新从站数据
+            $(document).on("change", ".slave-address, .slave-coil-start, .slave-coil-end, .slave-poll-interval", function() {
+                var index = parseInt($(this).data("index"));
+                var className = $(this).attr("class").split(" ")[0];
+                var value = parseInt($(this).val());
+                
+                switch(className) {
+                    case "slave-address":
+                        node.slaves[index].address = value;
+                        break;
+                    case "slave-coil-start":
+                        node.slaves[index].coilStart = value;
+                        break;
+                    case "slave-coil-end":
+                        node.slaves[index].coilEnd = value;
+                        break;
+                    case "slave-poll-interval":
+                        node.slaves[index].pollInterval = value;
+                        break;
+                }
+            });
+            
+            // 初始化渲染
+            renderSlaveList();
+            
+            // 切换连接类型时显示/隐藏相关配置
+            $("#node-input-connectionType").on("change", function() {
+                var connType = $(this).val();
+                if (connType === "tcp") {
+                    $(".form-row-tcp").show();
+                    $(".form-row-serial").hide();
+                } else {
+                    $(".form-row-tcp").hide();
+                    $(".form-row-serial").show();
+                }
+            });
+            
+            // 初始化显示
+            $("#node-input-connectionType").trigger("change");
+            
+            // MQTT开关
+            $("#node-input-enableMqtt").on("change", function() {
+                if ($(this).is(":checked")) {
+                    $(".form-row-mqtt").show();
+                } else {
+                    $(".form-row-mqtt").hide();
+                }
+            });
+            
+            // 初始化MQTT显示
+            $("#node-input-enableMqtt").trigger("change");
+        },
+        oneditsave: function() {
+            // 保存从站配置到节点
+            this.slaves = this.slaves || [];
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="modbus-master">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="Modbus主站">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-connectionType"><i class="fa fa-plug"></i> 连接类型</label>
+        <select id="node-input-connectionType">
+            <option value="tcp">TCP/IP</option>
+            <option value="serial">串口</option>
+        </select>
+    </div>
+    
+    <!-- TCP配置 -->
+    <div class="form-row form-row-tcp">
+        <label for="node-input-tcpHost"><i class="fa fa-server"></i> TCP主机</label>
+        <input type="text" id="node-input-tcpHost" placeholder="127.0.0.1">
+    </div>
+    
+    <div class="form-row form-row-tcp">
+        <label for="node-input-tcpPort"><i class="fa fa-plug"></i> TCP端口</label>
+        <input type="number" id="node-input-tcpPort" placeholder="502">
+    </div>
+    
+    <!-- 串口配置 -->
+    <div class="form-row form-row-serial">
+        <label for="node-input-serialPort"><i class="fa fa-terminal"></i> 串口</label>
+        <input type="text" id="node-input-serialPort" placeholder="COM1">
+    </div>
+    
+    <div class="form-row form-row-serial">
+        <label for="node-input-serialBaudRate"><i class="fa fa-tachometer"></i> 波特率</label>
+        <select id="node-input-serialBaudRate">
+            <option value="9600">9600</option>
+            <option value="19200">19200</option>
+            <option value="38400">38400</option>
+            <option value="57600">57600</option>
+            <option value="115200">115200</option>
+        </select>
+    </div>
+    
+    <div class="form-row form-row-serial">
+        <label for="node-input-serialDataBits"><i class="fa fa-database"></i> 数据位</label>
+        <select id="node-input-serialDataBits">
+            <option value="7">7</option>
+            <option value="8">8</option>
+        </select>
+    </div>
+    
+    <div class="form-row form-row-serial">
+        <label for="node-input-serialStopBits"><i class="fa fa-stop"></i> 停止位</label>
+        <select id="node-input-serialStopBits">
+            <option value="1">1</option>
+            <option value="2">2</option>
+        </select>
+    </div>
+    
+    <div class="form-row form-row-serial">
+        <label for="node-input-serialParity"><i class="fa fa-check"></i> 校验位</label>
+        <select id="node-input-serialParity">
+            <option value="none">无</option>
+            <option value="even">偶校验</option>
+            <option value="odd">奇校验</option>
+        </select>
+    </div>
+    
+    <!-- 从站配置 -->
+    <hr>
+    <div class="form-row">
+        <label style="width: 100%; margin-bottom: 10px;">
+            <i class="fa fa-server"></i> 从站设备配置
+            <span style="font-size: 11px; color: #999; margin-left: 10px;">（最多10台，默认从地址10=0x0A开始）</span>
+        </label>
+        <div id="slave-list-container" style="width: 100%; margin-top: 10px;">
+            <!-- 从站列表将在这里动态生成 -->
+        </div>
+        <button type="button" id="btn-add-slave" style="margin-top: 10px; padding: 6px 12px; background: #5cb85c; color: white; border: none; border-radius: 4px; cursor: pointer;">
+            <i class="fa fa-plus"></i> 添加从站
+        </button>
+        <div style="font-size: 11px; color: #999; margin-top: 8px;">
+            💡 提示：默认地址10(0x0A)、11(0x0B)、12(0x0C)...，轮询间隔推荐200ms
+        </div>
+    </div>
+    
+    <!-- MQTT配置 -->
+    <hr>
+    <div class="form-row">
+        <label for="node-input-enableMqtt"><i class="fa fa-toggle-on"></i> 启用MQTT</label>
+        <input type="checkbox" id="node-input-enableMqtt" style="width: auto; margin-left: 10px;">
+    </div>
+    
+    <div class="form-row form-row-mqtt">
+        <label for="node-input-mqttBroker"><i class="fa fa-server"></i> MQTT服务器</label>
+        <input type="text" id="node-input-mqttBroker" placeholder="mqtt://localhost:1883">
+    </div>
+    
+    <div class="form-row form-row-mqtt">
+        <label for="node-input-mqttUsername"><i class="fa fa-user"></i> MQTT用户名</label>
+        <input type="text" id="node-input-mqttUsername" placeholder="可选">
+    </div>
+    
+    <div class="form-row form-row-mqtt">
+        <label for="node-input-mqttPassword"><i class="fa fa-lock"></i> MQTT密码</label>
+        <input type="password" id="node-input-mqttPassword" placeholder="可选">
+    </div>
+    
+    <div class="form-row form-row-mqtt">
+        <label for="node-input-mqttBaseTopic"><i class="fa fa-sitemap"></i> MQTT基础主题</label>
+        <input type="text" id="node-input-mqttBaseTopic" placeholder="modbus/relay">
+        <div style="font-size: 11px; color: #999; margin-top: 3px; margin-left: 110px;">
+            MQTT主题前缀（用于状态发布和命令订阅）<br>
+            实体将自动注册到Home Assistant（MQTT Discovery）
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="modbus-master">
+    <p>Modbus主站节点，用于轮询Modbus继电器设备并生成MQTT实体。</p>
+    
+    <h3>配置</h3>
+    <dl class="message-properties">
+        <dt>连接类型<span class="property-type">string</span></dt>
+        <dd>选择TCP/IP或串口连接方式</dd>
+        
+        <dt>从站配置<span class="property-type">number</span></dt>
+        <dd>配置起始从站地址（默认10）、从站数量（最多10台）</dd>
+        
+        <dt>线圈范围<span class="property-type">number</span></dt>
+        <dd>配置要轮询的线圈起始和结束位置（0-31）</dd>
+        
+        <dt>轮询间隔<span class="property-type">number</span></dt>
+        <dd>每台设备的轮询间隔，单位毫秒（默认100ms）</dd>
+        
+        <dt>MQTT配置<span class="property-type">object</span></dt>
+        <dd>可选启用MQTT，自动发布设备状态到MQTT服务器</dd>
+    </dl>
+    
+    <h3>输入</h3>
+    <dl class="message-properties">
+        <dt>payload<span class="property-type">object</span></dt>
+        <dd>控制命令：
+            <ul>
+                <li><code>{"cmd": "writeCoil", "slave": 10, "coil": 0, "value": true}</code> - 写单个线圈</li>
+                <li><code>{"cmd": "writeCoils", "slave": 10, "coils": [true, false, ...]}</code> - 写多个线圈</li>
+                <li><code>{"cmd": "start"}</code> - 开始轮询</li>
+                <li><code>{"cmd": "stop"}</code> - 停止轮询</li>
+            </ul>
+        </dd>
+    </dl>
+    
+    <h3>输出</h3>
+    <dl class="message-properties">
+        <dt>payload<span class="property-type">object</span></dt>
+        <dd>轮询结果：
+            <pre>{
+  "slave": 10,
+  "coils": [true, false, true, ...],
+  "timestamp": 1234567890
+}</pre>
+        </dd>
+    </dl>
+    
+    <h3>详细信息</h3>
+    <p>本节点支持通过TCP或串口连接Modbus继电器设备，可以轮询最多10台设备，每台设备32路继电器。</p>
+    <p>启用MQTT后，会自动生成Home Assistant兼容的MQTT发现消息和状态更新。</p>
+</script>
+