node-red-contrib-symi-modbus 2.7.2 → 2.7.3

package/README.md

@@ -737,7 +737,7 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 **设备类型说明**：
 - **开关模式**：接收`true`发送打开指令，接收`false`发送关闭指令
-- **窗帘模式**：`true/false`交替触发，循环发送打开→关闭→暂停→打开...
+- **窗帘模式**：无论收到`true`还是`false`，都触发下一个指令，循环顺序：打开 → 暂停 → 关闭 → 暂停 → 打开...
 - **其他模式**：与开关模式相同，接收`true/false`发送对应指令
 
 **功能特性**：
@@ -758,18 +758,23 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 **窗帘模式示例**：
 ```
-第1次收到true  → 发送"打开"指令（例如：01 05 00 00 FF 00 8C 3A）
-第2次收到false → 发送"关闭"指令（例如：01 05 00 00 00 00 CD CA）
-第3次收到true  → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
-第4次收到false → 循环回到"打开"指令
+第1次收到true/false → 发送"打开"指令（例如：01 05 00 00 FF 00 8C 3A）
+第2次收到true/false → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
+第3次收到true/false → 发送"关闭"指令（例如：01 05 00 00 00 00 CD CA）
+第4次收到true/false → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
+第5次收到true/false → 循环回到"打开"指令
 ```
 
+**适配两种开关模式**：
+- **有状态开关**（开关模式）：从站开关关联实际线圈，输出`true/false`交替
+- **无状态开关**（场景模式）：从站开关关联虚拟线圈（如线圈32），每次点击只发`true`或`false`
+
 **技术细节**：
 - 输入消息：`msg.payload = true/false`（从从站开关节点接收）
 - 输出消息：`msg.payload = Buffer`（16进制数据，可连线到debug节点）
 - 16进制字符串自动转换为Buffer格式
 - 支持空格、大小写混合输入，自动格式化
-- 窗帘模式内部维护状态索引，自动循环
+- 窗帘模式内部维护状态索引，自动循环（4个状态：打开→暂停→关闭→暂停）
 
 **注意事项**：
 - 16进制指令最多48字节
@@ -857,42 +862,18 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - Node.js: >=14.0.0
 - Node-RED: >=2.0.0
 
-**最新更新（v2.7.2）**：
-- **🔥 新增自定义协议节点**：
-  - 支持控制非标准Modbus协议的485设备
-  - 三种设备类型：开关（打开/关闭）、窗帘（打开/关闭/暂停循环）、其他（打开/关闭）
-  - 窗帘模式：true/false交替触发，循环发送打开→关闭→暂停→打开...
-  - 16进制指令配置，最多48字节，自动格式化
-  - 配置界面可直接测试发送指令到串口总线
-  - 配置持久化保存，重启后自动恢复
-  - 连线方式：从站开关 → 自定义协议 → debug节点
-
-**历史更新**：
-- **v2.7.1**：新增可视化控制看板节点，实时显示和控制所有继电器状态
-- **v2.7.0**：智能写入队列机制，解决HomeKit群控锁竞争问题，支持160个继电器同时群控
-- **v2.6.8**：新增HomeKit网桥节点，一键桥接到Apple HomeKit，支持Siri语音控制
-- **v2.6.7**：修复LED反馈功能，TCP连接稳定性优化，日志优化
-- **v2.6.6**：解决MQTT日志刷屏问题，局域网IP检测优化
-- **v2.6.5**：修复MQTT报错问题，新增"启用MQTT"勾选框
-- **v2.6.4**：日志优化，大幅减少日志输出
-- **v2.6.3**：MQTT可选配置，完全兼容无MQTT环境
-
-**性能优化**：
-- 轮询间隔优化：修复间隔计算逻辑，确保每个从站使用正确的轮询间隔
-- MQTT发布使用QoS=0，避免阻塞轮询
-- 异步发布状态更新，不影响Modbus读取性能
-- 减少调试日志输出，降低CPU占用
-- 互斥锁机制确保读写操作不冲突
-- 共享连接配置节点，避免串口资源冲突
-- 写入队列20ms间隔，快速响应，总线稳定
-
-**许可证**: MIT License
-
-**作者**: symi-daguo
+## 许可证
+
+MIT License
+
+## 作者
+
+symi-daguo
 - NPM: https://www.npmjs.com/~symi-daguo
 - GitHub: https://github.com/symi-daguo
 
-**支持**:
+## 支持
+
 - Issues: https://github.com/symi-daguo/node-red-contrib-symi-modbus/issues
 - NPM: https://www.npmjs.com/package/node-red-contrib-symi-modbus
 
@@ -919,16 +900,6 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - HEX显示：可选大写、可选时间戳、`maxBytes` 控制显示长度
 - 输出：`msg.payload`（格式化HEX）、`msg.buffer`（原始Buffer）、`msg.meta`（来源信息）
 
