CATALOG

芯步的智能墙壁开关开放了标准HTTP接口,这意味着你可以通过简单的API调用,将门禁出门按钮的功能集成到任意软件项目中。下面从硬件选型、接口对接、到业务落地的完整流程展开说明。

解决方案:基于芯步开放接口的小区门禁远程出门控制系统

1. 概述与选型

在小区门禁系统中,传统的出门控制依赖于物理按钮(出门按钮)或室内分机。为了实现软件化管理(如APP一键开门、远程授权、定时开门),我们可以将芯步单路远程控制墙壁开关作为核心执行部件。

硬件选型:

  • 推荐设备:芯步 智能触摸墙壁开关1路智能墙壁开关1路

  • 介入方式:将原门禁系统的“出门按钮”接线柱并联或串联至该智能开关的继电器输出端。由于门禁系统的出门按钮通常是常开(NO) 干接点信号,智能开关接通时模拟短接,触发门禁控制器开门。

2. 技术原理与接口规范

芯步的设备开放基于 HTTP/HTTPS 的标准接口,无需复杂的SDK集成,支持任何主流编程语言(Java, Python, PHP, Go, C#等)

核心API端点:

  • URLhttps://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • Method:POST

  • Content-Type:application/json

关键参数解析

  • AppId:应用唯一标识(在芯步控制台获取)。

  • device:设备的唯一ID。

  • order:控制指令。

    • 对于单路开关,开门动作对应 order: {"power1":"1"}(接通电路)

    • 安全机制:为防止门磁损坏或长时间通电烧毁门锁,使用点动模式

3. “点动”模式配置(开门场景核心)

在开门场景中,我们不需要墙壁开关一直保持开启状态,而是需要模拟“按下按钮立即松开”的动作。芯步接口支持先通后断功能。

推荐指令若需要继电器接通1秒后自动断开(模拟手指按按钮1秒),指令如下:

注:1000 单位为毫秒(1秒)。这确保了门禁系统接收到脉冲信号,同时保护了门锁线圈

4. 软件项目集成步骤

为了使开发者在Web后端或云函数中快速调用,以下是具体的集成逻辑与代码示例(核心逻辑):

4.1 签名计算

在调用API前,必须计算签名以验证身份。芯步的签名算法为:sign = md5(md5(AppSecret) + ts)

流程示例(伪代码逻辑):

4.2 核心开门函数

开发者需要在后端服务中集成以下逻辑:

5. 高级应用与设计

5.1 结合传感器实现自动化

参考芯步的传感器产品手册,可以构建更智能的系统

  • 场景:消防联动。当烟感传感器检测到烟雾时,服务器自动调用上述开门接口,打开单元门锁,便于居民疏散。

  • 实现:服务器接收传感器上报的报警消息 {"smoke": 1},触发预定义的规则引擎,调用控制接口。

5.2 局域网与私有化部署

对于小区物业管理,网络稳定性至关重要。芯步设备支持 WiFi 2.4G 直连,且接口支持私有化部署(纯局域网环境)

  • :如果小区网络环境允许,将API请求地址指向局域网内的本地服务器IP,降低开门延迟(实测可在80-120ms内响应),并避免因公网断网导致无法开门

5.3 代码封装示例(JavaScript / Node.js)

适用于小程序或Web管理后台:

6. 注意事项与故障排查

  1. 接线安全

    • 芯步的墙壁开关用于控制强电(220V)。在接入门禁系统(通常为12V或24V弱电)时,请确认开关的继电器是无源干触点,或者正确接线。

    • :如果控制弱电信号,无需接零火线(L/N),只需将门禁的“出门按钮”两根线接到开关的COM和NO端,并确保开关供电正常。

  2. 状态同步

    • 由于使用了“先通后断”的点动指令,开关状态会在1秒后自动恢复为“关”。软件系统中无需额外发送关闭指令,只需请求一次即可。

  3. 超时设置

    • 在HTTP客户端设置连接超时时间为5秒。在WiFi信号弱的角落,设备响应可能延迟

通过以上方案,开发者可以快速将传统门禁系统升级为云控门禁,不仅能实现手机APP一键开门,还能方便地进行权限下放和出入记录统计。