node-red-contrib-symi-modbus 2.6.8 → 2.6.9

package/README.md

@@ -16,8 +16,15 @@ Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成，
   - Modbus TCP（标准Modbus TCP）
   - Modbus RTU over TCP（TCP转RS485网关）
   - Telnet ASCII（推荐用于TCP转RS485网关）
-- **Symi开关集成**：自动识别并处理Symi私有协议按键事件，实现开关面板与继电器的双向同步
+- **Symi开关集成**：
+  - RS-485开关：自动识别并处理Symi私有协议按键事件
+  - 蓝牙Mesh开关：支持Symi蓝牙Mesh网关和1-6路Mesh开关
+  - 双向同步：开关面板与继电器状态实时同步
+  - 设备持久化：Mesh设备列表自动保存，重启无需重新扫描
 - **HomeKit网桥**：一键桥接到Apple HomeKit，支持Siri语音控制，自动同步主站配置，名称可自定义
+- **智能写入队列**：所有写入操作串行执行，支持HomeKit群控160个继电器同时动作，流畅无卡顿
+- **可视化控制看板**：实时显示和控制所有继电器状态，美观易用，适合现场调试和日常监控
+- **自定义协议转换**：支持非标准485协议设备，窗帘循环控制，配置界面可测试发送
 - **多设备轮询**：支持最多10台Modbus从站设备，每台32路继电器
 - **智能轮询机制**：从站上报时自动暂停轮询，优先处理数据，避免冲突
 - **稳定可靠**：完整的内存管理、错误处理、断线重连，适合7x24小时长期运行
@@ -53,7 +60,7 @@ node-red-restart
 **配置方法**：
 1. 主站节点：不启用MQTT或不配置MQTT服务器
 2. 从站开关节点：不配置MQTT服务器
-3. **无需连线**：主站和从站通过内部事件自动通信（v2.6.7+）
+3. **无需连线**：主站和从站通过内部事件自动通信
 
 **优势**：
 - ✅ 断网也能稳定运行
@@ -132,21 +139,73 @@ node-red-restart
 
 ### 5. 配置从站开关节点（可选）
 
-使用物理开关面板控制继电器：
+使用物理开关面板控制继电器，支持三种模式：
+
+#### 模式1：RS-485开关模式（传统有线开关）
 
 1. 拖拽 **从站开关** 节点到流程画布
 2. 选择刚创建的RS-485连接配置
 3. 配置开关面板信息：
    - 面板品牌: `亖米` (默认)
+   - 按钮类型: `开关按钮（RS-485）`
    - 开关ID: 物理面板地址 (0-255)
    - 按钮编号: 按键编号 (1-8)
-   - 按钮类型: 开关按钮或场景按钮（也可自动识别）
 4. 配置映射到的继电器：
    - 目标从站地址: `10`
-   - 目标线圈编号: `0`
-5. **无需连线**：主站和从站通过内部事件自动通信，无需手动连线
+   - 目标线圈编号: `1`（用户输入1-32）
+5. **无需连线**：主站和从站通过内部事件自动通信
 6. 部署流程
 
