node-red-contrib-symi-mesh 1.6.5 → 1.6.6

package/README.md

@@ -202,7 +202,7 @@ node-red-restart
 
 ### 开关状态编码（重要）
 
-**协议规则**: 每2位表示1路，b01=关，b10=开
+**协议规则**: 每2位表示1路，`01`=关，`10`=开，从最低位开始
 
 | 路数 | 全关 | 全开 | 示例 |
 |-----|------|------|------|
@@ -211,24 +211,57 @@ node-red-restart
 | 3路 | 0x15 | 0x2A | 从低位开始 |
 | 4路 | 0x55 | 0xAA | 每2位1路 |
 | 6路 | 0x5555 | 0xAAAA | 2字节小端序 |
+| 8路 | 0x5555 | 0xAAAA | 2字节小端序 |
+
+#### 8路开关状态详解
+
+8路开关使用2字节（16位）表示状态，小端序传输。实测帧示例：
+
+```
+帧格式: 53 80 [Status] [Length] [网络地址LE] [AttrType] [状态LE] [Checksum]
+示例帧: 53 80 05 05 E4 01 45 56 55 70
+        │  │  │  │  └─────┘ │  └───┘ └─ 校验和
+        │  │  │  │     │    │    └─ 状态值 0x5556 (第1路开)
+        │  │  │  │     │    └─ AttrType=0x45 (8路开关)
+        │  │  │  │     └─ 网络地址 0x01E4
+        │  │  │  └─ 数据长度=5字节
+        │  │  └─ 状态码
+        │  └─ Opcode=0x80 (事件上报)
+        └─ 帧头
+```
+
+**状态值对照表**（小端序）:
+| 状态数据 | 16位值 | 二进制 | 含义 |
+|---------|--------|--------|------|
+| 55 55 | 0x5555 | 01010101 01010101 | 全关 |
+| 56 55 | 0x5556 | 01010101 01010110 | 第1路开 |
+| 59 55 | 0x5559 | 01010101 01011001 | 第2路开 |
+| 65 55 | 0x5565 | 01010101 01100101 | 第3路开 |
+| 95 55 | 0x5595 | 01010101 10010101 | 第4路开 |
+| 55 56 | 0x5655 | 01010110 01010101 | 第5路开 |
+| 55 59 | 0x5955 | 01011001 01010101 | 第6路开 |
+| 55 65 | 0x6555 | 01100101 01010101 | 第7路开 |
+| 55 95 | 0x9555 | 10010101 01010101 | 第8路开 |
+| AA AA | 0xAAAA | 10101010 10101010 | 全开 |
 
 ### 常用消息类型
 
 | 消息类型 | 代码 | 数据格式 | 范围/说明 |
 |---------|------|---------|----------|
-| 开关状态 | 0x02 | 1-2字节 | 见上表 |
+| 开关状态 | 0x02 | 1字节 | 1-4路开关，见上表 |
 | 亮度 | 0x03 | 1字节 | 0-100% |
 | 色温 | 0x04 | 1字节 | 0%=暖白, 100%=冷白 |
 | 窗帘动作 | 0x05 | 1字节 | 1=开/2=关/3=停 |
 | 窗帘位置 | 0x06 | 1字节 | 0-100% |
 | 人体感应 | 0x0C | 1字节 | 0=无活动/1=检测到 |
 | 插卡状态 | 0x0E | 1字节 | 0=无卡/1=有卡 |
-| RGB颜色 | 0x11 | 5字节 | R(0-255)/G/B/WW(0-100)/CW |
-| 当前温度 | 0x16 | 2字节LE | 温度*100 |
-| 目标温度 | 0x1B | 2字节LE | 16-30°C, *100 |
+| 湿度 | 0x17 | 1字节 | 0-100% |
+| 当前温度 | 0x16 | 2字节LE | 温度*100（如2500=25.00°C）|
+| 目标温度 | 0x1B | 1字节 | 16-30°C（直接温度值）|
 | 风速 | 0x1C | 1字节 | 1=高/2=中/3=低/4=自动 |
 | 模式 | 0x1D | 1字节 | 1=制冷/2=制热/3=送风/4=除湿 |
