node-red-contrib-symi-mesh 1.7.7 → 1.7.8

package/README.md

@@ -368,7 +368,7 @@ npm install node-red-contrib-home-assistant-websocket
 **适合使用KNX-HA桥接的场景**：
 - HA中已有KNX集成，希望与其他系统整合
 - 需要KNX设备与HA中的Zigbee、WiFi等设备联动
-- 希望在HA中统一管理所有设备
+- 可以在HA中统一管理所有设备
 - 需要利用HA的自动化和场景功能
 - 已安装node-red-contrib-home-assistant-websocket，共享HA配置
 
@@ -383,6 +383,46 @@ npm install node-red-contrib-home-assistant-websocket
 - 配置灵活，易于调整
 
 
+### HA双向同步
+
+Symi HA同步节点 (`symi-ha-sync`) 用于实现Symi蓝牙Mesh设备与Home Assistant实体的直接双向同步。
+
+#### 功能特性
+
+1. **配置复用**：
+   - 复用`symi-mqtt`配置节点获取Symi设备信息
+   - 复用`server`配置节点连接Home Assistant
+2. **双向同步**：
+   - **Symi -> HA**：Mesh设备状态变化 -> 更新HA实体状态
+   - **HA -> Symi**：HA实体状态变化 -> 控制Mesh设备
+3. **防死循环**：
+   - 内置800ms冷却机制
+   - 区分Symi触发和HA触发，避免信号震荡
+4. **便捷配置**：
+   - 自动加载所有Symi设备和HA实体
+   - 支持按键通道选择（1-4键）
+   - 支持实体ID搜索和下拉选择
+
+#### 配置步骤
+
+1. **添加节点**：从左侧拖入`Symi HA Sync`节点
+2. **选择MQTT配置**：选择已有的`symi-mqtt`配置节点（共享Symi网关连接）
+3. **选择HA服务器**：选择已有的`server`配置节点（共享HA连接）
+4. **添加映射**：
+   - 点击"添加"按钮
+   - **Symi设备**：下拉选择Mesh设备（显示名称和MAC）
+   - **按键**：选择控制通道（按键1-4）
+   - **HA实体**：输入或选择要同步的HA实体ID（如`switch.living_room_light`）
+5. **部署**：点击部署，立即生效
+
+#### 注意事项
+
+- **MQTT配置**：必须选择`symi-mqtt`配置节点，用于获取设备列表和接收Mesh事件
+- **HA连接**：必须确保HA服务器节点连接正常
+- **实体类型**：建议同步相同类型的实体（如开关对开关，调光灯对灯光）
+- **多通道设备**：对于多键开关，请分别为每个按键添加一条映射
+
+
 ## 协议说明
 
 ### 核心协议格式
