CATALOG

芯步的智能出门开关本质上是“可远程控制通断的继电器”,通过HTTP接口下发reset命令实现“短暂断电再自动恢复”的开门机制。以下方案涵盖硬件选型、接口对接、签名算法及联动控制逻辑。

一、 概述

在许多商业场景(如自助棋牌室、公寓民宿、办公室)中,需要将传统的门锁系统升级为远程可控的智能门禁。本方案基于芯步智能硬件产品及开放API接口,旨在通过简单的HTTP协议,快速实现单路远程出门控制开关与现有门禁系统的联动。

方案核心是利用“智能墙壁出门开关”直接控制电磁锁/电插锁的电源通断。通过调用芯步开放平台的reset(先断后通)命令,实现对门锁的精准、临时性断电开门,并具备比较高的响应速度和稳定性

二、 硬件选型与集成

1. 硬件

  • 产品名称智能墙壁出门开关(或智能触摸墙壁出门开关)

  • 推荐理由:该设备采用标准86型底盒设计,支持直接串联在电磁锁/电插锁的供电回路中。它支持断电开锁|通电上锁断电上锁|通电开锁两种模式切换,适配市面上绝大多数电锁

  • 通信方式:WiFi 2.4GHz,无需额外网关,直接通过网络连接路由器

2. 接线拓扑

  • 物理连接:将220V交流电或12V直流电源输入智能开关,输出端串联至电磁锁。

  • 网络连接:设备通过WiFi连接至互联网/局域网,与芯步云平台保持长连接。

  • 控制逻辑:服务器通过HTTP指令 -> 云平台 -> 智能开关继电器断开(门锁断电) -> 门体打开。

三、 开放接口对接详解

芯步开放了全功能的HTTP接口,支持任何具备网络请求能力的后端语言(Java, Python, PHP, Node.js等)或SaaS系统进行对接。

1. 接口通用信息

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方式POST

  • 数据格式JSON

2. 核心命令:先断后通

针对门禁控制场景,核心命令为reset(先断后通)。为了让人员通行并随后自动锁门,系统需要发送一个“断电脉冲”。例如:命令智能开关断开电路,5秒后自动恢复通电。

关键参数说明

  • device:设备ID(唯一标识硬件)。

  • order:控制指令。

    • reset: 立即断开电路(门开),等待指定毫秒后自动闭合电路(门锁重新上锁)

3. 签名机制

为了安全性,每次请求需携带签名。算法逻辑如下

  1. 获取AppSecret,进行一次MD5加密。

  2. 将加密结果拼接当前时间戳ts

  3. 对拼接后的字符串再次进行MD5加密,得到sign

  4. *公式:sign = md5( md5(AppSecret) + ts )*

4. 代码对接示例

以下示例演示如何控制设备ID为820720的智能开关,执行开门动作(断电5秒后自动恢复):

请求示例

逻辑说明芯步平台下发指令到设备的平均响应时间为80-120ms,几乎无延迟

四、 门禁联动逻辑实现

要完成一套完整的“门禁联动控制”,通常不仅仅是远程开门,还需配合传感器实现自动化。以下是两种典型的联动场景解决方案:

第一种场景:配合人脸/二维码门禁机

需求:用户扫脸成功 -> 门自动打开 -> 延时关闭。解决方案

  1. 对接流程:第三方门禁机在验证身份成功后,通过其内置的HTTP请求功能,调用芯步API。

  2. API调用:调用命令{"reset": 3000}(如设置延时3秒)。

  3. 结果:智能开关断开3秒 -> 电磁锁断电 -> 门体打开 -> 3秒后智能开关吸合 -> 门锁闭。

第二种场景:配合人体传感器实现无人自动落锁(安防增强)

需求:用户出门后,系统检测到人已离开,立即锁门;或检测到门长时间未关,自动告警并关门。解决方案

  1. 设备组合:智能出门开关 + 智能人体存在雷达传感器

  2. 联动逻辑(服务端实现)

    • 后端服务器接收到用户“开门请求”。

    • 执行{"reset": 10000}(长延时,防止用户进出被夹)。

    • 触发条件:人体传感器检测到“无人”状态持续30秒。

    • 联动动作:服务器主动向智能开关发送{"power": 0}指令,强制立刻上锁

五、 方案优势

  1. 极简改造:无需更换现有的电锁和门体结构,直接将智能开关串联入原电源线路即可,安装时间约10分钟

  2. 高可靠低延迟:得益于HTTP直连和优化的通信协议,指令下发至设备执行仅需80-120毫秒,用户体验极佳

  3. 开发友好:接口文档清晰,签名算法简单,通过简单的POST请求即可完成控制,开发难度极低,支持十分钟快速对接

  4. 定时与自动化:除了点动控制外,还支持定时任务。例如:每天晚上23:00自动发送{"power":0}强制锁门,防止未关门风险

  5. 多环境适配:支持公网和局域网通信。如果部署在内网环境且无需外网访问,可启用私有化部署模式,保障数据安全

六、 总结

通过对接芯步“智能墙壁出门开关”及开放API,开发者可以像调用本地函数一样控制远程门锁。只需一个HTTP请求,即可将传统门锁融入现代的SaaS管理系统,是实现共享空间、远程运维、办公室智能化最快捷、成本最低的方案之一。