一、概述
本方案基于芯步智能墙壁复合开关产品，利用其开放的HTTP API接口，实现手机端对门禁设备和照明设备的远程遥控。复合开关的多路独立控制特性，使其能够同时管理门禁锁（如电插锁、电磁锁）和照明灯具，一套设备解决入口控制与环境照明的联动需求。
适用场景：办公室远程开门、出租屋门禁管理、车库门遥控、居家照明远程控制、商铺防盗门联动照明等。
核心优势
接口开放标准，支持任意编程语言/小程序/APP调用
控制延迟低至80-120ms，响应迅速
支持单火/零火线安装，可直接替换86型开关
三路独立控制，门禁与照明可共用一台设备
二、系统架构
2.1 硬件组成
| 组件 | 型号/规格 | 作用 |
|---|---|---|
| 智能墙壁复合开关 | 芯步3路智能开关 | 核心控制器，接收云端指令，执行通断动作 |
| 电插锁/电磁锁 | 12V/24V（与开关适配） | 门禁执行机构，通电开锁/断电开锁按需选择 |
| 照明灯具 | AC 220V LED/节能灯 | 照明执行机构 |
| 12V电源 | 12V/2A DC | 为电锁供电（如锁具需12V） |
| 手机端APP/小程序 | 自研或第三方 | 用户操作界面，发送控制指令 |
复合开关选型说明：推荐选用3路型号，其中1路控制门禁锁（通过中间继电器转换），另外2路分别控制不同区域照明，实现设备复用。
2.2 软件组成
| 组件 | 说明 |
|---|---|
| 芯步开放平台 | 提供设备接入、指令下发、状态同步服务 |
| 控制端应用 | 微信小程序 / Android/iOS APP / Web管理后台 |
| API接口 | https://api.thingboot.com/{AppID}/device/control/ |
2.3 系统拓扑图
三、硬件接线方案
3.1 门禁控制接线（关键）
重要安全提示：复合开关的继电器输出为干接点信号，不能直接驱动电锁。电锁工作时电流较大（通常0.5A-3A），必须通过中间继电器转换。
接线步骤
复合开关第1路输出（L1接线柱）连接中间继电器的线圈正极
复合开关零线端（N接线柱）连接中间继电器的线圈负极
中间继电器常开端（NO）与公共端（COM） 接入电锁的电源回路
若电锁为“通电开锁型”：继电器COM接12V+，NO接电锁正极，电锁负极接电源负极
若电锁为“断电开锁型”：改用常闭端（NC）
芯步官方明确提示：“请勿直接将电插锁接在出门开关上！” 同样原理，请勿直接将电锁接在复合开关输出端。
3.2 照明接线
第2路输出：火线进→开关L2→灯具火线，灯具零线直连零线排
第3路输出：同上
复合开关支持单火线接线（无需零线）和零火线接线两种方式，旧房改造适用。
3.3 电气连接示意
四、接口对接方案
4.1 准备工作
注册芯步账号，创建工作台
获取AppID和AppSecret（在控制台的开发设置中获取）
添加设备，记录设备ID（可在设备外壳或控制台查看）
为设备配网，确保开关联网在线
4.2 API接口说明
请求地址
签名算法
其中ts为当前Unix时间戳（秒）
请求头
请求体格式
4.3 控制命令详解
针对智能墙壁复合开关3路产品，支持以下命令
| 功能 | 命令示例 | 说明 |
|---|---|---|
| 第1路开启 | {"power1":1} | 门禁开锁 |
| 第1路关闭 | {"power1":0} | 门禁闭锁 |
| 第2路开启 | {"power2":1} | 开灯 |
| 第2路关闭 | {"power2":0} | 关灯 |
| 第3路开启 | {"power3":1} | 开灯 |
| 第3路关闭 | {"power3":0} | 关灯 |
| 定时关闭 | {"power1":1, "reset1":5000} | 开锁，5秒后自动闭锁 |
| 状态保持 | {"power1":{"keep":"1","revert":"10"}} | 保持开状态，用户手动关后10秒自动恢复开 |
针对门禁场景的特殊说明
使用定时关闭模式，防止门锁长时间通电烧毁线圈
reset1单位为毫秒，一般设3000-5000ms（3-5秒）足够门锁动作
4.4 代码示例
微信小程序版本
Web前端/JavaScript版本
Python后端版本
4.5 响应处理
接口返回code:200仅表示命令已下发到平台，设备实际执行结果需通过异步消息推送确认
常见错误码
| code | 说明 |
|---|---|
| 200 | 命令下发成功 |
| 501 | 未指定设备ID |
| 502 | 设备不存在 |
| 503 | 设备数量超过100台 |
五、门禁场景特殊功能设计
5.1 临时授权码
可结合业务系统生成临时开门权限（如访客密码、限时二维码）：
5.2 开门记录留存
芯步平台支持设备状态上报，可订阅消息推送获取每次开门的时间戳和设备状态，存入业务数据库用于审计。
5.3 联动逻辑
开门亮灯：先发开锁命令，延时500ms发照明开启命令
离家模式：一键关闭所有照明+确认门锁已闭合
夜间感应：结合人体传感器，检测到人时自动开灯（需额外传感器配合）
六、安装与调试注意事项
6.1 安全警告
⚠️ 接线前请一定要关闭总闸断路器电源，防止触电⚠️ 电锁必须通过中间继电器与复合开关隔离，禁止直连⚠️ 复合开关负载能力有限，大功率灯具（>1000W）需外接交流接触器
6.2 常见故障排查
| 故障现象 | 可能原因 | 解决方案 |
|---|---|---|
| 命令返回200但门不动 | 继电器线圈未得电 | 检查复合开关第1路是否有220V输出 |
| 门锁持续吸合不释放 | reset1未设置或过长 | 命令中添加reset1:3000 |
| 开关离线 | WiFi信号弱 | 检查网络，靠近路由器重新配网 |
| 照明闪烁 | 单火接线取电不足 | 灯具两端并联2W/220kΩ电容 |
6.3 配网步骤
下载并安装“芯步”官方APP或使用工作台控制
长按复合开关面板上的按键5秒，进入配网模式（指示灯快闪）
在APP中选择“添加设备”，扫描或输入设备ID
输入WiFi密码完成配网，指示灯常亮表示在线
七、方案扩展
7.1 无网络环境
如需纯局域网控制（如内网部署），芯步支持私有化部署，可将API服务部署在内网服务器，设备通过局域网IP直接控制。
7.2 批量设备管理
芯步接口支持一次命令控制多台设备，设备ID用逗号分隔，最多100台
7.3 语音控制集成
可将复合开关接入Home Assistant等智能家居平台，进而对接小爱同学、天猫精灵实现语音开门/开灯。
八、总结
本方案基于芯步智能墙壁复合开关的开放HTTP接口，实现了手机远程遥控门禁和照明的完整解决方案。核心要点：
硬件连接：复合开关第1路通过中间继电器驱动电锁，第2/3路直驱照明
接口调用：签名认证后POST指令，80-120ms极速响应
门禁优化：使用
reset1定时关闭功能，3-5秒自动断电，保护电锁扩展能力：支持临时授权、记录留存、批量控制、语音集成
该方案产品现货供应，芯步免费提供全程技术指导，从选型、对接到接线、调试均有工程师支持。