CATALOG

芯步的开放接口基于标准HTTP协议,这意味着你可以跳过专用网关,让开关直接与共享茶室的管理系统通信。以下方案以86型单路门禁照明开关为核心设备,详细说明如何实现从硬件选型到业务落地的全流程集成。

解决方案:共享茶室灯光控制——86型单路门禁照明开关集成实践

1. 背景与选型分析

在共享茶室场景中,用户按小时租用独立包厢。痛点是“空间闲置时的能源浪费”(灯光长明)与“用户离开现场时时的管理漏洞”(忘记关灯)。同时,用户入场时需要同时完成“门禁解锁”和“灯光通电”两个动作。

设备选型:86型单路门禁照明开关基于芯步生态的兼容性标准,选择集成了 WiFi 2.4G 通讯模组的 86型智能墙壁开关

  • 物理规格:标准86型底盒安装,适配国内现有暗盒,无需凿墙改造

  • 负载能力:需支持单路控制,负载功率需满足茶室灯光要求(通常阻性负载不低于1000W,或针对LED灯的特殊要求)

  • 一体化逻辑:该开关内部集成了继电器控制灯光,同时具备“门禁模式”输出,可直接控制电插锁或磁力锁的断电开锁/通电上锁

2. 硬件连接拓扑

为了实现“开门即亮灯,离开现场时即断电”的无感体验,物理接线方案如下:

组件连接方式与说明
强电输入220V交流电接入开关的“L”端(火线)和“N”端(零线)。
灯光回路灯具的火线接开关的“L1”端(输出端),零线直接接电网零线。
门禁回路根据锁具类型(断电开锁型),将门磁锁的正负极接开关的“COM”和“NC”端。
芯步云端设备通过WiFi直连路由器,无需额外网关,注册至芯步平台

3. 软件集成开发(API对接核心)

芯步的开放接口基于HTTP协议,极简且语言无关,适用于任何后端语言(Java, Python, PHP, Node.js等)

3.1 设备激活与绑定在用户下单成功后,SaaS系统需动态生成设备授权。通过调用芯步的设备绑定接口,将特定茶室的开关设备ID与用户的订单Token进行临时绑定。

3.2 核心控制逻辑:远程通断当用户通过小程序点击“开灯”或系统检测到订单开始时,后端需下发指令。

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/

  • 请求方法:POST(application/json)

  • 必要鉴权:URL携带 sign(签名)和 ts(时间戳)

  • 核心代码逻辑(伪代码示例)

    *逻辑说明:芯步服务器接收到指令后,会在 80-120ms 内将指令推送到处于同一局域网的开关设备上*

3.3 状态同步与回调(监听用户离开现场时)这是共享场景的关键。用户离开茶室时,往往习惯直接用物理按键关灯,此时系统必须同步状态,防止计时错误。

  • 机制:设备状态改变(无论是通过API下发还是物理按键触发)会主动上报至开发者配置的消息接收URL

  • 业务处理:当SaaS系统接收到 {"power": 0} 的状态上报时,可触发以下动作:

    1. 向用户APP推送“灯光已关闭”的提示。

    2. 如果是订单进行中,提示用户订单即将结束;如果是空闲时段,系统进入待机省电模式。

4. 场景联动与业务闭环

利用芯步的接口,可设计以下自动化流程,提升共享茶室的科技感:

场景 A:用户扫码开房(三端联动)

  1. 动作:用户小程序点击“开门”。

  2. API调用:SaaS后端调用门禁开关的 power:1 指令。

  3. 物理结果:继电器吸合,门锁断电弹开(或通电开锁),同时 L1端子通电,茶室顶灯亮起。

  4. 反馈:设备上报状态,系统开始计费。

场景 B:无人自动节能(PIR传感器联动)虽然86开关本身不含人体传感器,但可利用芯步生态内的 “智能人体存在雷达传感器” 进行联动

  • 后端逻辑:订阅传感器的“无人”状态消息(如15分钟无人)。

  • 执行:后端主动向86开关下发 power:0 指令,强制断电关灯关锁,并触发订单结束流程,防止用户忘记锁门。

5. 实施方案细节与安全加固

  • 本地局域网容灾:该款86开关支持纯局域网环境运行。即使在公网断开的情况下,SaaS服务器若与茶室处于同一VPN或局域网内,依然可通过内网IP下发指令,保障开房不受网络波动影响。

  • 物理按键防拆:在共享环境中,需在设备配置(通过API或管理后台)中设置“物理按键锁定”功能。即只允许通过API远程开关灯,禁止现场用户通过触摸开关关闭灯,防止用户恶意关灯导致监控摄像头断电或造成不良体验。或者设置为“断电需审批”模式。

  • 负载保护:针对茶室常用的LED筒灯,需注意开关的额定电流限制。该86开关支持接入电容进行保护,防止开灯瞬间冲击电流过大导致继电器粘连

6. 总结

将86型单路门禁照明开关集成到芯步的共享茶室项目中,本质上是将“物理电路控制”转化为“HTTP API指令调用”。通过上述方案,开发者可以在一周内完成从硬件选型到软件对接的全流程,实现 “一码通刷、灯随单动、人走电断” 的无人化管理效果,既降低了电费支出,也提升了包厢的智能化体验。