node-red-contrib-symi-mesh 1.3.1 → 1.6.1

package/README.md

@@ -13,7 +13,8 @@
 - **MQTT Discovery**：自动发布HA Discovery配置，设备即插即用
 - **双向状态同步**：支持0x80状态事件，实时反馈设备状态变化
 - **多设备类型**：支持开关、灯光、窗帘、温控器、传感器等12+种设备
-- **三合一面板**：完整支持空调+新风+地暖三合一控制面板
+- **三合一面板**：完整支持空调+新风+地暖三合一控制面板，自动识别
+- **RS485/Modbus集成**：支持第三方485设备双向同步，内置协议模板
 - **KNX集成**：支持与KNX系统双向同步
 - **云端同步**：从酒店云云平台自动获取设备名称和场景信息
 - **稳定可靠**：完善的错误处理和自动重连机制
@@ -86,6 +87,31 @@ node-red-restart
 3. 在Home Assistant中查看自动发现的设备
 4. 测试设备控制和状态反馈
 
+### 5. 多网关配置（可选）
+
+对于大户型或多区域部署，可以配置多个网关节点：
+
+1. **添加第二个网关节点**：
+   - 拖入新的"Symi Gateway"节点
+   - 配置不同的IP地址或串口
+   - 给网关起不同的名称（如"网关-客厅"、"网关-卧室"）
+
+2. **添加对应的MQTT节点**：
+   - 为每个网关添加独立的"Symi MQTT"节点
+   - 在配置中选择对应的网关
+   - 使用相同的MQTT broker配置
+
+3. **设备隔离**：
+   - 每个网关的设备独立存储，互不干扰
+   - 每个网关的设备在HA中独立显示
+   - 可以为不同网关配置不同的MQTT主题前缀
+
+**示例配置**：
+```
+网关1（客厅）: 192.168.2.110:4196 → MQTT主题: symi_mesh/living_room/
+网关2（卧室）: 192.168.2.111:4196 → MQTT主题: symi_mesh/bedroom/
+```
+
 ## 支持的设备类型
 
 | 设备类型 | 类型码 | HA实体 | 功能说明 |
@@ -101,6 +127,7 @@ node-red-restart
 | 温控器/三合一 | 0x0A | climate | 温度/模式/风速控制，当前温度采集 || 空调+新风+地暖三合一控制面板 |
 | 温湿度传感器 | 0x0B | sensor | 温湿度监测 |
 | 五色调光灯 | 0x18 | light | RGB+亮度+色温调节 |
+| 四输入八输出 | 0x27 (39) | switch | 8路独立控制，支持场景绑定 |
 
 
 ### 三合一设备说明
@@ -125,7 +152,19 @@ node-red-restart
 
 #### 使用方式
 
-**自动识别**：部署后自动区分普通温控器和三合一设备，无需手动配置
+**自动识别机制**：
+- 空调温控器和三合一面板属于同一设备品类（deviceType=10）
+- 系统通过主动查询新风(0x68)和地暖(0x6B)状态来区分
+- 有响应的识别为三合一面板，无响应的识别为普通温控器
+- 无需手动配置，部署后自动完成识别
+
+**识别日志示例**：
+```
+[三合一检测] 发现温控器类型设备: 温控器_xxx，将通过查询新风/地暖确认类型
+[三合一检测] 开始检测设备 xxx (0xABCD)
+[三合一检测] 收到 xxx 的新风响应 (0x68)，确认为三合一面板
+[三合一检测] 确认为三合一面板（收到新风/地暖响应）
+```
 
 **控制方式**：
 - HA中直接控制：设置温度/模式自动开启设备