+#### 模式2：RS-485场景模式（场景触发）
+
+1. 配置步骤同上，但按钮类型选择 `场景按钮（RS-485）`
+2. 每次按键触发状态翻转（ON→OFF或OFF→ON）
+3. 适用于场景联动、一键控制等场景
+
+#### 模式3：Mesh开关模式（蓝牙Mesh无线开关）
+
+**适用场景**：使用Symi蓝牙Mesh网关和Mesh开关面板
+
+**配置步骤**：
+
+1. **准备工作**
+   - 确保Mesh网关已通过TCP或串口连接到Node-RED
+   - 确保Mesh开关已配网到网关
+
+2. **添加节点**
+   - 拖拽 **从站开关** 节点到流程画布
+   - 选择Mesh网关的连接配置（TCP或串口）
+
+3. **扫描Mesh设备**
+   - 按钮类型: 选择 `Mesh开关（蓝牙Mesh）`
+   - 点击 **扫描设备** 按钮
+   - 系统发送 `53 12 00 41` 协议帧到网关
+   - 网关立即返回所有Mesh开关列表（通常5秒内完成）
+   - 设备列表自动持久化保存到 `~/.node-red/mesh-devices-persist/`
+   - 重启Node-RED无需重新扫描，直接从持久化存储加载
+
+4. **选择设备和按键**
+   - Mesh设备: 从下拉框选择开关（显示格式：`MAC地址 (X路开关)`）
+   - 按钮编号: 选择要使用的按键（1-6路）
+   - 多个节点可共享同一设备列表，无需重复扫描
+
+5. **配置目标继电器**
+   - 目标从站地址: `10`
+   - 目标线圈编号: `1`（用户输入1-32）
+
+6. **部署流程**
+   - 点击"完成"并部署
+   - Mesh开关按键会自动控制对应继电器
+   - 继电器状态变化会自动反馈到Mesh开关LED
+
+**Mesh模式特点**：
+- ✅ 无线控制，无需布线
+- ✅ 支持1-6路开关
+- ✅ 双向同步（按键→继电器，继电器→LED）
+- ✅ 设备列表持久化保存
+- ✅ 短地址自动更新（如果网关重新配网）
+- ✅ 与RS-485开关使用方式完全一致
+
 ### 6. 配置HomeKit网桥节点（可选）
 
 将Modbus继电器桥接到Apple HomeKit，实现Siri语音控制：
@@ -183,6 +242,35 @@ node-red-restart
 - 支持Siri语音控制："嘿Siri，打开客厅灯"
 - 支持HomeKit自动化和场景
 - 配置会自动保存，重启后无需重新配对
+- **群控性能**：支持同时控制多个继电器（如创建编组），智能队列机制确保流畅无卡顿
+
+**群控说明**（客户友好模式）：
+
+本节点专为智能家居群控场景优化，支持以下高性能操作：
+
+1. **HomeKit编组群控**：
+   - 在HomeKit中创建房间或编组，可同时控制多个继电器
+   - 例如：创建"客厅"编组，包含10个灯光开关，一键全开/全关
+   - 智能队列机制确保所有继电器按序快速执行，无超时警告
+   - 10个继电器同时动作仅需约200ms（20ms间隔×10）
+
+2. **场景联动**：
+   - 支持HomeKit场景（如"回家模式"、"离家模式"）
+   - 场景可包含多个继电器动作，自动串行执行
+   - 前16个线圈（继电器）可同时动作，后16个线圈（场景）按需触发
+
+3. **性能保证**：
+   - 最大支持10台继电器（每台32路），共320个线圈
+   - 前160个线圈（10台×16路）可用于继电器控制，支持群控
+   - 后160个线圈（10台×16路）可用于场景触发，一般不会全部同时动作
+   - 智能写入队列确保所有操作串行执行，避免总线冲突
+   - 长期稳定运行，反复控制不会造成内存增加、卡顿或死机
+
+4. **技术细节**：
+   - 写入队列间隔：20ms（确保总线稳定）
+   - 轮询恢复时间：20ms（快速响应）
+   - 锁等待超时：100ms（快速检测异常）
+   - 队列自动处理，无需手动干预
 
 ## 核心特性说明
 
@@ -650,6 +738,79 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 配置信息持久化存储在~/.node-red/homekit-persist目录
 - 重启Node-RED后自动恢复配对状态，无需重新配对
 
