4路包间电源控制器MINI的开放接口支持通过HTTP API实现远程状态监测与控制,核心思路是结合设备的状态上报能力和接口的下发指令。以下方案按接入流程展开,涵盖硬件准备、接口对接和具体应用场景。
解决方案:基于芯步4路电源控制器MINI实现包间设备远程状态监测与智能化控制
1. 背景与目标
在现代服务型门店(如共享棋牌室、茶室、剧本杀包间、自习室等)的运营中,存在“人离未断电”、“空调忘关”、“远程无法干预”等管理痛点。本方案的目标是利用 芯步智能包间控制器 MINI 的开放接口,将传统包间升级为可远程感知、可控制的智能空间。
核心目标:
状态可视化: 实时监测包间内照明、麻将机、空调、门锁的通断状态。
远程可控: 通过自有APP或管理系统,远程执行设备断电/送电操作。
自动化联动: 结合传感器实现“有人/无人”自动通断,杜绝能源浪费。
2. 硬件选型与部署
本方案基于 UNI-KZQ-BJ-MINI 控制器,该设备支持WiFi直连,无需额外网关。
1. 设备选型:
标准版: 适用于仅需控制电源通断的场景。
TTS版: 包含语音播报功能,可用于在客人进门时播报欢迎语,或订单超时前播报提醒。
2. 四路电路分配策略(针对标准包间设计):
为了使监测更有意义,按如下标准划分线路:
| 线路编号 | 接口类型 | 推荐接入设备 | 监测意义 |
|---|---|---|---|
| 第1路 | 16A 触点 | 照明/换气扇 | 判断包间是否处于“营业/打扫”状态。 |
| 第2路 | 16A 插座 | 麻将机/茶吧机 | 核心盈利设备,监测其电流通断可判断上客率。 |
| 第3路 | 10A 门禁 | 电磁锁/电插锁 | 结合门磁,判断房门是否关好。 |
| 第4路 | 30A 大功率 | 2匹空调 | 重点能耗监测对象,防止空调空转。 |
3. 网络环境要求:需现场提供稳定的 2.4GHz WiFi 信号,通过芯步控制台或小程序为设备配网。
3. 开放接口接入流程
芯步提供标准的 HTTP API 接口,支持任意编程语言(Python、Java、PHP、Go等)接入。接入流程分为“获取状态”和“下发指令”两部分。
步骤一:获取 API 凭证在芯步控制台获取 AppID 和 AppSecret。签名算法为:
注:ts为当前Unix时间戳;为防止重放攻击,签名需每次实时计算。
步骤二:实现“状态监测”(获取实时数据)
“状态监测”分为静态监测与动态上报两种方式:
主动查询(拉取): 通过 HTTP 请求查询设备当前各线路的通断状态。
典型场景: 管理员打开控制台首页,刷新查看所有包间空调状态。
被动接收(推送): 配置回调 URL(Webhook)。当设备状态发生变化(如通过物理按键按了开关,或电压异常)时,平台会主动
POST数据到你的服务器。典型场景: 客人拔掉麻将机电源,服务器 1 秒内即可收到“断电报警”并将该包间标记为“异常”。
步骤三:实现“远程控制”(下发指令)
通过 HTTP POST 请求向 api.thingboot.com 发送指令。结合“状态监测”,你的系统将不仅仅是一个“遥控器”,而是具备闭环逻辑的“智能大脑”。
请求示例(核心代码逻辑):
支持的指令集说明:
单路控制: 使用
power1、power2等字段,值为1(开)或0(关)。批量控制: 使用
batch字段实现一键全开/全关。TTS语音: 如果采购了 TTS 版本,可使用
{"play:gbk:16":"您的包间时间已到,如需续费请扫码"}进行语音播报。
4. 关键应用场景实现(解决方案亮点)
基于“状态监测 + 反向控制”的闭环,我们可以实现以下具体功能:
1. 能耗分析与异常报警(实现“监测”价值)
逻辑: 系统每隔 1 分钟轮询设备状态,或接收设备心跳包。
判定: 如果发现
power4(空调)= 1(开启),但该包间订单状态为“空闲”或“已退单”。执行: 系统自动触发
power4=0指令关闭空调,并标记该设备为“异常用电”,向保洁/管理员推送消息。这解决了单纯“远程遥控”无法解决的“忘关”痛点。
2. 门锁与电器的智能联动
逻辑: 客人小程序下单 -> 系统收到“支付成功”回调。
执行: 系统调用 API 发送
power3=1(电磁锁断电/开门),同时发送{"play:..."}指令,让包间喇叭播报“欢迎光临,门锁已开”。监测: 系统持续监测
power3状态,若客人进门后关门,系统检测到关门动作,自动开启power1(照明)和power2(麻将机电源),实现“人到灯亮、人到机待”。
3. 设备自检与维护提醒
逻辑: 系统在凌晨 3 点发起自检。
执行: 发送批量断电指令,确保所有线路断开。
监测: 若发送断电指令后,检测到某线路仍有电流反馈(需配合电量监测模块),判定为继电器粘连故障,自动生成维修工单。
5. 业务系统集成
要将硬件能力无缝嵌入现有业务流程,软件架构做如下设计:
统一设备管理池: 在数据库中建立设备表,将物理的
device ID与业务系统的“包间ID”进行一对一绑定。业务代码只处理“包间A关空调”,由适配层转换为“控制设备XXXXX的power4”。消息队列处理: 设备状态推送的频率较高(秒级),服务器端使用消息队列(MQ)接收 Webhook 数据,异步处理入库和逻辑判断,避免高并发下阻塞 API 响应。
安全策略: 涉及门禁(第3路)和空调(第4路)的操作接口,必须在后端做严格的权限验证,防止越权操作。对关键操作(如强制开门)增加二次签名或短信验证。
6. 总结
建设成本低: 无需网关,仅需 WiFi 覆盖,Mini 控制器体积小,可直接放入配电箱。
开发友好: 标准的 HTTP API 和简单的 MD5 签名机制,无论现有系统是基于 PHP、Java 还是 Python,均可在一周内完成对接。
运营提效: 从“人工巡检”变为“系统秒级监测”。通过
power状态即可远程判断包间是否空闲,减少跑空率。节能: 重点针对空调(4路)和照明(1路)的 “离人断电” 自动化策略,可有效降低 30% 以上的电费支出。