智能墙壁复合开关通过HTTP API接口开放控制能力，对接的核心是签名鉴权和指令构造。以下方案从接口协议、双路控制命令到场景联动代码，逐步说明如何将其集成到办公设备管理系统中。
1. 项目概述与对接目标
在智能办公场景中，照明系统与办公设备（如投影仪、窗帘、工位传感器）的联动是实现节能与自动化管理的关键环节。芯步推出的智能墙壁复合开关2路（型号：UNI-KG-KC）支持通过标准HTTP API接口进行远程控制，具备局域网通信和私有化部署能力，非常适合集成到企业的自有办公管理系统中。
本方案的目标是解决如何在您的Web应用、移动端或后台服务中，通过对接该开关的开放接口，实现对两路独立照明电路的精准控制。最终目标是实现“人来灯亮、设备启动；人走灯灭、设备断电”的智慧办公体验。
2. 接口鉴权与硬件准备
在开始编码前，需要完成底层硬件配网及API调用凭证的准备工作。芯步的接口采用动态签名验证，保障了局域网及云端调用的安全性。
2.1 核心参数获取
首先需在芯步官方控制台完成以下配置：
AppID 与 AppSecret：注册并创建工作台后，在“开发设置”中获取，用于计算接口签名。
Device ID：设备配网成功后，在控制台获取该开关的唯一标识，下发指令时需以此为目标。
配网流程：设备支持WiFi 2.4G直连。可通过PC控制台或微信小程序，将现场WiFi凭证写入设备，待指示灯停止闪烁即表示上线。
2.2 签名算法详解
为防止接口被篡改，所有请求需携带签名（sign）。算法规则为双重MD5加密：sign = md5( md5(AppSecret) + ts )
| 参数 | 说明 | 示例 |
|---|---|---|
| AppSecret | 开发者密码（需MD5一次） | e10adc3949ba59abbe56e057f20f883e |
| ts | 当前Unix时间戳（秒） | 1715123456 |
| 拼接字符串 | MD5后的Secret + ts | e10adc...883e1715123456 |
| 最终sign | 对上一步字符串再次MD5 | 6fa12f...8b4d |
注：时间戳ts需实时生成，与服务器时间误差过大会导致鉴权失败。
3. 双路独立控制的API实现
该开关的核心优势在于“复合”控制，不仅支持简单的开/关，还支持“点动”和“状态保持”等工业级逻辑。针对办公场景，API请求地址统一为：https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}（云端）或切换至局域网IP进行私有化调用。
3.1 基础通断电控制（照明开关）
办公场景中最常用的操作是控制特定线路的照明。order参数是JSON字符串，需根据命令格式传递。
线路1控制
{"power1": 1}（开启），{"power1": 0}（关闭）。线路2控制
{"power2": 1}（开启），{"power2": 0}（关闭）。
场景示例：会议室预定系统检测到会议结束，自动关闭所有灯光。
3.2 高级复合逻辑（点动与联动）
针对投影幕布联动或卫生间自动关灯场景，可利用“状态保持”和“点动”功能。
状态保持（暂态）：适合无人传感器联动。当传感器触发时，开启灯光，若用户忘记关闭，系统在设定时间后自动恢复。
指令示例：
{“power1”： {“keep”： “1”， “revert”： “60”}}（强制开启线路1，60秒后无论手动状态如何，自动关闭）。
点动控制：适合用于触发电动窗帘或门禁。指令使电路接通指定毫秒后立即断开。
指令示例：
{“point1”： “1000”}（线路1接通1秒后断开）。
4. 办公场景联动代码实战
以下是一段集成到您项目后端（如Node.js/Python）的业务逻辑示例，展示了如何在“会议模式”下联动开关。
4.1 核心请求函数（Python示例）
4.2 高级场景：投影仪联动“一键观影”
在智能会议室，当启动投影仪时，往往需要自动调暗灯光。如果办公系统检测到投影仪开启（或通过中控按钮触发），可调用以下指令：指令逻辑：关闭线路2（投影区前方灯光），同时启动线路1的“延时点动”以关闭后排照明。执行代码order = { “power2”： 0, “point1”： “2000” }（效果：前排立刻灭灯，后排2秒后自动熄灭）。
5. 状态同步与私有化部署
为了确保办公管理系统中显示的“灯的状态”与实际物理状态一致，做好以下两点：
消息推送（回调）除了主动查询（拉取）状态，在芯步控制台设置“上游消息接收地址”（Webhook）。当人员手动触摸墙壁开关时，设备会主动向您的服务器推送状态变更消息。您只需接收POST请求并更新数据库即可。
局域网私有化对于对数据安全要求比较高或网络环境封闭的办公园区，该开关支持纯局域网控制。您的服务器可直接通过设备本地IP调用接口，完全不经过云端，极大降低了指令延迟。
6. 总结
通过以上步骤，您可以迅速将芯步的智能墙壁复合开关2路接入现有的办公设备联动系统中。其开放的HTTP接口屏蔽了复杂的底层通信协议（Wi-Fi配网等），开发者只需关注业务逻辑层（order参数的组合）。利用该开关的“两路独立”特性，您可以灵活划分办公区与公共走道的照明策略，结合“点动”与“保持”逻辑，实现更细腻的能耗管理。