node-red-contrib-symi-modbus 2.7.0 → 2.7.3

package/README.md

@@ -19,6 +19,8 @@ Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成，
 - **Symi开关集成**：自动识别并处理Symi私有协议按键事件，实现开关面板与继电器的双向同步
 - **HomeKit网桥**：一键桥接到Apple HomeKit，支持Siri语音控制，自动同步主站配置，名称可自定义
 - **智能写入队列**：所有写入操作串行执行，支持HomeKit群控160个继电器同时动作，流畅无卡顿
+- **可视化控制看板**：实时显示和控制所有继电器状态，美观易用，适合现场调试和日常监控
+- **自定义协议转换**：支持非标准485协议设备，窗帘循环控制，配置界面可测试发送
 - **多设备轮询**：支持最多10台Modbus从站设备，每台32路继电器
 - **智能轮询机制**：从站上报时自动暂停轮询，优先处理数据，避免冲突
 - **稳定可靠**：完整的内存管理、错误处理、断线重连，适合7x24小时长期运行
@@ -680,6 +682,107 @@ 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设备，支持开关、窗帘、其他三种设备类型。
+
+**配置参数**：
+- **节点名称**：自定义协议节点的显示名称（默认：自定义协议）
+- **设备类型**：选择设备类型（开关/窗帘/其他）
+- **串口配置**：选择串口配置节点（必填）
+- **打开指令**：16进制打开指令（最多48字节）
+- **关闭指令**：16进制关闭指令（最多48字节）
+- **暂停指令**：16进制暂停指令（仅窗帘模式，最多48字节）
+
+**设备类型说明**：
+- **开关模式**：接收`true`发送打开指令，接收`false`发送关闭指令
+- **窗帘模式**：无论收到`true`还是`false`，都触发下一个指令，循环顺序：打开 → 暂停 → 关闭 → 暂停 → 打开...
+- **其他模式**：与开关模式相同，接收`true/false`发送对应指令
+
+**功能特性**：
+- **16进制配置**：支持空格分隔的16进制码，自动格式化为大写
+- **字节限制**：每个指令最多48字节，超出自动截断
+- **测试功能**：配置界面可直接点击"测试"按钮发送指令到串口总线
+- **持久化保存**：配置自动保存，重启后自动恢复
+- **连线方式**：从站开关 → 自定义协议 → debug节点
+
+**使用示例**：
+1. 在Node-RED中添加自定义协议节点
+2. 选择设备类型（例如：窗帘）
+3. 选择串口配置节点
+4. 输入16进制指令（例如：`01 05 00 00 FF 00 8C 3A`）
+5. 点击"测试"按钮验证指令是否正确
+6. 连线：从站开关 → 自定义协议 → debug节点
+7. 部署流程，触发从站开关即可发送自定义指令
+
+**窗帘模式示例**：
+```
+第1次收到true/false → 发送"打开"指令（例如：01 05 00 00 FF 00 8C 3A）
+第2次收到true/false → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
+第3次收到true/false → 发送"关闭"指令（例如：01 05 00 00 00 00 CD CA）
+第4次收到true/false → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
+第5次收到true/false → 循环回到"打开"指令
+```
+
+**适配两种开关模式**：
+- **有状态开关**（开关模式）：从站开关关联实际线圈，输出`true/false`交替
+- **无状态开关**（场景模式）：从站开关关联虚拟线圈（如线圈32），每次点击只发`true`或`false`
+
+**技术细节**：
+- 输入消息：`msg.payload = true/false`（从从站开关节点接收）
+- 输出消息：`msg.payload = Buffer`（16进制数据，可连线到debug节点）
+- 16进制字符串自动转换为Buffer格式
+- 支持空格、大小写混合输入，自动格式化
+- 窗帘模式内部维护状态索引，自动循环（4个状态：打开→暂停→关闭→暂停）
+
+**注意事项**：
+- 16进制指令最多48字节
+- 窗帘模式需要配置三个指令（打开、关闭、暂停）
+- 测试功能需要先选择串口配置且串口已打开
+- 输出需要连线到debug节点才能发送到串口
+- 非标准协议设备数量不多时推荐使用连线方式
+
 ## 输出消息格式
 
 ### 主站节点
