包间场景下，灯光、空调、排风、门牌等设备往往需要按场景批量切换（如“营业模式”“打扫模式”），单路控制效率太低。芯步8路控制器的batch批量命令可以一次调用切换多路状态，同时支持point/reset实现设备间的时序联动。以下是具体的接入方案：

解决方案：基于芯步8路电源控制器的包间场景模式切换系统

1. 概述

本方案的目标是利用芯步智能通用控制器（8路） 的开放HTTP API接口，将传统包间内的灯光、电视、空调、排风扇、门牌灯箱等设备接入统一的物联网控制系统。

通过集成API，您的现有软件系统（如餐饮管理系统、智能家居APP、包厢服务中控台）可以远程一键切换包间的设备组合状态，实现“迎宾模式”、“用餐模式”、“打扫模式”、“离席待客模式”等场景的秒级切换。

核心优势：

• 无需网关： 设备直连WiFi 2.4G，降低硬件成本。

• 接口标准化： 提供全开放HTTP接口，支持任何编程语言（Java, Python, PHP, Go等）调用。

• 控制精准： 支持单路独立控制、全开全关、任意组合批量控制。

2. 硬件与接口能力

硬件型号：UNI-KZQ-TY-8（以及衍生的智能交流/直流控制器8路版）。

8路控制能力定义：将8路继电器输出与包间设备进行标准化绑定，例如：

• 路1：主照明

• 路2：氛围灯带

• 路3：电视机/投影仪电源

• 路4：空调室内机电源

• 路5：排风扇/新风系统

• 路6：请勿打扰/门牌指示灯

• 路7：呼叫/服务灯

• 路8：备用插座

3. 场景模式切换的核心逻辑实现

要实现“一键切换场景”，本质上是向控制器发送特定的 组合命令。芯步的接口支持 单路控制 和 批量控制 两种模式。

（1）单路独立控制用于调试或微调，例如仅打开主照明：

（2）批量场景切换（核心功能）在场景模式切换时，我们通常需要同时改变多路状态。推荐使用 batch 命令，它支持指定任意几路同时开启或关闭。

场景A：迎宾/用餐模式需求：主照明开、氛围灯开、空调开、门牌灯转换为“使用中”。

注意：未在relay中列出的路数（如排风扇、电视）状态保持不变。

场景B：打扫/清洁模式需求：排风扇开、主照明开、其余关闭。

场景C：全关/离席模式需求：8路设备全部断开。

4. 时序联动控制（高级功能）

在某些场景切换时，为了防止设备损坏或逻辑更自然，需要设备按顺序动作。例如：先关闭空调压缩机，稍后延时再关闭风机盘管电源。此时可使用 point（先通后断）或 reset（先断后通）命令。

应用示例：投影幕布与投影仪联动需求：开启“观影模式”时，先给投影仪供电，等2秒后降下幕布（假设幕布电机接在另一路）。

（注：第二动作需要配合第二条指令控制路2幕布，或在本地逻辑中通过后端代码分两次调用API实现复杂时序）

5. 后端接入流程与代码示例

第一步：获取凭证登录芯步控制台，获取 AppID 和 AppSecret。获取设备的唯一 Device ID（可在控制台查看或扫码获取）。

第二步：签名算法为了防止接口被恶意篡改，API请求需要携带动态签名。

• 规则：Sign = MD5( MD5(AppSecret) + ts )。

• ts： 当前Unix时间戳（秒）。

第三步：发起HTTP请求

请求地址：POST https://api.thingboot.com/{AppId}/device/control/？sign={Sign}&ts={ts}

请求头 (Headers)：Content-Type： application/json

请求体 (Body) 示例（PHP/cURL 伪代码）：

6. 私有化部署与局域网控制（可选）

对于注重数据安全或网络稳定性要求比较高的场所（如大型KTV、连锁足浴），芯步设备支持 局域网私有化 部署。

• 操作： 设备配网时，将其指向您内网中的自建服务器IP。

• 效果： 即使外网断开，服务员手中的平板依然能控制包间灯光场景，且响应延迟极低（<100ms）。

7. 总结

通过接入芯步8路控制器的开放接口，开发者可以在3-5天内完成“单包间控制”到“整店场景联动”的升级。核心在于利用 Batch命令 封装多种设备状态，配合 签名鉴权 机制，即可安全、稳定地实现8路设备的多场景模式一键切换。