-| 6键开关状态 | 0x45 | 2字节LE | 场景执行后状态上报 |
+| 6-8路开关 | 0x45 | 2字节LE | 多路开关状态，见上表 |
+| 五色RGB | 0x4C | 5字节 | R/G/B/WW/CW (各0-255) |
 
 ## MQTT主题结构
 
@@ -531,10 +564,35 @@ Mesh 四键开关 第2路 ↔ RS485 六键开关 第5路  地址:2   ✓ 支持
 |-------------|--------------|---------|
 | 开关-按键N | 开关 | 开/关状态 |
 | 温控器 | 空调 | 开关、温度、模式、风速 |
+| 三合一面板 | 空调+新风+地暖 | 分别配置，独立同步 |
 | 调光灯 | 调光器 | 开关、亮度 |
 
 **部分同步**：如果RS485协议不提供某些功能点，只同步双方都支持的内容
 
+### 三合一面板配置
+
+三合一面板（温控器类型）可同时控制空调、新风、地暖，需要创建3个独立映射：
+
+#### 配置示例（话语前湾协议）
+
+| Mesh设备 | RS485设备类型 | 从机地址 | 说明 |
+|---------|--------------|---------|------|
+| 三合一面板_xxx | 次卧1空调 | 0 | 空调寄存器0x0FA4-0x0FA7 |
+| 三合一面板_xxx | 新风 | 60 | 开关0x0039，风速0x004B |
+| 三合一面板_xxx | 次卧1地暖 | 62 | 开关0x0039，温度0x0043 |
+
+#### 话语前湾地暖/新风从机地址
+
+| 设备 | 从机地址 | 十六进制 |
+|------|---------|---------|
+| 客餐厅地暖 | 60 | 0x3C |
+| 新风 | 60 | 0x3C |
+| 主卧地暖 | 61 | 0x3D |
+| 次卧1地暖 | 62 | 0x3E |
+| 次卧2地暖 | 63 | 0x3F |
+
+> **注意**：新风和客餐厅地暖共用从机地址60，但开关值不同（新风开=1，地暖开=2），请分别创建映射。
+
 ### 内置协议支持
 
 | 品牌 | 支持设备 |
@@ -992,6 +1050,131 @@ A: 每个房间部署一个云端同步节点，配置对应的酒店ID和房间
 - 获取失败时自动使用上次缓存的数据
 - 可以禁用节点，不影响其他功能正常运行
 
