node-red-contrib-symi-modbus 2.9.3 → 2.9.4

package/README.md

@@ -888,29 +888,17 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.9.3 (2025-12-15)
+**当前版本**: v2.9.4 (2025-12-15)
 
-**v2.9.3 更新内容**：
+**v2.9.4 更新内容**：
 - **重要修复**：场景按钮LED反馈不同步问题
-  - 修复场景按钮帧使用特殊通道（如0x0F）导致LED反馈失效的问题
-  - 场景模式保持使用配置计算的按键通道，不被帧中的特殊标识覆盖
-  - 解决"部署后场景按钮可以同步一次，点击其他开关后不再同步"的问题
-- **优化**：场景按钮匹配逻辑
-  - 增加场景模式帧的特殊匹配：通道0x0F或isSceneMode标识
-  - 同一面板的场景按钮现在能正确识别和处理
-
-**v2.9.2 更新内容**：
-- **稳定性增强**：全局防抖缓存定期清理机制
-  - 每10分钟自动清理超过1分钟未使用的防抖记录
-  - 防止长期运行时内存缓慢增长
-- **稳定性增强**：Mesh无线模式按键注册清理
-  - 节点关闭时正确清理meshWirelessButtons全局Map
-  - 避免重新部署时残留无效注册信息
-- **代码审查**：全面检查所有节点代码
-  - 确认所有定时器在节点关闭时正确清理
-  - 确认所有事件监听器正确注销
-  - 确认所有连接资源正确释放
-  - 支持断电断网后自动恢复运行
+  - 修复场景按钮按下后背光灯不跟随继电器状态变化的bug
+  - 问题根因：场景模式下currentState提前更新，导致后续状态变化事件被认为"未变化"而跳过LED反馈
+  - 解决方案：场景按钮触发时立即发送LED反馈，不等待状态变化事件
+- **新功能**：按键背光灯选项
+  - 在按钮编号下拉框中新增"按键背光灯"选项（通道0x0F）
+  - 用于红外感应触发背光灯的联动控制
+  - 未选择此选项时，红外感应帧会被正确忽略，避免误触发
 
 **核心特性**：
 - 支持Modbus RTU/TCP协议，兼容标准Modbus设备和TCP转RS485网关

package/nodes/modbus-slave-switch.html

@@ -37,7 +37,8 @@
             } else {
                 // 开关模式和场景模式显示
                 const coilDisplay = this.targetCoilNumber || 1;
-                return this.name || `开关${this.switchId}-按钮${this.buttonNumber} → 继电器${this.targetSlaveAddress}-${coilDisplay}路`;
+                const btnLabel = this.buttonNumber == 15 ? '背光灯' : `按钮${this.buttonNumber}`;
+                return this.name || `开关${this.switchId}-${btnLabel} → 继电器${this.targetSlaveAddress}-${coilDisplay}路`;
             }
         },
         oneditprepare: function() {
@@ -68,6 +69,16 @@
                 }
             });
 
