node-red-contrib-symi-modbus 2.2.0 → 2.3.0

package/README.md

@@ -2,69 +2,6 @@
 
 Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成。
 
-> **最新版本 v2.2.0** - 修复Modbus读写并发冲突，实现100%稳定控制
-
-## 版本更新
-
-### v2.2.0 (2025-10-20) - 关键并发问题修复
-
-**核心修复**：
-- 修复Modbus读取（轮询）和写入（控制）之间的并发冲突问题
-- 添加互斥锁机制，确保读写操作不冲突
-- 写入后100ms内暂停该从站轮询，避免读到旧值覆盖新值
-- 改进写入函数为async/await，支持错误捕获和传递
-- 优化MQTT命令处理，异步执行并捕获错误
-- 实现100%稳定控制和状态反馈
-
-**问题描述**（v2.1.0及之前版本）：
-- 轮询每200ms读取32个线圈状态
-- MQTT命令随时写入单个线圈
-- 两者没有互斥保护，会冲突导致写入失败
-- 写入成功后轮询可能立即读到旧值，覆盖刚写入的新值
-- 控制成功率低，尤其是快速连续控制时
-
-**修复后效果**：
-- 轮询检测到写操作时主动跳过，避免冲突
-- 写入操作等待轮询完成后执行，最多等待500ms
-- 写入后100ms内不轮询该从站，确保设备状态已更新
-- 读写操作完全互斥，保证数据一致性
-- 控制成功率100%，状态反馈实时准确
-
-**技术实现**：
-```javascript
-// 添加互斥锁
-node.modbusLock = false;
-node.lastWriteTime = {};
-
-// 轮询时检查锁
-if (node.modbusLock) {
-    return;  // 跳过本次轮询
-}
-
-// 写入时设置锁
-node.modbusLock = true;
-await node.client.writeCoil(coil, value);
-node.lastWriteTime[slaveId] = Date.now();
-node.modbusLock = false;
-```
-
-**测试验证**：
-- 32路线圈连续快速控制，成功率100%
-- 轮询间隔200ms，写入响应<100ms
-- HA控制稳定，状态实时同步
-- 适合Linux工控机24/7长期稳定运行
-
----
-
-**升级方式**：
-```bash
-cd ~/.node-red
-npm install node-red-contrib-symi-modbus@latest
-# 重启Node-RED生效
-```
-
----
-
 ## 功能特性
 
 - 多协议支持：支持Modbus TCP和Modbus RTU（串口）
@@ -569,6 +506,51 @@ docker run --privileged ...
 - **稳定运行**：经过工控机7x24小时长期运行验证，无内存泄漏
 - **容错能力**：Modbus从站离线不影响其他从站，MQTT断线自动重连
 
+
+> **最新版本 v2.3.0** - Symi轻量级协议完美支持，8键开关面板按键识别正常，MQTT双向同步稳定
+
+## 版本更新
+
+### v2.3.0 (2025-10-20) - Symi轻量级协议支持完善
+
+**核心修复**：
+- 修复从站开关节点对Symi轻量级协议的解析支持
+- 协议检测同时支持SET(0x03)和REPORT(0x04)类型帧（面板按键发送SET类型）
+- 添加详细的RS485数据接收日志（十六进制输出）
+- 增强连接状态提示（RS485连接成功会明确显示）
+- 添加完整的按键事件检测日志（设备地址、通道、状态匹配）
+- 确保从站开关与主站轮询的双向同步不冲突
+
+**协议修复说明**：
+- Symi 8键开关面板按键时发送 `7E 01 03 0F 01 00 01 [01-08] 00 00 00 00 01 [CRC] 7D`
+- 数据类型为 `0x03`(SET)，不是 `0x04`(REPORT)
+- 旧版本只检测REPORT类型，导致无法识别物理按键
+- 新版本同时支持SET和REPORT，完美兼容所有Symi协议设备
+
+**调试增强**：
+- RS485数据接收时输出原始十六进制数据
+- 协议解析成功输出设备地址、通道、数据类型、操作码
+- 按键匹配成功输出完整的状态信息
+- 按键不匹配时输出期望值和实际值对比
+- 所有日志级别合理，不会造成系统负担
+
+**测试验证**：
+- 本地Node-RED环境测试通过
+- 8键开关面板按键识别正常
+- MQTT双向同步稳定
+- 适合Linux工控机24/7长期稳定运行
+
+---
+
+**升级方式**：
+```bash
+cd ~/.node-red
+npm install node-red-contrib-symi-modbus@latest
+# 重启Node-RED生效
+```
+
+---
+
 ## 许可证
 
 MIT License

package/nodes/lightweight-protocol.js

