node-red-contrib-symi-modbus 2.8.5 → 2.8.7

package/README.md

@@ -63,11 +63,11 @@ node-red-restart
 3. **无需连线**：主站和从站通过内部事件自动通信
 
 **优势**：
-- ✅ 断网也能稳定运行
-- ✅ 不依赖外部服务
-- ✅ 响应速度更快
-- ✅ 配置更简单
-- ✅ 无需手动连线（免连线通信）
+- 断网也能稳定运行
+- 不依赖外部服务
+- 响应速度更快
+- 配置更简单
+- 无需手动连线（免连线通信）
 
 #### 模式2：MQTT模式（推荐用于Home Assistant集成）
 
@@ -85,9 +85,9 @@ node-red-restart
    - 基础主题: `modbus/relay` (默认)
 
 **优势**：
-- ✅ Home Assistant自动发现
-- ✅ 支持远程控制
-- ✅ 状态持久化存储
+- Home Assistant自动发现
+- 支持远程控制
+- 状态持久化存储
 
 ### 3. 配置主站节点
 
@@ -199,12 +199,12 @@ node-red-restart
    - 继电器状态变化会自动反馈到Mesh开关LED
 
 **Mesh模式特点**：
-- ✅ 无线控制，无需布线
-- ✅ 支持1-6路开关
-- ✅ 双向同步（按键→继电器，继电器→LED）
-- ✅ 设备列表持久化保存
-- ✅ 短地址自动更新（如果网关重新配网）
-- ✅ 与RS-485开关使用方式完全一致
+- 无线控制，无需布线
+- 支持1-6路开关
+- 双向同步（按键→继电器，继电器→LED）
+- 设备列表持久化保存
+- 短地址自动更新（如果网关重新配网）
+- 与RS-485开关使用方式完全一致
 
 ### 6. 配置HomeKit网桥节点（可选）
 
