86型WiFi出门开关的核心价值在于:它不是一个独立的门禁系统,而是一个可编程的“继电器控制器”——通过HTTP接口,你可以把它无缝对接到现有的工单系统、访客管理App或办公自动化平台中。
下面从设备选型、接口对接逻辑到典型场景,整理一份完整的方案。
1. 硬件选型与接线
在开始对接前,你需要确认使用的具体设备。根据芯步的产品线,以下两款标准86型开关非常适合门禁改造:
智能墙壁出门开关:性价比高,塑料材质,支持单路控制。
智能触摸墙壁出门开关:钢化玻璃面板,颜值更高,同样支持强电控制。
关键接线逻辑这类开关本质上是强电继电器。你需要将开关串联在门禁电源与电锁(电磁锁/电插锁)的火线上。
接线场景 A(断电开锁):大多数门禁使用“断电开锁”电锁。将智能开关设置在常通模式,出门时让开关断开(断电),门即打开,延迟几秒后自动恢复通电锁门。
接线场景 B(通电开锁):如某些玻璃门电插锁。出门时让开关瞬间通电(开锁),随即断电。
电气参数注意:设备工作电压为 100-250V AC,负载能力通常为 10A。请确认你的电锁功率在范围内。如果不熟悉强电操作,由电工负责安装,确保安全。
2. 核心对接:API接口详解
芯步的开放接口采用标准的 HTTP POST 请求,这是实现联动的核心。所有操作均需通过调用 device/control 接口完成。
2.1 接口信息
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法:POST
数据格式:JSON
2.2 鉴权机制
为了安全,每次请求都需要携带签名(sign)。签名的生成算法为双重MD5加密,具体步骤如下:
准备你的
AppSecret(在芯步控制台获取)。获取当前时间戳
ts(Unix时间戳,秒)。计算
Sign = MD5( MD5(AppSecret) + ts)。将生成的 Sign 和 ts 拼接在 URL 上。
2.3 核心控制指令
针对“出门开关”场景,主要通过 order 字段传递不同命令来实现不同的门禁逻辑:
| 命令类型 | order 参数示例 | 功能描述 | 适用门禁场景 |
|---|---|---|---|
| 瞬间动作 | {"power":"0"} | 立即断开继电器 | 配合“断电开锁”型电锁,直接开门。 |
| 定时恢复 | {"reset":"5000"} | 先断开,持续 5 秒(5000ms)后自动接通 | 最推荐。开门后自动恢复供电锁门,无需额外逻辑。 |
| 脉冲开锁 | {"point":"2000"} | 先接通,持续 2 秒后自动断开 | 适用于“通电开锁”型电锁(如部分电控锁)。 |
注:如果是双路开关,请使用 power1、reset1、point1 等命令。
3. 实战对接流程
一旦硬件接线完毕且设备已通过Wi-Fi配网成功,你就可以通过软件控制门禁了。
第一步:获取设备ID
在芯步控制台的后台,找到已添加的出门开关设备,记录下唯一的 Device ID(例如:820720)。
第二步:发送开门指令
你可以使用任何支持HTTP请求的语言或工具。以下以 curl 命令和 Java 为例:
示例 1:使用 cURL 命令开门 (5秒自动关门)
示例 2:集成到你的门禁系统如果你在开发App或小程序,只需在你的后端或云函数中封装上述HTTP请求。当用户点击“一键开门”按钮,或通过人脸识别验证时,后端调用该接口即可。
第三步:接收状态反馈
除了主动控制,你可以利用接口查询设备当前状态,或配置回调来接收设备状态变化通知,实现门磁状态的实时监控。
4. 高级应用场景
利用开放接口,你不仅可以用App开门,还能实现以下联动:
第一种场景:酒店/办公室的“出门按钮”逻辑普通的出门开关是物理按钮,按下即断电。但利用86型智能开关,你可以实现自定义:需求:客人按出门开关退房,不仅开门,还要通知前台打扫。实现:物理按键按下 -> 开关触发状态变化 -> 你的服务器收到回调 -> 触发开门指令 -> 同时调用你的酒店PMS系统API生成保洁任务。
第二种场景:远程临时授权快递员按门铃 -> 你的App收到推送 -> 点击“临时开门” -> App调用芯步API:
{"point":"10000"}(通电10秒) -> 门锁打开,10秒后自动锁闭。第三种场景:定时任务办公室下午6点下班,你可以在后台设置定时任务,让开关在5分钟后执行一次
reset动作,自动锁门,防止有人忘记锁门。
5. 常见问题排查
设备离线
86型开关仅支持 2.4GHz Wi-Fi,不支持5G。检查路由器配置。
确认强电供电正常(零火线是否接反,部分型号可能需要零线)。
控制延迟或失败
检查签名算法,确保
ts(时间戳)与服务器时间误差在合理范围内。确认设备ID无误。
电锁不动作
万用表测量智能开关输出端电压。如果开关已动作但无电压输出,检查继电器是否烧毁(电锁电流过大)。
确认锁的类型:断电开锁 配合
power:0或reset;通电开锁 配合power:1或point。
6. 总结
通过对接芯步的86型WiFi出门开关,你可以将物理门禁无缝转化为云门禁。
核心步骤回顾
接线:开关串联在门禁电源与电锁之间。
配网:设备连接2.4G Wi-Fi。
调参:使用
reset(先断后通) 或point(先通后断) 命令匹配你的锁类型。集成:调用
https://api.thingboot.com/[AppID]/device/control/接口,实现远程、定时或联动控制。
这种方案大幅降低了门禁系统智能化的开发门槛,你无需关心底层通信协议,只需通过简单的HTTP请求,就能将传统门禁升级为云端可控的智能系统。