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

package/README.md

@@ -18,6 +18,9 @@ Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成，
   - Telnet ASCII（推荐用于TCP转RS485网关）
 - **Symi开关集成**：自动识别并处理Symi私有协议按键事件，实现开关面板与继电器的双向同步
 - **HomeKit网桥**：一键桥接到Apple HomeKit，支持Siri语音控制，自动同步主站配置，名称可自定义
+- **智能写入队列**：所有写入操作串行执行，支持HomeKit群控160个继电器同时动作，流畅无卡顿
+- **可视化控制看板**：实时显示和控制所有继电器状态，美观易用，适合现场调试和日常监控
+- **自定义协议转换**：支持非标准485协议设备，窗帘循环控制，配置界面可测试发送
 - **多设备轮询**：支持最多10台Modbus从站设备，每台32路继电器
 - **智能轮询机制**：从站上报时自动暂停轮询，优先处理数据，避免冲突
 - **稳定可靠**：完整的内存管理、错误处理、断线重连，适合7x24小时长期运行
@@ -183,6 +186,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 +682,102 @@ 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  → 发送"打开"指令（例如：01 05 00 00 FF 00 8C 3A）
+第2次收到false → 发送"关闭"指令（例如：01 05 00 00 00 00 CD CA）
+第3次收到true  → 发送"暂停"指令（例如：01 05 00 01 FF 00 DD FA）
+第4次收到false → 循环回到"打开"指令
+```
+
+**技术细节**：
+- 输入消息：`msg.payload = true/false`（从从站开关节点接收）
+- 输出消息：`msg.payload = Buffer`（16进制数据，可连线到debug节点）
+- 16进制字符串自动转换为Buffer格式
+- 支持空格、大小写混合输入，自动格式化
+- 窗帘模式内部维护状态索引，自动循环
+
+**注意事项**：
+- 16进制指令最多48字节
+- 窗帘模式需要配置三个指令（打开、关闭、暂停）
+- 测试功能需要先选择串口配置且串口已打开
+- 输出需要连线到debug节点才能发送到串口
+- 非标准协议设备数量不多时推荐使用连线方式
+
 ## 输出消息格式
 
 ### 主站节点
@@ -710,7 +838,7 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 
 ## 项目信息
 
-**版本**: v2.6.8
+**版本**: v2.7.2
 
 **核心功能**：
 - 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
@@ -718,6 +846,9 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
 - 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线）
 - 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制）
+- 🔥 **智能写入队列**（所有写入操作串行执行，避免锁竞争，支持HomeKit群控）
+- 🔥 **可视化控制看板**（实时显示和控制所有继电器状态，美观易用）
+- 🔥 **自定义协议转换**（支持非标准485协议设备，窗帘循环控制）
 - MQTT集成（可选启用，Home Assistant自动发现）
 - 物理开关面板双向同步（支持开关模式和场景模式）
 - 长期稳定运行（内存管理、智能重连、异步处理）
@@ -726,59 +857,25 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - Node.js: >=14.0.0
 - Node-RED: >=2.0.0
 
-**最新更新（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
-  - 智能切换和状态显示
+**最新更新（v2.7.2）**：
+- **🔥 新增自定义协议节点**：
+  - 支持控制非标准Modbus协议的485设备
+  - 三种设备类型：开关（打开/关闭）、窗帘（打开/关闭/暂停循环）、其他（打开/关闭）
+  - 窗帘模式：true/false交替触发，循环发送打开→关闭→暂停→打开...
+  - 16进制指令配置，最多48字节，自动格式化
+  - 配置界面可直接测试发送指令到串口总线
+  - 配置持久化保存，重启后自动恢复
+  - 连线方式：从站开关 → 自定义协议 → debug节点
+
+**历史更新**：
+- **v2.7.1**：新增可视化控制看板节点，实时显示和控制所有继电器状态
+- **v2.7.0**：智能写入队列机制，解决HomeKit群控锁竞争问题，支持160个继电器同时群控
+- **v2.6.8**：新增HomeKit网桥节点，一键桥接到Apple HomeKit，支持Siri语音控制
+- **v2.6.7**：修复LED反馈功能，TCP连接稳定性优化，日志优化
+- **v2.6.6**：解决MQTT日志刷屏问题，局域网IP检测优化
+- **v2.6.5**：修复MQTT报错问题，新增"启用MQTT"勾选框
+- **v2.6.4**：日志优化，大幅减少日志输出
+- **v2.6.3**：MQTT可选配置，完全兼容无MQTT环境
 
 **性能优化**：
 - 轮询间隔优化：修复间隔计算逻辑，确保每个从站使用正确的轮询间隔
@@ -787,6 +884,7 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 - 减少调试日志输出，降低CPU占用
 - 互斥锁机制确保读写操作不冲突
 - 共享连接配置节点，避免串口资源冲突
+- 写入队列20ms间隔，快速响应，总线稳定
 
 **许可证**: MIT License
 
@@ -801,11 +899,17 @@ HomeKit网桥节点无需输入消息，自动同步主站配置和状态。
 ### 节点与分类（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）使用要点
 
@@ -1063,7 +1167,7 @@ msg.payload = 1;      // 或 0
 
 ## 项目信息
 
-**版本**: v2.6.8
+**版本**: v2.7.2
 
 **核心功能**：
 - 支持多种Modbus协议（Telnet ASCII、RTU over TCP、Modbus TCP、Modbus RTU串口）
@@ -1073,6 +1177,9 @@ msg.payload = 1;      // 或 0
 - 🔥 **双模式支持**（本地模式和MQTT模式可选切换，断网也能稳定运行）
 - 🔥 **免连线通信**（主站和从站通过内部事件通信，无需连线，支持本地模式和MQTT模式）
 - 🔥 **HomeKit网桥**（一键桥接到Apple HomeKit，支持Siri语音控制，名称可自定义）
+- 🔥 **智能写入队列**（所有写入操作串行执行，避免锁竞争，支持HomeKit群控）
+- 🔥 **可视化控制看板**（实时显示和控制所有继电器状态，美观易用，客户友好）
+- 🔥 **自定义协议转换**（支持非标准485协议设备，窗帘循环控制，配置界面可测试）
 - MQTT集成（可选启用，Home Assistant自动发现，实体唯一性保证，QoS=0高性能发布）
 - 物理开关面板双向同步（亖米协议支持，LED反馈同步，支持开关模式和场景模式）
 - 共享连接架构（多个从站开关节点共享同一个串口/TCP连接，支持500+节点）

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>
+