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

package/README.md

@@ -382,6 +382,7 @@ npm install node-red-contrib-home-assistant-websocket
 - 支持与HA中任意实体同步
 - 配置灵活，易于调整
 
+
 ## 协议说明
 
 ### 核心协议格式
@@ -746,6 +747,14 @@ Mesh 四键开关 第2路 ↔ RS485 六键开关 第5路  地址:2   ✓ 支持
 
 当内置协议无法满足需求时，可使用"自定义协议"模式，手动录入RS485十六进制码进行双向匹配。
 
+#### 反馈选项
+
+每个映射可设置"反馈"复选框：
+- **勾选反馈**（默认）：RS485收码触发Mesh动作后，Mesh状态变化会再发送发码到RS485总线
+- **不勾选反馈**：RS485收码触发Mesh动作后，不再发送反馈码，避免总线重复数据
+
+适用场景：当第三方设备已经知道自己的状态，不需要收到确认反馈时，取消勾选可减少总线流量。
+
 #### 自定义开关（4组码）
 
 - **发开码**：Mesh开关打开时，发送此码到RS485总线
@@ -812,6 +821,198 @@ Mesh 四键开关 第2路 ↔ RS485 六键开关 第5路  地址:2   ✓ 支持
 4. **防循环保护**：内置同步锁机制，避免状态死循环
 5. **485转TCP网关**：Node-RED只能收到自己发送请求后的设备回应，其他TCP客户端的数据不会转发（网关机制）
 
