CATALOG

芯步的开放接口支持通过HTTP/MQTT向设备下发指令,你可以利用这个能力把“出门按钮”和整套门禁系统联动起来——不管是简单接线、接无线开关,还是做成小程序里的虚拟按钮,都可以按需实现。下面聊聊几种集成方式。

一、 这活儿到底是干啥的?

说白了,门禁系统分“进门”和“出门”两头。

  • 进门:比较严格,需要刷卡、刷脸或者输密码,确认“你是谁”。

  • 出门:一般比较简单,按一下按钮就开了,主要是为了方便里面的人快速出去,不需要再掏卡验证。

我们要解决的问题就是:怎么把一个“触摸式按钮”的点击动作,变成让锁打开的指令?

二、 硬件接线方案:最简单粗暴的玩法

如果你的项目还在布线阶段,或者你有机会接触门禁控制器的电路板,直接接线是最稳、最快的方式。

实际上,芯步的智能硬件(比如门禁主板或网关)上,通常预留了物理的输入接口(GPIO口或者特定的“开门信号”端子)。

怎么接?

  1. 找接口:找到你芯步设备上的“出门按钮”接口(通常标注为 PUSHBTN,或者是一组 COM/NO 常开触点)。

  2. 接线:普通的机械按钮接这两根线就行。我们的触摸式按钮虽然看起来高科技,但背后本质也是一个“干接点”信号。把触摸按钮的“输出端”接到门禁主板的“出门信号端”即可。

  3. 设置:在芯步的设备后台,把这个IO口的功能设置为“本地开门”。

效果:有人摸一下那块触摸板,电路瞬间导通,门禁系统收到信号,“咔哒”一声,锁就开了。这种方式的优点是不依赖网络,断了网也能按。

三、 软件/API集成方案:网络远程玩法

有些时候,线已经布好了,没法再拆墙重新接物理按钮。或者你的触摸按钮离门禁控制器很远(比如你在前台电脑旁放一个按钮,控制大门口的门)。

这时候就要用到芯步的开放接口了。这时候的“触摸按钮”,其实是一个发送指令的发射器

你需要准备以下“食材”:

  1. 一个联网的控制端(比如带触摸屏的树莓派、平板电脑,或者一个连接了触摸传感器的开发板如ESP32)。

  2. 芯步的设备接口权限(AppID/AppSecret)。

  3. 被你控制的智能门锁/门禁控制器

核心原理

触摸按钮触发 -> 控制端程序捕获信号 -> 调用芯步API下发开门指令 -> 门开了。

详细步骤

第1步:拿到你的“指挥权”(接口凭证)先去芯步开放平台的控制台,拿到你的 AppIDAppSecret。这是你调用API的身份证。

参考官方文档:设备 - 向设备下发指令

第2步:搞定你的触摸硬件(也就是那个“开关”)这里分两种情况:

  • 情况A:你买的是现成的“智能触摸开关”如果这个开关本身就是芯步生态里的,那就很简单了。你只需要在后台设置一个“联动”:当检测到按键事件(事件),执行向门禁设备下发开门指令(动作)。

  • 情况B:你用的是普通的触摸传感器(比如一个电容式触摸模块)你需要写一点点代码了。比如用一个Arduino或ESP32连接触摸传感器。

    • 逻辑就是:if (触摸信号 == 真) { 发起HTTP请求; }

    • 代码核心逻辑:当检测到触摸,你的设备需要向芯步的服务器发一个请求。

第3步:构造API指令(让设备动起来)当你触摸按钮时,你的控制端(比如一台电脑或一个单片机)需要向这个地址发请求:

请求参数大概长这样:

  • device: 你要开的那个门的设备ID(在芯步后台能查到)。

  • order: 这个命令告诉锁该干嘛。如果你们的门禁设备协议里开门命令是 {"relay":"pull"}(继电器吸合),那你就传这个。

  • sign: 为了安全,需要加密签名,防止有人随便调接口把门开了

如果你用Python写一个简单的脚本(伪代码逻辑):

第4步:给按钮加个“壳”如果你觉得用代码控制太“极客”了,想工程化一点。芯步支持 MQTT协议你把触摸按钮连上网络,当触摸事件发生时,向MQTT服务器发布一条消息:

  • 发布主题api/{AppID}/device/control

  • 消息内容{"device":"xxx","order":"开门"}

这种方式响应极快,适合对延迟要求高的场景。

四、 另一种省钱/省事的思路:改造“出门”场景

其实芯步的设备很多时候是联网的,你们有手机APP吗?

既然都用API了,其实根本不用焊电路:你可以直接利用芯步的接口,做一个手机上的虚拟触摸按钮

  1. 买个那种带触摸屏的智能音箱(或者直接用手机/平板)。

  2. 开发一个简单的Web页面,上面画一个大大的圆形按钮。

  3. 把这个页面挂在大厅的墙上。

  4. 离开的人摸一下屏幕,网页触发JS,调用上面的API。门开了。

这种方式的好处是:零布线,谁摸一下都行,而且你可以加权限(比如只有特定时间段才响应触摸,或者记录谁按过)。

五、 写给你的避坑指南

根据我看到的资料 ,有几个地方你调试时可能会卡住,提前打个预防针:

  1. 异步问题API返回“200”只代表芯步的云平台收到指令了,不代表锁真的开了。如果门没反应,别急,先去查设备是否在线,或者MQTT消息推送里的执行结果

  2. 触摸灵敏度如果你自己DIY触摸模块,注意防水和干扰。用手指按没事,但下大雨或者旁边有强电线,可能会误触。在程序里加个“去抖动”延时,或者设置成“长按1秒才开门”,防止路过一只猫门就开了

  3. 安全第一出门虽然主要是方便,但也得防着坏人。如果是高安保区域,最好别只靠一个简单的触摸开关。可以配合芯步的门磁传感器,检测到门是在“里面”被触摸的才放行,或者开门后立马自动再锁上。

总结一下怎么选

  • 如果门禁控制器就在门旁边,且能拆开接线:直接把触摸按钮的两根线接到PUSH和GND上。成本最低,最稳定。

  • 如果触摸按钮距离门很远(比如远程开门):买个ESP32接上触摸板,烧录代码调用芯步的API/发MQTT指令。可玩性最高。

  • 如果只是想偷懒不想动手:用平板做个H5页面,调用接口。最优雅,适合极简装修。