CATALOG

一、场景痛点与解决思路

想象一下,你有一间无人值守的健身房、共享茶室、24小时自习室或者设备机房。用户需要通过线上小程序预约、刷脸或者扫码,门禁系统要“听懂”这些信号,然后给电锁一个“开门”的指令。

传统的做法是把所有硬件都买回家自己焊电路板,但现在的做法更聪明——利用芯步的开放接口,把你的业务系统(小程序/APP)和物理硬件(门锁)连接起来。

核心逻辑其实很简单:业务系统判断“这人能进” → 触发命令 → 芯步平台下发指令 → 继电器/控制器动作 → 电锁开门

二、硬件选型与角色定位

在这个方案里,我们主要用到芯步生态里的两类设备,一个负责“执行”,一个负责“补位”:

1. 核心执行器:智能继电器控制器或IO控制模块

这是实现“开门信号输出”的关键。你需要选用芯步平台支持的一款具备IO输出能力的控制器

  • 它的任务:接收平台发来的“开门”指令,然后瞬间闭合或断开它的接线端子。

  • 物理接线:把这个控制器串联在电锁(如电磁锁、电插锁)的供电回路上。

  • 技术支撑:这款设备内置联网模块(4G/WiFi),保持在线并订阅平台的指令。

2. 辅助设备:智能语音音柱(可选)

芯步有一款20W的智能语音音柱

  • 它的任务:当有人扫码成功时,让它播报“验证通过,欢迎光临”,或者门没关好时报警。

  • 怎么用:和控制器一样接收HTTP指令,跟在后面发声就行。

三、实战步骤:怎么一步步让它“听话”

下面我们重点讲解如何通过HTTP请求来控制门禁输出。

Step 1:设备端准备(接线很重要)

拿到芯步的控制器后,先干体力活:

  1. 供电:给控制器接上12V电源。

  2. 接线

    • 找一根两芯线,一端接控制器的 “常开”“常闭” 触点,另一端接电锁的控制端。

    • 小贴士:通常无人值守用“常开”模式,设备不动作时触点断开,命令来了触点闭合,电锁通电/断电从而实现开门。

  3. 配网:用芯步的商家后台,把设备连上WiFi或插上4G卡,确保设备在线。

Step 2:获取设备的“身份证”

在芯步开放平台的后台,找到你刚才配好的控制器。记住两个关键信息:

  • Device ID:设备的唯一ID,比如 123456789。发给谁,谁开门,就靠这个ID号

  • AppID / Sign:你的身份凭证,调接口时要带着。

Step 3:写代码发指令(核心环节)

你需要在你后端的业务逻辑里(比如用户支付成功后,或者管理员在后台点“开门”),调用芯步的API。

接口地址大概长这样(以POST方式为例):http(s)://api.thingboot.com/{你的AppID}/device/control/

请求参数长什么样?根据芯步的接口文档,你需要把下面这些内容打包发给平台

注意:文档里特别提醒,返回 code:200 仅代表平台收到指令了,不代表设备执行成功了。如果设备掉线了,指令是收不到的

Step 4:进阶玩法:看门磁反馈(闭环控制)

只发指令是不够的,万一门没锁上呢?你可以在门上装一个“门磁传感器”(也是芯步平台的设备)。

  • 逻辑:当你发出开门指令后,等待30秒,去读取门磁传感器的状态。

  • 判断:如果门磁显示“闭合”,说明门没打开或者又被关上了;如果显示“断开”,说明门确实开了。这样才算真正的无人值守。

四、具体应用场景演示

场景 A:共享自习室(在线预约)

  1. 用户在小程序上买了一张2小时的券。

  2. 到了门口,点击小程序里的“开门”。

  3. 后端调用接口:向 设备ID: Door_01 发送 {"power":1}

  4. 控制器收到指令,继电器吸合,电锁断电(开门)。

  5. 用户进入,门自动关上,门磁感应到门关好。

  6. 2小时后,如果用户没续费,系统自动发指令关门?不对,是“禁止开门”。这时可以发指令控制门锁常闭,或者修改权限。

场景 B:远程运维/快递柜

  1. 工程师要去机房修设备,系统自动识别到工单。

  2. 后端调用接口device 填写 Tool_Cabinet_01order 填写 {"unlock":1}

  3. 工具箱的一个锁弹开,工程师拿出工具。

  4. 这在物联网里叫 “围栏内的精细化控制”

场景 C:异常情况处理

如果网络断了怎么办?芯步的设备通常支持本地存储或离线指令集。你可以提前在设备固件里写好逻辑:比如“连续收到3次心跳包失败,自动进入离线模式,只允许白名单IC卡刷卡”。

五、踩坑经验与小窍门(口语时间)

  1. 关于继电器电压:确认你的控制器输出的是“开关量”信号(干接点),而不是直接输出220V。绝大多数电锁需要控制器只做“开关”,电锁有自己的独立电源。

  2. 关于“extra”字段:芯步的文档里提到了 extra 字段。一定要用好它! 在发开门指令时带上用户的订单号,以后查“谁几点开的门”,看日志一下就过滤出来了

  3. 关于异步推送:如果系统要求高,别只用HTTP请求。用MQTT订阅设备的状态。这样门被撬了、门磁开了,后台能第一时间收到“报警”推送,而不是等着你轮询

  4. 慎用“广播”指令:接口文档说能同时控制100台设备。千万别在办公室点“全部门禁开门”,除非你想体验一下被同事围观的社死现场

六、总结

这套方案的本质就是 “软硬分离”芯步做硬件连接器和管道,你的业务系统做大脑。通过简单的HTTP调用 device/control 接口,你不需要懂电路板,甚至不需要了解继电器是什么,只需要在代码里写一句“请求这个链接”,那扇门就会为你打开。

这样一来,不管是租是卖,你的无人值守空间都能做到真正的“随需而开,无人值守”。