+## RS485网桥节点
+
+### 功能概述
+
+RS485网桥节点实现Mesh网关与第三方RS485设备的**双向同步**：
+
+- **事件驱动**：状态变化时立即同步，无轮询
+- **多协议支持**：标准Modbus RTU、杜亚窗帘、自定义十六进制码
+- **按键对按键**：Mesh开关的每一路可独立映射到RS485的任意按键
+- **防循环保护**：智能防抖机制，避免无限循环
+- **内存安全**：命令队列限制100条，缓存自动清理
+
+### 配置说明
+
+#### 1. 添加RS485配置节点
+
+首先配置RS485连接（串口或TCP）：
+
+- **连接方式**: 串口 或 TCP
+- **串口模式**: 选择串口路径，波特率默认9600
+- **TCP模式**: 输入IP地址和端口
+
+#### 2. 添加RS485桥接节点
+
+配置实体映射：
+
+| 配置项 | 说明 |
+|-------|------|
+| **Mesh实体** | 选择要同步的Mesh设备 |
+| **Mesh按键** | 选择具体哪一路（多路开关） |
+| **品牌** | 选择协议品牌（话语前湾、杜亚、自定义等） |
+| **设备类型** | 选择设备类型（决定寄存器配置） |
+| **RS485按键** | 选择RS485端的哪一路 |
+| **从机地址** | Modbus从机地址（0-255，空调填0） |
+
+### 话语前湾协议配置
+
+话语前湾项目使用以下协议：
+
+#### 开关设备 (A4B3)
+
+| 设备 | 从机地址 | 配置方式 |
+|-----|---------|---------|
+| 客厅主灯 | 3 | 选择"话语前湾" → "一键开关"，地址填3 |
+| 餐厅主灯 | 3 | 选择"话语前湾" → "三键开关"，按键3，地址填3 |
+| 玄关灯带 | 1 | 选择"话语前湾" → "四键开关"，按键4，地址填1 |
+
+**寄存器映射**：
+- 按键1: 0x1031
+- 按键2: 0x1032
+- 按键3: 0x1033
+- 按键4: 0x1034
+- 按键5: 0x1035
+- 按键6: 0x1036
+
+#### 空调设备 (A5B5)
+
+**所有空调从机地址都是0**，通过设备类型区分房间：
+
+| 房间 | 设备类型 | 寄存器范围 |
+|-----|---------|-----------|
+| 客厅空调 | ac_living | 0x0FA0-0x0FA3 |
+| 次卧1空调 | ac_bedroom2_1 | 0x0FA4-0x0FA7 |
+| 次卧2空调 | ac_bedroom2_2 | 0x0FA8-0x0FAB |
+| 主卧空调 | ac_master | 0x0FAC-0x0FAF |
+
+**配置示例**：选择"话语前湾" → "主卧空调"，地址填**0**
+
+#### 地暖设备 (A3B3)
+
+| 房间 | 从机地址 | 说明 |
+|-----|---------|------|
+| 客餐厅 | 60 (0x3C) | 开关:0x0039, 温度:0x0043 |
+| 主卧 | 61 (0x3D) | 开关:0x0039, 温度:0x0043 |
+| 次卧1 | 62 (0x3E) | 开关:0x0039, 温度:0x0043 |
+| 次卧2 | 63 (0x3F) | 开关:0x0039, 温度:0x0043 |
+
+**配置示例**：选择"话语前湾" → "地暖"，地址填60/61/62/63
+
+#### 新风设备 (A3B3)
+
+| 参数 | 从机地址 | 说明 |
+|-----|---------|------|
+| 新风 | 60 (0x3C) | 开关:0x0039(值01), 风速:0x004B |
+
+**配置示例**：选择"话语前湾" → "新风"，地址填60
+
+#### 杜亚窗帘 (A6B6)
+
+| 窗帘 | 地址高 | 地址低 |
+|-----|-------|-------|
+| 主卧窗帘 | 2 | 2 |
+| 主卧窗纱 | 1 | 1 |
+
+**配置示例**：选择"杜亚窗帘" → "窗帘"，地址高填2，地址低填2
+
+### 双向同步流程
+
+```
+Mesh面板按键 → 网关 → device-state-changed事件
+                            ↓
+                    RS485桥接节点检测状态变化
+                            ↓
+                    匹配映射配置 + 检查isUserControl
+                            ↓
+                    生成RS485帧 → 发送到485总线
+                            ↓
+                    485设备执行动作
+
+485面板/遥控器 → 485总线 → RS485桥接节点接收帧
+                            ↓
+                    解析帧 + 匹配映射配置
+                            ↓
+                    调用gateway.sendControl()
+                            ↓
+                    Mesh设备执行动作 → HA状态更新
+```
+
+### 注意事项
+
+1. **HA只对接Mesh设备**：485设备不会发布到HA，避免重复实体
+2. **窗帘防抖**：窗帘操作有1-2秒防抖，防止电机反馈误触发
+3. **初始化延迟**：启动后20秒才开始同步，等待Mesh设备发现完成
+4. **场景执行**：场景触发时多设备状态会排队同步，每命令间隔50ms
+
 ## 开发者信息
 
 ### 项目结构