@@ -408,6 +447,110 @@ return {
 4. **双向同步**：避免循环控制，使用`outputRBE: true`防抖
 5. **测试验证**：先测试单向同步，确认正常后再启用双向
 
+## RS485/Modbus双向同步
+
+本节点支持与第三方RS485/Modbus设备进行双向状态同步，适用于对接各品牌空调、新风、地暖等设备。
+
+### 功能特点
+
+- **双模式连接**：支持串口(RS485)和TCP/IP两种连接方式
+- **协议模板**：内置常用协议模板，支持自定义寄存器映射
+- **双向同步**：Mesh设备和485设备状态实时同步
+- **多设备支持**：单个485连接可管理多达105个设备
+
+### 配置步骤
+
+#### 1. 添加RS485桥接节点
+
+从"Symi Mesh"分类中拖入"RS485桥接"节点，双击打开配置：
+
+**基本配置**：
+- **Mesh网关**：选择已配置的Symi Gateway（点击+号可新建）
+- **RS485连接**：点击+号新建连接配置
+
+#### 2. 配置RS485连接
+
+点击RS485连接旁边的+号，创建新连接：
+
+**串口模式**：
+- **连接方式**：选择 串口(RS485)
+- **串口**：从下拉框选择USB串口（点击刷新按钮可重新扫描）
+- **波特率**：根据设备设置（常用9600）
+- **校验位**：无/偶校验/奇校验
+
+**TCP模式**：
+- **连接方式**：选择 TCP/IP
+- **主机地址**：485转TCP网关的IP地址
+- **端口**：Modbus TCP端口（默认502）
+
+#### 3. 配置实体映射
+
+点击"添加映射"按钮，每行配置一组对应关系：
+
+| 列 | 说明 |
+|----|------|
+| Mesh实体/按键 | 选择Mesh设备，开关设备会显示按键选择（第1路、第2路...） |
+| 品牌 | 选择RS485协议品牌（如 话语前湾） |
+| 类型/按键 | 选择设备类型，开关类型会显示按键选择 |
+| 地址 | Modbus从机地址（1-255） |
+
+**开关设备命名**：按按键数命名，方便识别：
+- Mesh端：一键开关、二键开关、三键开关、四键开关、六键开关、八键开关
+- RS485端：一键开关、二键开关、三键开关、四键开关、六键开关、八键开关
+
+**按键独立配置**：Mesh和RS485的按键可以自由对应，不必一一匹配：
+```
+Mesh 六键开关 第3路 ↔ RS485 四键开关 第1路  地址:1   ✓ 支持
+Mesh 四键开关 第2路 ↔ RS485 六键开关 第5路  地址:2   ✓ 支持
+```
+
+#### 4. 部署
+
+点击"部署"按钮，所有映射自动开始双向同步
+
+### RS485调试节点
+
+新增 `RS485调试` 节点用于抓取并显示原始485字节流：
+
+**功能**：
+- 实时显示RS485总线所有通信数据（TX发送/RX接收）
+- 自动解析Modbus RTU帧结构（从机地址、功能码）
+- 支持手动发送测试帧（输入十六进制字符串）
+- 十六进制/ASCII显示模式
+- 调试窗口高度自适应
+
+**输出示例**：
+```
+[15:07:55.123] → TX: 01 06 10 31 00 01 6A 35 | 从机:1 写单寄存器
+[15:07:55.180] ← RX: 01 06 10 31 00 01 6A 35 | 从机:1 写单寄存器
+```
+
+### 实体映射规则
+
+| Mesh实体类型 | RS485实体类型 | 同步内容 |
+|-------------|--------------|---------|
+| 开关-按键N | 开关 | 开/关状态 |
+| 温控器 | 空调 | 开关、温度、模式、风速 |
+| 调光灯 | 调光器 | 开关、亮度 |
+
+**部分同步**：如果RS485协议不提供某些功能点，只同步双方都支持的内容
+
+### 内置协议支持
+
+| 品牌 | 支持设备 |
+|-----|---------|
+| 话语前湾 | 空调、地暖、新风、窗帘、1-8键开关 |
+
+> 如需扩展其他品牌协议，请联系技术支持
+
+### 注意事项
+
+1. **Modbus地址**：同一485总线上设备地址不能重复（1-255）
+2. **自动重连**：网络断开后5秒自动重连，无需人工干预
+3. **事件驱动**：非轮询模式，设备状态变化时才同步
+4. **防循环保护**：内置同步锁机制，避免状态死循环
+5. **485转TCP网关**：Node-RED只能收到自己发送请求后的设备回应，其他TCP客户端的数据不会转发（网关机制）
+
 ## 云端数据同步
 
 本节点支持从酒店云云平台自动获取设备名称和场景信息，实现本地化配置的自动同步。
@@ -429,8 +572,8 @@ return {
 - **MQTT节点**：选择Symi MQTT节点（用于更新Discovery配置）
 
 **云端认证**：
-- **App ID**：`cee70459`（默认已填写）
-- **App Secret**：`a719a4b58e2e57e50d758ee3762507e7`（默认已填写）
+- **App ID**：请联系Symi技术支持获取
+- **App Secret**：请联系Symi技术支持获取
 - 点击"测试连接"按钮验证认证信息
 
 **房间配置**：
@@ -469,6 +612,70 @@ payload: "sync"
 payload: { scene_id: 4 }  // 执行场景ID为4的场景（如"全关"）
 ```
 
+### 按键场景自动触发
+
+**v1.4.0新功能**：开关按键可以绑定场景，按下时自动触发场景执行，实现本地化场景联动。
+
+#### 工作原理
+
+1. **云端配置获取**：从云端获取每个按键的配置信息（sub_device）
+2. **按键类型识别**：
+   - **普通按键**（sub_type="普通"）：控制本地继电器，不触发场景
+   - **场景按键**（sub_type="场景"）：按下时触发指定场景（scene_id）
+   - **双控按键**（sub_type="双控"）：根据当前状态触发开场景（on_scene_id）或关场景（off_scene_id）
+   - **总控按键**（sub_type="总控"）：同双控，用于全局控制
+3. **本地化触发**：按键按下时，系统自动检测并发送0x34场景控制命令到总线
+4. **状态同步**：场景执行后，所有相关设备状态自动同步到Home Assistant
+
+#### 配置示例
+
+云端配置（酒店云云平台）：
+```json
+{
+  "device_name": "床头三键",
+  "sub_device": [
+    {
+      "sub_name": "明亮",
+      "sub_type": "场景",
+      "scene_id": 4
+    },
+    {
+      "sub_name": "温馨",
+      "sub_type": "场景",
+      "scene_id": 6
+    },
+    {
+      "sub_name": "睡眠",
+      "sub_type": "场景",
+      "scene_id": 5
+    }
+  ]
+}
+```
+
+#### 日志示例
+
+启动时显示场景绑定：
+```
+[场景绑定] 床头三键: 按键1(明亮)→场景4, 按键2(温馨)→场景6, 按键3(睡眠)→场景5
+[场景绑定] 入户二键: 按键1(廊灯)→开:场景22/关:场景21, 按键2(卫浴灯)→开:场景24/关:场景23
+```
+
+按键按下时触发场景：
+```
+[按键场景] 检测到按键1(明亮)状态变化: 关 → 开, 触发场景4
+[按键场景] ✓ 场景4(明亮)控制命令已发送
+[场景控制] 场景控制命令已被网关接受
+[场景执行] 收到场景执行通知事件: 场景ID=4
+```
+
+#### 注意事项
+
+1. **云端配置必需**：需要先配置云端同步节点并成功获取设备配置
+2. **完全本地化**：场景触发完全在本地进行，不依赖云端
+3. **避免循环**：场景执行期间不会再次触发按键场景，防止循环
+4. **状态同步**：场景执行后的设备状态变化会自动同步到HA
+
 ### 工作原理
 
 #### 数据获取流程
@@ -825,48 +1032,12 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
-### v1.3.1 (2025-11-07)
-- **重要修复**：场景控制协议修正（从0x31改为0x34，符合最新协议规范）
-- **重要修复**：场景执行状态同步队列处理（确保场景触发后所有设备状态正确同步）
-- **重要修复**：6键开关状态同步（新增0x45消息类型支持）
-- **性能优化**：状态事件队列化处理，避免高频状态更新时的CPU占用
-- **稳定性提升**：场景执行2秒超时机制，确保状态同步窗口准确
-- **日志优化**：场景执行期间的状态更新使用log级别，便于调试和验证
-- 场景控制帧格式：`53 34 06 BC C0 00 05 01 [场景ID] [校验]`
-- 场景执行响应：`53 B4 00 00 E7`（网关确认）
-- 场景执行通知：`53 80 11 ...`（设备执行通知）
-- 支持场景执行后的批量设备状态同步（队列处理，非阻塞）
-- 6键开关场景状态同步（0x45消息类型，2字节小端序）
-- 所有设备类型的场景状态同步验证通过
-
-### v1.3.0 (2025-11-06)
-- **新功能**：新增云端同步节点（Symi Cloud Sync）
-- **重要修复**：MAC地址反序处理（修复设备匹配问题）
-- **重要修复**：场景触发事件路由机制（修复场景无法执行问题）
-- **重要修复**：设备控制日志级别（从debug改为log，便于调试）
-- **重要修复**：酒店和房间选择持久化保存（重新打开配置无需重新选择）
-- **重要修复**：云端"未命名"设备自动保留设备类型标准名称
-- **架构优化**：MQTT配置统一到网关节点，简化配置流程
-- **节点优化**：Symi MQTT改为config node，不再显示在左侧面板
-- 支持从酒店云云平台自动获取设备名称和场景信息
-- 云端MAC地址自动反转匹配本地设备（云端存储为反序）
-- 支持开关设备的按键名称同步（sub_device）
-- 显示云端设备列表（所有设备都有名称）
-- 自动重新发布MQTT Discovery配置（使用云端名称）
-- HA实体名称为纯名称，不带MAC地址和ID
-- 场景自动发布为Home Assistant按钮实体
-- 支持在HA中直接触发场景（本地化控制）
-- 场景触发通过事件机制路由，确保可靠执行
-- 可选择性同步设备和场景（勾选功能，支持一键全选）
-- 数据持久化存储，获取失败时使用缓存
-- 仅在启动时获取一次，不影响系统性能
-
-### v1.2.4 (2025-11-04)
-- **重大优化**：大幅减少日志输出，解决长期运行日志膨胀问题
-- 将高频日志（Frame接收/发送、状态事件、MQTT消息等）改为debug级别
-- 保留关键日志（连接/断开、设备发现、错误）用于问题排查
-- 提升系统性能和稳定性，适合7x24小时长期运行
-- 修复网关或MQTT服务器离线时的错误处理
+### v1.6.0 (2025-12-03)
+- **MQTT订阅修复**：修复闭包问题导致的设备MAC映射错误，确保HA实体可控
+- **内存泄漏修复**：节点关闭时正确移除gateway事件监听器，防止内存累积
+- **三合一面板完善**：空调/新风/地暖控制和状态反馈全面优化
+- **RS485双向同步**：支持Mesh与第三方485设备双向状态同步
+- **代码优化**：中文注释规范化，移除冗余代码，提升可维护性
 
 
 ## 许可证
@@ -880,8 +1051,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.3.1
+**版本**: 1.6.0
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-11-07
+**最后更新**: 2025-12-03
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/examples/basic-example.json

@@ -0,0 +1,151 @@
+[
+    {
+        "id": "basic_flow",
+        "type": "tab",
+        "label": "Symi Mesh 基础示例",
+        "disabled": false,
+        "info": "展示Symi Mesh网关的基本配置和使用方法"
+    },
+    {
+        "id": "symi_gateway_config",
+        "type": "symi-gateway",
+        "name": "Symi网关",
+        "connectionType": "tcp",
+        "host": "192.168.2.110",
+        "port": "4196",
+        "serialPort": "",
+        "baudRate": "115200",
+        "mqttBroker": "mqtt://localhost:1883",
+        "mqttUsername": "",
+        "mqttPassword": "",
+        "mqttPrefix": "homeassistant"
+    },
+    {
+        "id": "comment_intro",
+        "type": "comment",
+        "z": "basic_flow",
+        "name": "说明: 修改网关IP地址后部署即可使用",
+        "info": "1. 双击上方网关节点修改IP地址\n2. 点击部署按钮\n3. 设备将自动发现并发布到MQTT",
+        "x": 220,
+        "y": 60,
+        "wires": []
+    },
+    {
+        "id": "symi_mqtt_node",
+        "type": "symi-mqtt",
+        "z": "basic_flow",
+        "name": "MQTT桥接",
+        "gateway": "symi_gateway_config",
+        "x": 130,
+        "y": 140,
+        "wires": []
+    },
+    {
+        "id": "comment_mqtt",
+        "type": "comment",
+        "z": "basic_flow",
+        "name": "MQTT节点自动发布设备到Home Assistant",
+        "info": "部署后设备会自动通过MQTT Discovery发布到HA",
+        "x": 230,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "comment_three_in_one",
+        "type": "comment",
+        "z": "basic_flow",
+        "name": "三合一面板控制示例 (空调+新风+地暖)",
+        "info": "三合一面板会被自动识别，发布为独立的climate和fan实体",
+        "x": 220,
+        "y": 280,
+        "wires": []
+    },
+    {
+        "id": "inject_climate_cool",
+        "type": "inject",
+        "z": "basic_flow",
+        "name": "空调制冷",
+        "props": [
+            {"p": "topic", "vt": "str"},
+            {"p": "payload"}
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "symi_mesh/894ab820dacc/climate/mode/set",
+        "payload": "cool",
+        "payloadType": "str",
+        "x": 130,
+        "y": 340,
+        "wires": [["mqtt_out"]]
+    },
+    {
+        "id": "inject_fresh_air_on",
+        "type": "inject",
+        "z": "basic_flow",
+        "name": "新风开启",
+        "props": [
+            {"p": "topic", "vt": "str"},
+            {"p": "payload"}
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "symi_mesh/894ab820dacc/fresh_air/set",
+        "payload": "ON",
+        "payloadType": "str",
+        "x": 130,
+        "y": 400,
+        "wires": [["mqtt_out"]]
+    },
+    {
+        "id": "inject_floor_heat",
+        "type": "inject",
+        "z": "basic_flow",
+        "name": "地暖制热",
+        "props": [
+            {"p": "topic", "vt": "str"},
+            {"p": "payload"}
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "symi_mesh/894ab820dacc/floor_heating/mode/set",
+        "payload": "heat",
+        "payloadType": "str",
+        "x": 130,
+        "y": 460,
+        "wires": [["mqtt_out"]]
+    },
+    {
+        "id": "mqtt_out",
+        "type": "mqtt out",
+        "z": "basic_flow",
+        "name": "MQTT发送",
+        "topic": "",
+        "qos": "",
+        "retain": "",
+        "respTopic": "",
+        "contentType": "",
+        "userProps": "",
+        "correl": "",
+        "expiry": "",
+        "broker": "",
+        "x": 350,
+        "y": 400,
+        "wires": []
+    },
+    {
+        "id": "comment_note",
+        "type": "comment",
+        "z": "basic_flow",
+        "name": "注意: 修改topic中的MAC地址为您的实际设备MAC",
+        "info": "MAC地址格式: 小写无冒号，如894ab820dacc",
+        "x": 250,
+        "y": 520,
+        "wires": []
+    }
+]