@@ -740,7 +843,7 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 项目信息
 
-**版本**: v2.7.0
+**版本**: v2.7.2
 
 **核心功能**：
 - 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
@@ -749,6 +852,8 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线）
 - 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制）
 - 🔥 **智能写入队列**（所有写入操作串行执行，避免锁竞争，支持HomeKit群控）
+- 🔥 **可视化控制看板**（实时显示和控制所有继电器状态，美观易用）
+- 🔥 **自定义协议转换**（支持非标准485协议设备，窗帘循环控制）
 - MQTT集成（可选启用，Home Assistant自动发现）
 - 物理开关面板双向同步（支持开关模式和场景模式）
 - 长期稳定运行（内存管理、智能重连、异步处理）
@@ -757,98 +862,35 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - Node.js: >=14.0.0
 - Node-RED: >=2.0.0
 
-**最新更新（v2.7.0）**：
-- **🔥 智能写入队列机制**：
-  - 所有写入操作（HomeKit、MQTT、内部事件）统一进入队列串行执行
-  - 彻底解决HomeKit群控时的锁竞争问题，不再出现"写入线圈等待超时"警告
-  - 写入间隔优化到20ms，确保快速响应（10个继电器同时动作仅需200ms）
-  - 队列自动处理，无需手动干预，确保总线稳定性
-  - 支持最多160个继电器（10台从站×16路）同时群控，流畅无卡顿
-- **性能优化**：
-  - 轮询恢复时间从100ms优化到20ms，提升响应速度5倍
-  - 锁等待超时从1000ms降低到100ms，快速检测异常
-  - 内存占用更低，CPU占用更少，适合长期运行
-
-**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
+## 许可证
+
+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）
 
 - 侧边栏分类名：`SYMI-MODBUS`
-- 包含节点：`modbus-master`（主站）、`modbus-slave-switch`（从站开关）、`modbus-debug`（调试）
+- 包含节点：
+  - `modbus-master`（主站）
+  - `modbus-slave-switch`（从站开关）
+  - `modbus-dashboard`（控制看板）
+  - `homekit-bridge`（HomeKit网桥）
+  - `custom-protocol`（自定义协议）
+  - `modbus-debug`（调试）
 - 如果未显示该分类或节点：
   - 刷新浏览器缓存（Shift+刷新）
   - 重启 Node-RED（如：`node-red-restart` 或系统服务方式）
-  - 在“节点管理（Manage Palette）”确认安装版本为 `v2.6.6`
+  - 在“节点管理（Manage Palette）”确认安装版本为最新版
 
 ### 调试节点（modbus-debug）使用要点
 
@@ -858,16 +900,6 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - HEX显示：可选大写、可选时间戳、`maxBytes` 控制显示长度
 - 输出：`msg.payload`（格式化HEX）、`msg.buffer`（原始Buffer）、`msg.meta`（来源信息）
 
-### v2.6.6 重要更新
-
-- 调试节点配置验证修复：根据所选数据来源类型（`serial`/`modbus`）动态校验，避免误报为“配置不正确”
-- 统一侧边栏分类：所有节点统一归类到 `SYMI-MODBUS`
-- 文档更新：补充节点分类、调试节点要点与常见问题处理
-
-典型用法：
-- 联调TCP转RS485网关时，观察上行/下行原始数据帧是否完整。
-- 排查波特率/数据位/校验位配置是否正确（串口模式）。
-- 与 `modbus-master` 或 `modbus-slave-switch` 同时使用，定位现场设备通信异常。
 
 ### MQTT自动发现
 
@@ -1106,27 +1138,26 @@ msg.payload = 1;      // 或 0
 
 ## 项目信息
 
-**版本**: v2.7.0
+**当前版本**: v2.7.3
 