+## RS485协议同步
+
+本节点支持两种不同RS485协议之间的双向数据同步，适用于对接中弘VRF网关与SYMI空调面板等场景。
+
+### 功能特点
+
+- **协议互转**：中弘VRF ↔ SYMI空调面板 ↔ 自定义码
+- **双向同步**：A侧状态变化自动同步到B侧，反之亦然
+- **自动轮询**：内置定时轮询中弘VRF设备状态（默认1秒）
+- **多组映射**：单节点支持多组设备映射
+- **防死循环**：2秒防抖机制，避免状态回环
+- **持久化配置**：重启后保持所有映射设置
+
+### 支持的协议
+
+| 协议类型 | 说明 | 帧格式 |
+|---------|------|--------|
+| 中弘VRF | 中弘品牌VRF空调网关（需轮询） | `[从机] [功能码] [控制值] [数量] [外机] [内机] [校验和]` |
+| SYMI空调面板 | SYMI Mesh空调面板RS485接口（主动上报） | `[地址] [0x60] [开关] [温度] [模式] [风速] [...] [校验和]` |
+| 自定义码 | 任意十六进制码匹配 | 用户自定义 |
+
+### 中弘VRF协议详解（需轮询）
+
+| 功能码 | 用途 | 控制值 |
+|--------|------|--------|
+| 0x31 | 开关控制 | 0x00=关, 0x01=开 |
+| 0x32 | 温度控制 | 16-30（直接温度值） |
+| 0x33 | 模式控制 | 0x01=制冷, 0x02=除湿, 0x04=送风, 0x08=制热 |
+| 0x34 | 风速控制 | 0x01=高, 0x02=中, 0x04=低 |
+| 0x50 | 状态查询 | - |
+
+> **注意**：中弘VRF是被动响应式协议，需要主动轮询才能获取设备状态。启用轮询后会定时发送0x50查询命令。
+
+### SYMI空调面板协议详解（主动上报）
+
+SYMI空调面板会主动上报状态变化，无需轮询。
+
+**帧格式**：`[地址] [0x60] [开关] [温度] [模式] [风速] [x] [x] [x] [校验和]`
+
+| 字节 | 说明 | 值域 |
+|------|------|------|
+| 0 | 设备地址 | 1-255 |
+| 1 | 功能码 | 0x60 |
+| 2 | 开关状态 | 0x00=关, 0x01=开 |
+| 3 | 目标温度 | 16-30 (0x10-0x1E) |
+| 4 | 运行模式 | 0x01=制冷, 0x02=除湿, 0x04=送风, 0x08=制热 |
+| 5 | 风速 | 0x01=低, 0x02=中, 0x04=高 |
+| 6-8 | 保留 | - |
+| 9 | 校验和 | 前9字节累加和的低8位 |
+
+**示例帧**：`01 60 01 18 08 02 01 01 00 86`
+- 地址1, 开机, 24°C, 制热, 中风
+
+**帧示例**（开机）：
+```
+01 31 01 01 01 01 36
+│  │  │  │  │  │  └─ 校验和
+│  │  │  │  │  └─ 内机地址
+│  │  │  │  └─ 外机地址
+│  │  │  └─ 空调数量
+│  │  └─ 控制值（开）
+│  └─ 功能码（开关）
+└─ 从机地址
+```
+
+### 配置步骤
+
+#### 1. 添加RS485同步节点
+
+从"Symi Mesh"分类中拖入"RS485同步"节点
+
+#### 2. 配置RS485连接
+
+**RS485连接A**：选择第一种协议的RS485配置（如中弘VRF网关）
+**RS485连接B**：选择第二种协议的RS485配置（如SYMI空调面板）
+
+> **注意**：A和B必须是两个不同的RS485配置节点
+
+#### 3. 添加协议映射
+
+点击"添加映射"按钮，配置每组对应关系：
+
+| 配置项 | 说明 |
+|--------|------|
+| A侧协议 | 选择A侧使用的协议（中弘VRF/SYMI空调面板/自定义码） |
+| B侧协议 | 选择B侧使用的协议 |
+| 详细参数 | 点击齿轮按钮展开，配置地址等参数 |
+
+#### 4. 轮询设置
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| 启用轮询 | 开启后自动轮询中弘VRF设备状态 | 启用 |
+| 轮询间隔 | 轮询周期（毫秒） | 1000ms |
+
+> **说明**：中弘VRF是被动响应式协议，需要主动查询才能获取设备状态。启用轮询后会逐个查询所有配置的中弘VRF设备。
+
+#### 5. 中弘VRF参数配置
+
+| 参数 | 说明 | 范围 |
+|------|------|------|
+| 外机地址 | VRF外机地址 | 0-255 |
+| 内机地址 | VRF内机地址 | 0-255 |
+
+#### 6. SYMI空调面板参数配置
+
+| 参数 | 说明 | 范围 |
+|------|------|------|
+| 设备地址 | SYMI面板Modbus地址 | 1-255 |
+
+#### 7. 自定义码参数配置
+
+| 参数 | 说明 |
+|------|------|
+| 开机发码 | 检测到开机时发送的十六进制码 |
+| 关机发码 | 检测到关机时发送的十六进制码 |
+| 开机收码 | 收到此码时认为设备开机 |
+| 关机收码 | 收到此码时认为设备关机 |
+
+#### 8. 部署
+
+点击"部署"按钮，节点自动开始双向同步
+
+### 配置示例
+
+**中弘VRF ↔ SYMI空调面板**：
+```
+RS485连接A: 192.168.2.100:502 (中弘VRF网关)
+RS485连接B: 192.168.2.110:1031 (SYMI面板总线)
+
+映射1:
+  A侧: 中弘VRF (从机1, 外机1, 内机1)
+  B侧: SYMI空调面板 (地址1)
+
+映射2:
+  A侧: 中弘VRF (从机1, 外机1, 内机2)
+  B侧: SYMI空调面板 (地址2)
+```
+
+### 工作原理
+
+#### A→B同步流程
+
+1. A侧RS485收到状态帧
+2. 解析协议，提取状态（开关/温度/模式/风速）
+3. 根据B侧协议生成控制命令
+4. 发送到B侧RS485
+
+#### B→A同步流程
+
+1. B侧RS485收到状态帧
+2. 解析协议，提取状态
+3. 根据A侧协议生成控制命令
+4. 发送到A侧RS485
+
+#### 防死循环机制
+
+- 同步后2秒内忽略反向状态变化
+- 每组映射独立防抖，互不影响
+- 状态缓存避免重复同步
+
+### 手动触发查询
+
+可以使用inject节点发送查询命令：
+
+```json
+{
+  "payload": {
+    "action": "query"
+  }
+}
+```
+
+这将向A侧所有中弘VRF设备发送状态查询命令。
+
+### 故障排查
+
+**A→B不工作**：
+1. 检查日志是否有`[A侧收到]`输出
+2. 确认A侧协议参数（从机/外机/内机地址）正确
+3. 检查RS485连接A是否已连接
+
+**B→A不工作**：
+1. 检查日志是否有`[B侧收到]`输出
+2. 确认B侧协议参数正确
+3. 检查RS485连接B是否已连接
+
+**状态不同步**：
+1. 检查节点状态是否显示"同步中"
+2. 确认两个RS485连接都已连接（绿色状态）
+3. 查看日志中的同步消息
+
 ## 云端数据同步
 
 本节点支持从酒店云云平台自动获取设备名称和场景信息，实现本地化配置的自动同步。
