芯步提供两款核心设备可用于共享茶室的电器集中控制:智能通用控制器|24路可直接实现24路控制,若茶室有多个包间,也可采用多台智能包间控制器|Max(每台8路)组合的方式。以下方案聚焦于如何通过开放接口完成设备接入与系统开发。
解决方案:基于芯步开放接口的共享茶室24路电器集中控制系统
1. 概述与硬件选型
针对共享茶室需要集中控制照明、空调、茶炉、麻将机、门禁、换气扇等24路电器的需求,本方案的核心控制设备选用芯步“智能通用控制器|24路”。
核心设备:该设备提供24路继电器输出,可通过HTTP接口独立控制每一路的通断,单路最大支持2200W阻性负载,完全覆盖茶室常见电器。
拓展设备:为实现“人离断电”或环境监测,可搭配智能人体存在传感器。当传感器检测到无人状态时,通过接口自动触发关闭所有电路。
网络架构:设备通过WiFi 2.4G联网,无需额外网关,支持云端直连或局域网私有化部署。
2. 接口协议与核心开发逻辑
芯步的开放接口基于HTTP协议,采用“签名鉴权”机制,适合任何支持HTTP请求的后端语言(如Java、Python、PHP、Node.js)或小程序前端直接调用。
接入流程:
获取凭证:在芯步开发者后台获取
AppId和AppSecret。签名计算:为防止接口被篡改,每次请求需计算签名
Sign。算法逻辑:
Sign = md5( md5(AppSecret) + ts ),其中ts为当前Unix时间戳。
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={Sign}&ts={ts}
核心控制逻辑示例 (以场景“打开1路照明并关闭2路换气扇”为例):请求方式为POST,Content-Type为application/json。
注:针对24路控制器,命令字段为 power1 至 power24,值为 1(开)或 0(关)。
3. 24路电器的精细化分配方案
为了高效管理,对24路进行模块化分配。若单个包间无需24路,可将其用作多个包间的总电控箱或一个大型VIP茶室的场景联动。
| 线路编号 | 控制对象 | 控制逻辑/策略 | 备注 |
|---|---|---|---|
| 1-4路 | 照明系统 (主灯、射灯、氛围灯) | 用户下单自动开灯;离店扫码断电 | 支持缓亮缓灭(需设备支持) |
| 5-8路 | 环境电器 (空调、新风、换气扇) | 预约时段自动开启换气;温度传感器联动 | 空调需注意接触器匹配 |
| 9-12路 | 茶饮设备 (自动上水器、智能茶炉、电磁炉) | 用户扫码通电,超时未使用自动断电 | 高功率电器预留16A接口 |
| 13-16路 | 娱乐设施 (麻将机、背景音乐、投影仪) | 配合订单时长,倒计时结束前10分钟提醒 | 可接入智能语音音柱进行语音提醒 |
| 17-20路 | 辅助设施 (电动窗帘、灭蚊灯、香薰机) | 结合光照传感器或定时任务自动执行 | - |
| 21-22路 | 安防门禁 (电磁锁、门磁) | 用户下单成功后动态开锁;门磁状态实时反馈 | 需与门禁系统联动 |
| 23-24路 | 备用/分区 | 预留扩容 | - |
4. 业务场景联动机智(代码级策略)
第一种场景:用户扫码下单自动分配房间当用户在微信小程序支付成功后,后端需执行“清场并激活”操作:
清场复位:调用接口指令
{"reset":{"relay":[1,2,3,...24],"interval":500}},将所有线路断开,间隔500ms依次复位。激活设备
语音播报:调用智能音柱接口,TTS播报:“欢迎光临XX茶室,空调已为您开启,祝您品茗愉快”。
第二种场景:节能策略与无人值守通过部署人体存在传感器(雷达传感器比红外更适合检测静坐品茶的人体微动),其状态变化会主动推送至你的服务器。逻辑判断
触发:传感器上报
{"radar":"off"}(无人状态)。动作:后端执行延时15分钟检测。若连续15分钟无人,则调用接口:
容错:为防止误判(如客人只是去洗手间),在包间内设置“延时按钮”,客人按下后可临时请求保持通电。
第三种场景:批量操作与定时任务由于拥有24路,管理后台需要提供批量控制能力。
一键全开/全关:使用
{"order": {"power": 1}}即可控制全部24路。定时消毒:设定每日凌晨2:00,系统自动打开第18路(紫外线消毒灯),2:30自动关闭。
5. 实施注意事项
负载匹配:虽然控制器支持高功率,但请一定要确认线路类型。茶室的煮茶器属于感性负载,实际带载能力约为阻性负载的1/3至1/2。大功率电器(超过1000W)通过控制器的触点控制交流接触器,再由接触器带载,以延长设备寿命。
网络稳定性:24路控制器仅支持2.4G WiFi。茶室环境隔墙较多,需确保信号覆盖。如果设备较多,开启私有化部署模式(局域网通信),摆脱外网依赖,响应速度更快且更安全。
接口超时重试:网络波动可能导致指令未送达。在开发订单结束逻辑时,必须设计“查询设备状态”的接口校验环节,或利用平台的消息推送机制确认指令执行成功,避免“显示已断电但实际未断”的计费纠纷。
此方案利用芯步标准的 HTTP API,将底层硬件控制权完全开放给上层业务系统,使得共享茶室的运营者能够通过小程序后台,对店内所有电气设备的状态“可视、可控、可管”。