CATALOG

芯步的智能硬件通过HTTP接口开放控制能力,可以将任意编程语言(Python、Shell、Node-RED等)与门禁执行设备对接。以下方案以创客工坊为场景,展示如何用几行代码实现远程开门、扫码开闸等控制逻辑。

—— 基于芯步开放接口的开门信号输出控制

一、 背景与需求

在创客工坊的日常运营中,门禁管理通常面临以下几个痛点:

  1. 人员流动性大:工坊成员、学员、访客频繁出入,传统钥匙或固定密码难以管理且存在安全隐患。

  2. 自动化需求高:创客空间常需要无人值守时段(如24小时共享模式),需要授权用户通过扫码、远程或刷卡自主进入。

  3. 集成灵活性:工坊内已有各类创客自制系统(如人脸识别门禁、Telegram机器人),需要一个标准化的“执行末梢”来真正控制门锁通断。

解决方案核心:利用芯步智能墙壁出门开关智能4路控制器作为执行机构,通过其全面开放的HTTP接口,将任意身份识别系统(二维码、刷卡、手机App)与物理门锁(电磁锁/电插锁)连接起来。

二、 解决方案架构

本方案采用“身份识别层 —— 云/本地API网关 —— 执行层”的轻量级架构。

  • 身份识别层:可以是工坊自建的基于树莓派的人脸识别门禁、ESP32扫码枪、小程序“一键开门”按钮,甚至是一个简单的Shell脚本。

  • 控制核心芯步智能硬件。它接收HTTP指令,内部继电器通断,从而控制门锁电源。

  • 执行设备:电插锁、电磁锁或阳极锁。

架构流程图

用户触发(扫码/按键) -> 工坊服务器/云端脚本 -> 调用芯步HTTP接口 -> 智能墙壁开关 -> 继电器吸合(断电) -> 电磁锁打开 -> 延时自动上锁

三、 硬件选型:开门信号的输出执行

针对“开门信号输出”这一核心需求,推荐以下芯步设备:

设备类型推荐型号/品类选型理由控制方式
智能墙壁出门开关86型智能通断器- 直接替换:直接安装在86底盒中,控制门锁电源的通断。- 接线简单:支持“断电开锁”或“上电开锁”两种模式,适配各类锁具。- 无损改造:不需要破坏原有门禁线路。干接点信号/直接控制220V或12V锁具电源
智能4路控制器4路网络继电器- 多路控制:如果工坊有多个门(正门、工具间、耗材室),一台设备可以控制4个门。- 逻辑灵活:可独立控制每一路输出。开关量信号

创客:购买时注意锁具的电压。如果是12V电插锁,请选择对应电压版本的控制器,或通过中间继电器转接。

四、 接口对接详解:如何下发“开门”指令

芯步的核心优势在于HTTP API接口极其简单,开发者无需阅读复杂的SDK文档,只需掌握POST请求即可。

1. 接口准备

  • AppId 与 AppSecret:在芯步控制台获取,用于身份认证。

  • Device ID:设备的唯一编号(如:820720)。

  • 签名算法:为了安全,接口采用动态签名 sign = md5( md5(AppSecret) + ts )

2. 开门指令逻辑

物理原理:通常默认情况下,电磁锁处于“通电上锁”状态。为了开门,需要断开锁具的电源(或触发开门按钮信号)。

对应命令:发送reset命令(先断后通),即:断开电源(开门) -> 等待N秒 -> 自动恢复供电(锁门)

JSON命令示例

注:如果是控制点动开关(如卷帘门),可使用 point 命令(先通后断)。

3. 代码实现示例

对于创客工坊,以下是几种最实用的集成方式:

场景A:树莓派/Python接入(适用于人脸识别门禁)

场景B:Shell脚本(适用于服务器脚本触发)如果你想通过命令行直接开门,或者在Node-RED中执行,可以使用curl

场景C:低代码/Node-RED(适合可视化编程)

  1. 拖入一个“HTTP Request”节点。

  2. 设置Method为POST,URL填入带签名的时间戳地址。

  3. Body部分填入JSON格式的order命令。

  4. 连接到一个注入节点,点击即开门。

五、 典型创客场景应用

场景1:微信/钉钉机器人远程开门

  • 需求:成员忘带钥匙,通过群聊发送指令开门。

  • 实现

    1. 部署一个简单的Flask或Node.js服务,接收钉钉/微信的消息回调。

    2. 验证发送者身份(确认是群内成员)。

    3. 身份验证通过后,服务端执行上述场景B的代码,调用芯步接口。

    4. 门禁继电器动作,门打开。

场景2:二维码扫码入园(无人值守)

  • 需求:会员在工坊小程序购买月卡后,获得临时二维码,扫码开门。

  • 实现

    1. 前端:用户微信小程序展示动态二维码。

    2. 后端:工坊服务器部署扫码枪(或手机摄像头识别),识别到UID后查询数据库权限。

    3. 执行:权限有效 -> 触发芯步接口 {"reset":3000} -> 门开3秒。

    4. 安全机制:利用芯步接口的快速响应(80-120ms),几乎无延迟,体验良好。

场景3:叠加双因素认证(人脸+工牌)

  • 需求:贵重工具间需要双重验证。

  • 实现

    1. 连接两个识别设备(如:摄像头识别到特定人脸 + RFID读到特定卡)。

    2. 逻辑判断采用“与”门。

    3. 满足条件时,仅执行一次HTTP调用。

    4. 特点:芯步支持多设备管理,同一套代码可以控制工具间门,也可以控制工坊大门。

六、 高级功能与优势

  1. 超低延迟与稳定性:从云端指令下发到设备执行,典型耗时为80-120ms。这意味着在工坊局域网环境下,甚至可以直接通过局域网IP控制(需局域网模式),不受外网波动影响。

  2. 定时任务:不需要在创客服务器上跑复杂的Cron任务。

    • 例如:{"reset":3600000} 可实现按一下按钮,门开1小时,适合搬运大型设备进出,时间到后自动锁闭。

  3. 功率计量(进阶) :如果门禁接入了大功率电锁或工坊总电,可以通过接口实时读取电流/电压,监测门锁是否损坏或工坊总功率是否超限。

七、 总结

通过对接芯步智能墙壁出门开关及其HTTP API接口,创客工坊可以在30分钟内完成一套智能门禁系统的搭建。

  • 投入成本低:仅需一个智能开关 + 一个旧电磁锁 + 一台能联网的电脑(树莓派)。

  • 代码门槛低:无需学习复杂的MQTT协议,简单的curl POST命令即可实现核心的“开门信号输出”。

  • 扩展性强:无论未来工坊引入人脸识别、指纹识别还是脑机接口,最终都可以转化为那一行{"reset":5000}的JSON数据,通过芯步的接口驱动门锁动作。

在工坊内的“物联开发工作台”常备一个芯步的测试开关,配合其开放的API,它可以成为几乎所有物联网创客项目的“万能执行终端”。