芯步3路智能墙壁开关开放了完整的HTTP API接口，支持局域网和公网两种调用方式，响应延迟仅80-120ms。以下方案围绕“照明+门禁”场景，从接口能力、联动逻辑到代码实现，给出可落地的二次开发路径。
1. 解决概述
1.1 背景与目标
在现代智能建筑和智慧办公场景中，用户不仅需要远程控制灯光，更希望实现“人来灯亮、人走断电、联动门禁”的全自动化体验。芯步智能触摸墙壁开关3路产品支持开放的HTTP API接口，具备比较高的二次开发灵活性。
本方案的目标是指导开发者如何利用该产品的 3路独立继电器输出 和 开放API，将其集成到现有的上位机系统（如微信小程序、PC管理后台、SaaS平台）中，实现以下核心目标：
场景联动：通过传感器或软件逻辑，实现多路照明之间的时序控制。
门禁集成：利用其中一路（常开/常闭触点）控制门禁锁的供电或触发信号。
自动化时序：实现“一键布防”、“延时断电”等复杂逻辑。
1.2 核心技术能力
芯步3路开关提供三类核心API命令，这是二次开发的基础
| 命令类型 | API指令示例 | 功能描述 | 应用场景 |
|---|---|---|---|
| 基础通断 | {"power1": 1} / {"power1": 0} | 立刻开启或关闭第N路继电器 | 手动远程控制灯光或插座 |
| 临时动作 | {"point1": 1} | 先接通线路，延时后自动断开 | 触发门禁开门（通电开锁） |
| 复位动作 | {"reset1": 1} | 先断开线路，延时后自动接通 | 控制排气扇或停电后再通电告警 |
| 状态保持 | {"power1": {"keep":"0", "revert":"2"}} | 用户操作后自动还原状态 | 防止非法操作或特定模式锁定 |
2. 系统设计
为了实现稳定的控制与联动，采用 云-端-设备 的经典架构。
2.1 架构分层
设备层：芯步3路智能墙壁开关（安装在86底盒中），连接三路负载。例如：L1（主照明）、L2（氛围灯/排风扇）、L3（门禁电磁锁电源）。
传输层：设备通过Wi-Fi连接路由器，通过HTTP协议与芯步云平台或本地局域网通信。
平台层
芯步云：负责设备注册、长连接维护、签名验证。
二次开发服务器：开发者自建的业务服务器，负责存储联动逻辑（如“夜晚开门才亮灯”）、处理传感器触发事件。
应用层：PC管理端、移动端H5/小程序、人脸识别门禁主机等。
2.2 核心交互流程（开门亮灯示例）
门禁控制器识别合法用户（刷卡/人脸）。
门禁控制器（或中控服务器）调用芯步API接口。
携带
AppID、Sign（MD5加密）、DeviceID和命令{"point1": 5000}（L1路瞬间通电）。云平台验证签名后转发命令给墙壁开关。
开关L1路接通，灯光亮起；5秒后若无人为干预，自动熄灭。
3. 关键开发技术与实现
3.1 API接入与鉴权
芯步接口采用动态签名鉴权，只要支持HTTP请求的环境均可接入。
Python 后端调用示例：
3.2 核心场景：门禁联动控制
门禁系统通常需要通电开锁或断电开锁两种模式。利用3路开关的灵活时序命令，无需额外继电器即可对接。
断电开锁门禁（如电插锁）：锁体平时需要通电才能锁门。
开门动作：需要切断锁的电。
推荐API
{"reset3": 3000}。此命令会立即断开L3路，电磁锁失电开门，持续3秒后自动恢复供电，重新锁门。
通电开锁门禁（如磁力锁）：锁体通电吸合，断电掉落。
开门动作：需要瞬间通电吸合。
推荐API
{"point3": 2000}。此命令会立即接通L3路，磁力锁通电吸合实现开门，2秒后自动断电。
3.3 场景联动：照明逻辑开发
利用3路开关的独立性，开发者可以在软件层轻松实现“互锁”或“交替”逻辑。
场景A：一键离家模式（关闭所有灯光并锁门）
场景B：影音模式联动（关主灯、开氛围灯）可以在业务层实现时序控制，先关主灯（L1），再开氛围灯（L2）。
3.4 局域网与私有化部署（低延迟方案）
对于对延迟敏感的场景（如停车场车来灯亮），公网API的80-120ms虽已很快，但局域网直连更佳。芯步支持局域网API调用。
实现的方式是：在同一局域网内，直接向设备的IP地址或局域网发现的API地址发送HTTP请求，无需经过外网云平台。
4. 典型应用方案实战
4.1 智慧办公室：人脸识别联动
硬件配置
芯步3路开关控制（筒灯、射灯、门磁锁）。
人脸识别面板（具备网络请求能力）。
开发逻辑
上班场景（人脸识别成功）
如果时间在 8:00-10:00 且识别通过：
调用API：
{"power1":1}（开主照明）。同时调用：
{"reset3":5000}（门禁断电5秒放行）。
下班场景（面板按下“下班键”）
调用API：
{"power1":0, "power2":0}。延时10秒调用：
{"power3":0}（确保最后一人离开后关门）。
4.2 智能酒店客房：取电开关逻辑
需求：插入房卡后，客房的“欢迎模式”启动；拔出房卡后，除冰箱外所有插座断电。实现
L1：总照明（默认打开）。
L2：普通插座（通过
reset2实现延时断电）。开发细节：取电开关控制一个传感器输入给开发者服务器，服务器接收到“取电信号”后，发送
{"power1":1}。当接收到“断电信号”时，发送{"power1":0}。
5. 高级功能和需要注意的点 (FAQ)
5.1 关于“状态保持”的妙用
芯步接口支持 keep 和 revert 参数。例如设置 {"power1":{"keep":"0","revert":"2"}}，表示如果有人在面板上手动打开了L1路的灯，系统将在2秒后强制关闭。这在公共卫生间、楼道等要求“人走灯灭”的场景非常有用，可以防止人为误触导致的能源浪费。
5.2 硬件接线注意事项
零火线：确保3路开关的输入端接好了零线和火线，以维持Wi-Fi模块的待机稳定。
门禁负载控制：门禁锁（电插锁/磁力锁）通常是12V/24V直流电，而芯步开关输出是220V交流电。严禁将门禁锁直接接在开关上！必须通过 220V转12V开关电源 进行隔离转换，即：开关 -> 开关电源 -> 门禁锁。
5.3 设备ID管理
设备ID是控制的唯一凭证。开发者可以通过芯步控制台获取，也可以通过 设备列表查询接口（同样遵循签名规则）动态拉取，方便批量设备管理。
6. 总结
依托芯步3路智能墙壁开关开放的 HTTP API接口 和 局域网控制能力，开发者可以像调用本地函数一样轻松控制物理电路。通过本文介绍的 power（开关）、reset（断电复位）、point（通电脉冲）三种核心指令排列组合，无论是复杂的A级办公区门禁互锁，还是家庭影院的灯光场景联动，都可以在统一的业务中台系统内稳定、高效地实现。