@@ -1291,6 +1331,7 @@ 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 HA Sync** | HA实体双向同步 | [HA双向同步](#ha双向同步) |
 | **Symi MQTT Sync** | 第三方MQTT品牌设备同步 | v1.7.3新增 |
 | **Symi MQTT Brand** | 品牌MQTT配置节点 | v1.7.3新增 |
 | **RS485 Debug** | RS485总线数据抓包调试 | [RS485调试节点](#rs485调试节点) |
@@ -1462,65 +1503,53 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
-### v1.7.5 (2025-12-24)
-- **API路径兼容性修复**：修复HassOS环境下节点配置界面无法加载设备列表的问题
-  - **根本原因**：HassOS Node-RED使用nginx反向代理，绝对路径`/api`会被拦截，需使用相对路径`api`
-  - **修复范围**：所有节点HTML中的`$.getJSON()`调用统一使用相对路径
-  - **开发规范**：后续开发节点时，所有前端API调用必须使用相对路径，不带前导斜杠
-- **KNX Bridge双向同步修复**：修复Mesh控制KNX开关不工作的问题
-  - **根本原因**：knxUltimate节点当`setTopicType: "str"`时使用`msg.topic`作为目标地址，而非`msg.destination`
-  - **修复方案**：发送消息同时包含`topic`和`destination`字段，确保兼容所有knxUltimate配置
-  - **消息格式**：`{ topic, destination, payload, dpt, event }`
-  - **防死循环**：不包含`knx`对象，避免触发knxUltimate的循环引用保护机制
-- **用户体验优化**：
-  - 设备列表加载时显示"加载中..."提示
-  - API调用失败时显示"加载失败，请重试"提示
-
-### 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.8 (2026-01-05)
+- **配置持久化增强**：所有同步节点的设备列表和映射配置持久保存
+  - **MQTT同步节点**：Mesh设备和品牌设备列表持久化，断线后仍可显示已配置的映射
+  - **HA同步节点**：Symi设备和HA实体列表持久化，断线后仍可显示已配置的映射
+  - **RS485桥接节点**：Mesh设备列表持久化，断线后仍可显示已配置的映射
+  - **离线设备显示**：[离线]标记缓存中但当前不在线的设备，[未找到]标记不在缓存中的设备
+  - **刷新按钮**：各节点添加独立刷新按钮，可手动刷新设备列表
+- **MQTT品牌同步增强**：完整对接HYQW（花语前湾）MQTT协议
+  - **完整设备类型支持**：灯具(8)、空调(12)、窗帘(14)、地暖(16)、新风(36)
+  - **功能码映射**：完整的fn/fv到Mesh属性双向转换
+    - 灯具：开关(fn=1)、亮度(fn=2, 0-100)
+    - 空调：开关(fn=1)、温度(fn=2, 18-29°C)、模式(fn=3)、风速(fn=4)
+    - 窗帘：动作(fn=1, 开/关/停)、位置(fn=2, 0-100%)
+    - 地暖：开关(fn=1)、温度(fn=2, 5-35°C)
+    - 新风：开关(fn=1)、风速(fn=3)
+  - **可扩展架构**：BRAND_PROTOCOLS对象支持添加新品牌协议
+  - **双向状态同步**：HYQW↔Mesh实时同步，2秒防抖防死循环
+  - **自动设备发现**：自动发现品牌MQTT设备，限制200个
+  - **错误日志限流**：每60秒最多记录一次错误，避免日志爆炸
+  - **自动重连**：5秒重连间隔，断线自动恢复
+  - **资源清理**：完善的定时器和事件监听器清理机制
+- **HA同步节点完整重构**：实现所有实体类型的完美双向同步
+  - **完整实体类型支持**：
+    - switch/input_boolean：开关状态 (on/off)
+    - light：开关 + 亮度 (0-255 ↔ 0-100)
+    - cover：开/关/停 + 位置 (0-100%)
+    - climate：开关 + 温度 + 模式(cool/heat/fan_only/dry) + 风速(high/medium/low/auto)
+    - fan：开关 + 风速
+  - **Mesh属性完整映射**：
+    - 0x02 开关状态（单路/多路）
+    - 0x03 亮度 (0-100)
+    - 0x05 窗帘运行状态
+    - 0x06 窗帘位置 (0-100)
+    - 0x1B 目标温度 (16-30°C)
+    - 0x1C 风速 (1=高/2=中/3=低/4=自动)
+    - 0x1D 空调模式 (1=制冷/2=制热/3=送风/4=除湿)
+  - **智能按键选择**：只有多路开关才显示按键选择，温控器/窗帘/调光灯显示"-"
+  - **设备类型标签**：自动识别并显示设备类型（[温控器]、[窗帘]、[调光灯]、[N路开关]）
+  - **智能防抖机制**：窗帘和调光灯使用500ms防抖，只同步最终位置/亮度
+  - **防死循环增强**：2秒冷却时间 + 双向时间戳检查
+  - **配置持久化**：设备列表和映射配置持久保存
+  - **内存泄漏防护**：定时清理过期时间戳和防抖定时器
+- **代码质量优化**：
+  - 同步时间戳Map自动清理60秒以上的条目
+  - 设备发现数量限制，防止内存溢出
+  - 完善的节点关闭清理逻辑
+  - 防死循环机制增强：双向时间戳检查
 
 ### v1.7.7 (2026-01-05)
 - **RS485桥接节点逻辑优化**：
@@ -1596,18 +1625,6 @@ node-red-contrib-symi-mesh/
     - 队列限制100条，防止内存溢出
   - **调试日志**：添加详细调试日志，方便排查问题
 
-### v1.7.0 (2025-12-21)
-- **自定义协议增强**：RS485桥接节点自定义协议功能全面升级
-  - 自定义开关：添加发开、发关、收开、收关4组码
-  - 翻转模式：收开码=收关码时，收到后自动翻转开关状态
-  - 自定义窗帘：添加发开、发关、发停、收开、收关、收停6组码
-  - 自定义空调：新增完整收发码支持（开关、风速、模式、温度）
-  - 支持最多24字节（72个十六进制字符）数据录入
-  - 自定义模式自动隐藏地址字段
-  - 配置持久化保存，重启后保持
-  - 防死循环机制优化
-  - 内存优化，防止日志溢出
-
 ## 许可证
 
 MIT License
@@ -1619,7 +1636,7 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.6
+**版本**: 1.7.8
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
 **最后更新**: 2026-01-05
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh

package/nodes/symi-485-bridge.html

@@ -6,7 +6,9 @@
             name: { value: '' },
             gateway: { value: '', type: 'symi-gateway', required: true },
             rs485Config: { value: '', type: 'symi-485-config', required: true },
-            mappings: { value: '[]' }
+            mappings: { value: '[]' },
+            // 持久化缓存：保存设备列表，断线后仍可显示
+            cachedMeshDevices: { value: '[]' }
         },
         inputs: 1,
         outputs: 1,
@@ -26,6 +28,7 @@
             var meshDevices = [];
             var protocolData = {};
             var mappings = [];
+            var cachedMeshDevices = [];
             
             // 设置编辑面板更宽
             var panel = $('#dialog-form').parent();
@@ -34,23 +37,58 @@
             }
             
             try { mappings = JSON.parse(node.mappings || '[]'); } catch(e) { mappings = []; }