@@ -220,9 +220,9 @@ module.exports = {
     detectButtonPress: function(frame) {
         if (!frame) return null;
         
-        // 检查是否是灯光设备的上报
+        // 检查是否是灯光设备的SET或REPORT（面板按键会发送SET类型）
         if (frame.deviceType === this.DEVICE_TYPE_LIGHT && 
-            frame.dataType === this.DATA_TYPE_REPORT) {
+            (frame.dataType === this.DATA_TYPE_REPORT || frame.dataType === this.DATA_TYPE_SET)) {
             
             if (frame.opCode === this.LIGHT_OP_SINGLE) {
                 // 单灯按键按下

package/nodes/modbus-slave-switch.js

@@ -185,7 +185,8 @@ module.exports = function(RED) {
                     await node.rs485Client.connectTCP(node.config.tcpHost, {
                         port: node.config.tcpPort
                     });
-                    node.log(`已连接到RS-485 TCP: ${node.config.tcpHost}:${node.config.tcpPort}`);
+                    node.log(`RS485连接成功（TCP）: ${node.config.tcpHost}:${node.config.tcpPort}`);
+                    node.log(`监听Symi开关${node.config.switchId}的按钮${node.config.buttonNumber}按键事件...`);
                 } else {
                     // 串口连接验证
                     if (!node.config.serialPort) {
@@ -197,7 +198,8 @@ module.exports = function(RED) {
                         stopBits: node.config.serialStopBits || 1,
                         parity: node.config.serialParity || 'none'
                     });
-                    node.log(`已连接到RS-485串口: ${node.config.serialPort}`);
+                    node.log(`RS485连接成功（串口）: ${node.config.serialPort} @ ${node.config.serialBaudRate || 9600}bps`);
+                    node.log(`监听Symi开关${node.config.switchId}的按钮${node.config.buttonNumber}按键事件...`);
                 }
                 
                 node.rs485Client.setTimeout(5000);
@@ -253,40 +255,55 @@ module.exports = function(RED) {
         // 处理RS-485接收到的数据
         node.handleRs485Data = function(data) {
             try {
+                // 输出原始数据（十六进制）- 方便调试
+                const hexData = Array.from(data).map(b => b.toString(16).padStart(2, '0').toUpperCase()).join(' ');
+                node.log(`RS485收到数据: ${hexData}`);
+                
                 // 解析轻量级协议帧
                 const frame = protocol.parseFrame(data);
                 if (!frame) {
-                    return; // 无效帧
+                    node.warn(`无效的协议帧（CRC校验失败或格式错误）: ${hexData}`);
+                    return;
                 }
                 
+                node.log(`解析成功: 设备地址=${frame.deviceAddr} 通道=${frame.channel} 数据类型=0x${frame.dataType.toString(16).toUpperCase()} 操作码=0x${frame.opCode.toString(16).toUpperCase()}`);
+                
                 // 检测是否是按键按下事件
                 const buttonEvent = protocol.detectButtonPress(frame);
                 if (!buttonEvent) {
-                    return; // 不是按键事件
+                    node.log(`不是按键事件（设备类型=${frame.deviceType} 数据类型=${frame.dataType} 操作码=${frame.opCode}）`);
+                    return;
                 }
                 
+                node.log(`检测到按键事件: 类型=${buttonEvent.type} 设备=${buttonEvent.deviceAddr} 通道=${buttonEvent.channel}`);
+                
                 // 检查是否是我们监听的开关和按钮
                 if (buttonEvent.deviceAddr === node.config.switchId) {
                     if (buttonEvent.type === 'single') {
                         // 单键按下
                         if (buttonEvent.channel === node.config.buttonNumber) {
-                            node.log(`检测到按键按下: 开关${node.config.switchId} 按钮${node.config.buttonNumber} 状态=${buttonEvent.state}`);
+                            node.log(`匹配成功！开关${node.config.switchId} 按钮${node.config.buttonNumber} 状态=${buttonEvent.state ? 'ON' : 'OFF'}`);
                             // 发送MQTT命令到继电器
                             node.sendMqttCommand(buttonEvent.state);
+                        } else {
+                            node.log(`按钮编号不匹配: 收到${buttonEvent.channel} 期望${node.config.buttonNumber}`);
                         }
                     } else if (buttonEvent.type === 'multi') {
                         // 多键按下
                         const buttonIndex = node.config.buttonNumber - 1; // 转换为0-7索引
                         if (buttonIndex >= 0 && buttonIndex < 8) {
                             const state = buttonEvent.buttonStates[buttonIndex];
-                            node.log(`检测到多键事件: 开关${node.config.switchId} 按钮${node.config.buttonNumber} 状态=${state}`);
+                            node.log(`匹配成功！开关${node.config.switchId} 多键按钮${node.config.buttonNumber} 状态=${state ? 'ON' : 'OFF'}`);
                             // 发送MQTT命令到继电器
                             node.sendMqttCommand(state);
                         }
                     }
+                } else {
+                    node.log(`开关ID不匹配: 收到${buttonEvent.deviceAddr} 期望${node.config.switchId}`);
                 }
             } catch (err) {
-                node.warn(`解析RS-485数据失败: ${err.message}`);
+                node.error(`解析RS-485数据失败: ${err.message}`);
+                node.error(`错误数据: ${Array.from(data).map(b => b.toString(16).padStart(2, '0').toUpperCase()).join(' ')}`);
             }
         };
         

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、智能MQTT连接（自动fallback HassOS/Docker环境）、Home Assistant自动发现和多品牌开关面板，生产级稳定版本",
   "main": "nodes/modbus-master.js",
   "scripts": {