4路包间智能远程控制器MINI是芯步专为棋牌室、茶室等场景设计的核心设备,其开放HTTP API的能力是实现分组独立管理的基础。以下方案围绕“设备接入→分组映射→独立控制”三条主线展开。
解决方案:基于芯步4路控制器MINI的包间设备分组独立管理系统
1. 概述与设计目标
在棋牌室、茶室或剧本杀店铺等场景中,通常存在多个包间,每个包间内包含照明、空调、麻将机、门锁等多个设备。目标:利用芯步“智能包间控制器Mini”(型号:UNI-KZQ-BJ-MINI)的4路独立输出接口和开放HTTP API,通过上层软件逻辑,实现不同包间设备的物理隔离与独立管理。最终达到“A包间顾客扫码通电,B包间设备不受影响;管理员可在后台一键关闭所有包间空调”的精细化运营效果。
2. 硬件选型:4路包间智能控制器MINI
本方案的核心执行单元是该控制器。根据其产品手册,它具有以下关键特性,是实现分组管理的基础:
多路独立控制:提供4路物理输出接口。
第1路:16A开关,适合照明、换气扇。
第2路:16A插座,适合麻将机、饮水机。
第3路:10A门禁接口,适合电磁锁。
第4路:30A大功率接口,专门用于2匹空调。
开放性:支持HTTP API控制,签名验证方式为
md5(md5(AppSecret) + ts)。网络灵活性:支持WiFi 2.4G直连,无需网关;同时支持私有化部署和局域网通信,确保在公网断网时内网仍可控制。
3. 设计:如何实现“分组独立管理”
要实现分组管理,不能仅靠硬件,必须构建“设备-云端/本地-应用端”的三角架构。
物理层(执行):在每个包间(如包间101)部署一台Mini控制器。将该包间的照明接在
power1,麻将机接power2,门锁接power3,空调接power4。数据层(映射):在您的业务服务器(SaaS后台)中,建立设备ID与业务分组的映射关系。即:
设备ID: 123456对应包间: VIP-01对应线路定义: power1=主灯。控制层(逻辑):您的服务器作为中转。当小程序请求“关闭VIP-01房间空调”时,服务器查询映射表找到设备ID,向芯步API发起针对该设备
power4的操作指令。
4. 详细接入步骤:从配网到分组控制
第一步:设备部署与配网
接线:强电施工需由专业人员操作,将包间内对应电器接入控制器指定线路(注意空调接第4路30A接口)。
配网:利用芯步官方小程序或物联网控制台进行“网络配置”。将设备配置到现场2.4G WiFi中。
获取凭证:在芯步控制台获取该设备的唯一
Device ID(如:820720)以及您的AppID和AppSecret。
第二步:建立分组映射逻辑(关键步骤)这是实现“分组独立管理”的核心代码层逻辑。您不需要修改硬件,而是在数据库和API请求中做文章。
数据库设计示例
字段:
room_id(包间ID),device_id(控制器ID),channel_map(线路映射JSON,例如:{"light":1, "majiang":2, "lock":3, "ac":4})。
API调用逻辑当请求“打开包间A的麻将机”时:
查库:包间A的设备ID为
123456,麻将机对应channel 2。封装指令:
{"device":"123456", "order":{"power2":1}}。签名:计算
sign = md5(md5(AppSecret) + timestamp)。下发:
POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。
第三步:实现“先断后通”与“批量分组管理”芯步的接口支持高级命令,非常适合商业场景:
门禁管理(先通后断):用户下单成功后,发送
{"point":{"relay":[3],"interval":5000}},门磁通电5秒后自动断电,实现“通电开门后自动断电”,防止电磁锁烧毁。批量全关(打扫模式):当顾客离开现场时,管理员需要关闭整个包间。可以发送批量命令:
{"batch":{"relay":[1,2,3,4],"power":0}},一键关闭所有电器。跨包间分组管理:假设需要同时关闭“3楼所有包间”的空调。您的服务器只需循环查询“3楼”分组下的所有
device_id列表,然后并发调用API分别控制每个设备的power4即可。
5. 场景用例:顾客扫码与控制流
以“共享棋牌室”为例,展示分组独立管理下的完整闭环:
顾客A 预订“梅花厅”并支付。系统自动寻找“梅花厅”对应的
device_id。通电:系统调用API发送
{"power3":1}(门锁通电5秒开门)及{"power1":1}(亮灯)。使用中:室内产生烟雾,传感器检测到(若接入了烟雾传感器),系统联动API发送
{"power2":0}自动断电麻将机。续费提醒:使用结束前10分钟,若Mini为TTS版本,可发送语音播报指令:
{"play:gbk:16":"您的订单即将结束,如需续费请扫码"}。断电:时间到,顾客未续费。系统调用
{"batch":{"relay":[1,2,4],"power":0}}(保留门磁电,关闭娱乐设备)。
6. 关键注意事项与优化
私有化部署与安全
由于涉及资金交易和门禁控制,使用芯步支持的私有化部署功能,将API请求指向本地局域网服务器,避免因公网波动影响开门。
签名验证:后端服请一定要须严格验证
sign,防止设备被恶意伪造请求控制。
TTS语音播报如果选用带TTS语音播报版本的Mini(带后缀-TTS),利用语音接口可以在顾客进门时播放“欢迎光临”,或者在时间快到时直接通过喇叭提醒,无需单独采购语音硬件。
负载限制特别留意第3路(门锁)和第4路(空调)的负载类型。第4路虽然电流大(30A),但如果是感性负载(如老式空调压缩机),实际承载能力会有折算(约1100W),需确认电器参数。
通过上述方案,开发者无需修改硬件固件,仅利用芯步标准的HTTP API配合业务层的分组数据库设计,即可轻松实现4路控制器在多点位包间中的独立、分组、批量管理。