+            try { cachedMeshDevices = JSON.parse(node.cachedMeshDevices || '[]'); } catch(e) { cachedMeshDevices = []; }
+
+            // 合并设备列表：在线设备 + 缓存设备（去重）
+            function mergeDevices(onlineDevices, cachedDevices) {
+                var merged = [];
+                var keys = new Set();
+                
+                // 先添加在线设备
+                (onlineDevices || []).forEach(function(d) {
+                    var key = (d.mac || '').toLowerCase().replace(/:/g, '');
+                    if (key && !keys.has(key)) {
+                        keys.add(key);
+                        d._online = true;
+                        merged.push(d);
+                    }
+                });
+                
+                // 再添加缓存中不在线的设备
+                (cachedDevices || []).forEach(function(d) {
+                    var key = (d.mac || '').toLowerCase().replace(/:/g, '');
+                    if (key && !keys.has(key)) {
+                        keys.add(key);
+                        d._online = false;
+                        merged.push(d);
+                    }
+                });
+                
+                return merged;
+            }
 
             // 加载Mesh设备 - 等待gateway选择框初始化完成
             function loadMeshDevices(callback) {
                 var gatewayId = $('#node-input-gateway').val();
                 if (!gatewayId) { 
-                    meshDevices = []; 
+                    meshDevices = mergeDevices([], cachedMeshDevices);
                     if (callback) callback(); 
                     return; 
                 }
                 $.getJSON('symi-rs485-bridge/mesh-devices/' + gatewayId)
                     .done(function(devices) {
-                        meshDevices = devices || [];
+                        meshDevices = mergeDevices(devices || [], cachedMeshDevices);
+                        // 更新缓存
+                        if (devices && devices.length > 0) {
+                            cachedMeshDevices = devices.map(function(d) {
+                                return { mac: d.mac, name: d.name, channels: d.channels };
+                            });
+                        }
                         console.log('[RS485 Bridge] 加载Mesh设备:', meshDevices.length);
                         if (callback) callback();
                     })
                     .fail(function() {
-                        meshDevices = [];
+                        meshDevices = mergeDevices([], cachedMeshDevices);
                         if (callback) callback();
                     });
             }
@@ -81,25 +119,34 @@
                 return device.channels || 1;
             }
 
