node-red-contrib-symi-mesh 1.7.2 → 1.7.4

package/README.md

@@ -1291,6 +1291,8 @@ A: 每个房间部署一个云端同步节点，配置对应的酒店ID和房间
 | **Symi RS485 Bridge** | RS485设备双向同步 | [RS485/Modbus双向同步](#rs485modbus双向同步) |
 | **Symi KNX Bridge** | KNX系统双向同步 | [KNX双向同步](#knx双向同步) |
 | **Symi KNX-HA Bridge** | KNX与HA实体双向同步 | [KNX-HA双向同步](#knx-ha双向同步) |
+| **Symi MQTT Sync** | 第三方MQTT品牌设备同步 | v1.7.3新增 |
+| **Symi MQTT Brand** | 品牌MQTT配置节点 | v1.7.3新增 |
 | **RS485 Debug** | RS485总线数据抓包调试 | [RS485调试节点](#rs485调试节点) |
 | **Symi RS485 Sync** | 两种RS485协议双向同步 | [RS485协议同步](#rs485协议同步) |
 
@@ -1314,12 +1316,15 @@ node-red-contrib-symi-mesh/
 │   ├── symi-485-bridge.js/html # RS485桥接节点
 │   ├── symi-485-config.js/html # RS485配置节点
 │   ├── symi-knx-bridge.js/html # KNX桥接节点
+│   ├── symi-knx-ha-bridge.js/html # KNX-HA桥接节点
 │   ├── symi-rs485-sync.js/html # RS485协议同步节点
+│   ├── symi-mqtt-sync.js/html # MQTT品牌同步节点
+│   ├── symi-mqtt-brand.js/html # 品牌MQTT配置节点
 │   └── rs485-debug.js/html   # RS485调试节点
 ├── examples/
 │   ├── basic-example.json    # 基础示例
-│   ├── knx-sync-example.json # KNX Function节点示例
-│   └── knx-bridge-example.json # KNX桥接节点示例
+│   ├── knx-sync-example.json # KNX桥接节点示例
+│   └── rs485-sync-example.json # RS485协议同步示例
 ├── LICENSE
 ├── README.md
 └── package.json
@@ -1457,6 +1462,52 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.7.4 (2025-12-24)
+- **串口配置完善**：完整的串口参数配置，解决HassOS环境串口锁定问题
+  - **完整参数**：波特率、数据位(7/8)、停止位(1/2)、校验位(None/Even/Odd)
+  - **串口解锁**：添加`lock: false`参数，避免HassOS环境下"Cannot lock port"错误
+  - **配置持久化**：所有串口参数自动保存，重启后保持
+  - **统一界面**：symi-gateway和symi-485-config使用相同的串口配置界面
+- **串口兼容性修复**：兼容serialport v9和v10+，确保HassOS环境正常使用串口
+  - `serial-client.js`：动态检测serialport版本
+  - `symi-485-config.js`：兼容v9/v10+ API
+  - `symi-485-bridge.js`：兼容v9/v10+ API
+- **KNX Bridge窗帘/调光同步优化**：重新设计步进设备同步逻辑，解决双向控制时乱动问题
+  - **控制锁定机制**：谁先发起控制谁锁定，3秒内忽略另一方的反馈
+  - **窗帘设备**：Mesh控制→锁定→忽略KNX反馈；KNX控制→锁定→忽略Mesh反馈
+  - **调光设备**：同样应用控制锁定机制，避免亮度调节过程中的反馈干扰
+  - **停止解锁**：窗帘stopped动作会解除锁定，允许下一次控制
+  - **位置/亮度同步**：只同步最终值，不同步过程中的步进状态
+
+### v1.7.3 (2025-12-24)
+- **MQTT同步节点**：新增`symi-mqtt-sync`节点实现第三方MQTT品牌设备与Mesh设备双向同步
+  - **双MQTT配置节点架构**：
+    - Mesh MQTT：选择`symi-mqtt`配置节点，获取Mesh设备列表
+    - 品牌MQTT：选择`symi-mqtt-brand`配置节点（支持下拉选择+编辑+添加）
+  - **品牌MQTT配置节点**：新增`symi-mqtt-brand`配置节点
+    - 支持配置MQTT服务器地址、用户名、密码
+    - 支持HYQW协议（项目代码、设备SN）
+    - 自动发现品牌MQTT设备实体
+    - 可扩展支持更多品牌协议
+  - **实体映射**：
+    - 左边选择Mesh设备+通道
+    - 右边选择品牌设备+通道（灯具支持多路）
+    - 相同类型实体一对一映射
+  - **设备类型**：灯具(8)、空调(12)、窗帘(14)、地暖(16)、新风(36)
+  - **双向同步**：MQTT↔Mesh实时状态同步，2秒防抖防死循环
+  - **输入输出端口**：支持连接debug节点调试同步数据
+  - **错误日志限流**：网络故障时每60秒最多记录一次错误
+  - **断线自动重连**：5秒重连间隔
+- **串口支持优化**：
+  - 所有串口节点支持手动输入+搜索选择
+  - 兼容serialport v9/v10+，兼容HassOS环境
+  - 串口错误日志限流，避免长时间故障时日志爆炸
+- **稳定性优化**：
+  - 错误日志频率限制，长时间网络故障不影响系统性能
+  - 静默处理非关键错误，生产级稳定性
+  - 内存安全，无调试日志，断电断网恢复后正常工作
+  - 缓存队列处理，符合MQTT协议要求
+
 ### v1.7.2 (2025-12-22)
 - **RS485双向同步节点**：新增`symi-rs485-sync`独立节点实现两种不同RS485协议之间的双向同步
   - 支持中弘VRF网关协议（功能码0x31-0x34控制，0x50查询）
@@ -1551,19 +1602,6 @@ node-red-contrib-symi-mesh/
   - 连接knxUltimate节点，无缝集成
   - 适用于已有KNX系统与HA整合的场景
 
-### v1.6.8 (2025-12-15)
-- **KNX双向同步修复**：彻底修复米家/面板操作KNX不同步的问题
-  - 修复0x45消息类型处理：米家/面板操作发送msgType=0x45，不再限制channels>=6
-  - 支持1-4路开关2字节参数解析（米家/面板场景触发格式）
-  - 场景执行通知(0x11)后自动查询设备状态
-- **syncLock阻塞修复**：移除handleMeshStateChange中syncLock检查
-  - 避免队列处理期间丢失状态变化事件
-  - 改用per-device时间戳防回环机制
-- **processQueue健壮性**：添加try/finally确保processing标志正确重置
-- **防死循环参数调整**：LOOP_PREVENTION_MS调整为800ms
-- **同时修复RS485桥接**：应用相同syncLock修复
-
-
 ## 许可证
 
 MIT License
@@ -1575,8 +1613,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.2
+**版本**: 1.7.4
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-12-23
+**最后更新**: 2025-12-24
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/lib/serial-client.js

@@ -6,10 +6,13 @@ const EventEmitter = require('events');
 const { ProtocolHandler } = require('./protocol');
 
 class SerialClient extends EventEmitter {
-    constructor(portPath, baudRate = 115200, logger = console) {
+    constructor(portPath, baudRate = 115200, logger = console, options = {}) {
         super();
         this.portPath = portPath;
         this.baudRate = baudRate;
+        this.dataBits = options.dataBits || 8;
+        this.stopBits = options.stopBits || 1;
+        this.parity = options.parity || 'none';
         this.logger = logger;
         this.port = null;
         this.protocolHandler = new ProtocolHandler();
@@ -20,6 +23,23 @@ class SerialClient extends EventEmitter {
         this.reconnectDelay = 5000;
         this.reconnectTimer = null;
         this.autoReconnect = true;
+        // 错误日志限流
+        this._lastErrorLog = 0;
+        this._errorLogInterval = 60000;  // 60秒最多记录一次错误
+        this._reconnectAttempts = 0;
+    }
+
+    // 限流错误日志
+    _logErrorThrottled(msg) {
+        const now = Date.now();
+        if (now - this._lastErrorLog > this._errorLogInterval) {
+            this._lastErrorLog = now;
+            if (this._reconnectAttempts > 1) {
+                this.logger.warn(`${msg} (已尝试${this._reconnectAttempts}次)`);
+            } else {
+                this.logger.warn(msg);
+            }
+        }
     }
 
     async connect() {
@@ -42,15 +62,23 @@ class SerialClient extends EventEmitter {
             }
 
             if (!this.SerialPort) {
-                this.SerialPort = require('serialport').SerialPort;
+                // 兼容serialport v9和v10+
+                try {
+                    // v10+ API
+                    this.SerialPort = require('serialport').SerialPort;
+                } catch (e) {
+                    // v9 API
+                    this.SerialPort = require('serialport');
+                }
             }
 
             this.port = new this.SerialPort({
                 path: this.portPath,
                 baudRate: this.baudRate,
-                dataBits: 8,
-                stopBits: 1,
-                parity: 'none'
+                dataBits: this.dataBits,
+                stopBits: this.stopBits,
+                parity: this.parity,
+                lock: false  // 不锁定串口，避免HassOS环境下的锁定问题
             });
 
             return new Promise((resolve, reject) => {
@@ -98,7 +126,7 @@ class SerialClient extends EventEmitter {
 
                 this.port.on('error', (error) => {
                     clearTimeout(timeout);
-                    this.logger.error('Serial port error:', error.message);
+                    this._logErrorThrottled(`串口错误: ${error.message}`);
                     this.emit('error', error);
                     
                     if (!resolved && !rejected) {
@@ -153,13 +181,15 @@ class SerialClient extends EventEmitter {
         if (this.autoReconnect && !this.reconnectTimer) {
             this.reconnectTimer = setTimeout(() => {
                 this.reconnectTimer = null;
-                this.logger.log('Attempting to reconnect serial port...');
+                this._reconnectAttempts++;
                 this.connect()
                     .then(() => {
-                        this.logger.log('Serial port reconnected successfully');
+                        this._reconnectAttempts = 0;
+                        this._lastErrorLog = 0;  // 重置错误日志限流
+                        this.logger.log(`串口重连成功: ${this.portPath}`);
                     })
                     .catch((error) => {
-                        this.logger.error(`Serial port reconnect failed: ${error.message}`);
+                        this._logErrorThrottled(`串口重连失败: ${error.message}`);
                         // 失败后会自动继续尝试重连（通过handleDisconnect）
                     });
             }, this.reconnectDelay);

package/nodes/symi-485-bridge.js

@@ -4,7 +4,13 @@
  * 事件驱动架构，命令队列顺序处理
  */
 
-const { SerialPort } = require('serialport');
+// 兼容serialport v9和v10+
+let SerialPort;
+try {
+    SerialPort = require('serialport').SerialPort;
+} catch (e) {
+    SerialPort = require('serialport');
+}
 
 module.exports = function(RED) {
     

package/nodes/symi-485-config.html

@@ -8,6 +8,8 @@
             port: { value: 502 },
             serialPort: { value: '' },
             baudRate: { value: 9600 },
+            dataBits: { value: 8 },
+            stopBits: { value: 1 },
             parity: { value: 'none' }
         },
         label: function() {
@@ -29,24 +31,45 @@
                 }
             }).trigger('change');
 
-            // 加载串口列表
-            function loadSerialPorts() {
-                $.getJSON('/symi-rs485-bridge/serial-ports', function(ports) {
-                    var select = $('#node-config-input-serialPort');
-                    var currentVal = select.val() || node.serialPort;
-                    select.empty();
-                    select.append('<option value="">-- 选择串口 --</option>');
-                    ports.forEach(function(p) {
-                        var label = p.path;
-                        if (p.manufacturer) label += ' (' + p.manufacturer + ')';
-                        var sel = (p.path === currentVal) ? ' selected' : '';
-                        select.append('<option value="' + p.path + '"' + sel + '>' + label + '</option>');
-                    });
+            // 串口搜索
+            $('#btn-refresh-ports').on('click', function() {
+                var $btn = $(this);
+                var $select = $('#serial-port-select');
+                $btn.prop('disabled', true);
+                $select.empty().append('<option value="">搜索中...</option>').show();
+                
+                $.getJSON('/symi-gateway/serial-ports', function(ports) {
+                    $select.empty();
+                    if (ports && ports.length > 0) {
+                        $select.append('<option value="">-- 选择串口 --</option>');
+                        ports.forEach(function(p) {
+                            var label = p.path;
+                            if (p.manufacturer) label += ' (' + p.manufacturer + ')';
+                            var sel = (p.path === node.serialPort) ? ' selected' : '';
+                            $select.append('<option value="' + p.path + '"' + sel + '>' + label + '</option>');
+                        });
+                    } else {
+                        $select.append('<option value="">未发现串口</option>');
+                    }
+                    $btn.prop('disabled', false);
+                }).fail(function() {
+                    $select.empty().append('<option value="">搜索失败</option>');
+                    $btn.prop('disabled', false);
                 });
+            });
+
+            // 串口选择
+            $('#serial-port-select').on('change', function() {
+                var val = $(this).val();
+                if (val) {
+                    $('#node-config-input-serialPort').val(val);
+                }
+            });
+
+            // 初始化时如果已有串口配置，显示在下拉框
+            if (node.serialPort) {
+                $('#serial-port-select').append('<option value="' + node.serialPort + '" selected>' + node.serialPort + '</option>').show();
             }
-            
-            $('#btn-refresh-ports').on('click', loadSerialPorts);
-            loadSerialPorts();
         }
     });
 </script>
@@ -67,11 +90,13 @@
     
     <div class="serial-config">
         <div class="form-row">
-            <label for="node-config-input-serialPort"><i class="fa fa-usb"></i> 串口</label>
-            <select id="node-config-input-serialPort" style="width:60%"></select>
-            <button type="button" id="btn-refresh-ports" class="red-ui-button" style="margin-left:5px">
-                <i class="fa fa-refresh"></i>
-            </button>
+            <label for="node-config-input-serialPort"><i class="fa fa-usb"></i> 串口路径</label>
+            <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0 或 COM3" style="width:50%;">
+            <button type="button" id="btn-refresh-ports" class="red-ui-button" style="margin-left:5px">搜索串口</button>
+        </div>
+        <div class="form-row">
+            <label>&nbsp;</label>
+            <select id="serial-port-select" style="width:70%;display:none;"></select>
         </div>
         
         <div class="form-row">
@@ -85,6 +110,22 @@
             </select>
         </div>
         
+        <div class="form-row">
+            <label for="node-config-input-dataBits"><i class="fa fa-bars"></i> 数据位</label>
+            <select id="node-config-input-dataBits">
+                <option value="7">7</option>
+                <option value="8">8</option>
+            </select>
+        </div>
+        
+        <div class="form-row">
+            <label for="node-config-input-stopBits"><i class="fa fa-stop"></i> 停止位</label>
+            <select id="node-config-input-stopBits">
+                <option value="1">1</option>
+                <option value="2">2</option>
+            </select>
+        </div>
+        
         <div class="form-row">
             <label for="node-config-input-parity"><i class="fa fa-check-square"></i> 校验位</label>
             <select id="node-config-input-parity">

package/nodes/symi-485-config.js

@@ -3,7 +3,13 @@
  * 使用与Mesh网关相同的技术栈（SerialPort/net）
  */
 
-const { SerialPort } = require('serialport');
+// 兼容serialport v9和v10+
+let SerialPort;
+try {
+    SerialPort = require('serialport').SerialPort;
+} catch (e) {
+    SerialPort = require('serialport');
+}
 const net = require('net');
 
 // 全局禁用 Happy Eyeballs 算法，防止 AggregateError 导致 Node-RED 崩溃
@@ -50,6 +56,8 @@ module.exports = function(RED) {
         node.port = parseInt(config.port) || 502;
         node.serialPort = config.serialPort || '';
         node.baudRate = parseInt(config.baudRate) || 9600;
+        node.dataBits = parseInt(config.dataBits) || 8;
+        node.stopBits = parseInt(config.stopBits) || 1;
         node.parity = config.parity || 'none';
 
         // 连接状态
@@ -93,10 +101,11 @@ module.exports = function(RED) {
                     node.client = new SerialPort({
                         path: node.serialPort,
                         baudRate: node.baudRate,
-                        dataBits: 8,
-                        stopBits: 1,
+                        dataBits: node.dataBits,
+                        stopBits: node.stopBits,
                         parity: node.parity,
-                        autoOpen: false
+                        autoOpen: false,
+                        lock: false  // 不锁定串口，避免HassOS环境下的锁定问题
                     });
 
                     node.client.on('open', () => {

package/nodes/symi-gateway.html

@@ -7,7 +7,10 @@
             host: { value: '' },
             port: { value: 4196 },
             serialPort: { value: '' },
-            baudRate: { value: 115200 }
+            baudRate: { value: 115200 },
+            dataBits: { value: 8 },
+            stopBits: { value: 1 },
+            parity: { value: 'none' }
         },
         label: function() {
             return this.name || (this.connectionType === 'tcp'
@@ -15,6 +18,8 @@
                 : `Symi Gateway (${this.serialPort})`);
         },
         oneditprepare: function() {
+            var node = this;
+            
             $('#node-config-input-connectionType').on('change', function() {
                 if ($(this).val() === 'tcp') {
                     $('.tcp-config').show();
@@ -24,6 +29,47 @@
                     $('.serial-config').show();
                 }
             }).trigger('change');
+
+            // 串口自动发现
+            $('#serial-discover-btn').on('click', function() {
+                var $btn = $(this);
+                var $select = $('#serial-port-select');
+                $btn.prop('disabled', true).text('搜索中...');
+                $select.empty().append('<option value="">搜索中...</option>');
+                
+                $.getJSON('/symi-gateway/serial-ports', function(ports) {
+                    $select.empty();
+                    if (ports && ports.length > 0) {
+                        $select.append('<option value="">-- 选择串口 --</option>');
+                        ports.forEach(function(port) {
+                            var label = port.path;
+                            if (port.manufacturer) label += ' (' + port.manufacturer + ')';
+                            var selected = (node.serialPort === port.path) ? 'selected' : '';
+                            $select.append('<option value="' + port.path + '" ' + selected + '>' + label + '</option>');
+                        });
+                        $select.show();
+                    } else {
+                        $select.append('<option value="">未发现串口</option>');
+                    }
+                    $btn.prop('disabled', false).text('搜索串口');
+                }).fail(function() {
+                    $select.empty().append('<option value="">搜索失败</option>');
+                    $btn.prop('disabled', false).text('搜索串口');
+                });
+            });
+
+            // 串口选择
+            $('#serial-port-select').on('change', function() {
+                var val = $(this).val();
+                if (val) {
+                    $('#node-config-input-serialPort').val(val);
+                }
+            });
+
+            // 初始化时如果已有串口配置，显示在下拉框
+            if (node.serialPort) {
+                $('#serial-port-select').append('<option value="' + node.serialPort + '" selected>' + node.serialPort + '</option>').show();
+            }
         }
     });
 </script>
@@ -54,12 +100,48 @@
     
     <div class="form-row serial-config">
         <label for="node-config-input-serialPort"><i class="fa fa-usb"></i> 串口路径</label>
-        <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0 或 COM3">
+        <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0 或 COM3" style="width:50%;">
+        <button type="button" id="serial-discover-btn" class="red-ui-button" style="margin-left:5px;">搜索串口</button>
+    </div>
+    <div class="form-row serial-config">
+        <label>&nbsp;</label>
+        <select id="serial-port-select" style="width:70%;display:none;"></select>
     </div>
     
     <div class="form-row serial-config">
         <label for="node-config-input-baudRate"><i class="fa fa-tachometer"></i> 波特率</label>
-        <input type="number" id="node-config-input-baudRate" placeholder="115200">
+        <select id="node-config-input-baudRate">
+            <option value="9600">9600</option>
+            <option value="19200">19200</option>
+            <option value="38400">38400</option>
+            <option value="57600">57600</option>
+            <option value="115200">115200</option>
+        </select>
+    </div>
+    
+    <div class="form-row serial-config">
+        <label for="node-config-input-dataBits"><i class="fa fa-bars"></i> 数据位</label>
+        <select id="node-config-input-dataBits">
+            <option value="7">7</option>
+            <option value="8">8</option>
+        </select>
+    </div>
+    
+    <div class="form-row serial-config">
+        <label for="node-config-input-stopBits"><i class="fa fa-stop"></i> 停止位</label>
+        <select id="node-config-input-stopBits">
+            <option value="1">1</option>
+            <option value="2">2</option>
+        </select>
+    </div>
+    
+    <div class="form-row serial-config">
+        <label for="node-config-input-parity"><i class="fa fa-check-square"></i> 校验位</label>
+        <select id="node-config-input-parity">
+            <option value="none">无 (None)</option>
+            <option value="even">偶校验 (Even)</option>
+            <option value="odd">奇校验 (Odd)</option>
+        </select>
     </div>
 </script>
 

package/nodes/symi-gateway.js

@@ -45,6 +45,9 @@ module.exports = function(RED) {
         this.port = parseInt(config.port) || 4196;
         this.serialPort = config.serialPort;
         this.baudRate = parseInt(config.baudRate) || 115200;
+        this.dataBits = parseInt(config.dataBits) || 8;
+        this.stopBits = parseInt(config.stopBits) || 1;
+        this.parity = config.parity || 'none';
 
         this.client = null;
         this.deviceManager = new DeviceManager(this.context(), this, this.id);
@@ -83,7 +86,11 @@ module.exports = function(RED) {
             if (this.connectionType === 'tcp') {
                 this.client = new TCPClient(this.host, this.port, this);
             } else {
-                this.client = new SerialClient(this.serialPort, this.baudRate, this);
+                this.client = new SerialClient(this.serialPort, this.baudRate, this, {
+                    dataBits: this.dataBits,
+                    stopBits: this.stopBits,
+                    parity: this.parity
+                });
             }
             
             this.client.on('connected', () => {
@@ -682,6 +689,39 @@ module.exports = function(RED) {
                 res.json([]);
             }
         });
+
+        // 串口自动发现API - 兼容不同版本serialport
+        RED.httpAdmin.get('/symi-gateway/serial-ports', async function(req, res) {
+            try {
+                let ports = [];
+                try {
+                    // 尝试新版API (serialport v10+)
+                    const { SerialPort } = require('serialport');
+                    ports = await SerialPort.list();
+                } catch (e1) {
+                    try {
+                        // 尝试旧版API (serialport v9)
+                        const SerialPort = require('serialport');
+                        if (typeof SerialPort.list === 'function') {
+                            ports = await SerialPort.list();
+                        }
+                    } catch (e2) {
+                        // 静默处理
+                    }
+                }
+                // 过滤常见串口设备
+                const filteredPorts = (ports || []).filter(function(p) {
+                    const path = (p.path || '').toLowerCase();
+                    // 排除蓝牙和内部设备
+                    if (path.includes('bluetooth') || path.includes('bt-')) return false;
+                    // 包含USB、tty、COM端口
+                    return path.includes('usb') || path.includes('tty') || path.includes('com') || path.includes('serial');
+                });
+                res.json(filteredPorts);
+            } catch (e) {
+                res.json([]);
+            }
+        });
     }
 };