node-red-contrib-symi-modbus 2.9.8 → 2.9.9

package/README.md

@@ -471,8 +471,8 @@ node-red-restart
   - 连接前彻底清理旧实例，避免资源泄漏
 - **互斥锁机制**：防止读写冲突导致的数据异常
 - **TCP永久连接**：
-  - 禁用TCP超时（永久连接），避免无数据时超时断开
-  - Keep-Alive心跳10秒间隔，确保连接活跃
+    - 禁用TCP超时（永久连接），避免无数据时超时断开
+    - Keep-Alive心跳10秒间隔，确保连接活跃
   - 适应客户长期不在家、总线无数据的场景
   - 网络故障自动重连，恢复后立即恢复通信
 
@@ -952,7 +952,17 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 版本信息
 
-**当前版本**: v2.9.8 (2026-01-06)
+**当前版本**: v2.9.9 (2026-01-08)
+
+**v2.9.9 更新内容**：
+- **深度优化多 TCP 主站并发**：
+  - **独立主站标识**：为每个 TCP 主站生成唯一标识，支持多个 TCP 连接独立运行，互不干扰
+  - **全局实例管理**：建立全局实例表，解决多节点并发时的资源抢占和卡顿问题
+  - **TCP 参数调优**：
+    - 降低 TCP 超时时间至 1000ms，提升异常响应速度
+    - 启用 Keep-Alive（10秒心跳），确保长连接稳定性
+    - 开启 NoDelay，禁用 Nagle 算法，显著降低指令发送延迟
+  - **稳定性增强**：完善节点关闭时的资源释放逻辑，防止内存泄漏和连接残留
 
 **v2.9.8 更新内容**：
 - **新增品牌支持**：Clowire（克伦威尔）智能面板

package/nodes/modbus-master.js