@@ -884,93 +884,28 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.8.4
-
-### v2.8.4 (2025-11-11)
-
-**核心优化**：
-- **移除首次部署LED同步延迟**：部署/重启后立即同步所有LED状态（1秒内完成）
-  - 移除固定5秒初始化延迟限制
-  - 识别首次轮询（source: 'init'），允许立即发送LED反馈
-  - 通过队列机制自动限速（40ms间隔），不会造成总线拥堵
-  - 用户体验提升：重启后立即看到正确的LED状态
-
-**稳定性增强**：
-- **内存泄漏防护**：每5分钟自动检查监听器数量、队列长度、Buffer大小
-  - 监听器数量超过100个时告警
-  - 队列积压超过1000个时自动清理（保留最新100个）
-  - 帧缓冲区超过10KB时自动清空
-  - 确保长期稳定运行，不死机不卡顿
-- **日志防护**：错误日志限流（每5分钟最多输出一次），避免硬盘被日志填满
-- **资源清理**：节点关闭时正确清理所有定时器和监听器，防止内存泄漏
-
-**实际使用场景优化**：
-- 主站轮询：200ms/台，5台从站 = 1秒完成一轮
-- 开关面板：支持50个以内，约200个按钮（设计极限500+按钮）
-- Mesh设备发现：仅首次手动触发，已持久化，后续部署不再触发
-- 部署后立即同步：主站首次轮询完成后，所有LED状态立即同步（1秒内）
-
-**配置持久化**：
-- 所有配置参数本地持久化存储
-- Node-RED重启后自动恢复，不受重启影响
-- Mesh设备列表持久化，无需重复扫描
-- 断网/通网、断电/通电不影响正常运行
-
-
-### v2.8.3 (2025-11-11)
-
-**核心功能**：
-- **Mesh开关完整支持**：支持Symi蓝牙Mesh网关和1-6路Mesh开关，实现双向状态同步
-  - 全局共享状态管理：同一Mesh设备的多个按钮节点共享状态数组，确保LED反馈正确
-  - Mesh控制帧格式：完全兼容Symi Mesh协议，支持1/2/3/4/6路开关
-  - 设备持久化：Mesh设备列表自动保存，重启无需重新扫描
-  - LED状态同步：继电器状态变化时自动同步到Mesh开关LED指示灯
-  - **彻底解决Mesh开关LED不跟随继电器状态同步的问题**
-
-**重要修复**：
-- **修复串口锁定问题**：优化监听器注销逻辑，添加2秒延迟关闭机制，避免Mesh设备发现等临时操作导致串口频繁开关
-  - 问题原因：Mesh设备发现API注销监听器时立即关闭串口，导致其他节点无法打开串口（Resource temporarily unavailable Cannot lock port）
-  - 解决方案：监听器注销后延迟2秒关闭连接，给其他节点注册监听器的机会，确保485串口和TCP网关都能正常工作
-- 修复Mesh LED反馈状态不同步问题：引入全局共享状态Map，所有按钮节点共享同一个状态数组
-- 修复Mesh控制帧格式错误：移除多余参数，修正长度字段，确保与Mesh网关协议一致
-- 修复部署后LED指示灯不同步问题：主站首次轮询时主动广播所有线圈状态
-- 优化初始化逻辑：从站开关节点无需查询状态，主站节点主动推送，更加高效可靠
-
-**稳定性增强**：
-- 完整的资源清理：所有定时器、监听器、连接在节点关闭时正确释放，防止内存泄漏
-- 断网重连机制：TCP连接断开后自动重连，不影响本地串口通信
-- 防抖机制：避免重复处理同一按键事件，防止死循环
-- 全局队列优化：40ms间隔 + 智能优先队列，确保长期稳定流畅运行
-- 串行发送：所有LED反馈按优先级和加入顺序依次发送，间隔40ms（TCP和串口统一）
-- 去重机制：每个节点50ms内不重复发送相同状态，避免总线拥堵
-- 延迟关闭机制：连接在所有监听器注销后延迟2秒关闭，避免临时操作导致连接频繁开关
-
-**典型场景说明**：
-1. **场景1：单个继电器控制**
-   - 按下开关 → 设置触发源 → 继电器动作 → LED反馈优先加入队列 → 40ms后发送
-   - 该面板的LED反馈会优先处理，响应最快
-
-2. **场景2：批量控制（如17通道全开，16个继电器）**
-   - 触发17通道 → 设置触发源（操作的面板） → 1-16路继电器全开
-   - 假设每个继电器绑定2个开关面板 = 32个LED反馈
-   - 触发源面板的LED反馈优先处理（最快响应）
-   - 其他面板按加入队列的顺序依次发送，耗时约1280ms（40ms×32）
-
-3. **场景3：快速切换（如17通道全开后立即18通道全关）**
-   - 17通道触发 → 设置触发源 → 1-16路全开 → 触发源面板优先反馈
-   - 18通道触发 → 更新触发源 → 1-16路全关 → 新触发源面板优先反馈
-   - 全局队列按优先级和顺序处理，确保所有面板最终显示正确状态
-
-4. **场景4：双控开关（1个继电器绑定2个不同ID的开关面板）**
-   - 继电器状态变化 → 2个LED反馈加入全局队列
-   - 如果是其中一个面板触发的，该面板优先反馈
-   - 另一个面板按顺序发送，间隔40ms
-
-5. **场景5：大规模部署（50个8键开关 = 400个按键）**
-   - 批量控制触发 → 设置触发源 → 所有LED反馈加入全局队列
-   - 触发源面板优先反馈（用户最快看到响应）
-   - 其他面板按部署时的节点顺序依次发送，耗时约16秒（40ms×400）
-   - 确保总线稳定，不会冲突或丢失
+**当前版本**: v2.8.7 (2025-11-12)
+
+**核心特性**：
+- 支持Modbus RTU/TCP协议，兼容标准Modbus设备和TCP转RS485网关
+- 支持Symi RS-485开关和蓝牙Mesh开关，实现双向状态同步
+- 内置HomeKit网桥，支持Siri语音控制
+- 可视化控制看板，实时显示和控制所有继电器状态
+- 智能写入队列，支持大规模批量控制（160+继电器）流畅无卡顿
+- 完整的内存管理和错误处理，适合7x24小时长期稳定运行
+
+**稳定性保障**：
+- 连接永久保持：串口/TCP连接一旦建立就保持打开，避免部署时频繁开关导致的锁定问题
+- 内存泄漏防护：每5分钟自动检查并清理异常积压数据
+- 日志防护：错误日志限流，避免硬盘被填满
+- 配置持久化：所有配置和Mesh设备列表自动保存，重启后自动恢复
+- 断网/断电不影响：本地模式下完全脱离网络依赖
+
+**实际使用场景**：
+- 主站轮询：200ms/台，支持5-10台从站设备
+- 开关面板：支持50个以内面板，约200个按钮（设计极限500+）
+- LED同步：部署/重启后1秒内完成所有LED状态同步
+- 批量控制：支持17通道全开/全关等批量操作，LED反馈流畅无卡顿
 
 ## 许可证
 

package/nodes/modbus-master.js

@@ -1539,6 +1539,12 @@ module.exports = function(RED) {
                 node.cleanupTimer = null;
             }
 
+            // 清除MQTT命令队列定时器
+            if (node.mqttCommandTimer) {
+                clearTimeout(node.mqttCommandTimer);
+                node.mqttCommandTimer = null;
+            }
+
             // 发布离线状态到MQTT（让HA知道设备离线）
             if (node.config.enableMqtt && node.mqttClient && node.mqttClient.connected) {
                 node.publishOfflineStatus();

package/nodes/serial-port-config.js

@@ -530,14 +530,14 @@ module.exports = function(RED) {
             // 清除延迟关闭定时器
             if (node.closeTimer) {
                 clearTimeout(node.closeTimer);
+                node.closeTimer = null;
+            }
 
             // 清除内存检查定时器
             if (node.memoryCheckInterval) {
                 clearInterval(node.memoryCheckInterval);
                 node.memoryCheckInterval = null;
             }
-                node.closeTimer = null;
-            }
 
             // 清空所有监听器
             node.dataListeners = [];

package/package.json

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