node-red-contrib-symi-modbus 2.4.0 → 2.5.0

package/README.md

@@ -507,10 +507,47 @@ docker run --privileged ...
 - **容错能力**：Modbus从站离线不影响其他从站，MQTT断线自动重连
 
 
-> **最新版本 v2.4.0** - TCP流式数据帧缓冲、命令队列、LED反馈队列，确保100%稳定控制和反馈
+> **最新版本 v2.5.0** - Mac串口兼容性修复，互斥锁优化，确保各平台稳定运行
 
 ## 版本更新
 
+### v2.5.0 (2025-10-20) - Mac串口兼容性与互斥锁优化
+
+**核心修复**：
+- 修复Mac串口设备选择问题，明确使用 `/dev/cu.*` 设备
+- 延长互斥锁等待时间（从500ms到6秒），匹配Modbus 5秒超时
+- 优化锁等待间隔（从10ms到50ms），降低CPU占用
+- 添加Mac串口说明到UI（cu.usbserial-xxx, cu.wchusbserial*）
+- 更新串口placeholder提示，包含Mac设备示例
+- 改进超时错误消息，提示可能是轮询阻塞
+
+**Mac串口设备说明**：
+Mac上USB转串口会创建两种设备：
+- `/dev/tty.*` - Terminal设备（用于等待incoming连接）**不要用**
+- `/dev/cu.*` - Call-out设备（用于主动连接）**正确选择**
+
+例如：
+```
+✅ /dev/cu.wchusbserial83420   ← 使用这个
+✅ /dev/cu.usbserial-83420     ← 或这个
+❌ /dev/tty.wchusbserial83420  ← 不要用（会报Resource busy错误）
+❌ /dev/tty.usbserial-83420    ← 不要用
+```
+
+**互斥锁优化说明**：
+- 旧版本：写入操作等待锁最多500ms，但Modbus超时是5000ms
+- 问题：如果轮询超时（5秒），写入操作在500ms就放弃，导致"等待锁释放超时"
+- 修复：写入操作等待锁最多6秒，确保能等到轮询超时后锁释放
+- 等待间隔从10ms增加到50ms，降低CPU占用
+
+**测试验证**：
+- Mac串口连接正常（cu.wchusbserial83420）
+- 轮询和写入操作不再冲突
+- 写入不再提前超时
+- 适合Windows/Linux/macOS平台长期稳定运行
+
+---
+
 ### v2.4.0 (2025-10-20) - TCP帧缓冲与命令队列机制
 
 **核心修复**：
@@ -547,6 +584,7 @@ docker run --privileged ...
 - 适合Linux工控机24/7长期稳定运行
 
 ---
+
 **升级方式**：
 ```bash
 cd ~/.node-red

package/nodes/modbus-master.html

@@ -311,7 +311,7 @@
         <label for="node-input-serialPort" style="width: 110px;"><i class="fa fa-terminal"></i> 串口</label>
         <div style="display: inline-block; width: calc(70% - 110px);">
             <div style="display: flex; gap: 5px; align-items: center;">
-                <input type="text" id="node-input-serialPort" placeholder="COM1, /dev/ttyUSB0, /dev/ttyS1" style="flex: 1; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
+                <input type="text" id="node-input-serialPort" placeholder="COM1, /dev/ttyUSB0, /dev/cu.usbserial-xxx" style="flex: 1; padding: 5px 8px; border: 1px solid #ccc; border-radius: 4px; font-size: 13px;">
                 <select id="port-list-master" style="flex: 1; padding: 5px; font-family: monospace; font-size: 12px; border: 1px solid #ccc; border-radius: 4px; display: none;">
                     <option value="">-- 选择检测到的串口 --</option>
                 </select>
@@ -324,6 +324,7 @@
                 <span style="color: #555; font-size: 11px;">
                 • <strong>Windows</strong>: COM1, COM2, COM3...<br>
                 • <strong>Linux</strong>: /dev/ttyUSB0, /dev/ttyS0, /dev/ttyAMA0<br>
+                • <strong>macOS</strong>: <span style="background: #fff3cd; padding: 1px 4px; border-radius: 2px; font-weight: 600;">/dev/cu.*</span> (例如 /dev/cu.usbserial-xxx, /dev/cu.wchusbserial*)<br>
                 • <strong>HassOS</strong>: 插件配置添加设备映射即可<br>
                 • <strong>Docker</strong>: 需映射设备 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px; font-size: 10px;">--device=/dev/ttyUSB0</code> 或 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px; font-size: 10px;">--privileged</code>
                 </span>

package/nodes/modbus-master.js

@@ -780,15 +780,15 @@ module.exports = function(RED) {
                 return;
             }
             
-            // 等待锁释放（最多等待500ms）
-            const maxWait = 500;
+            // 等待锁释放（最多等待6秒，因为Modbus超时是5秒）
+            const maxWait = 6000;
             const startWait = Date.now();
             while (node.modbusLock && (Date.now() - startWait) < maxWait) {
-                await new Promise(resolve => setTimeout(resolve, 10));
+                await new Promise(resolve => setTimeout(resolve, 50));
             }
             
             if (node.modbusLock) {
-                node.error(`写入线圈超时: 从站${slaveId} 线圈${coil} (等待锁释放超时)`);
+                node.error(`写入线圈超时: 从站${slaveId} 线圈${coil} (等待锁释放超时，轮询可能阻塞)`);
                 return;
             }
             
@@ -834,15 +834,15 @@ module.exports = function(RED) {
                 return;
             }
             
-            // 等待锁释放（最多等待500ms）
-            const maxWait = 500;
+            // 等待锁释放（最多等待6秒，因为Modbus超时是5秒）
+            const maxWait = 6000;
             const startWait = Date.now();
             while (node.modbusLock && (Date.now() - startWait) < maxWait) {
-                await new Promise(resolve => setTimeout(resolve, 10));
+                await new Promise(resolve => setTimeout(resolve, 50));
             }
             
             if (node.modbusLock) {
-                node.error(`批量写入线圈超时: 从站${slaveId} 起始线圈${startCoil} (等待锁释放超时)`);
+                node.error(`批量写入线圈超时: 从站${slaveId} 起始线圈${startCoil} (等待锁释放超时，轮询可能阻塞)`);
                 return;
             }
             

package/package.json

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