@@ -1061,6 +1244,34 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.6.6 (2025-12-09)
+- **三合一面板完整双向同步**：支持空调+新风+地暖独立RS485映射
+  - 三合一0x94协议完整解析：空调(开关/模式/风速/温度)、地暖(开关/温度)、新风(开关/风速)
+  - Mesh→RS485：三合一状态变化自动发送对应RS485帧
+  - RS485→Mesh：RS485帧自动同步到三合一面板对应功能
+  - 支持climateSwitch/climateMode/fanMode/floorHeatingSwitch/freshAirSwitch等字段
+- **开关双向同步修复**：修复米家App全开/全关只触发部分按键的问题
+  - 命令队列防抖逻辑修复：只有完全相同映射才合并，不同映射独立处理
+  - 支持同一Mesh设备多通道分别绑定不同RS485设备
+- **RS485多映射匹配**：修复同一从机地址多个映射时只匹配第一个的问题
+  - findAllRS485Mappings返回所有匹配的映射
+  - rs485Channel精确匹配：根据寄存器地址确定通道
+- **网络异常处理增强**：彻底修复Node.js 18+ AggregateError导致崩溃的问题
+  - 全局uncaughtException/unhandledRejection处理器
+  - TCP连接过程同步错误捕获
+  - 只捕获网络相关错误，不影响其他异常
+- **三合一面板自动识别**：设备列表API返回isThreeInOne标志
+- **窗帘双协议兼容**：同时支持米家和小程序两种控制协议
+  - 米家协议: `subOpcode=0x06, status: 0=打开中, 1=关闭中, 2=停止`
+  - 小程序协议: `subOpcode=0x05, status: 1=打开, 2=关闭, 3=停止`
+- **话语前湾协议完善**：
+  - 空调：客厅/主卧/次卧1/次卧2，寄存器0x0FA0-0x0FAF
+  - 地暖：客餐厅(60)/主卧(61)/次卧1(62)/次卧2(63)，寄存器0x0039/0x0043
+  - 新风：从机60，开关0x0039(开=1)，风速0x004B(高=2,低=0)
+- **地址输入修复**：允许从机地址为0（话语前湾空调地址是0）
+- **内存安全**：命令队列限制100条，节点关闭时清理所有缓存
+- **文档更新**：添加三合一面板RS485配置说明和协议对照表
+
 ### v1.6.5 (2025-12-06)
 - **杜亚窗帘协议**：原生支持杜亚窗帘协议(A6B6)，2字节地址，自动CRC16计算
   - 帧格式：55 [地址高] [地址低] 03 [动作/位置] [CRC16低] [CRC16高]
@@ -1078,25 +1289,6 @@ node-red-contrib-symi-mesh/
 - **RS485调试增强**：新增协议测试发送功能
 - **初始化延迟**：20秒，避免部署时误发命令
 
-### v1.6.4 (2025-12-05)
-- **代码优化**：移除未使用的 `three-in-one-detected` 事件监听器（死代码清理）
-- **TCP连接优化**：移除可能导致连接问题的keep-alive设置
-- **多从机支持修复**：修复只能配置从机ID1的问题，现在支持任意从机地址(1-255)
-- **映射数值类型修复**：确保address/meshChannel/rs485Channel字段为正确的数字类型
-
-### v1.6.3 (2025-12-05)
-- **自定义协议模式**：支持任意RS485十六进制码双向匹配
-- **按键寄存器优化**：只处理按键寄存器(0x1031-0x1036)，移除指示灯寄存器处理
-- **CRC校验正确**：发送帧与协议文档完全匹配
-
-### v1.6.2 (2025-12-05)
-- **MQTT订阅修复**：修复闭包问题导致的设备MAC映射错误，确保HA实体可控
-- **内存泄漏修复**：节点关闭时正确移除gateway事件监听器，防止内存累积
-- **三合一面板完善**：空调/新风/地暖控制和状态反馈全面优化
-- **RS485双向同步**：支持Mesh与第三方485设备双向状态同步
-- **代码优化**：中文注释规范化，移除冗余代码，提升可维护性
-
-
 ## 许可证
 
 MIT License