@@ -3,7 +3,11 @@ module.exports = function(RED) {
     const ModbusRTU = require("modbus-serial");
     const mqtt = require("mqtt");
     const protocol = require("./lightweight-protocol");
-    
+
+    // 全局主站实例注册表（用于多主站独立运行，避免互相干扰）
+    // 每个主站节点有独立的Modbus客户端实例，互不影响
+    const masterInstances = new Map();
+
     // 串口列表API - 支持Windows、Linux、macOS所有串口设备
     RED.httpAdmin.get('/modbus-master/serialports', async function(req, res) {
         try {
@@ -90,13 +94,16 @@ module.exports = function(RED) {
     function ModbusMasterNode(config) {
         RED.nodes.createNode(this, config);
         const node = this;
-        
+
+        // 生成唯一的主站标识（用于多主站独立运行）
+        node.masterId = `master_${node.id}`;
+
         // 获取Modbus服务器配置节点
         node.modbusServerConfig = RED.nodes.getNode(config.modbusServer);
-        
+
         // 获取MQTT服务器配置节点
         node.mqttServerConfig = RED.nodes.getNode(config.mqttServer);
-        
+
         // 配置参数（从Modbus服务器配置节点读取）
         node.config = {
             connectionType: node.modbusServerConfig ? (node.modbusServerConfig.connectionType || "tcp") : "tcp",
@@ -120,13 +127,19 @@ module.exports = function(RED) {
             mqttPassword: node.mqttServerConfig ? (node.mqttServerConfig.credentials ? node.mqttServerConfig.credentials.password : "") : "",
             mqttBaseTopic: node.mqttServerConfig ? node.mqttServerConfig.baseTopic : "modbus/relay"
         };
-        
+
         // 验证Modbus服务器配置
         if (!node.modbusServerConfig) {
             node.warn('未配置Modbus服务器，将使用默认配置');
         }
-        
-        // Modbus客户端
+
+        // 记录主站配置信息（用于调试多主站问题）
+        const connInfo = node.config.connectionType === "tcp"
+            ? `TCP ${node.config.tcpHost}:${node.config.tcpPort}`
+            : `串口 ${node.config.serialPort}`;
+        node.log(`主站初始化: ${node.masterId}, 连接: ${connInfo}`);
+
+        // Modbus客户端（每个主站独立的客户端实例）
         node.client = new ModbusRTU();
         node.isConnected = false;
         node.pollTimer = null;
@@ -139,7 +152,7 @@ module.exports = function(RED) {
         node.isClosing = false;
         node.lastErrorLog = {}; // 记录每个从站的最后错误日志时间
         node.lastMqttErrorLog = 0; // MQTT错误日志时间
-        node.errorLogInterval = 5 * 60 * 1000; // 错误日志间隔：5分钟（降低到5分钟，更快发现问题）
+        node.errorLogInterval = 5 * 60 * 1000; // 错误日志间隔：5分钟
         node.consecutiveErrors = {}; // 记录每个从站的连续错误次数
         node.modbusLock = false; // Modbus操作互斥锁（防止读写冲突）
         node.lastWriteTime = {}; // 记录每个从站的最后写入时间
@@ -152,6 +165,15 @@ module.exports = function(RED) {
         node.isProcessingWrite = false; // 是否正在处理写入队列
         node.writeQueueInterval = 50; // 写入队列处理间隔（50ms，厂家推荐间隔，确保总线稳定）
 
+        // 注册到全局主站实例表（用于调试和监控）
+        masterInstances.set(node.masterId, {
+            nodeId: node.id,
+            connection: connInfo,
+            slaves: node.config.slaves.map(s => s.address),
+            startTime: Date.now()
+        });
+        node.log(`已注册主站实例，当前主站数量: ${masterInstances.size}`);
+
         // 定期清理机制（每小时清理一次，防止内存泄漏）
         node.cleanupTimer = setInterval(() => {
             // 清理过期的错误日志记录
@@ -244,7 +266,7 @@ module.exports = function(RED) {
                         throw new Error('TCP主机地址未配置，请在节点配置中填写Modbus服务器IP地址');
                     }
 
-                    const tcpMode = node.config.tcpMode || "telnet";
+                    const tcpMode = node.modbusServerConfig ? (node.modbusServerConfig.tcpMode || "telnet") : "telnet";
                     const modeNames = {
                         "telnet": "Telnet ASCII",
                         "rtu": "RTU over TCP",
@@ -253,24 +275,35 @@ module.exports = function(RED) {
 
                     node.log(`正在连接TCP网关（${modeNames[tcpMode]}）: ${node.config.tcpHost}:${node.config.tcpPort}...`);
 
+                    // TCP连接选项（优化多主站并发性能）
+                    const tcpOptions = {
+                        port: node.config.tcpPort,
+                        // 注意：modbus-serial内部会设置socket选项
+                    };
+
                     if (tcpMode === "telnet") {
-                        await node.client.connectTelnet(node.config.tcpHost, {
-                            port: node.config.tcpPort
-                        });
+                        await node.client.connectTelnet(node.config.tcpHost, tcpOptions);
                     } else if (tcpMode === "rtu") {
-                        await node.client.connectTcpRTUBuffered(node.config.tcpHost, {
-                            port: node.config.tcpPort
-                        });
+                        await node.client.connectTcpRTUBuffered(node.config.tcpHost, tcpOptions);
                     } else {
-                        await node.client.connectTCP(node.config.tcpHost, {
-                            port: node.config.tcpPort
-                        });
+                        await node.client.connectTCP(node.config.tcpHost, tcpOptions);
+                    }
+
+                    // 优化TCP socket设置（提升多主站并发性能）
+                    if (node.client._client) {
+                        // 启用TCP Keep-Alive，10秒间隔
+                        node.client._client.setKeepAlive(true, 10000);
+                        // 禁用Nagle算法，减少延迟
+                        node.client._client.setNoDelay(true);
+                        // 设置socket超时为0（永不超时，由Modbus层控制超时）
+                        node.client._client.setTimeout(0);
+                        node.log('TCP socket优化: Keep-Alive=10s, NoDelay=true');
                     }
 
                     node.log(`TCP网关连接成功（${modeNames[tcpMode]}）: ${node.config.tcpHost}:${node.config.tcpPort}`);
                 } else {
                     node.log(`正在连接串口: ${node.config.serialPort} @ ${node.config.serialBaudRate || 9600}bps...`);
-                    
+
                     await node.client.connectRTUBuffered(node.config.serialPort, {
                         baudRate: node.config.serialBaudRate || 9600,
                         dataBits: node.config.serialDataBits || 8,
@@ -278,12 +311,14 @@ module.exports = function(RED) {
                         parity: node.config.serialParity || 'none',
                         lock: false  // 禁用串口锁定，解决HassOS中"Cannot lock port"错误
                     });
-                    
+
                     node.log(`串口Modbus连接成功: ${node.config.serialPort} @ ${node.config.serialBaudRate || 9600}bps`);
                 }
 
-                // 设置超时时间（串口需要更长的超时时间，但不能太长以免影响轮询）
-                const timeout = node.config.connectionType === "serial" ? 3000 : 2000;
+                // 设置Modbus超时时间
+                // TCP模式：降低到1000ms，避免一个主站超时阻塞其他主站太久
+                // 串口模式：保持2000ms，串口通信需要更长时间
+                const timeout = node.config.connectionType === "serial" ? 2000 : 1000;
                 node.client.setTimeout(timeout);
                 node.log(`Modbus超时设置: ${timeout}ms`);
 
@@ -293,6 +328,13 @@ module.exports = function(RED) {
                         node.warn(`串口错误（已忽略）: ${err.message}`);
                     });
                 }
+
+                // TCP模式：设置socket错误处理器
+                if (node.client._client) {
+                    node.client._client.on('error', (err) => {
+                        node.warn(`TCP socket错误（已忽略）: ${err.message}`);
+                    });
+                }
                 
                 node.isConnected = true;
                 node.reconnectAttempts = 0;  // 重置重连计数
@@ -1525,6 +1567,12 @@ module.exports = function(RED) {
             node.isClosing = true;
             node.stopPolling();
 
+            // 从全局主站实例表中移除
+            if (node.masterId) {
+                masterInstances.delete(node.masterId);
+                node.log(`已注销主站实例 ${node.masterId}，剩余主站数量: ${masterInstances.size}`);
+            }
+
             // 移除内部事件监听器
             if (node.internalEventHandler) {
                 RED.events.removeListener('modbus:writeCoil', node.internalEventHandler);
@@ -1553,13 +1601,13 @@ module.exports = function(RED) {
             if (node.config.enableMqtt && node.mqttClient && node.mqttClient.connected) {
                 node.publishOfflineStatus();
             }
-            
+
             // 清理设备状态缓存（释放内存）
             node.deviceStates = {};
             node.lastErrorLog = {};
             node.lastWriteTime = {};
             node.lastMqttErrorLog = 0;
-            
+
             // 关闭Modbus连接
             if (node.client) {
                 try {

package/nodes/modbus-server-config.js

@@ -4,6 +4,7 @@ module.exports = function(RED) {
     function ModbusServerConfigNode(config) {
         RED.nodes.createNode(this, config);
         this.connectionType = config.connectionType;
+        this.tcpMode = config.tcpMode || "telnet";  // TCP模式：telnet/rtu/tcp
         this.tcpHost = config.tcpHost;
         this.tcpPort = parseInt(config.tcpPort) || 502;
         this.serialPort = config.serialPort;
@@ -12,7 +13,7 @@ module.exports = function(RED) {
         this.serialStopBits = parseInt(config.serialStopBits) || 1;
         this.serialParity = config.serialParity || "none";
     }
-    
+
     RED.nodes.registerType("modbus-server-config", ModbusServerConfigNode);
 };
 

package/package.json

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