-**核心功能**：
-- 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
-- 多设备轮询（最多10台从站，每台32路继电器，轮询间隔100-10000ms可调）
-- Symi私有协议自动识别（支持两种485开关控制方式）
-- 智能轮询暂停机制（从站上报时自动暂停，处理完成后恢复）
-- 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
-- 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线，支持本地模式和MQTT模式）
-- 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制，名称可自定义）
-- 🔥 **智能写入队列**（所有写入操作串行执行，避免锁竞争，支持HomeKit群控）
-- MQTT集成（可选启用，Home Assistant自动发现，实体唯一性保证，QoS=0高性能发布）
-- 物理开关面板双向同步（亖米协议支持，LED反馈同步，支持开关模式和场景模式）
-- 共享连接架构（多个从站开关节点共享同一个串口/TCP连接，支持500+节点）
-- 长期稳定运行（内存管理、智能重连、错误日志限流、异步MQTT发布、TCP永久连接）
+**最新更新**（v2.7.3）：
+- 优化窗帘控制逻辑：打开 → 暂停 → 关闭 → 暂停 → 打开（循环），更符合实际使用场景
+- 优化MQTT断网日志：长期断网时减少日志输出，避免垃圾日志影响性能和硬盘空间
+- 重试间隔优化：从5秒改为30秒，减少重试频率，降低系统负担
+- 日志级别优化：MQTT错误从error改为debug，不写入日志文件
 
 **技术栈**：
-- 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
+- modbus-serial: ^8.0.23
+- serialport: ^12.0.0
+- mqtt: ^5.14.1（可选）
+- hap-nodejs: ^1.2.0
+- node-persist: ^4.0.4
+
+**历史版本**：
+- v2.7.2: 新增自定义协议节点，支持非标准485协议设备
+- v2.7.1: 新增可视化控制看板节点
+- v2.7.0: 智能写入队列机制，支持HomeKit群控
+- v2.6.8: 新增HomeKit网桥节点
+- v2.6.7及更早: 基础功能实现

package/nodes/custom-protocol.html

