CATALOG

芯步的MINI控制器通过HTTP API开放接口,可将4路不同规格输出(含30A空调专用回路)的实时状态对接到自有系统。以下方案涵盖设备选型、接口对接流程、状态监测与联动控制的具体实现。

——基于芯步4路多规格输出控制器MINI的接入实践

1. 解决概述

在共享棋牌室、茶室、琴房等无人值守服务型门店中,经营者面临的最大痛点是无法远程感知包间内设备的真实状态(如空调是否误关、麻将机是否断电失败),导致电费流失或用户体验下降。

本方案基于芯步智能包间控制器MINI,利用其4路独立多规格输出(10A/16A/30A)和全开放HTTP API接口,不仅实现设备的远程通断控制,更通过状态实时同步机制,将物理设备的通断状态转化为系统可读、可展示、可预警的数字化资产,实现对包间内所有电器的“可视、可管、可控”。

2. 硬件选型:4路多规格输出控制器MINI

针对包间复杂电器环境(包含弱电门锁、强电照明、大功率空调),MINI控制器是理想的匹配设备。其关键参数与接线如下:

输出通道规格参数典型负载场景监测意义
第1路16A照明、换气扇、吸烟灯、音响系统监测环境基础状态(如营业/打扫模式)
第2路16A麻将机、饮水机、按摩椅、共享充电线监测核心娱乐设施运行时长与空闲状态
第3路10A (直流)电磁锁、电插锁(门禁)监测门锁状态,判断包间是否处于占用中
第4路30A (2匹空调专用)挂机/柜机空调关键监测点:监测空调开关状态,防止顾客退单后空调未关导致巨额电费

该设备支持WiFi 2.4GHz联网,具备防火V0级外壳,在高温环境下运行稳定性有保障

3. 接口对接设计

为实现“状态监测”,系统需采用 双向数据流架构,而非单向的控制指令下发。

3.1 整体拓扑结构

业务服务器 (SaaS/小程序后端) <--> 芯步开放API <--> 包间控制器MINI同时,业务服务器需暴露接收消息推送的接口

3.2 状态监测实现原理

控制器不仅仅被动接收命令,当继电器因本地操作(如红外遥控空调、物理按键)或指令执行发生吸合/断开变化时,设备会主动上报状态:

  1. 上行(监测):设备状态变化 -> 平台推送 -> 业务服务器(更新数据库,记录日志)。

  2. 下行(控制):业务服务器 -> 签名认证 -> 下发指令 -> 设备执行。

4. 关键对接步骤:从控制到监测

4.1 设备激活与凭证获取

  • 将MINI控制器上电并配网。

  • 在芯步控制台注册企业账号,获取专属的 AppIDAppSecret

  • 记录下设备的唯一标识 Device ID(这是后续调用接口的参数)。

4.2 开发API签名与指令下发(以控制为例)

要实现对包间设备的远程监测,首先需具备控制能力。调用接口时需要动态生成签名,以保障安全性。签名生成逻辑为:sign = MD5( MD5(AppSecret) + ts )

以下是业务服务器向MINI控制器下发指令的核心逻辑伪代码,可用于开关灯或空调:

参考签名说明:

4.3 实现“状态监测”的核心:消息推送接收

仅下发指令无法实现“监测”。你需要配置一个HTTP接口来接收设备的实时状态。

配置步骤在芯步控制台设置“消息推送URL”(例如:https://yourdomain.com/api/device/state)。

数据格式示例当顾客关闭空调或门锁状态改变时,平台会主动推送如下JSON数据至你的服务器:

参考消息格式:

业务处理逻辑接收到该推送后,你的服务器应立即更新数据库中该包间的状态,记录日志。例如,若系统显示订单未结束但power4状态变为0(空调关闭),可判定为异常断电,触发客服介入提醒。

5. 进阶功能:精细化监测与联动

借助API接口的灵活性,你可以实现更复杂的“监测与控制”闭环策略:

5.1 “先断后通”模式实现门禁联动

包间管理常需实现“先断电/断门锁,顾客才能离开现场时”的逻辑。MINI接口支持reset命令。

  • 应用场景:用户点击“退租”。

  • 指令:下发 {“reset”: {“relay”: [3,4], “interval”: 1000}}

  • 效果:先断开第3路(门锁)和第4路(空调),等待1秒后恢复门锁供电(让门锁重新锁上),确保退单后房间封闭断电

5.2 数据可视化与预警

通过定时轮询接口(例如每5分钟请求一次设备状态)结合推送机制,可以开发能耗看板。

  • 空调监测专项:利用第4路的30A特性,监测高功率电器电流负载。若后台检测到空调状态为“通”但室温传感器(需配合温湿度传感器)显示温度无变化,可判定空调故障,推送报警

6. 总结

通过接入芯步MINI控制器的开放接口,开发者不仅能够实现基础的“通断”控制,更能借助主动状态推送机制,将所有物理电器转化为系统内实时同步的数字化节点。这套方案解决了共享/无人业态中 “看不到空调是否真关了”、“不知道麻将机断电没有” 的核心监测痛点,为降本增效提供了数据支撑。