共享茶室的痛点在于“远程授权+安全管控”的平衡——用户需要无感开门,商家需要防止逃单和超时占用。以下方案基于芯步开放接口,设计了一套从订单生成到退租清理的全自动门禁控制流程,重点解决电磁锁与预约系统的联动逻辑。
1. 背景与目标
在共享茶室(无人值守)的运营场景中,包间预约系统与门禁硬件的联动是实现无人化运营的核心环节。本方案的目标是利用芯步的开放 API 接口与智能硬件(主要是 WiFi 智能出门开关/智能控制器 与 电磁锁),解决传统“单机密码锁”密码泄露、人工核销效率低等问题。
核心目标:
自动化: 用户线上下单支付后,系统自动授予该时段的开门权限。
安全性: 订单结束后自动断电解锁(锁门),防止超时占用。
可追溯: 门禁动作与订单绑定,硬件状态云端实时监控。
2. 解决方案设计
[图:用户小程序 -> 云端业务系统 -> 芯步开放平台 -> 智能出门开关 -> 电磁锁]
本方案将采用 “电插锁/电磁锁 + 智能出门开关” 的组合模式。
电磁锁/电插锁:安装在门框上,承受剪切力,断电即开(符合消防规范)。
智能出门开关:芯步核心控制部件,负责接收云端指令,切断或接通电磁锁的电源。
| 层级 | 实现方案 | 功能描述 |
|---|---|---|
| 用户层 | 微信小程序 / H5 | 展示空闲时段、发起预约、支付押金、点击“开门”按钮 |
| 业务层 | 商户 SaaS 系统 | 订单管理、时段校验、生成临时 Access Token |
| 接入层 | 芯步开放 API | 接收业务系统指令,通过 MQTT/HTTP 协议向设备下发控制指令 |
| 设备层 | 智能出门开关 + 电磁锁 | 执行“断电”(开门)与“通电”(锁门)的物理动作 |
3. 硬件选型与接线
根据芯步产品库,推荐以下硬件组合:
智能 WiFi 墙壁出门开关
作为控制中枢。它继电器的常闭(NC, Normally Closed) 触点串联在电磁锁的 12V 电源线上。
逻辑:设备默认上电状态下,继电器吸合,NC 端导通,门锁闭;设备收到“开门”指令时,继电器断开,NC 端切断电流,门锁打开 。
电磁锁 / 电插锁
选购标准 12V 或 24V 锁具,安装在包间门体上。
接线逻辑:将电源适配器接入智能出门开关的输入端,将电磁锁的正负极接到智能出门开关的常闭(NC, Normally Closed)输出端。旁路安装:保留室内的物理出门开关按钮(并联),方便用户内部出门。
4. 接口对接与业务逻辑流程
本方案详细描述从“用户下单”到“订单结束”的完整数据流。
4.1 准备工作
在芯步控制台中获取:
AppID 和 AppKey:用于生成签名(sign)和时间戳(ts)。
设备ID (device):现场安装的智能出门开关的唯一标识 。
4.2 核心编码:开门动作
共享茶室的核心技术难点在于 “限时授权” 。结合芯步的指令特性,我们可以利用 reset(先断后通)命令来实现“开门一段时间后自动恢复锁闭”的功能,或者直接控制 power 状态。
场景 A:用户到达,预约有效
用户在小程序端点击“开门”。
业务服务器校验订单(时间是否在预约时段内、支付是否完成)。
业务服务器调用芯步开放 API:
https://api.thingboot.com/{AppID}/device/control/
注:官方文档提到,使用 reset 命令可实现“先断后通”,非常适合门禁场景:给予10秒(10000毫秒)的推门时间,之后自动吸回锁闭,无需额外调用关闭指令 。
场景 B:订单即将结束 / 超时
系统检测到用户订单时间耗尽。
若用户未续费,系统需要强制结束。
由于门锁通常处于通电锁闭状态(
power=1),为了阻止用户在非授权时段继续停留在室内,系统可以发送power=1指令(确保门锁闭),但这其实是一直保持的状态。更佳策略:在订单结束后,不发放新的开门权限。同时,如果门被强行打开(如通过室内开关),系统需触发警报或记录。但物理上,只要电磁铁吸合,没有外力或断电是打不开的。
物理逻辑:默认情况下,智能开关保持常闭(NC)导通 -> 电磁铁有电 -> 门强力锁闭 -> 用户无法进入。
4.3 场景扩展:设备联动与节能
结合芯步的多路控制器,可以实现“开门即通电”的体验。例如使用 4路智能控制器
第1路:控制门禁电磁锁(断电开门)。
第2路:控制包间灯光。
第3路:控制茶台插座。
联动指令:当用户点击“开门”时,业务系统不仅发送开门指令,可在稍作延迟后发送:
当用户点击“结束订单”或系统检测到超时后,发送 power2/3/4 为 0 的指令,自动断电,节省能耗 。
4.4 安全与异常处理
离线缓存:当 WiFi 信号不稳定时,智能出门开关具备本地缓存能力。由于电磁锁默认是通电吸合状态,网络波动不会导致门锁异常弹开,这保证了财物安全。
手动开门(反锁):室内必须安装物理出门开关(干接点)。当用户按下时,物理短接 NC 线路,门打开。这与云端控制并联,互不影响。
异常订单处理:当用户超时且联系不上时,后台管理员可在商户端直接调用
device/control接口,发送power=0试图开门清场,或发送power=1确保牢牢锁住。
5. 实施步骤概要
硬件安装:在茶室包间门框安装电磁锁,墙体安装 86 盒智能出门开关。将电磁锁电源线接入智能开关的 常闭(NC) 与 公共端(COM)。
配网绑定:使用“芯步”小程序或控制台,将智能开关连接至现场 2.4G WiFi,获取设备 ID。
接口开发
在芯步开放平台创建应用,获取 AppID/AppKey。
编写后端逻辑:预约成功 -> 记录时段。在用户点击“开门”时,生成签名并调用控制 API 下发
reset指令。
逻辑测试
测试用例1:支付成功的用户点击开门,电磁锁断开10秒,门能推开,10秒后自动吸回。
测试用例2:订单结束后,用户再次点击开门,系统校验失败,不调用 API 或调用锁闭 API,门不可开启。
6. 总结
基于芯步开放的 API 接口和稳定的 “智能出门开关+电磁锁” 组合方案,共享茶室能够实现高性价比、高稳定性的无人值守管理。得益于芯步 reset(先断后通) 等特色指令,开发者无需维护复杂的定时任务即可实现门禁的自动复锁,极大地缩短了开发周期并提高了系统的鲁棒性 。