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

package/README.md

@@ -15,6 +15,7 @@
 - **多设备类型**：支持开关、灯光、窗帘、温控器、传感器等12+种设备
 - **三合一面板**：完整支持空调+新风+地暖三合一控制面板
 - **KNX集成**：支持与KNX系统双向同步
+- **云端同步**：从酒店云云平台自动获取设备名称和场景信息
 - **稳定可靠**：完善的错误处理和自动重连机制
 
 ## 快速开始
@@ -48,22 +49,31 @@ node-red-restart
 
 添加"Symi Gateway"配置节点：
 
-**TCP模式**（推荐）:
-- 主机地址: 网关IP（如 192.168.2.110）
-- 端口: 4196（默认）
+**网关连接配置**:
+- **连接方式**: TCP/IP 或 串口
+- **TCP模式**（推荐）:
+  - 主机地址: 网关IP（如 192.168.2.110）
+  - 端口: 4196（默认）
+- **串口模式**:
+  - 串口路径: /dev/ttyUSB0
+  - 波特率: 115200
 
-**串口模式**:
-- 串口路径: /dev/ttyUSB0
-- 波特率: 115200
+**MQTT配置**（用于Home Assistant集成）:
+- **MQTT地址**: mqtt://localhost:1883（默认，可修改）
+- **用户名**: MQTT认证用户名（可选）
+- **密码**: MQTT认证密码（可选）
+- **HA前缀**: homeassistant（默认，可修改）
 
-### 3. 配置MQTT节点
+> **提示**: MQTT配置已集成到网关节点中，所有使用该网关的MQTT节点会自动使用这些配置。
 
-添加"Symi MQTT"节点：
+### 3. 添加MQTT桥接节点
+
+添加"Symi MQTT"节点到流程中：
 
 - **网关**: 选择已配置的网关节点
-- **MQTT Broker**: mqtt://localhost:1883
-- **用户名/密码**: MQTT认证信息（可选）
-- **Discovery前缀**: homeassistant（默认）
+- **名称**: 可选，用于标识节点
+
+> **注意**: MQTT连接参数从网关节点获取，无需重复配置。
 
 ### 4. 部署并验证
 
@@ -146,6 +156,8 @@ node-red-restart
 | 0x92 | 设备列表响应 | 网关→主机 | 返回设备信息 |
 | 0x30 | 设备控制 | 主机→网关 | 控制指定设备 |
 | 0xB0 | 控制响应 | 网关→主机 | 控制结果 |
+| 0x34 | 场景控制 | 主机→网关 | 执行场景（群控） |
+| 0xB4 | 场景控制响应 | 网关→主机 | 场景控制结果 |
 | 0x80 | 状态事件 | 网关→主机 | 设备状态主动上报 |
 | 0x32 | 状态查询 | 主机→网关 | 查询设备状态 |
 
@@ -177,6 +189,7 @@ node-red-restart
 | 目标温度 | 0x1B | 2字节LE | 16-30°C, *100 |
 | 风速 | 0x1C | 1字节 | 1=高/2=中/3=低/4=自动 |
 | 模式 | 0x1D | 1字节 | 1=制冷/2=制热/3=送风/4=除湿 |
+| 6键开关状态 | 0x45 | 2字节LE | 场景执行后状态上报 |
 
 ## MQTT主题结构
 
