芯步的1路智能墙壁开关采用标准86型设计，可直接替换现有开关，通过HTTP API即可实现照明与门禁的远程集成控制。以下方案涵盖设备对接、API调用、场景联动及部署要点，帮助快速落地。
解决方案：基于芯步1路墙壁开关的办公室照明与门禁集成方案
1. 概述
本方案的目标是利用芯步智能墙壁开关（1路） 的标准86型硬件和开放接口，解决办公室场景中“照明自动化”与“简易门禁/电控锁”集成的需求。通过集成该设备，开发者可以将其嵌入自有管理系统（如OA系统、工位管理或安防平台），实现远程控制、逻辑联动与状态监控。
适用场景：
独立办公室/会议室： 远程关闭遗留照明。
机房/服务器间： 通过门禁信号触发照明，或远程重启设备。
简易门禁： 控制门锁电源（需注意功率匹配）或通过继电器触发开门信号（配合门禁主机）。
2. 硬件选型与集成准备
硬件：芯步智能墙壁开关（UNI-KG-1）
物理规格：标准86型，直接替换现有面板，无需改造底盒。
电气参数：支持 100-240V AC 宽电压，额定电流 10A。注： 若用于LED灯，需确认负载功率小于300W（LED容性负载特性）；若用电感负载（如门磁锁），需预留余量。
通讯方式：Wi-Fi 2.4GHz，联网即可远程控制。
开放接口能力：芯步提供标准的 HTTP API，支持云端调用及局域网控制，包含以下核心功能
基础开关：控制线路通断。
状态保持：用户物理按键操作后，延迟若干秒自动恢复。
点动模式：模拟“按键”动作（先通后断或先断后通），适合触发门禁按钮。
3. 接口集成开发指南
要将开关集成到您的项目中，主要需完成设备注册、接口鉴权及指令下发三个步骤。
3.1 准备工作：获取凭证
在芯步开发者后台：
注册并创建“项目”，获取 AppID 和 AppSecret。
添加设备，获取 Device ID（贴在设备外壳或后台列表）。
将服务器的公网IP加入IP白名单以提高安全性。
3.2 接口鉴权（Sign生成）
所有API请求需携带签名以保证安全性。签名算法如下
Sign = md5( md5(AppSecret) + ts )
ts：当前 UNIX 时间戳（秒）。
步骤：先将 AppSecret 进行一次 MD5 加密，然后将结果字符串拼接上时间戳，再对整个字符串进行 MD5 加密。
3.3 核心指令下发示例
请求地址：POST https://api.thingboot.com/{AppID}/device/control/参数示例（JSON）：
| 应用场景 | 命令 JSON (Order字段) | 说明 |
|---|---|---|
| 定时/远程关灯 | {"power1":0} | 关闭第1路照明，0=关，1=开 |
| 实现“人走灯灭” | {"power1":{"keep":"1","revert":"10"}} | 用户手动关闭开关后，10秒后自动恢复开启状态。特别适合误触区域 |
| 控制门禁/电锁 | {"point1":"3000"} | 先通后断，接通3秒后自动断开。适合触发门禁开门信号 |
响应处理：API返回 {"code":200} 仅代表指令下发成功，并不代表设备执行成功。若需确认设备状态，配置 消息推送 回调地址，接收设备状态变化的实时通知。
3.3 关键集成逻辑
第一种场景：办公室照明自动化集成流程： 您的系统定时器 -> 调用设备控制接口 ->
{"power1":0}-> 灯光熄灭。进阶联动： 配合人体传感器。若检测到有人且系统处于下班时间，系统忽略关灯指令；若无人超过15分钟，系统强制下发关灯指令。第二种场景：门禁控制集成虽然该开关主要用于照明，但在弱电控制场景下，可利用其“点动”功能模拟开门按钮。
物理接线：将开关的L（火线进）和L1（出线）接入门禁控制器的“开门按钮”接线柱（常开点）。
软件逻辑：员工在APP/小程序点击“开门” -> 系统调用接口
{"point1":"1000"}-> 开关闭合1秒后断开 -> 门禁控制器检测到信号 -> 开门。
4. 项目落地方案和需要注意的点
实施步骤：
安装替换： 关闭总闸，拆掉旧开关，接零火线（注意UNI-KG-1通常需要零线，具体以实物说明书为准），固定面板。
配网绑定： 长按开关按键进入配网模式，通过API接口或官方APP将设备配置到指定Wi-Fi下。
系统对接： 运行上述鉴权算法，测试设备控制接口。
逻辑调试： 根据办公时间设置定时任务，或编写条件判断脚本。
关键注意事项：
负载匹配
照明： 现代LED驱动电路为容性负载，启动瞬间电流大。虽然开关标称10A，但LED总功率控制在300W以内以防止继电器触点粘连。
门锁： 若直接控制电插锁或磁力锁，请注意锁具为电感性负载，断电时会产生反向电动势。虽然开关继电器设计有防护，但在高频率开关门场景下，通过中间继电器隔离，保护智能开关主板。
网络断连预案：该开关在网络断连或云端故障时，依然支持本地物理按键操作，不影响基本办公照明，保证了高可用性。
安全合规：设备外壳采用防火V0级PC，安装时确保接线牢固，避免因接触不良发热引发风险。
5. 总结
芯步的1路墙壁开关通过提供原子化的 HTTP API（如 power1 和 point1），极大地降低了软硬件集成的门槛。
对于开发者而言，你无需关注底层通讯协议，只需专注于业务逻辑：将“power1”映射为你数据库中的工位状态，或将“point1”集成进你的门禁权限校验流程中。通过这种方式，仅需10A容量的物理触点，即可低成本、高效率地将办公室的照明或门禁纳入数字化管理。