-            // 构建Mesh设备选项（不包含按键，按键单独选择）
-            function getMeshOptions(selectedMac) {
+            // 构建Mesh设备选项（不包含按键，按键单独选择）- 支持离线显示
+            function getMeshOptions(selectedMac, savedName) {
                 var html = '<option value="">-- 选择 --</option>';
                 var selMacNorm = (selectedMac || '').toLowerCase().replace(/:/g, '');
+                var found = false;
                 meshDevices.forEach(function(d) {
                     var devMacNorm = (d.mac || '').toLowerCase().replace(/:/g, '');
                     var selected = (devMacNorm === selMacNorm && selMacNorm !== '') ? ' selected' : '';
-                    html += '<option value="' + d.mac + '" data-channels="' + (d.channels || 1) + '"' + selected + '>' + d.name + '</option>';
+                    if (selected) found = true;
+                    var statusIcon = d._online === false ? ' [离线]' : '';
+                    var style = d._online === false ? ' style="color:#999;"' : '';
+                    html += '<option value="' + d.mac + '" data-channels="' + (d.channels || 1) + '" data-name="' + (d.name || '') + '"' + selected + style + '>' + (d.name || d.mac) + statusIcon + '</option>';
                 });
+                // 如果已选择的设备不在列表中，添加它
+                if (selMacNorm && !found) {
+                    var displayName = savedName || selectedMac;
+                    html += '<option value="' + selectedMac + '" selected style="color:#c00;">' + displayName + ' [未找到]</option>';
+                }
                 return html;
             }
 
-            // 构建Mesh按键选项（仅当开关设备时显示）
-            function getMeshChannelOptions(mac, selectedChannel) {
+            // 构建Mesh按键选项（仅当开关设备时显示）- 支持保存的通道数
+            function getMeshChannelOptions(mac, selectedChannel, savedChannels) {
                 var macNorm = (mac || '').toLowerCase().replace(/:/g, '');
                 var device = meshDevices.find(function(d) { 
                     return (d.mac || '').toLowerCase().replace(/:/g, '') === macNorm; 
                 });
-                var channels = device ? (device.channels || 1) : 0;
+                var channels = device ? (device.channels || 1) : (savedChannels || 1);
                 if (channels <= 1) return '';
                 var html = '<select class="mesh-channel">';
                 for (var i = 1; i <= channels; i++) {
@@ -207,8 +254,8 @@
                     row.html(
                         '<div class="mapping-main">' +
                         '<div class="mesh-col">' +
-                        '  <select class="mesh-select">' + getMeshOptions(m.meshMac) + '</select>' +
-                        '  <span class="mesh-ch-wrap">' + getMeshChannelOptions(m.meshMac, m.meshChannel || 1) + '</span>' +
+                        '  <select class="mesh-select">' + getMeshOptions(m.meshMac, m.meshName) + '</select>' +
+                        '  <span class="mesh-ch-wrap">' + getMeshChannelOptions(m.meshMac, m.meshChannel || 1, m.meshChannels) + '</span>' +
                         '</div>' +
                         '<div class="arrow-col"><i class="fa fa-arrows-h"></i></div>' +
                         '<div class="brand-col">' +
@@ -279,10 +326,13 @@
                     var row = $(this).closest('.mapping-row');
                     var idx = row.data('idx');
                     var mac = $(this).val();
+                    var opt = $(this).find('option:selected');
                     mappings[idx].meshMac = mac || '';
+                    mappings[idx].meshName = opt.data('name') || opt.text().replace(' [离线]', '').replace(' [未找到]', '');
+                    mappings[idx].meshChannels = parseInt(opt.data('channels')) || 1;
                     mappings[idx].meshChannel = 1;
                     // 更新Mesh按键选择器
-                    row.find('.mesh-ch-wrap').html(getMeshChannelOptions(mac, 1));
+                    row.find('.mesh-ch-wrap').html(getMeshChannelOptions(mac, 1, mappings[idx].meshChannels));
                     bindEvents(); // 重新绑定新元素事件
                 });
 
@@ -658,6 +708,8 @@
                 
                 var m = {
                     meshMac: $(this).find('.mesh-select').val() || '',
+                    meshName: $(this).find('.mesh-select option:selected').data('name') || $(this).find('.mesh-select option:selected').text().replace(' [离线]', '').replace(' [未找到]', ''),
+                    meshChannels: parseInt($(this).find('.mesh-select option:selected').data('channels')) || 1,
                     meshChannel: parseInt($(this).find('.mesh-channel').val()) || 1,
                     brand: $(this).find('.brand-select').val() || '',
                     device: $(this).find('.device-select').val() || '',
@@ -766,6 +818,8 @@
                 mappings.push(m);
             });
             this.mappings = JSON.stringify(mappings);
+            // 保存缓存的设备列表
+            this.cachedMeshDevices = JSON.stringify(cachedMeshDevices);
         }
     });
 </script>
@@ -833,6 +887,8 @@
     <div class="form-tips" style="margin-top: 10px;">
         <p><b>提示：</b>开关设备需要分别选择Mesh和RS485的按键，可自由配置对应关系（如Mesh第3路 ↔ RS485第1路）</p>
     </div>
+    
+    <input type="hidden" id="node-input-cachedMeshDevices">
 </script>
 
 <script type="text/html" data-help-name="symi-rs485-bridge">