+            // 按钮编号切换时显示/隐藏背光灯提示
+            $("#node-input-buttonNumber").on("change", function() {
+                const buttonNumber = $(this).val();
+                if (buttonNumber === '15') {
+                    $("#backlight-hint").show();
+                } else {
+                    $("#backlight-hint").hide();
+                }
+            });
+
             // Mesh设备发现按钮
             $("#btn-discover-mesh").on("click", function() {
                 const serialPortConfig = $("#node-input-serialPortConfig").val();
@@ -297,8 +308,12 @@
             <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>
 
     <!-- Mesh模式配置 -->

package/nodes/modbus-slave-switch.js

@@ -442,11 +442,11 @@ module.exports = function(RED) {
         node.hasReceivedInitialState = false;
 
         // 根据按钮编号计算deviceAddr和channel（用于LED反馈）
-        // Symi协议公式：按键编号 = deviceAddr * 4 - 4 + channel
-        // 反推公式：deviceAddr = floor((buttonNumber - 1) / 4) + 1, channel = ((buttonNumber - 1) % 4) + 1
-        // 这样即使没有物理按键事件，也能正确发送LED反馈
-        node.buttonDeviceAddr = Math.floor((node.config.buttonNumber - 1) / 4) + 1;
-        node.buttonChannel = ((node.config.buttonNumber - 1) % 4) + 1;
+        // 8键面板：deviceAddr固定为1，channel直接使用按键编号1-8
+        // 这是因为8键面板的帧格式是 deviceAddr=1, channel=1-8，不是按4通道分组
+        // 例如：按键7的LED反馈帧是 7E 01 04 0F 01 00 01 07 ...（deviceAddr=1, channel=7）
+        node.buttonDeviceAddr = 1;
+        node.buttonChannel = node.config.buttonNumber;
         
         // MQTT主题（映射到继电器设备）
         node.stateTopic = `${node.config.mqttBaseTopic}/${node.config.targetSlaveAddress}/${node.config.targetCoilNumber}/state`;
@@ -729,14 +729,18 @@ module.exports = function(RED) {
                     // RS-485模式或非Mesh模式：只处理自己绑定的线圈
                     // 检查状态是否真正变化
                     const stateChanged = (node.currentState !== value);
+                    
+                    // 区分触发源：按键触发时LED反馈已在handleRs485Data中发送
+                    const isButtonPress = (triggerSource === 'button-press' || triggerSource === 'scene-trigger');
 
                     // 更新当前状态
                     node.currentState = value;
                     node.lastStateChange.timestamp = Date.now();
                     node.lastStateChange.value = value;
 
-                    if (stateChanged) {
-                        // RS-485模式：立即发送LED反馈（不需要防抖）
+                    if (stateChanged && !isButtonPress) {
+                        // RS-485模式：状态变化且非按键触发时发送LED反馈
+                        // 按键触发的LED反馈已在handleRs485Data中发送，避免重复
                         node.sendCommandToPanel(value);
                     }
 
@@ -788,35 +792,24 @@ module.exports = function(RED) {
                         continue; // 静默忽略非按键事件
                     }
 
-                    // 计算实际按键编号（Symi协议公式）
-                    // 例如：devAddr=1,channel=1→按键1；devAddr=2,channel=1→按键5
-                    const actualButtonNumber = buttonEvent.deviceAddr * 4 - 4 + buttonEvent.channel;
+                    // 计算实际按键编号
+                    // 8键面板：deviceAddr=1时，channel直接就是按键编号1-8
+                    // 例如：devAddr=1,channel=7→按键7
+                    // 特殊：channel=0x0F(15)是红外感应触发背光灯
+                    const actualButtonNumber = (buttonEvent.deviceAddr === 1) ? buttonEvent.channel : (buttonEvent.deviceAddr * 4 - 4 + buttonEvent.channel);
 
                     // 检查是否是我们监听的开关面板和按钮
                     // switchId对应本地地址（物理面板地址）
-                    // buttonNumber对应实际按键编号（1-8）
+                    // buttonNumber对应实际按键编号（1-8，或15表示背光灯）
                     // 
-                    // 重要：场景按钮的帧通道可能是特殊标识（如0x0F），而不是实际按键通道
-                    // 因此需要额外判断：如果是场景模式且localAddr匹配，也应该处理
-                    const isSceneModeFrame = buttonEvent.isSceneMode || buttonEvent.channel === 0x0F;
-                    const isMatchedByButtonNumber = (buttonEvent.raw.localAddr === node.config.switchId && actualButtonNumber === node.config.buttonNumber);
-                    const isMatchedBySceneMode = (buttonEvent.raw.localAddr === node.config.switchId && node.config.buttonType === 'scene' && isSceneModeFrame);
+                    // 注意：通道0x0F是红外感应触发背光灯
+                    // 只有当用户配置了buttonNumber=15（按键背光灯）时才处理该帧
+                    // 否则忽略红外感应帧（避免误触发普通按键事件）
+                    if (buttonEvent.channel === 0x0F && node.config.buttonNumber !== 15) {
+                        continue; // 忽略红外感应帧（仅当未配置为背光灯模式时）
+                    }
                     
-                    if (isMatchedByButtonNumber || isMatchedBySceneMode) {
-                        // 只有开关模式才更新deviceAddr和channel为实际值
-                        // 场景模式保持使用配置计算的值，因为场景帧的通道（如0x0F）是特殊标识，不是LED反馈通道
-                        if (!isSceneModeFrame && node.config.buttonType !== 'scene') {
-                            const oldDeviceAddr = node.buttonDeviceAddr;
-                            const oldChannel = node.buttonChannel;
-                            node.buttonDeviceAddr = buttonEvent.deviceAddr;
-                            node.buttonChannel = buttonEvent.channel;
-
-                            // 输出调试日志，对比计算值和实际值
-                            if (oldDeviceAddr !== buttonEvent.deviceAddr || oldChannel !== buttonEvent.channel) {
-                                node.log(`按键事件更新LED反馈地址：计算值(设备${oldDeviceAddr} 通道${oldChannel}) → 实际值(设备${buttonEvent.deviceAddr} 通道${buttonEvent.channel})`);
-                            }
-                        }
-
+                    if (buttonEvent.raw.localAddr === node.config.switchId && actualButtonNumber === node.config.buttonNumber) {
                         // 判断按钮类型：优先使用协议解析结果，其次使用配置
                         const isSceneMode = buttonEvent.isSceneMode ||
                                            node.config.buttonType === 'scene' ||
@@ -844,6 +837,10 @@ module.exports = function(RED) {
                             // 场景模式：切换状态（每次触发时翻转）
                             node.currentState = !node.currentState;
                             node.sendMqttCommand(node.currentState);
+                            
+                            // 场景模式：立即发送LED反馈（修复：不等待状态变化事件）
+                            // 因为currentState已经更新，后续的coilStateChanged事件会被认为"状态未变化"而跳过
+                            node.sendCommandToPanel(node.currentState);
                         } else {
                             // 开关模式：根据状态发送ON/OFF
                             node.debug(`开关${buttonEvent.state ? 'ON' : 'OFF'}: 面板${node.config.switchId} 按键${node.config.buttonNumber}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.9.3",
+  "version": "2.9.4",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、可选MQTT集成（支持纯本地模式和MQTT模式）、Home Assistant自动发现、HomeKit网桥、可视化控制看板、自定义协议转换和物理开关面板双向同步，工控机长期稳定运行",
   "main": "nodes/modbus-master.js",
   "scripts": {