@@ -1108,8 +1300,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.6.5
+**版本**: 1.6.6
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-12-06
+**最后更新**: 2025-12-09
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/lib/device-manager.js

@@ -100,9 +100,36 @@ class DeviceInfo {
                 break;
             case 0x05:
                 // CURT_RUN_STATUS - 窗帘运行状态
-                // 0=到头/停止, 1=打开中, 2=关闭中, 3=暂停
+                // 【兼容两种协议】：
+                // 米家协议: 0=打开中, 1=关闭中, 2=停止
+                // 小程序协议: 1=打开, 2=关闭, 3=停止
+                // 通过status=0(仅米家)和status=3(仅小程序)来区分协议类型
                 if (parameters.length > 0) {
-                    this.state.curtainStatus = parameters[0];
+                    const status = parameters[0];
+                    this.state.curtainStatus = status;
+                    
+                    // 检测协议类型：status=0只在米家出现，status=3只在小程序出现
+                    if (status === 0) {
+                        this.state.curtainProtocol = 'mijia';
+                        this.state.curtainAction = 'opening';
+                    } else if (status === 3) {
+                        this.state.curtainProtocol = 'miniprogram';
+                        this.state.curtainAction = 'stopped';
+                    } else if (status === 1) {
+                        // status=1: 米家=关闭中, 小程序=打开
+                        if (this.state.curtainProtocol === 'mijia') {
+                            this.state.curtainAction = 'closing';
+                        } else {
+                            this.state.curtainAction = 'opening';
+                        }
+                    } else if (status === 2) {
+                        // status=2: 米家=停止, 小程序=关闭
+                        if (this.state.curtainProtocol === 'mijia') {
+                            this.state.curtainAction = 'stopped';
+                        } else {
+                            this.state.curtainAction = 'closing';
+                        }
+                    }
                 }
                 break;
             case 0x06:
@@ -161,7 +188,7 @@ class DeviceInfo {
                 // 目标温度TMPC_TEMP：1字节，直接温度值（16-30°C）
                 if (parameters.length > 0) {
                     const temp = parameters[0];
-                    if (temp >= 5 && temp <= 35) {
+                    if (temp >= 16 && temp <= 30) {
                         this.state.targetTemp = temp;
                         // 不推断开关状态，完全由0x02消息决定
                     }

package/lib/mqtt-helper.js

@@ -627,11 +627,11 @@ function convertStateValue(entityType, attrType, value, deviceType = null) {
             
         case 'climate':
             if (attrType === 0x16) {
-                // 当前温度：温度*100 -> 温度
+                // 当前温度：温度*100 -> 温度 (2字节小端序)
                 return (value / 100).toFixed(1);
             } else if (attrType === 0x1B) {
-                // 目标温度：温度*100 -> 温度
-                return (value / 100).toFixed(1);
+                // 目标温度：直接温度值 (1字节，16-30°C)
+                return value.toString();
             } else if (attrType === 0x1C) {
                 // 风速：1=high, 2=medium, 3=low, 4=auto
                 const fanModes = { 1: 'high', 2: 'medium', 3: 'low', 4: 'auto' };

package/lib/tcp-client.js

@@ -57,21 +57,33 @@ class TCPClient extends EventEmitter {
                 }
             }, 10000);
 
-            this.client.connect(this.port, this.host, () => {
+            // 捕获connect过程中的同步错误（如AggregateError）
+            try {
+                this.client.connect(this.port, this.host, () => {
+                    if (!resolved && !rejected) {
+                        resolved = true;
+                        clearTimeout(timeout);
+                        this.connected = true;
+                        this.logger.log(`Connected to gateway at ${this.host}:${this.port}`);
+                        this.emit('connected');
+                        
+                        if (!this.processingQueue) {
+                            this.startQueueProcessor();
+                        }
+                        
+                        resolve();
+                    }
+                });
+            } catch (connectError) {
+                // 捕获同步错误（包括AggregateError）
                 if (!resolved && !rejected) {
-                    resolved = true;
+                    rejected = true;
                     clearTimeout(timeout);
-                    this.connected = true;
-                    this.logger.log(`Connected to gateway at ${this.host}:${this.port}`);
-                    this.emit('connected');
-                    
-                    if (!this.processingQueue) {
-                        this.startQueueProcessor();
-                    }
-                    
-                    resolve();
+                    this.logger.warn(`TCP连接同步错误: ${connectError.message || connectError}`);
+                    this.handleDisconnect();
+                    reject(connectError);
                 }
-            });
+            }
 
             this.client.on('data', (data) => {
                 try {
@@ -88,9 +100,13 @@ class TCPClient extends EventEmitter {
 
             this.client.on('error', (error) => {
                 clearTimeout(timeout);
+                // AggregateError特殊处理（Node.js 18+的IPv4/IPv6连接失败）
+                if (error.name === 'AggregateError' || error.errors) {
+                    this.logger.warn(`TCP连接失败: 无法连接到 ${this.host}:${this.port}`);
+                }
                 // 只在首次连接或重要错误时记录，避免大量重复日志
                 // ECONNRESET通常是网络波动，不记录错误
-                if (!this.connected && error.code !== 'ECONNREFUSED' && error.code !== 'ECONNRESET') {
+                else if (!this.connected && error.code !== 'ECONNREFUSED' && error.code !== 'ECONNRESET') {
                     this.logger.error('TCP client error:', error.message);
                 }
 

package/nodes/symi-485-bridge.html

@@ -169,7 +169,7 @@
                             '</div>';
                     } else {
                         addrHtml = '<div class="addr-col normal-addr">' +
-                            '<input type="number" class="addr-input" value="' + (m.address || 1) + '" min="1" max="255" title="Modbus地址">' +
+                            '<input type="number" class="addr-input" value="' + (m.address !== undefined ? m.address : 1) + '" min="0" max="255" title="Modbus从机地址(0-255)">' +
                             '</div>';
                     }
                     row.html(
@@ -258,7 +258,9 @@
 
                 container.find('.addr-input').off('change').on('change', function() {
                     var idx = $(this).closest('.mapping-row').data('idx');
-                    mappings[idx].address = parseInt($(this).val()) || 1;
+                    var val = $(this).val();
+                    mappings[idx].address = (val !== '' && val !== undefined) ? parseInt(val) : 1;
+                    if (isNaN(mappings[idx].address)) mappings[idx].address = 1;
                 });
 
                 // 杜亚2字节地址输入
@@ -352,14 +354,24 @@
         oneditsave: function() {
             var mappings = [];
             $('#mapping-list .mapping-row').each(function() {
+                // 获取地址值，允许0（话语前湾空调地址是0）
+                var addrVal = $(this).find('.addr-input').val();
+                var address = (addrVal !== '' && addrVal !== undefined) ? parseInt(addrVal) : 1;
+                if (isNaN(address)) address = 1;
+                
                 var m = {
                     meshMac: $(this).find('.mesh-select').val() || '',
                     meshChannel: parseInt($(this).find('.mesh-channel').val()) || 1,
                     brand: $(this).find('.brand-select').val() || '',
                     device: $(this).find('.device-select').val() || '',
-                    address: parseInt($(this).find('.addr-input').val()) || 1,
+                    address: address,
                     rs485Channel: parseInt($(this).find('.rs485-channel').val()) || 1
                 };
+                // 保存杜亚窗帘2字节地址
+                if (m.brand === 'duya') {
+                    m.addrHigh = parseInt($(this).find('.addr-high').val()) || 1;
+                    m.addrLow = parseInt($(this).find('.addr-low').val()) || 1;
+                }
                 // 保存自定义码
                 if (m.brand === 'custom') {
                     m.customCodes = {};