@@ -1091,6 +1292,7 @@ A: 每个房间部署一个云端同步节点，配置对应的酒店ID和房间
 | **Symi KNX Bridge** | KNX系统双向同步 | [KNX双向同步](#knx双向同步) |
 | **Symi KNX-HA Bridge** | KNX与HA实体双向同步 | [KNX-HA双向同步](#knx-ha双向同步) |
 | **RS485 Debug** | RS485总线数据抓包调试 | [RS485调试节点](#rs485调试节点) |
+| **Symi RS485 Sync** | 两种RS485协议双向同步 | [RS485协议同步](#rs485协议同步) |
 
 ## 开发者信息
 
@@ -1112,6 +1314,7 @@ node-red-contrib-symi-mesh/
 │   ├── symi-485-bridge.js/html # RS485桥接节点
 │   ├── symi-485-config.js/html # RS485配置节点
 │   ├── symi-knx-bridge.js/html # KNX桥接节点
+│   ├── symi-rs485-sync.js/html # RS485协议同步节点
 │   └── rs485-debug.js/html   # RS485调试节点
 ├── examples/
 │   ├── basic-example.json    # 基础示例
@@ -1254,6 +1457,71 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
+### v1.7.2 (2025-12-22)
+- **RS485双向同步节点**：新增`symi-rs485-sync`独立节点实现两种不同RS485协议之间的双向同步
+  - 支持中弘VRF网关协议（功能码0x31-0x34控制，0x50查询）
+  - 支持SYMI空调面板Modbus协议
+  - 支持自定义码协议
+  - 双向状态同步，2秒防抖防止死循环
+  - 多组映射配置，持久化保存
+  - **反馈选项**：新增"反馈"复选框，控制RS485收码后是否发送反馈码
+  - **Mesh→RS485方向**：
+    - 修复开关控制：只同步配置的通道，避免其他通道变化误触发
+    - 修复空调风速：fanMode变化正确发送fanSendHigh/Mid/Low/Auto码
+    - 修复空调中速(fanMode=2)事件触发
+    - 修复空调开关：去重处理，避免switch和acSwitch重复发送
+    - 添加自动风速(fanSendAuto/fanRecvAuto)配置支持
+  - **RS485→Mesh方向**：
+    - 修复收码匹配触发Mesh实体状态变化
+    - 自定义开关recvOn/recvOff正确触发开关动作
+    - 自定义空调acRecvOn/acRecvOff/fanRecvHigh等正确触发空调控制
+  - **事件系统优化**：
+    - DeviceManager事件添加完整字段（isUserControl、isSceneExecution等）
+    - 用户控制事件允许绕过首次状态缓存
+    - 修复单路温控器开关事件丢失问题
+    - fanMode事件同时发送acFanSpeed别名字段
+  - **防死循环优化**：
+    - 使用映射特定时间戳，避免不同设备同步互相影响
+    - Mesh→RS485和RS485→Mesh双向都记录同步时间
+    - 500ms冷却时间防止状态回环
+    - 空调命令去重（同类命令只发送一次）
+  - **生产稳定性**：
+    - 初始化延迟从10秒缩短为5秒
+    - 详细日志改为debug级别，减少生产环境日志量
+    - 保留关键同步日志便于问题排查
+  - **UI优化**：
+    - 自定义码折叠按钮移到同一行，减少占用空间
+    - 修复MAC地址大小写匹配问题
+    - 添加自动风速配置框（发自动/收自动）
+- **RS485-to-RS485空调桥接**：SYMI空调面板与中弘VRF系统双向同步
+  - 支持SYMI 485空调面板协议（7E...7D帧格式，CRC8校验）
+  - 支持中弘VRF空调协议（求和校验，功能码0x31-0x34控制，0x50查询）
+  - 双向状态同步：SYMI面板操作→中弘VRF执行，中弘状态→SYMI面板显示
+
+### v1.7.1 (2025-12-21)
+- **自定义协议全面修复**：完善自定义开关/窗帘/空调双向同步
+  - **空调风速控制**：修复风速变化事件触发机制
+    - 添加fanMode字段支持（mesh空调实际使用的字段）
+    - 修复DeviceInfo事件触发，正确发送device-state-changed事件
+    - 支持风速值1-4（1=高, 2=中, 3=低, 4=自动）
+    - 自动识别温控器0x02消息中的风速控制
+  - **空调开关控制**：修复开关状态变化事件触发
+    - 温控器0x02开关消息正确触发device-state-changed事件
+    - 自定义空调开关码（acSendOn/acSendOff）正确发送到RS485总线
+  - **RS485收码匹配**：修复hexStr格式处理
+    - hexStr完全去掉空格，确保标准格式（如030610330001BD27）
+    - 用户录入支持带空格格式（如01 06 10 34 00 01 0D 04）
+    - 自动匹配并触发mesh实体动作
+  - **事件系统优化**：
+    - DeviceInfo添加manager引用，正确触发事件
+    - 修复事件名称不匹配问题（stateChange -> device-state-changed）
+    - 确保所有自定义码双向同步正常
+  - **队列处理**：
+    - 命令队列顺序处理，防止并发冲突
+    - 500ms防死循环机制
+    - 队列限制100条，防止内存溢出
+  - **调试日志**：添加详细调试日志，方便排查问题
+
 ### v1.7.0 (2025-12-21)
 - **自定义协议增强**：RS485桥接节点自定义协议功能全面升级
   - 自定义开关：添加发开、发关、收开、收关4组码
@@ -1295,52 +1563,6 @@ node-red-contrib-symi-mesh/
 - **防死循环参数调整**：LOOP_PREVENTION_MS调整为800ms
 - **同时修复RS485桥接**：应用相同syncLock修复
 
-### v1.6.7 (2025-12-10)
-- **KNX双向同步完善**：`symi-knx-bridge`节点全面升级
-  - **knxUltimate消息格式**：符合官方规范，使用`destination`+`payload`+`dpt`+`event`
-  - **Universal Mode支持**：输出节点需启用"Listen to all GA"，动态设置组地址
-  - **消息事件**：添加`event: "GroupValue_Write"`，确保写入操作正确执行
-  - **payload类型修复**：DPT 1.001使用boolean类型(true/false)，不是number
-  - **地址映射修复**：根据设备类型正确映射扩展地址到具体功能
-  - **KNX输入匹配增强**：支持所有配置地址的匹配，通过地址函数确定功能类型
-  - **DPT格式兼容**：支持"DPT1.001"和"1.001"两种格式
-  - **新增处理器**：色温(light_color_temp)、空调风速(climate_fan)
-  - **防死循环**：1秒防抖机制，智能防止状态回环
-  - **命令队列**：最大100条，100ms防抖，50ms间隔
-  - **内存安全**：节点关闭时清理所有缓存和事件监听器
-- **KNX桥接节点功能**：
-  - KNX实体库：支持从模板导入KNX组地址
-  - 一行映射：紧凑表格显示，适合大量设备配置
-  - 多设备类型：开关、调光灯、窗帘、空调、新风、地暖
-  - 智能通道选择：根据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配置说明和协议对照表
 
 ## 许可证
 
@@ -1353,8 +1575,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.7.0
+**版本**: 1.7.2
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-12-21
+**最后更新**: 2025-12-23
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/examples/knx-sync-example.json

@@ -2,62 +2,71 @@
     {
         "id": "knx_sync_flow",
         "type": "tab",
-        "label": "Symi Mesh - KNX Sync",
+        "label": "KNX双向同步示例",
         "disabled": false,
-        "info": "Mesh设备与KNX系统双向同步示例"
+        "info": "Mesh设备与KNX系统双向同步示例，包含KNX桥接和KNX-HA桥接两种用法"
     },
     {
-        "id": "symi_gateway_knx",
-        "type": "symi-gateway",
-        "name": "Symi网关",
-        "connectionType": "tcp",
-        "host": "192.168.2.110",
-        "port": "4196",
-        "serialPort": "",
-        "baudRate": "115200"
-    },
-    {
-        "id": "knx_gateway_config",
-        "type": "knxUltimate-config",
-        "host": "192.168.1.50",
-        "port": "3671",
-        "physAddr": "15.15.22",
-        "hostProtocol": "TunnelUDP",
-        "loglevel": "error",
-        "name": "KNX Gateway",
-        "delaybetweentelegrams": 25,
-        "autoReconnect": "yes"
+        "id": "comment_usage",
+        "type": "comment",
+        "z": "knx_sync_flow",
+        "name": "使用说明: 1.修改网关IP 2.配置KNX实体 3.添加映射 4.部署测试",
+        "info": "KNX桥接: Mesh设备 ↔ KNX组地址\nKNX-HA桥接: KNX组地址 ↔ HA实体\n\n配置步骤:\n1. 修改Symi网关IP为实际地址\n2. 修改KNX网关IP为实际地址\n3. 双击桥接节点配置映射\n4. 部署后测试双向同步",
+        "x": 280,
+        "y": 40,
+        "wires": []
     },
     {
         "id": "knx_input_node",
         "type": "knxUltimate",
         "z": "knx_sync_flow",
         "server": "knx_gateway_config",
-        "topic": "",
+        "topic": "0/0/1",
+        "setTopicType": "str",
         "dpt": "1.001",
+        "initialread": 0,
+        "notifyreadrequest": false,
+        "notifyresponse": true,
+        "notifywrite": true,
+        "notifyreadrequestalsorespondtobus": false,
         "name": "KNX Input",
         "outputtype": "write",
         "outputRBE": "false",
         "inputRBE": "false",
-        "notifyreadrequest": false,
-        "notifyresponse": true,
-        "notifywrite": true,
+        "formatmultiplyvalue": 1,
+        "formatnegativevalue": "leave",
+        "formatdecimalsvalue": 999,
+        "passthrough": "no",
         "listenallga": true,
+        "gaSecure": "false",
+        "buttonEnabled": false,
         "x": 150,
-        "y": 100,
-        "wires": [["knx_bridge_node"]]
+        "y": 120,
+        "wires": [["knx_bridge_node", "knx_ha_bridge_node"]]
     },
     {
         "id": "knx_bridge_node",
         "type": "symi-knx-bridge",
         "z": "knx_sync_flow",
-        "name": "KNX Bridge",
+        "name": "KNX桥接",
         "gateway": "symi_gateway_knx",
-        "mappings": "[]",
-        "knxEntities": "[]",
-        "x": 350,
-        "y": 100,
-        "wires": [["knx_output_node"], ["debug_node"]]
+        "mappings": "[{\"meshMac\":\"98:e0:c8:20:da:cc\",\"meshChannel\":1,\"knxEntityId\":\"k_demo_switch\"}]",
+        "knxEntities": "[{\"id\":\"k_demo_switch\",\"name\":\"示例开关\",\"type\":\"switch\",\"cmdAddr\":\"0/0/1\",\"statusAddr\":\"0/1/1\",\"ext1\":\"\",\"ext2\":\"\",\"ext3\":\"\",\"invert\":false}]",
+        "x": 380,
+        "y": 180,
+        "wires": [["knx_output_node"], []]
+    },
+    {
+        "id": "knx_ha_bridge_node",
+        "type": "symi-knx-ha-bridge",
+        "z": "knx_sync_flow",
+        "name": "KNX HA桥接",
+        "haServer": "ha_server_config",
+        "mappings": "[{\"knxEntityId\":\"k_demo_light\",\"haEntityId\":\"light.demo\"}]",
+        "knxEntities": "[{\"id\":\"k_demo_light\",\"name\":\"示例灯\",\"type\":\"switch\",\"cmdAddr\":\"0/0/1\",\"statusAddr\":\"0/1/1\",\"ext1\":\"\",\"ext2\":\"\",\"ext3\":\"\",\"invert\":false}]",
+        "x": 390,
+        "y": 120,
+        "wires": [["knx_output_node"], []]
     },
     {
         "id": "knx_output_node",
@@ -65,39 +74,94 @@
         "z": "knx_sync_flow",
         "server": "knx_gateway_config",
         "topic": "",
+        "setTopicType": "str",
         "dpt": "0",
-        "name": "KNX Output (Universal Mode)",
+        "initialread": 0,
+        "notifyreadrequest": false,
+        "notifyresponse": false,
+        "notifywrite": true,
+        "name": "Universal KNX",
         "outputtype": "write",
         "outputRBE": "false",
         "inputRBE": "false",
-        "notifywrite": true,
+        "passthrough": "no",
         "listenallga": true,
-        "x": 550,
-        "y": 100,
-        "wires": []
+        "buttonEnabled": false,
+        "x": 620,
+        "y": 120,
+        "wires": [[]]
     },
     {
-        "id": "debug_node",
-        "type": "debug",
+        "id": "ha_state_node",
+        "type": "server-state-changed",
         "z": "knx_sync_flow",
-        "name": "Sync Debug",
-        "active": true,
-        "tosidebar": true,
-        "console": false,
-        "tostatus": false,
-        "complete": "payload",
-        "x": 550,
-        "y": 160,
-        "wires": []
+        "name": "HA状态变化",
+        "server": "ha_server_config",
+        "version": 6,
+        "outputs": 1,
+        "exposeAsEntityConfig": "",
+        "entities": {
+            "entity": ["light.demo"],
+            "substring": [],
+            "regex": []
+        },
+        "outputInitially": false,
+        "stateType": "str",
+        "ifState": "",
+        "ifStateType": "str",
+        "ifStateOperator": "is",
+        "outputOnlyOnStateChange": true,
+        "for": "0",
+        "forType": "num",
+        "forUnits": "minutes",
+        "x": 170,
+        "y": 180,
+        "wires": [["knx_ha_bridge_node"]]
     },
     {
-        "id": "comment_usage",
-        "type": "comment",
-        "z": "knx_sync_flow",
-        "name": "使用说明",
-        "info": "1. 修改symi_gateway_knx的IP为网关实际地址\n2. 修改knx_gateway_config的IP为KNX网关地址\n3. 双击KNX Bridge节点配置映射:\n   - 导入KNX实体(组地址)\n   - 添加Mesh设备与KNX实体的映射\n4. 部署后等待20秒初始化完成\n5. 测试双向同步",
-        "x": 140,
-        "y": 40,
-        "wires": []
+        "id": "symi_gateway_knx",
+        "type": "symi-gateway",
+        "name": "Symi网关",
+        "connectionType": "tcp",
+        "host": "192.168.2.110",
+        "port": 4196,
+        "serialPort": "",
+        "baudRate": 115200
+    },
+    {
+        "id": "knx_gateway_config",
+        "type": "knxUltimate-config",
+        "host": "192.168.2.62",
+        "port": 3671,
+        "physAddr": "1.1.234",
+        "hostProtocol": "TunnelUDP",
+        "suppressACKRequest": false,
+        "loglevel": "error",
+        "name": "KNX网关",
+        "delaybetweentelegrams": 25,
+        "autoReconnect": "yes"
+    },
+    {
+        "id": "ha_server_config",
+        "type": "server",
+        "name": "Home Assistant",
+        "version": 6,
+        "addon": false,
+        "rejectUnauthorizedCerts": true,
+        "ha_boolean": ["y", "yes", "true", "on", "home", "open"],
+        "connectionDelay": true,
+        "cacheJson": true,
+        "heartbeat": false,
+        "heartbeatInterval": 30,
+        "areaSelector": "friendlyName",
+        "deviceSelector": "friendlyName",
+        "entitySelector": "friendlyName",
+        "statusSeparator": ": ",
+        "statusYear": "hidden",
+        "statusMonth": "short",
+        "statusDay": "numeric",
+        "statusHourCycle": "default",
+        "statusTimeFormat": "h:m",
+        "enableGlobalContextStore": false
     }
 ]

package/examples/rs485-sync-example.json

@@ -0,0 +1,76 @@
+[
+    {
+        "id": "rs485_sync_flow",
+        "type": "tab",
+        "label": "RS485双向同步示例",
+        "disabled": false,
+        "info": "中弘VRF与SYMI空调面板RS485双向同步示例"
+    },
+    {
+        "id": "rs485_config_vrf",
+        "type": "symi-485-config",
+        "name": "VRF串口",
+        "serialPort": "/dev/ttyUSB0",
+        "baudRate": "9600",
+        "dataBits": "8",
+        "stopBits": "1",
+        "parity": "none"
+    },
+    {
+        "id": "rs485_config_symi",
+        "type": "symi-485-config",
+        "name": "SYMI串口",
+        "serialPort": "/dev/ttyUSB1",
+        "baudRate": "9600",
+        "dataBits": "8",
+        "stopBits": "1",
+        "parity": "none"
+    },
+    {
+        "id": "rs485_sync_node",
+        "type": "symi-rs485-sync",
+        "z": "rs485_sync_flow",
+        "name": "VRF-SYMI同步",
+        "rs485ConfigA": "rs485_config_vrf",
+        "rs485ConfigB": "rs485_config_symi",
+        "mappings": "[{\"protocolA\":\"zhonghong\",\"protocolB\":\"symi_climate\",\"configA\":{\"outdoorAddr\":1,\"indoorAddr\":0},\"configB\":{\"address\":1}}]",
+        "enablePolling": true,
+        "pollInterval": 1000,
+        "x": 300,
+        "y": 140,
+        "wires": [[]]
+    },
+    {
+        "id": "rs485_debug_node",
+        "type": "rs485-debug",
+        "z": "rs485_sync_flow",
+        "name": "调试监控",
+        "rs485Config": "rs485_config_vrf",
+        "displayMode": "hex",
+        "showTimestamp": true,
+        "maxMessages": 100,
+        "x": 300,
+        "y": 220,
+        "wires": [[]]
+    },
+    {
+        "id": "comment_rs485_usage",
+        "type": "comment",
+        "z": "rs485_sync_flow",
+        "name": "使用说明",
+        "info": "1. 修改串口配置为实际设备端口\n2. 配置映射关系:\n   - A侧: 中弘VRF (外机地址1, 内机地址0)\n   - B侧: SYMI空调面板 (设备地址1)\n3. 启用轮询获取VRF状态\n4. 部署后自动双向同步",
+        "x": 140,
+        "y": 60,
+        "wires": []
+    },
+    {
+        "id": "comment_protocol",
+        "type": "comment",
+        "z": "rs485_sync_flow",
+        "name": "协议说明: 中弘VRF需轮询, SYMI面板主动上报",
+        "info": "中弘VRF: 被动响应, 需定时发送0x50查询命令\nSYMI面板: 主动上报0x60功能码, 无需轮询",
+        "x": 240,
+        "y": 300,
+        "wires": []
+    }
+]