node-red-contrib-symi-modbus 2.9.6 → 2.9.7

package/README.md

@@ -816,6 +816,70 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 测试功能需先选择串口配置
 - 无需连线到debug节点，直接通过串口配置节点发送数据
 
+### 继电器输出节点（relay-output）
+
+用于控制Modbus继电器，支持**绑定从站开关触发源**或接收外部输入，**无需连线到主站**。
+
+**核心特性**：
+- 从站开关、继电器输出、主站之间**完全无需连线**
+- 共享RS-485连接配置，支持多个节点共用
+- 支持绑定从站开关作为触发源（内部事件通信）
+- 支持外部设备触发（如海康门禁）
+- 支持延时执行（0-60000毫秒），实现级联开灯效果
+- 配置持久化保存，断电断网恢复后正常工作
+
+**配置参数**：
+
+*RS-485连接配置*：
+- **连接配置**：选择已配置的RS-485连接（支持TCP网关或串口），多个节点共享
+
+*按键触发配置*：
+- **面板品牌**：开关面板品牌，目前支持亖米（Symi）
+- **按钮类型**：开关按钮/场景按钮/输入端触发（外部设备）
+- **开关ID**：物理面板地址（0-255）
+- **按钮编号**：按键编号(1-8，15=背光灯)
+- **门禁ID**：可选，0=不过滤，>0=只响应指定门禁编号
+
+*目标继电器配置*：
+- **从站地址**：要控制的Modbus从站地址(1-247)
+- **继电器路数**：要控制的继电器通道(1-32)
+
+*动作配置*：
+- **动作**：打开/关闭/跟随输入/翻转状态
+- **延时**：执行延时（0-60000毫秒），用于实现级联开灯效果
+- **忽略释放信号**：只响应按下信号
+
+**使用示例**：
+
+**示例1：按键触发继电器（无需任何连线）**
+```
+配置：开关ID=1，按钮编号=3，从站地址=10，继电器路数=1，动作=打开
+效果：当开关1的按钮3被按下时，自动控制从站10的1路继电器打开
+```
+
+**示例2：一个按键控制多路继电器（级联开灯）**
+```
+继电器输出1: 开关ID=1, 按钮=3, 继电器=1路, 延时=0ms, 动作=打开
+继电器输出2: 开关ID=1, 按钮=3, 继电器=2路, 延时=500ms, 动作=打开
+继电器输出3: 开关ID=1, 按钮=3, 继电器=3路, 延时=1000ms, 动作=打开
+```
+
+**示例3：海康门禁触发（使用输入端）**
+```
+海康门禁事件 → 继电器输出(按钮类型=输入端触发, 从站地址=10, 继电器=1路, 门禁ID=4)
+```
+
+**工作原理**：
+- 节点监听 `modbus:buttonPressed` 事件（按键触发）
+- 通过 `modbus:writeCoil` 事件发送控制命令到主站
+- 实现按键 → 继电器输出 → 主站之间的无连线通信
+
+**稳定性保障**：
+- 长期运行不卡顿、不死机、内存不溢出
+- 无调试数据输出，具备生产条件长期运行
+- 断电断网恢复后正常工作
+- 内置防抖和状态检测机制，不会出现设备反复开关进入死循环
+
 ## 输出消息格式
 
 ### 主站节点
@@ -888,7 +952,30 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.9.6 (2025-12-20)
+**当前版本**: v2.9.7 (2025-12-24)
+
+**v2.9.7 更新内容**：
+- **新增节点**：继电器输出节点（relay-output）
+  - 支持**绑定从站开关按键**，实现按键→继电器→主站之间**完全无需连线**
+  - 共享RS-485连接配置，支持多个节点共用同一连接
+  - 按键触发配置：面板品牌、按钮类型、开关ID(0-255)、按钮编号(1-8)、门禁ID(可选)
+  - 目标配置：从站地址、继电器路数、动作(打开/关闭/跟随/翻转)、延时(0-60000ms)
+  - 支持延时执行，一个按键控制多路继电器实现级联开灯
+  - 配置持久化保存，断电断网恢复后正常工作
+  - 长期稳定运行，不卡顿、不死机、内存不溢出，无调试数据输出
+- **界面优化**：所有SYMI MODBUS节点左侧名称改为中文显示
+- **重要修复**：HassOS串口兼容性问题
+  - 修复"Cannot lock port"错误：在所有串口连接中添加`lock: false`参数
+  - 修复位置：`serial-port-config.js`和`modbus-master.js`的串口连接配置
+  - 适用场景：HassOS、Docker容器、以及其他不支持串口锁定的环境
+- **功能改进**：串口配置界面优化
+  - Modbus服务器配置：串口路径改为输入框+搜索按钮，支持手动输入（搜索不到也能使用）
+  - 显示完整串口参数：数据位（7/8）、停止位（1/2）、校验位（无/偶/奇）
+  - 添加更多波特率选项：1200/2400/4800/9600/19200/38400/57600/115200
+- **稳定性保障**：
+  - 串口配置持久化保存到Node-RED配置文件
+  - 断电断网恢复后自动重连，正常工作
+  - 无调试数据输出，适合生产环境长期运行
 
 **v2.9.6 更新内容**：
 - **重要修复**：485开关场景按钮的CRC校验兼容性问题