-### v2.6.6 重要更新
-
-- 调试节点配置验证修复：根据所选数据来源类型（`serial`/`modbus`）动态校验，避免误报为“配置不正确”
-- 统一侧边栏分类：所有节点统一归类到 `SYMI-MODBUS`
-- 文档更新：补充节点分类、调试节点要点与常见问题处理
-
-典型用法：
-- 联调TCP转RS485网关时，观察上行/下行原始数据帧是否完整。
-- 排查波特率/数据位/校验位配置是否正确（串口模式）。
-- 与 `modbus-master` 或 `modbus-slave-switch` 同时使用，定位现场设备通信异常。
 
 ### MQTT自动发现
 
@@ -1167,29 +1138,26 @@ msg.payload = 1;      // 或 0
 
 ## 项目信息
 
-**版本**: v2.7.2
+**当前版本**: v2.7.3
 
-**核心功能**：
-- 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
-- 多设备轮询（最多10台从站，每台32路继电器，轮询间隔100-10000ms可调）
-- Symi私有协议自动识别（支持两种485开关控制方式）
-- 智能轮询暂停机制（从站上报时自动暂停，处理完成后恢复）
-- 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
-- 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线，支持本地模式和MQTT模式）
-- 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制，名称可自定义）
-- 🔥 **智能写入队列**（所有写入操作串行执行，避免锁竞争，支持HomeKit群控）
-- 🔥 **可视化控制看板**（实时显示和控制所有继电器状态，美观易用，客户友好）
-- 🔥 **自定义协议转换**（支持非标准485协议设备，窗帘循环控制，配置界面可测试）
-- MQTT集成（可选启用，Home Assistant自动发现，实体唯一性保证，QoS=0高性能发布）
-- 物理开关面板双向同步（亖米协议支持，LED反馈同步，支持开关模式和场景模式）
-- 共享连接架构（多个从站开关节点共享同一个串口/TCP连接，支持500+节点）
-- 长期稳定运行（内存管理、智能重连、错误日志限流、异步MQTT发布、TCP永久连接）
+**最新更新**（v2.7.3）：
+- 优化窗帘控制逻辑：打开 → 暂停 → 关闭 → 暂停 → 打开（循环），更符合实际使用场景
+- 优化MQTT断网日志：长期断网时减少日志输出，避免垃圾日志影响性能和硬盘空间
+- 重试间隔优化：从5秒改为30秒，减少重试频率，降低系统负担
+- 日志级别优化：MQTT错误从error改为debug，不写入日志文件
 
 **技术栈**：
-- modbus-serial: ^8.0.23（内部封装serialport，支持TCP和串口）
-- serialport: ^12.0.0（原生串口通信）
-- mqtt: ^5.14.1（最新稳定版，可选依赖）
-- hap-nodejs: ^1.2.0（HomeKit桥接）
-- node-persist: ^4.0.4（持久化存储）
 - Node.js: >=14.0.0
 - Node-RED: >=2.0.0
+- modbus-serial: ^8.0.23
+- serialport: ^12.0.0
+- mqtt: ^5.14.1（可选）
+- hap-nodejs: ^1.2.0
+- node-persist: ^4.0.4
+
+**历史版本**：
+- v2.7.2: 新增自定义协议节点，支持非标准485协议设备
+- v2.7.1: 新增可视化控制看板节点
+- v2.7.0: 智能写入队列机制，支持HomeKit群控
+- v2.6.8: 新增HomeKit网桥节点
+- v2.6.7及更早: 基础功能实现

package/nodes/custom-protocol.js