+### 控制看板节点（客户友好模式）
+
+控制看板节点提供可视化界面，实时显示和控制所有从站的继电器状态，适合现场调试和日常监控。
+
+**配置参数**：
+- **节点名称**：控制看板的显示名称（默认：Modbus控制看板）
+- **主站节点**：选择要监控的Modbus主站节点（必填）
+
+**功能特性**：
+- **实时状态显示**：在配置界面中显示所有从站和线圈的实时状态
+- **一键控制**：点击按钮即可控制继电器开关，无需部署流程
+- **美观布局**：网格布局，按从站分组显示，一目了然
+- **名称同步**：自动同步HomeKit网桥配置的继电器名称
+- **快速响应**：状态实时更新（500ms轮询），响应迅速
+- **零开销**：不参与实际Modbus通信，不影响主站性能
+
+**使用步骤**：
+1. 在Node-RED中添加控制看板节点
+2. 选择已配置的Modbus主站节点
+3. 双击节点打开配置界面，即可看到所有继电器状态
+4. 点击按钮即可控制继电器开关（绿色=ON，红色=OFF）
+5. 部署流程后，节点会显示"监控中"状态
+
+**使用场景**：
+- **现场调试**：快速测试继电器是否正常工作
+- **日常监控**：实时查看所有继电器状态
+- **批量控制**：快速控制多个继电器
+- **客户演示**：美观的界面，适合向客户展示系统功能
+
+**技术细节**：
+- 使用HTTP API与主站通信，通过内部事件发送控制命令
+- 状态缓存机制，减少网络请求
+- 仅在配置界面打开时才轮询状态，关闭后自动停止
+- 与HomeKit网桥共享继电器名称配置，保持一致性
+
+**注意事项**：
+- 确保主站节点已正确配置并运行
+- 控制看板只在配置界面打开时才轮询状态
+- 继电器名称需在HomeKit网桥节点中配置
+- 本节点不参与实际Modbus通信，不会增加主站负担
+
+### 自定义协议节点
+
+用于控制非标准Modbus协议的485设备（如窗帘、特殊开关等）。
+
+**配置步骤**：
+1. 添加自定义协议节点到流程画布
+2. 选择设备类型（开关/窗帘/其他）
+3. 选择串口配置节点
+4. 输入16进制指令（空格分隔，自动格式化为大写）
+   - 打开指令：例如 `01 05 00 00 FF 00 8C 3A`
+   - 关闭指令：例如 `01 05 00 00 00 00 CD CA`
+   - 暂停指令：仅窗帘模式需要，例如 `01 05 00 01 FF 00 DD FA`
+5. 点击"测试"按钮验证指令是否正确发送
+6. 连线：从站开关 → 自定义协议节点
+7. 部署流程
+
+**设备类型说明**：
+- **开关模式**：收到`true`发送打开指令，收到`false`发送关闭指令
+- **窗帘模式**：每次触发循环发送下一个指令（打开 → 暂停 → 关闭 → 暂停 → 打开...）
+- **其他模式**：与开关模式相同
+
+**使用场景**：
+- 窗帘控制：支持打开/暂停/关闭循环控制
+- 特殊开关：非标准Modbus协议的485设备
+- 自定义设备：任何需要发送固定16进制指令的设备
+
+**注意事项**：
+- 每个指令最多48字节
+- 窗帘模式需配置三个指令（打开、关闭、暂停）
+- 测试功能需先选择串口配置
+- 无需连线到debug节点，直接通过串口配置节点发送数据
+
 ## 输出消息格式
 
 ### 主站节点