@@ -0,0 +1,276 @@
+<script type="text/javascript">
+    RED.nodes.registerType('custom-protocol', {
+        category: 'SYMI-MODBUS',
+        color: '#FF9800',
+        defaults: {
+            name: {value: "自定义协议"},
+            deviceType: {value: "switch", required: true},
+            serialConfig: {value: "", type: "serial-port-config", required: true},
+            openCmd: {value: ""},
+            closeCmd: {value: ""},
+            pauseCmd: {value: ""}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-code",
+        label: function() {
+            var typeNames = {
+                'switch': '开关',
+                'curtain': '窗帘',
+                'other': '其他'
+            };
+            var typeName = typeNames[this.deviceType] || '自定义';
+            return this.name || (typeName + "协议");
+        },
+        oneditprepare: function() {
+            var node = this;
+
+            // 设备类型切换
+            $("#node-input-deviceType").on("change", function() {
+                var deviceType = $(this).val();
+                if (deviceType === "curtain") {
+                    $("#pause-cmd-row").show();
+                } else {
+                    $("#pause-cmd-row").hide();
+                }
+            });
+
+            // 初始化显示
+            if (node.deviceType === "curtain") {
+                $("#pause-cmd-row").show();
+            } else {
+                $("#pause-cmd-row").hide();
+            }
+
+            // 16进制输入验证和格式化
+            function validateHexInput(input) {
+                var value = $(input).val().trim();
+                // 移除所有非16进制字符
+                value = value.replace(/[^0-9A-Fa-f\s]/g, '');
+                // 自动添加空格分隔
+                value = value.replace(/\s+/g, '').match(/.{1,2}/g);
+                if (value) {
+                    value = value.join(' ').toUpperCase();
+                    // 限制48字节
+                    var bytes = value.split(' ');
+                    if (bytes.length > 48) {
+                        bytes = bytes.slice(0, 48);
+                        value = bytes.join(' ');
+                        RED.notify('指令长度已限制为48字节', 'warning');
+                    }
+                } else {
+                    value = '';
+                }
+                $(input).val(value);
+                return value;
+            }
+
+            // 绑定输入验证
+            $("#node-input-openCmd, #node-input-closeCmd, #node-input-pauseCmd").on("blur", function() {
+                validateHexInput(this);
+            });
+
+            // 测试按钮功能
+            function sendTestCommand(hexString, cmdName) {
+                if (!hexString || hexString.trim() === '') {
+                    RED.notify('请先输入16进制指令', 'warning');
+                    return;
+                }
+
+                var serialConfig = $("#node-input-serialConfig").val();
+                if (!serialConfig) {
+                    RED.notify('请先选择串口配置', 'warning');
+                    return;
+                }
+
+                // 发送测试命令
+                $.ajax({
+                    url: '/custom-protocol/test',
+                    method: 'POST',
+                    contentType: 'application/json',
+                    data: JSON.stringify({
+                        serialConfig: serialConfig,
+                        hexString: hexString,
+                        cmdName: cmdName
+                    }),
+                    success: function(result) {
+                        if (result.success) {
+                            RED.notify('✓ ' + cmdName + '指令已发送: ' + hexString, 'success');
+                        } else {
+                            RED.notify('✗ 发送失败: ' + result.error, 'error');
+                        }
+                    },
+                    error: function(err) {
+                        RED.notify('✗ 发送失败: ' + err.statusText, 'error');
+                    }
+                });
+            }
+
+            // 绑定测试按钮
+            $("#btn-test-open").on("click", function() {
+                var hexString = validateHexInput("#node-input-openCmd");
+                sendTestCommand(hexString, '打开');
+            });
+
+            $("#btn-test-close").on("click", function() {
+                var hexString = validateHexInput("#node-input-closeCmd");
+                sendTestCommand(hexString, '关闭');
+            });
+
+            $("#btn-test-pause").on("click", function() {
+                var hexString = validateHexInput("#node-input-pauseCmd");
+                sendTestCommand(hexString, '暂停');
+            });
+        },
+        oneditsave: function() {
+            // 保存前验证和格式化
+            validateHexInput("#node-input-openCmd");
+            validateHexInput("#node-input-closeCmd");
+            if (this.deviceType === "curtain") {
+                validateHexInput("#node-input-pauseCmd");
+            }
+        }
+    });
+
+    // 辅助函数
+    function validateHexInput(selector) {
+        var input = $(selector);
+        var value = input.val().trim();
+        value = value.replace(/[^0-9A-Fa-f\s]/g, '');
+        value = value.replace(/\s+/g, '').match(/.{1,2}/g);
+        if (value) {
+            value = value.join(' ').toUpperCase();
+            var bytes = value.split(' ');
+            if (bytes.length > 48) {
+                bytes = bytes.slice(0, 48);
+                value = bytes.join(' ');
+            }
+        } else {
+            value = '';
+        }
+        input.val(value);
+        return value;
+    }
+</script>
+
+<script type="text/html" data-template-name="custom-protocol">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 节点名称</label>
+        <input type="text" id="node-input-name" placeholder="自定义协议">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-deviceType"><i class="fa fa-cog"></i> 设备类型</label>
+        <select id="node-input-deviceType" style="width: 70%;">
+            <option value="switch">开关（打开/关闭）</option>
+            <option value="curtain">窗帘（打开/关闭/暂停循环）</option>
+            <option value="other">其他（打开/关闭）</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-serialConfig"><i class="fa fa-plug"></i> 串口配置</label>
+        <input type="text" id="node-input-serialConfig" style="width: 70%;">
+    </div>
+
+    <div class="form-row">
+        <label style="width: 100%; font-weight: bold; margin-top: 15px; margin-bottom: 10px;">
+            <i class="fa fa-code"></i> 16进制指令配置（最多48字节）
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-openCmd"><i class="fa fa-arrow-up"></i> 打开指令</label>
+        <input type="text" id="node-input-openCmd" placeholder="例如: 01 05 00 00 FF 00 8C 3A" style="width: 50%;">
+        <button type="button" id="btn-test-open" class="red-ui-button" style="margin-left: 5px;">
+            <i class="fa fa-play"></i> 测试
+        </button>
+        <div style="font-size: 11px; color: #999; margin-top: 5px; margin-left: 105px;">
+            输入16进制码，空格分隔，自动格式化
+        </div>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-closeCmd"><i class="fa fa-arrow-down"></i> 关闭指令</label>
+        <input type="text" id="node-input-closeCmd" placeholder="例如: 01 05 00 00 00 00 CD CA" style="width: 50%;">
+        <button type="button" id="btn-test-close" class="red-ui-button" style="margin-left: 5px;">
+            <i class="fa fa-play"></i> 测试
+        </button>
+    </div>
+
+    <div class="form-row" id="pause-cmd-row" style="display: none;">
+        <label for="node-input-pauseCmd"><i class="fa fa-pause"></i> 暂停指令</label>
+        <input type="text" id="node-input-pauseCmd" placeholder="例如: 01 05 00 01 FF 00 DD FA" style="width: 50%;">
+        <button type="button" id="btn-test-pause" class="red-ui-button" style="margin-left: 5px;">
+            <i class="fa fa-play"></i> 测试
+        </button>
+        <div style="font-size: 11px; color: #999; margin-top: 5px; margin-left: 105px;">
+            仅窗帘模式需要配置
+        </div>
+    </div>
+
+    <div class="form-row" style="margin-top: 20px;">
+        <div style="padding: 10px; background: #f0f8ff; border-left: 4px solid #2196F3; border-radius: 4px;">
+            <strong>使用说明：</strong><br>
+            <ul style="margin: 5px 0; padding-left: 20px; font-size: 12px;">
+                <li><strong>开关/其他模式</strong>: true发送打开指令，false发送关闭指令</li>
+                <li><strong>窗帘模式</strong>: true/false交替触发，循环发送打开→关闭→暂停→打开...</li>
+                <li>16进制码自动格式化为大写，空格分隔</li>
+                <li>点击"测试"按钮可直接发送到串口总线验证</li>
+                <li>配置自动持久化保存</li>
+            </ul>
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="custom-protocol">
+    <p>自定义协议节点，用于控制非标准Modbus协议的485设备。</p>
+    
+    <h3>功能特性</h3>
+    <ul>
+        <li>支持三种设备类型：开关、窗帘、其他</li>
+        <li>窗帘模式支持打开/关闭/暂停循环控制</li>
+        <li>16进制指令配置，最多48字节</li>
+        <li>配置界面可直接测试发送指令</li>
+        <li>配置持久化保存</li>
+    </ul>
+    
+    <h3>设备类型说明</h3>
+    <dl>
+        <dt>开关模式</dt>
+        <dd>接收true发送打开指令，接收false发送关闭指令</dd>
+        
+        <dt>窗帘模式</dt>
+        <dd>true/false交替触发，循环发送：打开→关闭→暂停→打开...</dd>
+        
+        <dt>其他模式</dt>
+        <dd>与开关模式相同，接收true/false发送对应指令</dd>
+    </dl>
+    
+    <h3>输入消息</h3>
+    <p>从从站开关节点接收：</p>
+    <pre>msg.payload = true/false</pre>
+    
+    <h3>输出消息</h3>
+    <p>输出Buffer格式的16进制数据，可连线到debug节点发送到串口：</p>
+    <pre>msg.payload = Buffer</pre>
+    
+    <h3>使用示例</h3>
+    <ol>
+        <li>配置串口节点</li>
+        <li>选择设备类型（开关/窗帘/其他）</li>
+        <li>输入16进制指令（空格分隔）</li>
+        <li>点击"测试"按钮验证指令是否正确</li>
+        <li>连线：从站开关 → 自定义协议 → debug节点</li>
+        <li>部署流程，触发从站开关即可发送自定义指令</li>
+    </ol>
+    
+    <h3>注意事项</h3>
+    <ul>
+        <li>16进制指令最多48字节</li>
+        <li>窗帘模式需要配置三个指令（打开、关闭、暂停）</li>
+        <li>测试功能需要先选择串口配置</li>
+        <li>输出需要连线到debug节点才能发送到串口</li>
+    </ul>
+</script>
+