@@ -83,7 +83,7 @@ module.exports = function(RED) {
         // 处理输入消息
         node.on('input', function(msg) {
             var value = msg.payload;
-            
+
             // 只接受布尔值
             if (typeof value !== 'boolean') {
                 node.warn('输入必须为true/false，当前类型: ' + typeof value);
@@ -91,38 +91,41 @@ module.exports = function(RED) {
             }
 
             if (node.config.deviceType === 'curtain') {
-                // 窗帘模式：true/false交替触发，循环发送三个指令
+                // 窗帘模式：无论收到true还是false，都触发下一个指令
+                // 适配有状态开关（true/false交替）和无状态开关（只发true或false）
+                // 循环顺序：打开 → 暂停 → 关闭 → 暂停 → 打开...
                 var commands = [
                     {name: '打开', hex: node.config.openCmd},
+                    {name: '暂停', hex: node.config.pauseCmd},
                     {name: '关闭', hex: node.config.closeCmd},
                     {name: '暂停', hex: node.config.pauseCmd}
                 ];
-                
+
                 // 获取当前指令
                 var currentCmd = commands[node.curtainStateIndex];
                 if (!currentCmd || !currentCmd.hex) {
                     node.warn('窗帘模式缺少' + currentCmd.name + '指令配置');
                     return;
                 }
-                
+
                 // 转换并发送
                 var buffer = hexStringToBuffer(currentCmd.hex);
                 if (buffer) {
                     sendCommand(buffer, currentCmd.name);
-                    
-                    // 移动到下一个状态
-                    node.curtainStateIndex = (node.curtainStateIndex + 1) % 3;
+
+                    // 移动到下一个状态（无论收到true还是false）
+                    node.curtainStateIndex = (node.curtainStateIndex + 1) % 4;
                 }
             } else {
                 // 开关/其他模式：true发送打开，false发送关闭
                 var cmdName = value ? '打开' : '关闭';
                 var hexString = value ? node.config.openCmd : node.config.closeCmd;
-                
+
                 if (!hexString) {
                     node.warn(cmdName + '指令未配置');
                     return;
                 }
-                
+
                 var buffer = hexStringToBuffer(hexString);
                 if (buffer) {
                     sendCommand(buffer, cmdName);

package/nodes/modbus-slave-switch.js

@@ -691,55 +691,59 @@ module.exports = function(RED) {
                     node.mqttClient.on('error', (err) => {
                         // 连接失败，尝试下一个候选地址
                         const errorMsg = err.message || err.code || '连接失败';
-                        node.warn(`MQTT连接错误: ${errorMsg} (broker: ${brokerUrl})`);
-                        
                         const now = Date.now();
+
+                        // 使用日志限流，避免长期断网时产生垃圾日志
+                        const shouldLogError = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+                        if (shouldLogError) {
+                            node.debug(`MQTT连接错误: ${errorMsg} (broker: ${brokerUrl})`);
+                        }
+
                         const timeSinceLastAttempt = now - lastConnectAttempt;
-                        
-                        // 避免频繁重试（至少等待1秒），但仍要记录错误
+
+                        // 避免频繁重试（至少等待1秒）
                         if (timeSinceLastAttempt < 1000) {
                             setTimeout(() => {
                                 tryNextBroker();
                             }, 1000);
                             return;
                         }
-                        
+
                         tryNextBroker();
-                        
+
                         function tryNextBroker() {
                             // 尝试下一个候选地址
                             currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
                             const nextBroker = brokerCandidates[currentCandidateIndex];
-                            
+
                             // 如果回到第一个地址，说明所有地址都试过了
                             if (currentCandidateIndex === 0) {
                                 // 判断是否是局域网IP配置（只有一个候选地址）
                                 const isSingleIpConfig = brokerCandidates.length === 1;
-                                
-                                if (isSingleIpConfig) {
-                                    // 局域网IP配置失败，立即输出错误（不受日志限流限制）
-                                    node.error(`MQTT连接失败: ${errorMsg}`);
-                                    node.error(`无法连接到MQTT broker: ${brokerCandidates[0]}`);
-                                    node.error('请检查：1) MQTT broker是否在该地址运行  2) 网络是否连通  3) 端口是否正确');
-                                    node.error('提示：可以使用命令测试: telnet 192.168.2.12 1883');
-                                } else {
-                                    // 多个fallback地址都失败，使用日志限流
-                                    const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
-                                    
-                                    if (shouldLog) {
-                                        node.error(`MQTT错误: ${errorMsg}`);
-                                        node.error(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
-                                        node.error('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
-                                        node.error('提示：如果Node-RED运行在Docker容器中，可能需要使用host.docker.internal或容器IP [此错误将在10分钟后再次显示]');
-                                        node.lastMqttErrorLog = now;
+
+                                // 使用日志限流，避免长期断网时产生垃圾日志
+                                const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+
+                                if (shouldLog) {
+                                    if (isSingleIpConfig) {
+                                        // 局域网IP配置失败，使用debug级别（不写入日志文件）
+                                        node.debug(`MQTT连接失败: ${errorMsg}`);
+                                        node.debug(`无法连接到MQTT broker: ${brokerCandidates[0]}`);
+                                        node.debug('请检查：1) MQTT broker是否在该地址运行  2) 网络是否连通  3) 端口是否正确');
+                                    } else {
+                                        // 多个fallback地址都失败，使用debug级别
+                                        node.debug(`MQTT错误: ${errorMsg}`);
+                                        node.debug(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
+                                        node.debug('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
                                     }
+                                    node.lastMqttErrorLog = now;
                                 }
-                                
-                                // 5秒后重试第一个地址
+
+                                // 30秒后重试第一个地址（从5秒改为30秒，减少重试频率）
                                 setTimeout(() => {
                                     node.debug('重试连接MQTT broker...');
                                     tryConnect(brokerCandidates[0]);
-                                }, 5000);
+                                }, 30000);
                             } else {
                                 node.debug(`尝试备用MQTT broker: ${nextBroker}`);
                                 setTimeout(() => {
@@ -747,7 +751,7 @@ module.exports = function(RED) {
                                 }, 500);  // 快速尝试下一个地址
                             }
                         }
-                        
+
                         node.updateStatus();
                     });
                     
@@ -758,16 +762,16 @@ module.exports = function(RED) {
                     node.mqttClient.on('offline', () => {
                         const now = Date.now();
                         const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
-                        
+
                         if (shouldLog) {
-                            node.warn('MQTT离线，正在尝试重连...');
+                            node.debug('MQTT离线，正在尝试重连...');
                             node.lastMqttErrorLog = now;
                         }
-                        
+
                         // 尝试下一个候选地址
                         currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
                         const nextBroker = brokerCandidates[currentCandidateIndex];
-                        
+
                         setTimeout(() => {
                             tryConnect(nextBroker);
                         }, 2000);

package/package.json

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