共享茶室的痛点是:如何在无人值守的情况下,让用户只控制自己预定的包厢,同时实现照明和门禁两套系统的独立管理?以下方案基于芯步开放接口,给出从硬件选型到接口调用的完整技术路径。
解决方案:基于芯步开放接口的共享茶室2路独立线路控制系统设计
1. 项目概述与目标
在共享茶室场景中,最核心的痛点是空间的私密性与能源的自动化管理。本方案的目标是利用芯步的智能硬件与开放API接口,解决传统茶室改造中的“一呼百应”问题(即一个开关控制全屋)。我们将专注于实现针对单个包厢内的两路独立线路的精准控制:
第一路(L1):照明与插座线路(为主照明、烧水壶等常规电器供电)。
第二路(L2):门禁专用线路(为电磁锁或门磁供电,实现订单开始供电开锁,订单结束断电闭锁)。
2. 硬件选型与线路规划
要实现两路独立控制,关键在于选择合适的控制器。传统的单路通断器无法满足“照明开、门禁关”或“照明关、门禁开”的差异化需求。
推荐硬件组合:
| 设备类型 | 推荐型号/系列 | 核心作用 | 芯步对接优势 |
|---|---|---|---|
| 核心控制器 | 芯步 2路/4路智能通断器 (WiFi版) | 接入包厢配电箱,作为L1、L2线路的总开关 | 支持标准HTTP API指令下发,毫秒级响应 |
| 门禁执行 | 12V磁力锁/电插锁 | 物理锁门 | 需通过控制器L2线路配合12V电源转换模块使用 |
| 状态感知 | 智能人体存在传感器 | 检测无人自动断电(节能) | 支持状态实时上报,联动控制逻辑 |
| 网络层 | 商用2.4G路由器 | 保障设备在线 | 硬件直连WiFi,无需额外网关 |
线路规划方案:在包厢的入户配电箱处进行线路改造:
总闸之后:将包厢进线分为两路。
L1线路(受控照明/插座):火线进智能控制器的“输入1”,出线接原包厢灯路和茶台插座。
L2线路(受控门禁):火线进智能控制器的“输入2”,出线接门禁电源(12V转换器)。
注意:为了实现“断电开锁”或“通电开锁”,需根据锁型调整继电器逻辑。通常共享场景选用“通电开锁”,即控制器L2通电,门锁吸合;订单结束,L2断电,门锁断开。
3. 控制逻辑与流程设计
本方案的核心在于软件层如何通过API调动硬件。芯步的开放平台允许用户将设备ID与业务系统(小程序/公众号)绑定。
场景时序图逻辑:
用户下单(空闲状态)
状态:L1 = 关(灯灭、插座无电);L2 = 关(门锁吸合/打不开)。
订单支付成功
业务服务器调用芯步API。
指令
POST /device/control,{"device":"包厢设备ID","order":{"power":1}}(针对L2线路)。动作:L2 线路接通 -> 门禁电源得电 -> 电磁锁吸合 -> 门可拉开。
可选:同时下发开门语音提示。
用户进入包厢
用户手动按压门框上的物理开关(或通过小程序)触发L1线路。
指令
{"device":"包厢设备ID","order":{"power":1}}(针对L1线路)。动作:照明亮起,插座通电(茶壶可烧水)。
使用中(续费与倒计时)
采集端:利用芯步传感器检测“是否有人”。若无人且订单未结束,可自动切断L1节能,保留L2门禁。
订单结束(或超时)
业务服务器发送批量指令:
指令1
{"device":"X","order":{"power":0}}(关L1照明)。指令2
{"device":"X","order":{"power":0}}(断L2门禁)。结果:屋内断电,门锁断电失效(处于可由外拉开或闭合但无法吸合状态)。
4. 关键接口开发详解(技术对接部分)
为了实现上述“两路独立控制”,开发人员在对接芯步Open API时,需注意设备物模型的区分。
根据芯步技术规范,对于多路控制器,接口调用示例如下:
1. 接口配置
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/认证方式:Signature签名 (MD5/HTTPS) + Timestamp
2. JSON指令示例(独立控制两路)假设设备ID为 123456,且具备两路独立继电器:
(注:具体控制参数如ch1_status或power需依据芯步控制台提供的设备产品定义文件为准,但逻辑上是支持多路独立寻址的)
3. 状态同步机制
轮询/推送:芯步支持消息推送。当用户物理关闭开关时,硬件会向服务器报告当前状态。
应用:如果用户按了墙上的物理关闭按钮,业务系统应立即收到回调,更新小程序前端显示“照明已关”,避免状态不同步。
5. 方案实施优势
布线简单,免网关:芯步硬件直接走WiFi 2.4G连接,在装修后的茶室改造中,无需重新铺设弱电控制线,极大降低了施工成本 。
高性价比独立控制:通过一个多路模块替代两个单路模块,减少了硬件采购成本和配电箱空间占用。
安全冗余:如果网络断连,用户依然可以通过手动操作控制器上的物理按键(若具备)来控制L1照明,而L2门禁系统可配置为“断电常开”模式,防止烧水干烧或人员被困 。
6. 防故障与异常处理
防误关机制:L2门禁线路在订单结束后必须强行断开。但需在程序中设置“缓冲期”:当传感器检测到L1线路(照明)仍在亮且有人移动时,系统应仅向APP推送“是否强制结束”的提醒,而非直接拉闸断电,以免用户摸黑。
电器保护:L1线路控制的茶桌插座若连接大功率烧水壶,利用芯步的API可实现“订单余额不足5分钟时,禁止L1线路关闭,直至倒计时归零”,防止用户手机没电或来不及关火。
通过上述方案,共享茶室运营者可以轻松实现一个App/后台管理所有包厢,用户扫码即可通电开门,离店自动断电锁门,全程无人化、智能化。