@@ -395,6 +408,209 @@ return {
 4. **双向同步**：避免循环控制，使用`outputRBE: true`防抖
 5. **测试验证**：先测试单向同步，确认正常后再启用双向
 
+## 云端数据同步
+
+本节点支持从酒店云云平台自动获取设备名称和场景信息，实现本地化配置的自动同步。
+
+### 使用场景
+
+- **酒店项目**：自动同步房间设备的本地化名称（如"客厅窗帘"、"床头灯"等）
+- **场景管理**：获取云端配置的场景列表（如"全关"、"睡眠模式"等）并本地化调用
+- **批量部署**：统一管理多个房间的设备名称，无需手动配置
+
+### 配置步骤
+
+#### 1. 添加云端同步节点
+
+在Node-RED中添加"Symi Cloud Sync"节点：
+
+**基础配置**：
+- **网关**：选择已配置的Symi Gateway节点
+- **MQTT节点**：选择Symi MQTT节点（用于更新Discovery配置）
+
+**云端认证**：
+- **App ID**：`cee70459`（默认已填写）
+- **App Secret**：`a719a4b58e2e57e50d758ee3762507e7`（默认已填写）
+- 点击"测试连接"按钮验证认证信息
+
+**房间配置**：
+- **酒店ID**：输入酒店ID或点击"加载酒店列表"自动获取
+- **房间号**：输入房间号（如：1001）
+- **房间UUID**：可选，如果有UUID可直接填写
+
+**同步选项**：
+- **自动同步**：勾选后，启动时自动从云端获取数据（推荐）
+
+#### 2. 部署并验证
+
+1. 点击右上角"部署"按钮
+2. 检查调试面板确认同步状态：
+   - `开始从云端获取数据` - 开始同步
+   - `云端数据获取成功: X个设备, Y个场景` - 同步成功
+   - `设备名称已更新: 旧名称 -> 新名称` - 名称更新
+   - `重新发布MQTT Discovery配置` - 更新HA配置
+3. 在Home Assistant中查看设备名称是否已更新
+
+#### 3. 手动触发同步
+
+如需手动触发同步，可以使用inject节点：
+
+```
+[inject] --> [cloud-sync]
+payload: "sync"
+```
+
+#### 4. 调用场景
+
+云端同步后，可以通过inject节点调用场景：
+
+```
+[inject] --> [cloud-sync]
+payload: { scene_id: 4 }  // 执行场景ID为4的场景（如"全关"）
+```
+
+### 工作原理
+
+#### 数据获取流程
+
+```
+启动/部署
+  ↓
+调用云端API（房间信息接口）
+  ↓
+解析设备列表和场景列表
+  ↓
+根据MAC地址匹配本地设备
+  ↓
+更新设备名称（device.name）
+  ↓
+保存场景列表到本地
+  ↓
+重新发布MQTT Discovery配置
+  ↓
+持久化存储（缓存）
+  ↓
+完成（不再调用）
+```
+
+#### MAC地址匹配规则
+
+云端返回的设备MAC地址会自动反转后与本地设备MAC地址匹配：
+
+```javascript
+// 云端设备（MAC地址为反序存储）
+{
+  "device_name": "窗帘",
+  "nick_name": "客厅窗帘",
+  "mac": "14d881c086d4",  // 云端反序存储
+  "naddr": 256
+}
+
+// 本地设备匹配
+1. 将云端MAC转换为小写并去除分隔符: "14d881c086d4"
+2. 反转MAC地址（每2位反转）: "d486c081d814"
+3. 与本地设备MAC进行精确匹配
+4. 匹配成功后更新 device.name = "客厅窗帘"
+5. 如果云端名称为"未命名"或空，则保留设备类型标准名称（如"智能窗帘"）
+6. 重新发布MQTT Discovery（使用新名称）
+```
+
+#### 场景本地化调用
+
+云端场景信息会保存到本地，可以通过网关直接调用：
+
+```javascript
+// 云端场景
+{
+  "scene_name": "全关",
+  "scene_id": 4
+}
+
+// 本地调用
+通过inject节点发送: { scene_id: 4 }
+节点会查找场景名称并输出到下游节点
+可以连接到其他节点进行进一步处理
+```
+
+### 数据持久化
+
+云端同步节点会将获取的数据持久化存储到Node-RED的context中：
+
+- **存储内容**：设备列表、场景列表、最后同步时间
+- **存储位置**：节点的context存储（重启后保留）
+- **使用场景**：
+  - 云端API调用失败时，自动使用缓存数据
+  - 禁用自动同步后，仍可使用上次获取的数据
+  - 网络故障时，不影响已同步的设备名称
+
+### 常见问题
+
+#### Q: 云端同步会影响性能吗？
+
+A: 不会。云端同步仅在启动/部署时执行一次，不会持续轮询。同步完成后，节点处于空闲状态，不占用资源。
+
+#### Q: 如果云端API调用失败怎么办？
+
+A: 节点会自动使用上次成功获取的缓存数据。如果从未成功获取过，设备将保持原有名称。
+
+#### Q: 可以禁用云端同步节点吗？
+
+A: 可以。禁用节点不会影响其他功能（网关、MQTT、设备控制）的正常运行。已同步的设备名称会保留。
+
+#### Q: 云端名称和本地设备如何匹配？
+
+A: 通过MAC地址精确匹配。云端返回的设备MAC地址会自动反转后与本地设备MAC匹配（因为云端存储为反序）。如果云端名称为"未命名"或空，则自动保留设备类型标准名称（如"智能窗帘"、"零火开关"等）。
+
+#### Q: 场景如何调用？
+
+A: 云端同步后，场景会自动发布为Home Assistant按钮实体。在HA中点击场景按钮即可触发本地场景执行（使用0x34协议，不经过云端）。场景执行后，所有相关设备的状态会自动同步到HA，确保状态一致性。也可以通过inject节点发送 `{ scene_id: X }` 来调用场景。
+
+#### Q: 设备列表中的勾选框是做什么用的？
+
+A: 勾选的设备会同步云端名称到本地，未勾选的设备保持原有名称不变。如果不勾选任何设备，则默认同步所有设备。场景勾选同理，勾选的场景会发布到Home Assistant。支持一键全选功能。
+
+#### Q: 开关设备的按键名称如何显示？
+
+A: 对于多键开关（1-6键），云端同步节点会显示每个按键的名称（如"床头灯"、"睡眠"等），这些名称来自云端的sub_device配置，并会同步到MQTT实体名称中。
+
+#### Q: MQTT配置在哪里？
+
+A: MQTT配置统一在**网关节点**中配置。所有使用该网关的节点（包括云端同步节点）都会自动使用网关中配置的MQTT客户端，无需重复配置。
+
+#### Q: HA中的实体名称格式是什么？
+
+A: HA实体名称为纯名称，不带MAC地址和ID。例如"客厅灯 床头灯"而不是"客厅灯_14d881c086d4_1"。MAC地址仅用作unique_id确保实体唯一性。
+
+#### Q: 多个房间如何管理？
+
+A: 每个房间部署一个云端同步节点，配置对应的酒店ID和房间号即可。
+
+### 故障排除
+
+**症状**: 云端同步失败
+
+**解决方法**:
+1. 检查App ID和App Secret是否正确
+2. 点击"测试连接"按钮验证认证信息
+3. 检查网络连接是否正常
+4. 查看调试日志中的详细错误信息
+
+**症状**: 设备名称未更新
+
+**解决方法**:
+1. 检查云端设备MAC地址是否与本地设备一致
+2. 查看调试日志中的"设备匹配完成"信息
+3. 确认MQTT节点已正确配置
+4. 手动触发同步（发送 `msg.payload = "sync"`）
+
+**症状**: 场景无法调用
+
+**解决方法**:
+1. 检查云端是否返回了场景列表
+2. 查看调试日志中的"场景列表已保存"信息
+3. 确认场景ID是否正确
+4. 检查网关连接是否正常
+
 ## 故障排除
 
 ### 网关连接失败
@@ -457,6 +673,7 @@ return {
 配置节点，管理与Symi蓝牙Mesh网关的连接。
 
 **配置项**：
+- MQTT配置：选择MQTT配置节点（用于Home Assistant Discovery）
 - 连接类型：TCP或串口
 - TCP模式：IP地址和端口（默认4196）
 - 串口模式：串口路径和波特率（默认115200）
@@ -494,6 +711,51 @@ return {
 - 发送控制命令
 - 支持KNX双向同步
 
+### Symi Cloud Sync（云端同步节点）
+
+从酒店云云平台同步设备名称和场景信息到本地。
+
+**配置项**：
+- 网关：选择已配置的网关节点（自动使用网关中配置的MQTT）
+- App ID / App Secret：云端API认证信息（已预填）
+- 酒店ID / 房间号：指定要同步的房间（支持下拉选择或手动输入）
+- 设备列表：显示云端设备列表（含按键名称），支持一键全选
+- 场景列表：显示云端场景列表，支持一键全选
+- 自动同步：启动时自动从云端获取数据
+
+**功能**：
+- 启动时自动从云端获取设备名称和场景列表
+- 根据MAC地址精确匹配本地设备并更新名称（云端MAC地址自动反转匹配）
+- 支持开关设备的按键名称同步（1-6键的sub_device名称）
+- 云端"未命名"设备自动保留设备类型标准名称（如"智能窗帘"、"零火开关"等）
+- 酒店和房间选择自动持久化保存，重新打开配置无需重新选择
+- 自动重新发布MQTT Discovery配置（使用云端名称）
+- HA实体名称为纯名称，不带MAC地址和ID
+- 将选中的场景发布为Home Assistant按钮实体
+- 在HA中点击场景按钮即可触发本地场景执行（使用0x31协议）
+- 场景触发通过事件机制路由，确保可靠执行
+- 数据持久化存储，获取失败时使用缓存
+- 支持手动触发同步（发送 `msg.payload = "sync"`）
+- 支持场景调用（发送 `msg.payload = { scene_id: 4 }`）
+
+**使用场景**：
+- 酒店项目：自动同步房间设备的本地化名称
+- 场景管理：将云端场景发布到Home Assistant进行控制
+- 批量部署：统一管理多个房间的设备名称和场景
+
+**注意事项**：
+- 仅在启动/部署时获取一次，不会持续轮询
+- 云端MAC地址自动反转匹配本地设备（云端存储为反序）
+- 云端"未命名"设备自动保留设备类型标准名称
+- 酒店和房间选择自动持久化保存，重新打开配置无需重新选择
+- 勾选的设备和场景才会同步，未勾选则同步全部（支持一键全选）
+- 场景按钮发布到HA后，点击即可触发本地场景执行（0x34协议）
+- 场景执行是本地化控制，不经过云端
+- 场景执行后，所有相关设备状态自动同步到HA（队列处理，确保可靠）
+- 按键名称会同步到MQTT实体名称，MAC地址仍作为唯一ID
+- 获取失败时自动使用上次缓存的数据
+- 可以禁用节点，不影响其他功能正常运行
+
 ## 开发者信息
 
 ### 项目结构
@@ -563,15 +825,48 @@ node-red-contrib-symi-mesh/
 
 ## 更新日志
 
-### v1.2.3 (2025-10-28)
-- 修复三合一设备新风方向状态同步问题
-- 优化日志输出，提升系统性能
-- 完善Home Assistant MQTT Discovery兼容性
-
-### v1.2.0 (2025-10-27)
-- 完整支持三合一设备（空调+新风+地暖）
-- 新增MQTT Discovery自动发现功能
-- 优化设备识别和状态同步机制
+### 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服务器离线时的错误处理
 
 
 ## 许可证
@@ -585,8 +880,8 @@ Copyright (c) 2025 SYMI 亖米
 ## 关于
 
 **作者**: SYMI 亖米
-**版本**: 1.2.3
+**版本**: 1.3.1
 **协议**: 蓝牙MESH网关（初级版）串口协议V1.0
-**最后更新**: 2025-10-28
+**最后更新**: 2025-11-07
 **仓库**: https://github.com/symi-daguo/node-red-contrib-symi-mesh
 **npm包**: https://www.npmjs.com/package/node-red-contrib-symi-mesh

package/lib/cloud-api.js

@@ -0,0 +1,96 @@
+/**
+ * Cloud API Client for Symi Hotel Cloud Platform
+ * 酒店云云接口封装
+ */
+
+const crypto = require('crypto');
+
+class CloudAPI {
+    constructor(appId, appSecret, logger = console) {
+        this.baseUrl = 'https://hotel.beancomm.net/hapi/open/';
+        this.appId = appId;
+        this.appSecret = appSecret;
+        this.logger = logger;
+    }
+
+    generateSignature(body, timestamp) {
+        const raw = body + timestamp + this.appSecret;
+        return crypto.createHash('md5').update(raw).digest('hex');
+    }
+
+    async request(endpoint, data = {}) {
+        const timestamp = Math.floor(Date.now() / 1000).toString();
+        const body = JSON.stringify(data);
+        const signature = this.generateSignature(body, timestamp);
+
+        const url = this.baseUrl + endpoint;
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Beancomm-Timestamp': timestamp,
+            'X-Beancomm-AppId': this.appId,
+            'X-Beancomm-Signature': signature
+        };
+
+        try {
+            const axios = require('axios');
+            const response = await axios.post(url, body, { 
+                headers,
+                timeout: 10000
+            });
+
+            if (response.data.code === 0) {
+                return response.data.data;
+            } else {
+                throw new Error(`API Error: ${response.data.message || 'Unknown error'}`);
+            }
+        } catch (error) {
+            if (error.response) {
+                throw new Error(`HTTP ${error.response.status}: ${error.response.statusText}`);
+            } else if (error.request) {
+                throw new Error('Network error: No response from server');
+            } else {
+                throw error;
+            }
+        }
+    }
+
+    async getHotelList(page = 1, limit = 100) {
+        return await this.request('hotel/list', { page, limit });
+    }
+
+    async getRoomList(hotelId, page = 1, limit = 100) {
+        return await this.request('room/list', { 
+            hotel_id: hotelId, 
+            page, 
+            limit 
+        });
+    }
+
+    async getRoomInfo(params) {
+        if (params.room_uuid) {
+            return await this.request('room/info', { 
+                room_uuid: params.room_uuid 
+            });
+        } else if (params.hotel_id && params.room_no) {
+            return await this.request('room/info', { 
+                hotel_id: params.hotel_id,
+                room_no: params.room_no
+            });
+        } else {
+            throw new Error('Must provide room_uuid or (hotel_id + room_no)');
+        }
+    }
+
+    async executeScene(roomUuid, sceneId) {
+        return await this.request('room/control', {
+            room_uuid: roomUuid,
+            action: 'execute_scene',
+            payload: {
+                scene_id: sceneId
+            }
+        });
+    }
+}
+
+module.exports = CloudAPI;
+

package/lib/device-manager.js

@@ -82,6 +82,13 @@ class DeviceInfo {
                     this.handleSwitchState(parameters);
                 }
                 break;
+            case 0x45:
+                // 6键开关状态上报（2字节，小端序）
+                // 用于场景执行后的状态同步
+                if (this.channels === 6) {
+                    this.handleSwitchState(parameters);
+                }
+                break;
             case 0x03:
                 if (parameters.length > 0) {
                     this.state.brightness = parameters[0];

package/lib/mqtt-helper.js

@@ -90,10 +90,17 @@ function generateDiscoveryConfig(device, mqttPrefix = 'homeassistant') {
             // 普通开关设备：为每个继电器创建一个按钮实体（button，非toggle）
             for (let i = 1; i <= device.channels; i++) {
                 const objectId = device.channels === 1 ? `${macClean}_switch` : `${macClean}_switch_${i}`;
-                const channelName = device.channels > 1 ? ` 第${i}路` : '';
+
+                let channelName = '';
+                if (device.subDeviceNames && device.subDeviceNames[i - 1]) {
+                    channelName = ` ${device.subDeviceNames[i - 1]}`;
+                } else if (device.channels > 1) {
+                    channelName = ` 第${i}路`;
+                }
+
                 const stateTopic = device.channels === 1 ? `symi_mesh/${macClean}/switch/state` : `symi_mesh/${macClean}/switch_${i}/state`;
                 const commandTopic = device.channels === 1 ? `symi_mesh/${macClean}/switch/set` : `symi_mesh/${macClean}/switch_${i}/set`;
-                
+
                 configs.push({
                     topic: `${mqttPrefix}/switch/${objectId}/config`,
                     payload: JSON.stringify({
@@ -650,10 +657,34 @@ function convertStateValue(entityType, attrType, value, deviceType = null) {
     }
 }
 
+function generateSceneButtonConfig(scene, roomNo, mqttPrefix = 'homeassistant') {
+    const sceneId = `scene_${scene.scene_id}`;
+    const objectId = `symi_room_${roomNo}_${sceneId}`;
+
+    return {
+        topic: `${mqttPrefix}/button/${objectId}/config`,
+        payload: JSON.stringify({
+            name: `${scene.scene_name}`,
+            unique_id: objectId,
+            command_topic: `symi_mesh/room_${roomNo}/scene/${scene.scene_id}/trigger`,
+            payload_press: 'PRESS',
+            icon: 'mdi:play-circle',
+            device: {
+                identifiers: [`symi_room_${roomNo}`],
+                name: `房间${roomNo}场景控制`,
+                model: 'Symi 场景控制器',
+                manufacturer: 'SYMI 亖米'
+            }
+        }),
+        retain: true
+    };
+}
+
 module.exports = {
     generateDiscoveryConfig,
     generateStateTopics,
     convertStateValue,
+    generateSceneButtonConfig,
     DEVICE_ICONS,
     DEVICE_CLASSES
 };

package/lib/protocol.js

@@ -9,12 +9,13 @@ const MIN_FRAME_LENGTH = 4;
 // Operation codes
 const OP_READ_DEVICE_LIST = 0x12;
 const OP_DEVICE_CONTROL = 0x30;
+const OP_SCENE_CONTROL = 0x34;  // 场景控制（使用0x34，不是0x31）
 const OP_TRANSPARENT_CONTROL = 0x40;
 const OP_EVENT_NODE_STATUS = 0x80;
 const OP_EVENT_TRANSPARENT_MSG = 0xC0;
 const OP_RESP_DEVICE_LIST = 0x92;
 const OP_RESP_DEVICE_CONTROL = 0xB0;
-const OP_SCENE_CONTROL = 0x31;
+const OP_RESP_SCENE_CONTROL = 0xB4;  // 场景控制响应
 const OP_DEVICE_STATUS_QUERY = 0x32;
 
 class ProtocolFrame {
@@ -410,7 +411,23 @@ class ProtocolHandler {
     }
 
     buildSceneControlFrame(sceneId) {
-        return this.buildFrame(OP_SCENE_CONTROL, Buffer.from([sceneId]));
+        // 场景控制协议格式：
+        // 53 34 06 bc c0 00 05 01 [场景ID] [校验]
+        // - 地址：0xC0BC（小端序：bc c0）- 广播地址，确保所有设备收到
+        // - ACK：0x00（不需要ACK）
+        // - 重传：0x05（重传5次，持续1.2秒）
+        // - msgtype：0x01（场景执行）
+        // - 场景ID：1字节
+
+        const addr = 0xC0BC;  // 广播地址
+        const addrLow = addr & 0xFF;        // 0xBC
+        const addrHigh = (addr >> 8) & 0xFF; // 0xC0
+        const ack = 0x00;       // 不需要ACK
+        const retrans = 0x05;   // 重传5次
+        const msgtype = 0x01;   // 场景执行
+
+        const data = Buffer.from([addrLow, addrHigh, ack, retrans, msgtype, sceneId]);
+        return this.buildFrame(OP_SCENE_CONTROL, data);
     }
 
     buildDeviceStatusQueryFrame(networkAddr, msgType = 0x00) {

package/lib/tcp-client.js

@@ -236,9 +236,9 @@ class TCPClient extends EventEmitter {
                 return;
             }
 
-            // 添加发送日志
+            // 使用debug记录发送帧，避免日志泛滥
             const frameHex = frame.toString('hex').toUpperCase();
-            this.logger.log(`[TCP Frame] 发送: ${frameHex}`);
+            this.logger.debug(`[TCP Frame] 发送: ${frameHex}`);
 
             this.client.write(frame, (error) => {
                 if (error) {