芯步的智能墙壁开关通过HTTP接口对外开放控制能力,使得单路门禁的远程控制、权限管理和自动化联动变得相当直接。以下方案从硬件选型、接口对接逻辑到典型场景,梳理了一套完整的接入路径。
解决方案:基于芯步开放接口的单路智能墙壁门禁开关接入方案
1. 概述与选型
对于单路门禁控制场景,核心需求通常是:远程开门、权限下发(可选)、以及断电保护机制。芯步提供的智能墙壁出门开关是此类场景的专用硬件。
推荐型号UNI-KG-CK (智能触摸墙壁复合出门开关) 或基础版智能墙壁出门开关。
核心优势
直接驱动:内置继电器,可直接控制电插锁、电磁锁、阴极锁等门禁锁具的通断电。
双模式支持:支持“通电开锁/断电闭锁”与“通电闭锁/断电开锁”两种模式,兼容市面上绝大多数锁具。
无需网关:设备直连2.4GHz WiFi,减少中间故障节点。
本地与远程结合:除了App远程控制,物理按键仍可直接控制开关,符合日常使用习惯。
在开始开发前,你需要准备:芯步开发者账号(获取AppID/AppSecret)、一台待接入的设备(获取Device ID),以及一个已连接互联网的2.4GHz WiFi环境。
2. 核心技术对接:开放接口详解
芯步采用标准的 HTTP POST 请求进行控制,签名机制保障了接口调用的安全性,无需复杂的SDK集成。
2.1 接口地址与鉴权
请求URL:
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法: POST
Content-Type: application/json
鉴权参数生成规则(关键步骤):
为确保通信安全,每次请求需携带动态签名。
参数
AppID: 平台颁发的应用ID。AppSecret: 平台颁发的应用密钥。ts: 当前Unix时间戳(秒)。
算法
step1 = md5(AppSecret)step2 = step1 + ts(字符串拼接)sign = md5(step2)简单来说,就是把AppSecret做一次MD5,拼上时间戳,再整体做一次MD5。
2.2 核心控制指令 (Order)
针对单路门禁开关,“通断”控制是最核心的操作。根据门禁需求的差异(如普通开关门、人员短暂通过),主要使用以下三个指令:
| 功能场景 | 命令字段 (Order JSON) | 说明 | 应用场景举例 |
|---|---|---|---|
| 即时通断 | {“power”: “1”} 或 {“power”: “0”} | 立刻改变继电器状态(1=接通/开锁,0=断开/闭锁)。 | 管理员远程开门、下班后闭锁。 |
| 定时通断 (点动) | {“point”: “3000”} | 先接通(开锁),延时N毫秒后自动断开(闭锁)。 | 最常用:访客按门铃,管理员远程按下“开门”键,锁打开3-5秒后自动锁上。 |
| 定时断通 (复位) | {“reset”: “3000”} | 先断开(闭锁),延时N毫秒后自动接通(开锁)。 | 用于特定断电开锁的门禁类型,或重启设备。 |
注:point和reset的单位为毫秒(ms),例如3000代表3秒。
3. 开发实施步骤
你可以利用任何支持HTTP协议的语言或工具(如Java、Python、PHP、cURL、Postman)来集成这些功能。
3.1 基础调用示例 (以cURL为例)假设需要实现“按下按钮,刷脸成功,门开3秒”:
3.2 高阶交互逻辑:状态保持功能
在某些写字楼或无人值守场景中,如果希望按下开关后门保持常开一段时间(例如搬运货物),可以利用高级命令参数,即“用户操作后自动恢复”。
通过该功能,你可以设定一个保持状态:若用户物理触碰开关打开门(或关闭门),系统会在设定的时间(如10分钟)后自动恢复到相反状态,防止门被遗忘打开。命令示例: {“power1”: {“keep”: “1”, “revert”: “600”}} (开门后保持10分钟,若期间有人手动关门,自动逻辑可依需求配置)。
3.3 局域网与高可用部署(私有化)
芯步开放接口的一个重要特性是支持私有化部署。对于对公网稳定性要求比较高的门禁系统,你可以打通自建消息服务器与设备的本地通信。设备支持在纯局域网环境下运行,即通过局域网IP直接调用接口,响应时延可降至10ms以内,且完全脱离外网依赖。
4. 应用场景与连接拓扑
在实际布线中,该设备通常串联在220V交流电回路中。
典型拓扑结构220V电源 --> 智能墙壁开关 (UNI-KG-CK) --> 12V/24V电源适配器 (或专用门禁电源) --> 电插锁/磁力锁
接线提醒:该开关输出的是干接点信号或通断信号。对于大功率的电磁锁,通过开关控制门禁专用电源的“PUSH”端(即控制信号输入端),而不是让开关直接承载锁具的大电流,以此延长设备寿命。
安全规格:工作电压100-250V AC,负载功率支持1000W(阻性负载),完全满足单路门禁需求。
5. 总结
通过对接芯步的单路智能墙壁开关,你可以将传统门禁升级为具备以下能力的物联网系统:
全渠道控制:支持物理按键、手机App、第三方平台(通过API)三端控制。
灵活的安全策略:利用
point指令实现标准的“点动开门”,利用私有化部署保障核心门禁数据的局域网安全性。极低开发门槛:仅需简单的HTTP请求和MD5加密即可完成对接,最快可在1小时内完成功能调试。