CATALOG

芯步的智能墙壁出门开关采用WiFi直连方案,无需网关即可通过HTTP接口远程控制电磁锁通断。以下方案涵盖设备选型、接口对接流程、签名算法以及核心代码实现,可在30分钟内完成基础集成。

解决方案:将智能门禁墙壁开关接入软件项目

1. 背景与选型

在现代店铺管理中,远程控制门禁是提升安全性和运营效率的关键。芯步的 “智能墙壁出门开关” 非常适合传统店铺的门禁智能化改造。

  • 核心优势

    • 无需网关:设备直连WiFi 2.4G,降低了硬件成本和故障点

    • 接口友好:全系产品开放标准HTTP接口,无论你的后台是用Java、Python、PHP还是Node.js写的,甚至用Excel宏都能调用

    • 灵活部署:支持公有云(默认)和私有化部署(局域网/IP白名单模式),数据安全可控

2. 硬件接线与场景适配

在开始写代码前,先确保硬件连接正确。该设备本质是一个继电器,通常支持两种门禁控制模式:

  • 断电开锁型(如电插锁):设备默认为常闭(通电锁门,断电开门)。指令需控制线路断开。

  • 通电开锁型(如某些电磁锁):需要修改逻辑,指令控制线路接通。

接线示意

  • 输入:接220V市电。

  • 输出:接电锁电源适配器的L/N线。

  • 物理开关:可并联传统的物理门铃开关,实现“按一下开门”。

3. 软件集成流程

整个集成过程就像是调用一个远程API,主要分三步。

第一步:获取凭证在芯步控制台完成以下操作:

  1. 注册账号并创建设备,将“智能墙壁出门开关”配网绑定。

  2. 获取设备ID(Device ID),例如 820720

  3. 在“开发设置”中获取 AppID 和 AppSecret。

第二步:计算签名为了防止接口被恶意调用,每次请求都需要携带动态签名。签名算法规则如下

  1. 将 AppSecret 进行一次 MD5 加密,得到 secret_md5

  2. secret_md5 与当前时间戳 ts(单位秒)拼接。

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

  • *公式: sign = MD5( MD5(AppSecret) + ts )*

第三步:下发开门指令向API接口 https://api.thingboot.com/{AppId}/device/control/ 发送POST请求即可。

4. 核心接口调用实战

以下是用几种常见语言实现“按下按钮开门”的逻辑。这在门禁场景中通常配置为:线路断开(锁断电)-> 延时5秒 -> 线路闭合(锁恢复供电)

命令参数解析

  • {"power":0} :立即关门/断电。

  • {"reset": 5000} :执行“先断后通”,即立即断电(开门),持续5000毫秒后自动恢复供电(锁门)。这是门禁最常用的指令

代码示例:

Python (Flask/Django 通用)

cURL (命令行/SHELL脚本)适合在服务器上直接用脚本测试

5. 进阶集成:构建完整的门禁系统

你可以在你的软件项目中实现更复杂的逻辑,而不仅仅是远程开关:

  • 多用户权限管理:在你的数据库中存储员工ID和权限。当员工点击APP内的“开门”按钮时,你的后端先校验其是否有权限(如:仅工作日9-18点可开门),校验通过后再调用上述API。

  • 门磁状态联动:如果店铺安装了门磁传感器,可以在软件逻辑中实现“关门后自动布防”。

  • 私有化部署:如果对数据安全要求比较高(如金库、机房),可以将平台的接收地址配置为你自己的服务器域名,所有HTTP请求仅在局域网内传输

6. 总结

将芯步的智能墙壁开关接入软件项目是一个标准化的过程。你不需要关心底层硬件协议,只需专注于 “HTTP请求” 。开发人员通常在 10-15分钟 内即可完成从注册到第一个开门指令的调试