@@ -708,381 +869,66 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 ]
 ```
 
-## 项目信息
-
-**版本**: v2.6.8
+完整示例请参考项目中的 `examples/basic-flow.json` 文件。
 
-**核心功能**：
-- 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
-- 多设备轮询（最多10台从站，每台32路继电器，轮询间隔100-10000ms可调）
-- 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
-- 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线）
-- 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制）
-- MQTT集成（可选启用，Home Assistant自动发现）
-- 物理开关面板双向同步（支持开关模式和场景模式）
-- 长期稳定运行（内存管理、智能重连、异步处理）
+## 技术栈
 
-**技术要求**：
 - Node.js: >=14.0.0
 - Node-RED: >=2.0.0
+- modbus-serial: ^8.0.23
+- serialport: ^12.0.0
+- mqtt: ^5.14.1（可选）
+- hap-nodejs: ^1.2.0
+- node-persist: ^4.0.4
 
-**最新更新（v2.6.8）**：
-- **🔥 新增HomeKit网桥节点**：
-  - 一键桥接Modbus继电器到Apple HomeKit
-  - 自动同步主站配置的所有从站和继电器
-  - 支持在Node-RED中配置继电器友好名称
-  - 双向同步：HomeKit控制继电器，继电器状态实时同步到HomeKit
-  - 支持Siri语音控制和HomeKit自动化场景
-  - 持久化存储配对信息，重启后自动恢复
-  - 线圈0-15显示为开关，线圈16-31显示为插座（避免误触发）
-
-**v2.6.7更新**：
-- **🔥 修复LED反馈功能**：
-  - 主站轮询检测到状态变化时自动广播事件
-  - 从站开关节点监听状态变化并发送LED反馈到物理面板
-  - 支持开关模式（SET协议）和场景模式（REPORT协议）
-  - LED反馈队列间隔20ms，避免总线拥堵
-- **🔥 TCP连接稳定性优化**：
-  - 禁用TCP超时（永久连接），避免无数据时超时断开
-  - Keep-Alive间隔从30秒优化到10秒
-  - 适应客户长期不在家、总线无数据的场景
-- **日志优化**：
-  - 移除频繁的轮询日志（"轮询持续运行中"、"正在轮询从站X"）
-  - 轮询永久稳定运行，无需频繁确认
-  - 减少日志输出，降低硬盘占用
-
-**v2.6.6更新**：
-- **🔥 彻底解决MQTT日志刷屏问题**：
-  - 局域网IP检测优化：配置192.168.x.x等IP后不再尝试fallback地址
-  - 高频MQTT日志改为debug级别：broker候选、认证、重连等
-  - 默认不输出到日志文件和调试窗口
-  - 配置局域网IP后立即连接，不产生多余日志
-- **日志输出优化**：
-  - 连接成功/失败：仍使用log（重要信息）
-  - 重连尝试、fallback地址、认证信息：改为debug（调试信息）
-  - 仅启用debug模式时才在调试窗口显示
-  - 彻底解决日志刷屏和硬盘占用问题
-
-**v2.6.5更新**：
-- **🔥 修复MQTT报错问题**：从站开关节点新增"启用MQTT"勾选框
-  - 默认不启用MQTT，不会尝试连接
-  - 本地模式和MQTT模式自由切换
-
-**v2.6.4更新**：
-- **🔥 日志优化**：大幅减少日志输出，保证长期稳定运行
-  - 高频操作日志改为debug级别
-  - 默认不输出到日志文件
-  - 完善的内存清理机制
-
-**v2.6.3更新**：
-- **🔥 MQTT可选配置**：完全兼容无MQTT环境
-  - 本地模式：纯串口通信
-  - MQTT模式：可选接入HA
-  - 智能切换和状态显示
-
-**性能优化**：
-- 轮询间隔优化：修复间隔计算逻辑，确保每个从站使用正确的轮询间隔
-- MQTT发布使用QoS=0，避免阻塞轮询
-- 异步发布状态更新，不影响Modbus读取性能
-- 减少调试日志输出，降低CPU占用
-- 互斥锁机制确保读写操作不冲突
-- 共享连接配置节点，避免串口资源冲突
-
-**许可证**: MIT License
-
-**作者**: symi-daguo
-- NPM: https://www.npmjs.com/~symi-daguo
-- GitHub: https://github.com/symi-daguo
-
-**支持**:
-- Issues: https://github.com/symi-daguo/node-red-contrib-symi-modbus/issues
-- NPM: https://www.npmjs.com/package/node-red-contrib-symi-modbus
+## 版本信息
 
-### 节点与分类（Palette）
+**当前版本**: v2.6.9
 
-- 侧边栏分类名：`SYMI-MODBUS`
-- 包含节点：`modbus-master`（主站）、`modbus-slave-switch`（从站开关）、`modbus-debug`（调试）
-- 如果未显示该分类或节点：
-  - 刷新浏览器缓存（Shift+刷新）
-  - 重启 Node-RED（如：`node-red-restart` 或系统服务方式）
-  - 在“节点管理（Manage Palette）”确认安装版本为 `v2.6.6`
+### v2.6.9 (2025-11-10)
 
-### 调试节点（modbus-debug）使用要点
+**重要修复**：
+- 修复LED反馈队列处理逻辑：移除本地队列，直接使用全局队列（serial-port-config统一管理）
+- 确保所有LED反馈按顺序串行发送，间隔20ms（TCP）或10ms（串口）
+- 修复多从站继电器同时变化时的LED反馈遗漏问题
+- 确保双控/多控场景下所有开关面板都能收到完整的状态反馈
 
-- 数据来源选择：`sourceType = serial`（共享串口）或 `modbus`（独立服务器）
-- 共享串口：需要选择并关联一个 `serial-port-config` 配置节点
-- 独立服务器：需要选择并关联一个 `modbus-server-config` 配置节点
-- HEX显示：可选大写、可选时间戳、`maxBytes` 控制显示长度
-- 输出：`msg.payload`（格式化HEX）、`msg.buffer`（原始Buffer）、`msg.meta`（来源信息）
+**队列处理机制**（全局统一队列）：
+- **全局队列**：所有从站开关节点共享同一个全局队列（由serial-port-config管理）
+- **串行发送**：所有LED反馈按加入队列的顺序依次发送，间隔20ms（TCP）或10ms（串口）
+- **完整性保证**：所有LED反馈都能正确发送，不会遗漏
+- **去重机制**：每个节点50ms内不重复发送相同状态，避免总线拥堵
+- **性能优化**：400个按键（50个8键开关）反馈耗时约8秒（20ms×400）
 
-### v2.6.6 重要更新
+**典型场景说明**：
+1. **场景1：单个继电器控制**
+   - 按下开关 → 继电器动作 → LED反馈加入全局队列 → 20ms后发送
 
-- 调试节点配置验证修复：根据所选数据来源类型（`serial`/`modbus`）动态校验，避免误报为“配置不正确”
-- 统一侧边栏分类：所有节点统一归类到 `SYMI-MODBUS`
-- 文档更新：补充节点分类、调试节点要点与常见问题处理
+2. **场景2：批量控制（如17通道全开，16个继电器）**
+   - 触发17通道 → 1-16路继电器全开 → 所有绑定的LED反馈加入全局队列
+   - 假设每个继电器绑定2个开关面板 = 32个LED反馈
+   - 按加入队列的顺序依次发送，耗时约640ms（20ms×32）
 
-典型用法：
-- 联调TCP转RS485网关时，观察上行/下行原始数据帧是否完整。
-- 排查波特率/数据位/校验位配置是否正确（串口模式）。
-- 与 `modbus-master` 或 `modbus-slave-switch` 同时使用，定位现场设备通信异常。
+3. **场景3：快速切换（如17通道全开后立即18通道全关）**
+   - 17通道触发 → 1-16路全开 → 32个LED反馈加入队列
+   - 18通道触发 → 1-16路全关 → 32个LED反馈加入队列
+   - 全局队列按顺序处理，确保所有面板最终显示正确状态
 
-### MQTT自动发现
+4. **场景4：双控开关（1个继电器绑定2个不同ID的开关面板）**
+   - 继电器状态变化 → 2个LED反馈加入全局队列
+   - 按顺序发送，间隔20ms，确保所有面板LED状态同步
 
-启用MQTT后，自动生成Home Assistant兼容的Discovery配置：
-- **唯一性保证**：每个实体使用稳定的`unique_id`，避免重复生成
-- **设备分组**：同一从站的所有继电器自动分组到一个设备下
-- **状态持久化**：使用`retain=true`确保状态持久化
-- **在线状态**：自动发布设备可用性状态
-
-### 配置持久化
+5. **场景5：大规模部署（50个8键开关 = 400个按键）**
+   - 批量控制触发 → 所有LED反馈加入全局队列
+   - 按部署时的节点顺序依次发送，耗时约8秒（20ms×400）
+   - 确保总线稳定，不会冲突或丢失
 
-所有节点配置自动保存到Node-RED的flows文件中：
-- 从站地址、线圈范围、轮询间隔
-- MQTT服务器配置
-- 开关面板映射关系
+## 许可证
 
-部署后配置永久生效，重启Node-RED后自动恢复。
+MIT License
 
-### 长期稳定运行
+## 支持与反馈
 
-针对工控机24/7长期运行优化：
-- **内存管理**：自动清理缓存，释放无用对象
-- **事件监听器清理**：关闭时移除所有监听器，防止内存泄漏
-- **智能日志限流**：错误日志10分钟输出一次，避免日志刷屏
-- **智能重连机制**：
-  - Modbus连接断开自动重连（指数退避：5秒→10秒→20秒...最大60秒）
-  - MQTT连接断开自动重连（支持多地址fallback）
-  - 串口拔插自动检测并重连
-  - TCP网络故障自动恢复
-  - 连接前彻底清理旧实例，避免资源泄漏
-- **互斥锁机制**：防止读写冲突导致的数据异常
-- **TCP永久连接**：
-  - 禁用TCP超时（永久连接），避免无数据时超时断开
-  - Keep-Alive心跳10秒间隔，确保连接活跃
-  - 适应客户长期不在家、总线无数据的场景
-  - 网络故障自动重连，恢复后立即恢复通信
-
-## 技术规格
-
-### Modbus协议
-
-- **协议类型**：Modbus TCP / Modbus RTU
-- **底层库**：modbus-serial ^8.0.23（内部封装serialport，支持TCP和串口）
-- **功能码支持**：0x01（读线圈）、0x05（写单个线圈）、0x0F（写多个线圈）
-- **从站地址范围**：1-247（建议从10开始）
-- **线圈数量**：每台设备32个（0-31）
-- **最大设备数**：10台同时轮询
-- **轮询间隔**：默认200ms（建议300-500ms，支持100-10000ms）
-- **串口配置**：9600 8-N-1（波特率9600，8数据位，无校验，1停止位）
-- **超时设置**：5000ms（TCP和串口通用）
-
-### 兼容性
-
-- **Node.js**: >= 14.0.0
-- **Node-RED**: >= 2.0.0
-- **MQTT Broker**: Mosquitto / EMQX / Any MQTT 3.1.1/5.0
-- **Home Assistant**: 2024.x+（MQTT Discovery标准）
-- **操作系统**: Windows / Linux / macOS / HassOS
-
-## Home Assistant集成
-
-### 自动发现
-
-启用MQTT后，设备自动出现在Home Assistant中：
-- 实体ID: `switch.relay_{从站地址}_{线圈编号}`
-- 设备名称: `Modbus继电器-{从站地址}`
-- 自动分组: 同一从站的所有继电器分组到一个设备
-
-### MQTT主题结构
-
-```
-状态主题: modbus/relay/{从站}/{线圈}/state
-命令主题: modbus/relay/{从站}/{线圈}/set
-可用性主题: modbus/relay/{从站}/availability
-发现主题: homeassistant/switch/modbus_relay_{从站}_{线圈}/config
-```
-
-## 故障排除
-
-### 串口连接失败
-
-**Linux**:
-```bash
-# 查看串口设备
-ls -l /dev/ttyUSB* /dev/ttyS*
-
-# 添加用户到dialout组（需要重新登录）
-sudo usermod -a -G dialout $USER
-```
-
-**macOS**:
-```bash
-# 查看串口设备（注意macOS使用cu.*而不是tty.*）
-ls -l /dev/cu.*
-```
-
-**Docker/HassOS**:
-```yaml
-# 在docker-compose.yml或HassOS插件配置中添加设备映射
-devices:
-  - /dev/ttyUSB0:/dev/ttyUSB0
-```
-
-### MQTT连接失败
-
-1. 确认MQTT broker正在运行：
-   ```bash
-   # Linux
-   sudo systemctl status mosquitto
-   
-   # macOS
-   brew services list | grep mosquitto
-   ```
-
-2. 测试MQTT连接：
-   ```bash
-   mosquitto_sub -h localhost -t test
-   ```
-
-3. 检查Node-RED日志中的MQTT连接信息
-
-### 主站轮询不工作
-
-1. **检查从站配置**：确认已添加所有从站设备（如10、11、12、13）
-2. **检查轮询间隔**：默认200ms，建议300-500ms（多台从站时避免总线拥堵）
-3. **查看Node-RED调试日志**：部署后查看日志中的轮询信息
-4. **检查串口波特率**：确认波特率为9600（与从站设备一致）
-5. **检查从站地址**：确认从站地址正确（1-247）
-6. **确认从站设备在线**：使用Modbus调试工具测试从站是否响应
-7. **检查MQTT连接**：确保MQTT broker地址正确，轮询不依赖MQTT但状态发布需要MQTT
-8. **测试连接**：
-   - TCP连接问题：先用 `modbus-serial` 单独测试TCP连接
-   - 串口问题：先用 `serialport` 单独测试串口通信
-
-### 从站开关无响应
-
-1. 检查RS-485连接是否正常
-2. 确认开关面板地址和按钮编号正确
-3. 检查MQTT连接状态
-4. 查看Node-RED日志中的协议解析信息
-
-## 输入消息格式
-
-### 主站节点
-
-```javascript
-// 启动轮询
-msg.payload = {cmd: "start"};
-
-// 停止轮询
-msg.payload = {cmd: "stop"};
-
-// 写单个线圈
-msg.payload = {
-    cmd: "writeCoil",
-    slave: 10,      // 从站地址
-    coil: 0,        // 线圈编号
-    value: true     // true=开, false=关
-};
-
-// 批量写多个线圈
-msg.payload = {
-    cmd: "writeCoils",
-    slave: 10,      // 从站地址
-    startCoil: 0,   // 起始线圈
-    values: [true, false, true, false]  // 线圈值数组
-};
-```
-
-### 从站开关节点
-
-```javascript
-// 发送开关命令
-msg.payload = true;   // 或 false
-msg.payload = "ON";   // 或 "OFF"
-msg.payload = 1;      // 或 0
-```
-
-## 输出消息格式
-
-### 主站节点
-
-```javascript
-{
-    payload: {
-        slave: 10,                // 从站地址
-        coils: [true, false, ...], // 线圈状态数组
-        timestamp: 1234567890     // 时间戳
-    }
-}
-```
-
-### 从站开关节点
-
-```javascript
-{
-    payload: true,                    // 开关状态
-    topic: "switch_0_btn1",          // 主题
-    switchId: 0,                     // 开关面板ID
-    button: 1,                       // 按钮编号
-    targetSlave: 10,                 // 目标从站地址
-    targetCoil: 0                    // 目标线圈编号
-}
-```
-
-## 性能指标
-
-- **内存占用**：< 50MB（单个主站节点，轮询10个设备）
-- **CPU占用**：< 5%（正常轮询状态）
-- **连接延迟**：Modbus响应 < 100ms，MQTT发布 < 50ms
-- **稳定运行**：经过工控机7x24小时长期运行验证
-- **容错能力**：Modbus从站离线不影响其他从站，MQTT断线自动重连
-
-## 示例Flow
-
-```json
-[
-    {
-        "id": "modbus-master-1",
-        "type": "modbus-master",
-        "name": "主站",
-        "connectionType": "serial",
-        "serialPort": "/dev/ttyUSB0",
-        "serialBaudRate": 9600,
-        "slaves": [
-            {"address": 10, "coilStart": 0, "coilEnd": 31, "pollInterval": 200},
-            {"address": 11, "coilStart": 0, "coilEnd": 31, "pollInterval": 200},
-            {"address": 12, "coilStart": 0, "coilEnd": 31, "pollInterval": 200},
-            {"address": 13, "coilStart": 0, "coilEnd": 31, "pollInterval": 200}
-        ],
-        "enableMqtt": true,
-        "mqttServer": "mqtt-config-1"
-    }
-]
-```
-
-## 项目信息
-
-**版本**: v2.6.8
-
-**核心功能**：
-- 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
-- 多设备轮询（最多10台从站，每台32路继电器，轮询间隔100-10000ms可调）
-- Symi私有协议自动识别（支持两种485开关控制方式）
-- 智能轮询暂停机制（从站上报时自动暂停，处理完成后恢复）
-- 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
-- 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线，支持本地模式和MQTT模式）
-- 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制，名称可自定义）
-- MQTT集成（可选启用，Home Assistant自动发现，实体唯一性保证，QoS=0高性能发布）
-- 物理开关面板双向同步（亖米协议支持，LED反馈同步，支持开关模式和场景模式）
-- 共享连接架构（多个从站开关节点共享同一个串口/TCP连接，支持500+节点）
-- 长期稳定运行（内存管理、智能重连、错误日志限流、异步MQTT发布、TCP永久连接）
-
-**技术栈**：
-- modbus-serial: ^8.0.23（内部封装serialport，支持TCP和串口）
-- serialport: ^12.0.0（原生串口通信）
-- mqtt: ^5.14.1（最新稳定版，可选依赖）
-- hap-nodejs: ^1.2.0（HomeKit桥接）
-- node-persist: ^4.0.4（持久化存储）
-- Node.js: >=14.0.0
-- Node-RED: >=2.0.0
+- GitHub: https://github.com/symi-daguo/node-red-contrib-symi-modbus
+- Issues: https://github.com/symi-daguo/node-red-contrib-symi-modbus/issues
+- NPM: https://www.npmjs.com/package/node-red-contrib-symi-modbus