package/nodes/custom-protocol.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('custom-protocol', {
         category: 'SYMI MODBUS',
         color: '#FF9800',
+        paletteLabel: "自定义协议",
         defaults: {
             name: {value: "自定义协议"},
             deviceType: {value: "switch", required: true},

package/nodes/homekit-bridge.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('homekit-bridge', {
         category: 'SYMI MODBUS',
         color: '#FF9800',
+        paletteLabel: "HomeKit网桥",
         defaults: {
             name: {value: "HomeKit网桥"},
             bridgeName: {value: "Modbus继电器网桥"},

package/nodes/modbus-dashboard.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('modbus-dashboard', {
         category: 'SYMI MODBUS',
         color: '#4CAF50',
+        paletteLabel: "控制看板",
         defaults: {
             name: {value: "Modbus控制看板"},
             masterNode: {value: "", required: true}

package/nodes/modbus-debug.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('modbus-debug', {
         category: 'SYMI MODBUS',
         color: '#C0DEED',
+        paletteLabel: "调试",
         defaults: {
             name: { value: '' },
             sourceType: { value: 'serial' }, // 仅支持 serial（避免串口冲突）

package/nodes/modbus-master.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('modbus-master', {
         category: 'SYMI MODBUS',
         color: '#3FADB5',
+        paletteLabel: "主站",
         defaults: {
             name: {value: "Modbus主站"},
             modbusServer: {value: "", type: "modbus-server-config", required: true},

package/nodes/modbus-master.js

@@ -275,7 +275,8 @@ module.exports = function(RED) {
                         baudRate: node.config.serialBaudRate || 9600,
                         dataBits: node.config.serialDataBits || 8,
                         stopBits: node.config.serialStopBits || 1,
-                        parity: node.config.serialParity || 'none'
+                        parity: node.config.serialParity || 'none',
+                        lock: false  // 禁用串口锁定，解决HassOS中"Cannot lock port"错误
                     });
                     
                     node.log(`串口Modbus连接成功: ${node.config.serialPort} @ ${node.config.serialBaudRate || 9600}bps`);

package/nodes/modbus-server-config.html

@@ -37,57 +37,46 @@
 
             $("#node-config-input-connectionType").trigger("change");
 
-            // 串口列表刷新按钮
+            // 串口搜索按钮
             $("#node-config-refresh-serial").on("click", function() {
                 var btn = $(this);
-                btn.prop("disabled", true).html('<i class="fa fa-spinner fa-spin"></i> 搜索中...');
-
-                $.getJSON('modbus-master/serialports', function(data) {
-                    var select = $("#node-config-input-serialPort");
-                    var currentVal = select.val();
-
-                    // 清空并重新填充
-                    select.empty();
+                btn.prop("disabled", true).html('<i class="fa fa-spinner fa-spin"></i>');
 
+                $.getJSON('serial-ports', function(data) {
                     if (data && data.length > 0) {
+                        var select = $('<select id="serial-port-select" style="width:100%; margin-top:10px;"></select>');
                         data.forEach(function(port) {
-                            if (port.isError) {
-                                select.append($('<option></option>')
-                                    .attr('value', port.comName)
-                                    .attr('disabled', true)
-                                    .text(port.comName + ' - ' + port.manufacturer));
-                            } else {
-                                var label = port.comName;
-                                if (port.manufacturer && port.manufacturer !== '未知设备') {
-                                    label += ' (' + port.manufacturer + ')';
-                                }
-                                select.append($('<option></option>')
-                                    .attr('value', port.comName)
-                                    .text(label));
+                            var path = port.path || port.comName;
+                            var label = path;
+                            if (port.manufacturer) {
+                                label += ' (' + port.manufacturer + ')';
                             }
+                            select.append('<option value="' + path + '">' + label + '</option>');
+                        });
+
+                        // 显示选择框
+                        $('#serial-port-list').html(select);
+
+                        // 监听选择
+                        select.on('change', function() {
+                            $('#node-config-input-serialPort').val($(this).val());
                         });
 
-                        // 恢复之前的选择
-                        if (currentVal) {
-                            select.val(currentVal);
+                        // 自动填充第一个
+                        if (data.length > 0) {
+                            var firstPath = data[0].path || data[0].comName;
+                            $('#node-config-input-serialPort').val(firstPath);
                         }
                     } else {
-                        select.append($('<option></option>')
-                            .attr('value', '/dev/ttyUSB0')
-                            .text('未检测到串口，请手动输入'));
+                        $('#serial-port-list').html('<div style="color:#999; margin-top:10px;">未找到可用串口，请手动输入</div>');
                     }
 
-                    btn.prop("disabled", false).html('<i class="fa fa-refresh"></i> 刷新串口列表');
+                    btn.prop("disabled", false).html('<i class="fa fa-search"></i> 搜索');
                 }).fail(function() {
-                    btn.prop("disabled", false).html('<i class="fa fa-refresh"></i> 刷新串口列表');
-                    RED.notify("串口列表获取失败", "error");
+                    $('#serial-port-list').html('<div style="color:#f00; margin-top:10px;">搜索失败</div>');
+                    btn.prop("disabled", false).html('<i class="fa fa-search"></i> 搜索');
                 });
             });
-
-            // 页面加载时自动刷新一次
-            setTimeout(function() {
-                $("#node-config-refresh-serial").trigger("click");
-            }, 100);
         }
     });
 </script>
@@ -127,18 +116,22 @@
     
     <div class="form-row form-row-serial">
         <label for="node-config-input-serialPort"><i class="fa fa-terminal"></i> 串口</label>
-        <select id="node-config-input-serialPort" style="width: 50%;">
-            <option value="/dev/ttyUSB0">/dev/ttyUSB0</option>
-        </select>
-        <button type="button" id="node-config-refresh-serial" class="red-ui-button" style="margin-left: 10px;">
-            <i class="fa fa-refresh"></i> 刷新串口列表
+        <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0" style="width: calc(50% - 90px);">
+        <button type="button" id="node-config-refresh-serial" class="red-ui-button" style="margin-left: 5px; width: 80px;">
+            <i class="fa fa-search"></i> 搜索
         </button>
     </div>
+    <div class="form-row form-row-serial">
+        <div id="serial-port-list" style="margin-left: 110px;"></div>
+    </div>
     
     <div class="form-row form-row-serial">
         <label for="node-config-input-serialBaudRate"><i class="fa fa-tachometer"></i> 波特率</label>
         <select id="node-config-input-serialBaudRate" style="width: 150px;">
-            <option value="9600">9600</option>
+            <option value="1200">1200</option>
+            <option value="2400">2400</option>
+            <option value="4800">4800</option>
+            <option value="9600" selected>9600</option>
             <option value="19200">19200</option>
             <option value="38400">38400</option>
             <option value="57600">57600</option>
@@ -146,7 +139,7 @@
         </select>
     </div>
     
-    <div class="form-row form-row-serial" style="display: none;">
+    <div class="form-row form-row-serial">
         <label for="node-config-input-serialDataBits"><i class="fa fa-database"></i> 数据位</label>
         <select id="node-config-input-serialDataBits" style="width: 100px;">
             <option value="7">7</option>
@@ -154,7 +147,7 @@
         </select>
     </div>
     
-    <div class="form-row form-row-serial" style="display: none;">
+    <div class="form-row form-row-serial">
         <label for="node-config-input-serialStopBits"><i class="fa fa-stop"></i> 停止位</label>
         <select id="node-config-input-serialStopBits" style="width: 100px;">
             <option value="1" selected>1</option>
@@ -162,12 +155,12 @@
         </select>
     </div>
     
-    <div class="form-row form-row-serial" style="display: none;">
+    <div class="form-row form-row-serial">
         <label for="node-config-input-serialParity"><i class="fa fa-check"></i> 校验位</label>
         <select id="node-config-input-serialParity" style="width: 100px;">
-            <option value="none" selected>无</option>
-            <option value="even">偶校验</option>
-            <option value="odd">奇校验</option>
+            <option value="none" selected>无 (N)</option>
+            <option value="even">偶校验 (E)</option>
+            <option value="odd">奇校验 (O)</option>
         </select>
     </div>
 </script>

package/nodes/modbus-slave-switch.html

@@ -2,6 +2,7 @@
     RED.nodes.registerType('modbus-slave-switch', {
         category: 'SYMI MODBUS',
         color: '#E9967A',
+        paletteLabel: "从站开关",
         defaults: {
             name: {value: "从站开关"},
             // RS-485连接配置（共享配置节点）

package/nodes/relay-output.html

@@ -0,0 +1,342 @@
+<script type="text/javascript">
+    RED.nodes.registerType('relay-output', {
+        category: 'SYMI MODBUS',
+        color: '#FFA500',
+        paletteLabel: "继电器输出",
+        defaults: {
+            name: { value: "" },
+            // RS-485连接配置（共享配置节点）
+            serialPortConfig: { value: "", type: "serial-port-config", required: false },
+            // 物理开关面板配置（触发源）
+            switchBrand: { value: "symi" },
+            buttonType: { value: "switch" },
+            switchId: { value: 0, validate: RED.validators.number() },
+            buttonNumber: { value: 1, validate: RED.validators.number() },
+            // 目标继电器配置
+            slaveAddress: { value: 10, validate: RED.validators.number() },
+            coilNumber: { value: 1, validate: RED.validators.number() },
+            // 动作配置
+            action: { value: "on" },
+            delayMs: { value: 0, validate: RED.validators.number() },
+            ignoreRelease: { value: true },
+            // 门禁ID过滤（可选）
+            filterDeviceId: { value: 0, validate: RED.validators.number() }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-lightbulb-o",
+        label: function() {
+            if (this.name) return this.name;
+            const actionMap = { 'on': '开', 'off': '关', 'follow': '跟随', 'toggle': '翻转' };
+            const btnLabel = this.buttonNumber == 15 ? '背光灯' : `按钮${this.buttonNumber}`;
+            if (this.buttonType === 'input') {
+                return `输入端 → 继电器${this.slaveAddress}-${this.coilNumber}路 ${actionMap[this.action] || '开'}`;
+            }
+            return `开关${this.switchId}-${btnLabel} → 继电器${this.slaveAddress}-${this.coilNumber}路 ${actionMap[this.action] || '开'}`;
+        },
+        oneditprepare: function() {
+            const node = this;
+
+            // 延时提示
+            $("#node-input-delayMs").on("change", function() {
+                var val = parseInt($(this).val()) || 0;
+                if (val > 0) {
+                    $("#delay-hint").text(`(${val}毫秒 = ${(val/1000).toFixed(1)}秒)`);
+                } else {
+                    $("#delay-hint").text("(立即执行)");
+                }
+            }).trigger("change");
+
+            // 按钮类型切换控制显示/隐藏
+            $("#node-input-buttonType").on("change", function() {
+                const buttonType = $(this).val();
+                if (buttonType === 'input') {
+                    $(".form-row-switch").hide();
+                } else {
+                    $(".form-row-switch").show();
+                }
+            }).trigger("change");
+
+            // 按钮编号切换时显示/隐藏背光灯提示
+            $("#node-input-buttonNumber").on("change", function() {
+                const buttonNumber = $(this).val();
+                if (buttonNumber === '15') {
+                    $("#backlight-hint").show();
+                } else {
+                    $("#backlight-hint").hide();
+                }
+            });
+
+            // 配置摘要更新
+            function updateSummary() {
+                var switchId = parseInt($("#node-input-switchId").val()) || 0;
+                var btnNum = parseInt($("#node-input-buttonNumber").val()) || 1;
+                var slave = parseInt($("#node-input-slaveAddress").val()) || 10;
+                var coil = parseInt($("#node-input-coilNumber").val()) || 1;
+                var action = $("#node-input-action").val() || 'on';
+                var delay = parseInt($("#node-input-delayMs").val()) || 0;
+                var buttonType = $("#node-input-buttonType").val();
+                
+                const actionMap = { 'on': '打开', 'off': '关闭', 'follow': '跟随', 'toggle': '翻转' };
+                const btnLabel = btnNum == 15 ? '背光灯' : `按钮${btnNum}`;
+                
+                var triggerText = buttonType === 'input' 
+                    ? '输入端触发' 
+                    : `开关${switchId}-${btnLabel}`;
+                var delayText = delay > 0 ? `, 延时${delay}ms` : '';
+                
+                $("#config-summary").html(`<strong>${triggerText}</strong> → 继电器${slave}-${coil}路 <strong>${actionMap[action]}</strong>${delayText}`);
+            }
+            
+            $("#node-input-switchId, #node-input-buttonNumber, #node-input-slaveAddress, #node-input-coilNumber, #node-input-action, #node-input-delayMs, #node-input-buttonType").on("change", updateSummary);
+            updateSummary();
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="relay-output">
+    <!-- 基本配置 -->
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="例如：客厅灯">
+    </div>
+
+    <!-- RS-485连接配置 -->
+    <hr style="margin: 15px 0; border: 0; border-top: 2px solid #e0e0e0;">
+    <div class="form-row">
+        <label style="width: 100%; margin-bottom: 8px;">
+            <i class="fa fa-plug" style="color: #ff9800;"></i>
+            <span style="font-size: 14px; font-weight: 600; color: #333;">RS-485连接配置</span>
+        </label>
+        <div style="font-size: 11px; color: #555; padding: 10px 12px; background: linear-gradient(135deg, #fff3cd 0%, #fffbe6 100%); border-left: 4px solid #ffc107; border-radius: 4px; box-shadow: 0 1px 3px rgba(0,0,0,0.08);">
+            <strong>说明：</strong>多个继电器输出节点可以共享同一个RS-485连接配置（支持TCP网关或串口）<br>
+            <strong>提示：</strong>此配置用于监听开关按键事件，无需连线到主站节点
+        </div>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-serialPortConfig" style="width: 110px;"><i class="fa fa-server"></i> 连接配置</label>
+        <input type="text" id="node-input-serialPortConfig" placeholder="选择或添加RS-485连接配置" style="width: calc(70% - 110px);">
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            选择已配置的RS-485连接（支持多个节点共享）
+        </div>
+    </div>
+
+    <!-- 按键触发配置 -->
+    <hr style="margin: 15px 0; border: 0; border-top: 2px solid #e0e0e0;">
+    <div class="form-row">
+        <label style="width: 100%; margin-bottom: 8px;">
+            <i class="fa fa-hand-pointer-o" style="color: #3f51b5;"></i> 
+            <span style="font-size: 14px; font-weight: 600; color: #333;">按键触发配置</span>
+        </label>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-switchBrand" style="width: 110px;"><i class="fa fa-trademark"></i> 面板品牌</label>
+        <select id="node-input-switchBrand" style="width: 200px;">
+            <option value="symi">亖米（Symi）</option>
+            <option value="other1" disabled style="color: #999;">其他品牌1（待开发）</option>
+            <option value="other2" disabled style="color: #999;">其他品牌2（待开发）</option>
+        </select>
+        <span style="margin-left: 10px; font-size: 11px; color: #666; font-style: italic;">支持1-8键开关</span>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-buttonType" style="width: 110px;"><i class="fa fa-cog"></i> 按钮类型</label>
+        <select id="node-input-buttonType" style="width: 200px;">
+            <option value="switch">开关按钮（RS-485）</option>
+            <option value="scene">场景按钮（RS-485）</option>
+            <option value="input">输入端触发（外部设备）</option>
+        </select>
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            <strong>开关按钮</strong>：RS-485开关，有开/关状态<br>
+            <strong>场景按钮</strong>：RS-485场景触发<br>
+            <strong>输入端触发</strong>：海康门禁等外部设备
+        </div>
+    </div>
+
+    <div class="form-row form-row-switch">
+        <label for="node-input-switchId" style="width: 110px;"><i class="fa fa-id-card"></i> 开关ID</label>
+        <input type="number" id="node-input-switchId" placeholder="0" min="0" max="255" style="width: 90px; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+        <span style="margin-left: 10px; color: #666; font-size: 12px;">物理面板地址：<strong>0-255</strong></span>
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            RS-485总线上的设备地址标识
+        </div>
+    </div>
+
+    <div class="form-row form-row-switch">
+        <label for="node-input-buttonNumber" style="width: 110px;"><i class="fa fa-hand-pointer-o"></i> 按钮编号</label>
+        <select id="node-input-buttonNumber" style="width: 150px;">
+            <option value="1">按钮 1</option>
+            <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>
+            <option value="15">按键背光灯</option>
+        </select>
+        <span style="margin-left: 10px; font-size: 11px; color: #666; font-style: italic;">面板物理按键</span>
+        <div id="backlight-hint" style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px; display: none;">
+            <i class="fa fa-info-circle" style="color: #2196f3;"></i> 按键背光灯用于红外感应触发，通道0x0F
+        </div>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-filterDeviceId" style="width: 110px;"><i class="fa fa-id-badge"></i> 门禁ID</label>
+        <input type="number" id="node-input-filterDeviceId" min="0" max="99" style="width: 90px; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+        <span style="margin-left: 10px; font-size: 11px; color: #666;">可选，0=不过滤，>0=只响应指定门禁</span>
+    </div>
+
+    <!-- 目标继电器配置 -->
+    <hr style="margin: 15px 0; border: 0; border-top: 2px solid #e0e0e0;">
+    <div class="form-row">
+        <label style="width: 100%; margin-bottom: 8px;">
+            <i class="fa fa-arrow-right" style="color: #4caf50;"></i> 
+            <span style="font-size: 14px; font-weight: 600; color: #333;">目标继电器配置</span>
+        </label>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-slaveAddress" style="width: 110px;"><i class="fa fa-map-marker"></i> 从站地址</label>
+        <input type="number" id="node-input-slaveAddress" placeholder="10" min="1" max="247" style="width: 90px; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+        <span style="margin-left: 10px; color: #666; font-size: 12px;">Modbus继电器：<strong>10-19</strong></span>
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            主站节点中配置的从站设备地址
+        </div>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-coilNumber" style="width: 110px;"><i class="fa fa-plug"></i> 继电器路数</label>
+        <input type="number" id="node-input-coilNumber" placeholder="1" min="1" max="32" style="width: 90px; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            继电器1-32路，对应线圈0-31，只需填写正确的继电器通道即可
+        </div>
+    </div>
+
+    <!-- 动作配置 -->
+    <hr style="margin: 15px 0; border: 0; border-top: 2px solid #e0e0e0;">
+    <div class="form-row">
+        <label style="width: 100%; margin-bottom: 8px;">
+            <i class="fa fa-bolt" style="color: #ff5722;"></i> 
+            <span style="font-size: 14px; font-weight: 600; color: #333;">动作配置</span>
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-action" style="width: 110px;"><i class="fa fa-play"></i> 动作</label>
+        <select id="node-input-action" style="width: 150px;">
+            <option value="on">打开</option>
+            <option value="off">关闭</option>
+            <option value="follow">跟随输入</option>
+            <option value="toggle">翻转状态</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-delayMs" style="width: 110px;"><i class="fa fa-clock-o"></i> 延时</label>
+        <input type="number" id="node-input-delayMs" min="0" max="60000" style="width: 120px; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+        <span style="margin-left: 5px;">ms</span>
+        <span id="delay-hint" style="margin-left: 10px; color: #f57c00; font-size: 11px;"></span>
+        <div style="font-size: 11px; color: #888; margin-left: 110px; margin-top: 3px;">
+            执行延时（0-60000毫秒），用于实现级联开灯效果
+        </div>
+    </div>
+
+    <div class="form-row">
+        <input type="checkbox" id="node-input-ignoreRelease" style="width: auto; margin-left: 110px;">
+        <label for="node-input-ignoreRelease" style="width: auto;">忽略释放信号（只响应按下）</label>
+    </div>
+    
+    <!-- 配置摘要 -->
+    <div class="form-row" style="margin-top: 20px; padding: 14px; background: linear-gradient(135deg, #e8f5e9 0%, #f1f8f4 100%); border-left: 4px solid #4caf50; border-radius: 6px; box-shadow: 0 2px 4px rgba(0,0,0,0.08);">
+        <div style="font-size: 12px; color: #333; line-height: 1.8;">
+            <div style="font-weight: 600; color: #2e7d32; margin-bottom: 10px; font-size: 13px;">
+                配置摘要
+            </div>
+            <div id="config-summary" style="background: white; padding: 8px; border-radius: 4px; border: 1px solid #c8e6c9; font-size: 12px; color: #555;">
+            </div>
+            <div style="margin-top: 10px; font-size: 11px; color: #666;">
+                <strong>工作原理：</strong>监听按键事件，通过内部事件发送控制命令到主站，<strong>无需连线</strong>
+            </div>
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="relay-output">
+    <p>继电器输出节点，绑定从站开关按键触发继电器动作，或接收外部输入（如海康门禁）。</p>
+    <p><b>无需连线到主站</b>，按键触发后自动通过内部事件控制继电器。</p>
+
+    <h3>RS-485连接配置</h3>
+    <dl class="message-properties">
+        <dt>连接配置 <span class="property-type">config</span></dt>
+        <dd>选择已配置的RS-485连接（支持TCP网关或串口），用于监听开关按键事件</dd>
+    </dl>
+
+    <h3>按键触发配置</h3>
+    <dl class="message-properties">
+        <dt>面板品牌 <span class="property-type">string</span></dt>
+        <dd>开关面板品牌，目前支持亖米（Symi）</dd>
+
+        <dt>按钮类型 <span class="property-type">string</span></dt>
+        <dd>开关按钮/场景按钮/输入端触发</dd>
+
+        <dt>开关ID <span class="property-type">number</span></dt>
+        <dd>物理面板地址（0-255）</dd>
+
+        <dt>按钮编号 <span class="property-type">number</span></dt>
+        <dd>按键编号(1-8，15=背光灯)</dd>
+
+        <dt>门禁ID <span class="property-type">number</span></dt>
+        <dd>可选，0=不过滤，>0=只响应指定门禁编号（用于多门禁场景）</dd>
+    </dl>
+
+    <h3>目标继电器配置</h3>
+    <dl class="message-properties">
+        <dt>从站地址 <span class="property-type">number</span></dt>
+        <dd>要控制的Modbus从站地址(1-247)</dd>
+
+        <dt>继电器路数 <span class="property-type">number</span></dt>
+        <dd>要控制的继电器通道(1-32)</dd>
+    </dl>
+
+    <h3>动作配置</h3>
+    <dl class="message-properties">
+        <dt>动作 <span class="property-type">string</span></dt>
+        <dd>打开/关闭/跟随输入/翻转状态</dd>
+
+        <dt>延时 <span class="property-type">number</span></dt>
+        <dd>执行延时（0-60000毫秒），用于实现级联开灯效果</dd>
+
+        <dt>忽略释放信号 <span class="property-type">boolean</span></dt>
+        <dd>勾选后，只响应按下信号，忽略释放信号</dd>
+    </dl>
+
+    <h3>使用场景</h3>
+    <p><b>场景1：按键触发继电器（无需连线）</b></p>
+    <p>配置开关ID=1，按钮编号=3，当开关1的按钮3被按下时，自动控制目标继电器。</p>
+
+    <p><b>场景2：一个按键控制多路继电器（级联开灯）</b></p>
+    <p>多个继电器输出节点绑定同一个按键（开关ID+按钮编号），配置不同的延时和动作，实现级联开灯效果。</p>
+    <pre>开关ID=1 按钮=3 → 继电器1(1路 延时0ms 打开)
+                 → 继电器2(2路 延时500ms 打开)
+                 → 继电器3(3路 延时1000ms 打开)</pre>
+
+    <p><b>场景3：海康门禁触发（使用输入端）</b></p>
+    <pre>海康门禁事件 → 继电器输出(按钮类型=输入端触发 目标从站10 1路)</pre>
+
+    <h3>工作原理</h3>
+    <p>节点监听 <code>modbus:buttonPressed</code> 事件（按键触发），
+    通过 <code>modbus:writeCoil</code> 事件发送控制命令到主站。</p>
+    
+    <h3>特点</h3>
+    <ul>
+        <li>✅ 完全解耦：无需连线到主站节点</li>
+        <li>✅ 配置持久化：配置自动保存到Node-RED</li>
+        <li>✅ 稳定可靠：长期运行不卡顿、不死机、内存不溢出</li>
+        <li>✅ 断电恢复：断电断网后自动恢复工作</li>
+        <li>✅ 防死循环：内置防抖和状态检测机制</li>
+        <li>✅ 生产就绪：无调试数据输出</li>
+    </ul>
+</script>

package/nodes/relay-output.js

@@ -0,0 +1,233 @@
+/**
+ * 继电器输出节点
+ * 接收触发信号，通过内部事件直接发送命令到Modbus主站
+ * 支持绑定从站开关触发源，实现无需连线的联动
+ * 无需连线到主站，简化流程配置
+ */
+
+module.exports = function(RED) {
+    "use strict";
+
+    function RelayOutputNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // 配置参数 - RS-485连接配置
+        node.serialPortConfig = config.serialPortConfig;
+        
+        // 配置参数 - 按键触发（绑定从站开关）
+        node.switchBrand = config.switchBrand || 'symi';
+        node.buttonType = config.buttonType || 'switch';  // switch, scene, input
+        node.switchId = parseInt(config.switchId) || 0;
+        node.buttonNumber = parseInt(config.buttonNumber) || 1;  // 按键编号(1-8, 15=背光灯)
+        node.filterDeviceId = parseInt(config.filterDeviceId) || 0;  // 0=不过滤，>0=只响应指定门禁ID
+        
+        // 配置参数 - 目标继电器
+        node.name = config.name || '';
+        node.slaveAddress = parseInt(config.slaveAddress) || 10;
+        node.coilNumber = parseInt(config.coilNumber) || 1;
+        
+        // 配置参数 - 动作
+        node.action = config.action || 'on';  // on, off, follow, toggle
+        node.delayMs = parseInt(config.delayMs) || 0;
+        node.ignoreRelease = config.ignoreRelease !== false;  // 默认忽略释放信号
+
+        // 节点状态
+        node.isClosing = false;
+        node.pendingTimer = null;  // 延时定时器
+        node.stateChangeListener = null;  // 状态变化监听器
+
+        // 初始化后延迟启动（防止重启时自动动作）
+        node.initialized = false;
+        node.initTimer = setTimeout(() => {
+            node.initialized = true;
+            const btnLabel = node.buttonNumber == 15 ? '背光灯' : `按键${node.buttonNumber}`;
+            const triggerInfo = node.buttonType === 'input' 
+                ? '← 输入端' 
+                : `← 开关${node.switchId}-${btnLabel}`;
+            node.status({ fill: 'blue', shape: 'ring', text: `就绪 ${triggerInfo} → 从站${node.slaveAddress}-${node.coilNumber}路` });
+        }, 2000);
+
+        // 更新状态显示
+        node.updateStatus = function(text, color) {
+            node.status({ fill: color || 'green', shape: 'dot', text: text });
+        };
+
+        // 监听从站开关按键事件（用于绑定触发源，非输入端模式）
+        if (node.buttonType !== 'input') {
+            node.stateChangeListener = function(data) {
+                // 未初始化时忽略
+                if (!node.initialized || node.isClosing) return;
+
+                // 检查是否匹配触发源
+                const msgSwitchId = data.switchId;
+                const msgButtonNumber = data.button || data.buttonNumber;
+
+                // 开关ID必须匹配
+                if (parseInt(msgSwitchId) !== node.switchId) return;
+
+                // 按键位必须匹配
+                if (parseInt(msgButtonNumber) !== node.buttonNumber) return;
+
+                // 门禁ID匹配（0=不过滤）
+                if (node.filterDeviceId > 0) {
+                    const msgDeviceId = data.deviceId || 0;
+                    if (msgDeviceId > 0 && parseInt(msgDeviceId) !== node.filterDeviceId) return;
+                }
+
+                // 获取触发值
+                const triggerValue = data.value !== undefined ? data.value : data.payload;
+
+                // 忽略释放信号
+                if (node.ignoreRelease && !triggerValue) {
+                    return;
+                }
+
+                // 执行控制
+                const btnLabel = msgButtonNumber == 15 ? '背光灯' : `按键${msgButtonNumber}`;
+                node.executeControl(triggerValue, `开关${msgSwitchId}-${btnLabel}`);
+            };
+
+            RED.events.on('modbus:buttonPressed', node.stateChangeListener);
+            const btnLabel = node.buttonNumber == 15 ? '背光灯' : `按键${node.buttonNumber}`;
+            node.log(`绑定触发源: 开关${node.switchId} ${btnLabel}`);
+        }
+
+        // 发送写入命令到主站（通过内部事件）
+        node.sendWriteCommand = function(value, source) {
+            const coilIndex = node.coilNumber - 1;  // 用户输入1-32，内部使用0-31
+            
+            RED.events.emit('modbus:writeCoil', {
+                slave: node.slaveAddress,
+                coil: coilIndex,
+                value: value,
+                source: 'relay-output',
+                nodeId: node.id
+            });
+
+            const actionText = value ? '打开' : '关闭';
+            const sourceText = source ? ` (${source})` : '';
+            node.updateStatus(`${actionText} → 从站${node.slaveAddress}线圈${node.coilNumber}${sourceText}`, value ? 'green' : 'grey');
+            node.log(`继电器输出: 从站${node.slaveAddress} 线圈${node.coilNumber} ${actionText}${sourceText}`);
+        };
+
+        // 执行控制逻辑
+        node.executeControl = function(triggerValue, source) {
+            // 确定目标值
+            let targetValue;
+            switch (node.action) {
+                case 'on':
+                    targetValue = true;
+                    break;
+                case 'off':
+                    targetValue = false;
+                    break;
+                case 'follow':
+                    targetValue = triggerValue;
+                    break;
+                case 'toggle':
+                    targetValue = !triggerValue;
+                    break;
+                default:
+                    targetValue = true;
+            }
+
+            // 清除之前的延时定时器
+            if (node.pendingTimer) {
+                clearTimeout(node.pendingTimer);
+                node.pendingTimer = null;
+            }
+
+            // 延时执行
+            if (node.delayMs > 0) {
+                node.status({ fill: 'yellow', shape: 'ring', text: `延时${node.delayMs}ms...` });
+                node.pendingTimer = setTimeout(() => {
+                    node.pendingTimer = null;
+                    if (!node.isClosing) {
+                        node.sendWriteCommand(targetValue, source);
+                    }
+                }, node.delayMs);
+            } else {
+                node.sendWriteCommand(targetValue, source);
+            }
+        };
+
+        // 处理输入消息（用于海康门禁等外部设备触发）
+        node.on('input', function(msg, send, done) {
+            // 未初始化时忽略（防止重启时自动动作）
+            if (!node.initialized) {
+                done();
+                return;
+            }
+
+            // 获取触发值
+            let triggerValue = msg.payload;
+            if (typeof triggerValue === 'object' && triggerValue !== null) {
+                triggerValue = triggerValue.value !== undefined ? triggerValue.value : triggerValue.state;
+            }
+
+            // 转换为布尔值
+            const isTriggerOn = triggerValue === true || triggerValue === 'true' || 
+                               triggerValue === 1 || triggerValue === '1' || 
+                               triggerValue === 'ON' || triggerValue === 'on';
+
+            // 忽略释放信号（如果配置了）
+            if (node.ignoreRelease && !isTriggerOn) {
+                node.status({ fill: 'grey', shape: 'ring', text: '忽略释放信号' });
+                done();
+                return;
+            }
+
+            // 门禁ID匹配（输入端模式）
+            if (node.filterDeviceId > 0) {
+                const msgDeviceId = msg.deviceId || 0;
+                if (msgDeviceId > 0 && parseInt(msgDeviceId) !== node.filterDeviceId) {
+                    done();
+                    return;
+                }
+            }
+
+            // 执行控制
+            node.executeControl(isTriggerOn, '输入端');
+
+            // 传递消息到输出（可选，用于连接其他节点如debug）
+            if (send) {
+                msg.relayOutput = {
+                    slave: node.slaveAddress,
+                    coil: node.coilNumber,
+                    delay: node.delayMs
+                };
+                send(msg);
+            }
+
+            done();
+        });
+
+        // 节点关闭时清理
+        node.on('close', function(done) {
+            node.isClosing = true;
+
+            // 清除初始化定时器
+            if (node.initTimer) {
+                clearTimeout(node.initTimer);
+                node.initTimer = null;
+            }
+
+            // 清除延时定时器
+            if (node.pendingTimer) {
+                clearTimeout(node.pendingTimer);
+                node.pendingTimer = null;
+            }
+
+            // 移除按键事件监听器
+            if (node.stateChangeListener) {
+                RED.events.removeListener('modbus:buttonPressed', node.stateChangeListener);
+                node.stateChangeListener = null;
+            }
+
+            done();
+        });
+    }
+
+    RED.nodes.registerType("relay-output", RelayOutputNode);
+};

package/nodes/serial-port-config.html

@@ -126,7 +126,10 @@
     <div class="form-row config-serial-row">
         <label for="node-config-input-baudRate"><i class="fa fa-tachometer"></i> 波特率</label>
         <select id="node-config-input-baudRate" style="width:70%">
-            <option value="9600">9600</option>
+            <option value="1200">1200</option>
+            <option value="2400">2400</option>
+            <option value="4800">4800</option>
+            <option value="9600" selected>9600</option>
             <option value="19200">19200</option>
             <option value="38400">38400</option>
             <option value="57600">57600</option>

package/nodes/serial-port-config.js

@@ -206,7 +206,7 @@ module.exports = function(RED) {
                         parity: node.parity,
                         stopBits: node.stopBits,
                         autoOpen: false,
-                        lock: true  // 明确启用串口锁定
+                        lock: false  // 禁用串口锁定，解决HassOS中"Cannot lock port"错误
                     });
 
                     // 打开串口

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.9.6",
+  "version": "2.9.7",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、可选MQTT集成（支持纯本地模式和MQTT模式）、Home Assistant自动发现、HomeKit网桥、可视化控制看板、自定义协议转换和物理开关面板双向同步，工控机长期稳定运行",
   "main": "nodes/modbus-master.js",
   "scripts": {
@@ -22,7 +22,7 @@
   ],
   "author": {
     "name": "symi-daguo",
-    "email": "symi@example.com"
+    "email": "303316404@qq.com"
   },
   "license": "MIT",
   "engines": {
@@ -40,7 +40,8 @@
       "modbus-debug": "nodes/modbus-debug.js",
       "homekit-bridge": "nodes/homekit-bridge.js",
       "modbus-dashboard": "nodes/modbus-dashboard.js",
-      "custom-protocol": "nodes/custom-protocol.js"
+      "custom-protocol": "nodes/custom-protocol.js",
+      "relay-output": "nodes/relay-output.js"
     }
   },
   "dependencies": {