CATALOG

共享茶室的痛点是:如何在无人值守的情况下,让用户只控制自己预定的包厢,同时实现照明和门禁两套系统的独立管理?以下方案基于芯步开放接口,给出从硬件选型到接口调用的完整技术路径。

解决方案:基于芯步开放接口的共享茶室2路独立线路控制系统设计

1. 项目概述与目标

在共享茶室场景中,最核心的痛点是空间的私密性能源的自动化管理本方案的目标是利用芯步的智能硬件与开放API接口,解决传统茶室改造中的“一呼百应”问题(即一个开关控制全屋)。我们将专注于实现针对单个包厢内的两路独立线路的精准控制:

  • 第一路(L1):照明与插座线路(为主照明、烧水壶等常规电器供电)。

  • 第二路(L2):门禁专用线路(为电磁锁或门磁供电,实现订单开始供电开锁,订单结束断电闭锁)。

2. 硬件选型与线路规划

要实现两路独立控制,关键在于选择合适的控制器。传统的单路通断器无法满足“照明开、门禁关”或“照明关、门禁开”的差异化需求。

推荐硬件组合:

设备类型推荐型号/系列核心作用芯步对接优势
核心控制器芯步 2路/4路智能通断器 (WiFi版)接入包厢配电箱,作为L1、L2线路的总开关支持标准HTTP API指令下发,毫秒级响应
门禁执行12V磁力锁/电插锁物理锁门需通过控制器L2线路配合12V电源转换模块使用
状态感知智能人体存在传感器检测无人自动断电(节能)支持状态实时上报,联动控制逻辑
网络层商用2.4G路由器保障设备在线硬件直连WiFi,无需额外网关

线路规划方案:在包厢的入户配电箱处进行线路改造:

  1. 总闸之后:将包厢进线分为两路。

  2. L1线路(受控照明/插座):火线进智能控制器的“输入1”,出线接原包厢灯路和茶台插座。

  3. L2线路(受控门禁):火线进智能控制器的“输入2”,出线接门禁电源(12V转换器)。

    • 注意:为了实现“断电开锁”或“通电开锁”,需根据锁型调整继电器逻辑。通常共享场景选用“通电开锁”,即控制器L2通电,门锁吸合;订单结束,L2断电,门锁断开。

3. 控制逻辑与流程设计

本方案的核心在于软件层如何通过API调动硬件。芯步的开放平台允许用户将设备ID与业务系统(小程序/公众号)绑定。

场景时序图逻辑:

  1. 用户下单(空闲状态)

    • 状态:L1 = 关(灯灭、插座无电);L2 = 关(门锁吸合/打不开)。

  2. 订单支付成功

    • 业务服务器调用芯步API。

    • 指令POST /device/control{"device":"包厢设备ID","order":{"power":1}}(针对L2线路)。

    • 动作:L2 线路接通 -> 门禁电源得电 -> 电磁锁吸合 -> 门可拉开。

    • 可选:同时下发开门语音提示。

  3. 用户进入包厢

    • 用户手动按压门框上的物理开关(或通过小程序)触发L1线路。

    • 指令{"device":"包厢设备ID","order":{"power":1}}(针对L1线路)。

    • 动作:照明亮起,插座通电(茶壶可烧水)。

  4. 使用中(续费与倒计时)

    • 采集端:利用芯步传感器检测“是否有人”。若无人且订单未结束,可自动切断L1节能,保留L2门禁。

  5. 订单结束(或超时)

    • 业务服务器发送批量指令:

    • 指令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_statuspower需依据芯步控制台提供的设备产品定义文件为准,但逻辑上是支持多路独立寻址的)

3. 状态同步机制

  • 轮询/推送:芯步支持消息推送。当用户物理关闭开关时,硬件会向服务器报告当前状态。

  • 应用:如果用户按了墙上的物理关闭按钮,业务系统应立即收到回调,更新小程序前端显示“照明已关”,避免状态不同步。

5. 方案实施优势

  1. 布线简单,免网关:芯步硬件直接走WiFi 2.4G连接,在装修后的茶室改造中,无需重新铺设弱电控制线,极大降低了施工成本

  2. 高性价比独立控制:通过一个多路模块替代两个单路模块,减少了硬件采购成本和配电箱空间占用。

  3. 安全冗余:如果网络断连,用户依然可以通过手动操作控制器上的物理按键(若具备)来控制L1照明,而L2门禁系统可配置为“断电常开”模式,防止烧水干烧或人员被困

6. 防故障与异常处理

  • 防误关机制:L2门禁线路在订单结束后必须强行断开。但需在程序中设置“缓冲期”:当传感器检测到L1线路(照明)仍在亮且有人移动时,系统应仅向APP推送“是否强制结束”的提醒,而非直接拉闸断电,以免用户摸黑。

  • 电器保护:L1线路控制的茶桌插座若连接大功率烧水壶,利用芯步的API可实现“订单余额不足5分钟时,禁止L1线路关闭,直至倒计时归零”,防止用户手机没电或来不及关火。

通过上述方案,共享茶室运营者可以轻松实现一个App/后台管理所有包厢,用户扫码即可通电开门,离店自动断电锁门,全程无人化、智能化。