CATALOG

芯步的智能墙壁开关通过HTTP接口对外开放控制能力,使得单路门禁的远程控制、权限管理和自动化联动变得相当直接。以下方案从硬件选型、接口对接逻辑到典型场景,梳理了一套完整的接入路径。

解决方案:基于芯步开放接口的单路智能墙壁门禁开关接入方案

1. 概述与选型

对于单路门禁控制场景,核心需求通常是:远程开门、权限下发(可选)、以及断电保护机制。芯步提供的智能墙壁出门开关是此类场景的专用硬件

  • 推荐型号UNI-KG-CK (智能触摸墙壁复合出门开关) 或基础版智能墙壁出门开关

  • 核心优势

    • 直接驱动:内置继电器,可直接控制电插锁、电磁锁、阴极锁等门禁锁具的通断电。

    • 双模式支持:支持“通电开锁/断电闭锁”与“通电闭锁/断电开锁”两种模式,兼容市面上绝大多数锁具

    • 无需网关:设备直连2.4GHz WiFi,减少中间故障节点

    • 本地与远程结合:除了App远程控制,物理按键仍可直接控制开关,符合日常使用习惯。

在开始开发前,你需要准备:芯步开发者账号(获取AppID/AppSecret)、一台待接入的设备(获取Device ID),以及一个已连接互联网的2.4GHz WiFi环境。

2. 核心技术对接:开放接口详解

芯步采用标准的 HTTP POST 请求进行控制,签名机制保障了接口调用的安全性,无需复杂的SDK集成

2.1 接口地址与鉴权

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

  • 请求方法: POST

  • Content-Type: application/json

鉴权参数生成规则(关键步骤):

为确保通信安全,每次请求需携带动态签名。

  1. 参数

    • AppID: 平台颁发的应用ID。

    • AppSecret: 平台颁发的应用密钥。

    • ts: 当前Unix时间戳(秒)。

  2. 算法

    • 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毫秒后自动接通(开锁)用于特定断电开锁的门禁类型,或重启设备。

注:pointreset的单位为毫秒(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. 总结

通过对接芯步的单路智能墙壁开关,你可以将传统门禁升级为具备以下能力的物联网系统:

  1. 全渠道控制:支持物理按键、手机App、第三方平台(通过API)三端控制。

  2. 灵活的安全策略:利用point指令实现标准的“点动开门”,利用私有化部署保障核心门禁数据的局域网安全性。

  3. 极低开发门槛:仅需简单的HTTP请求和MD5加密即可完成对接,最快可在1小时内完成功能调试。