芯步的智能包间控制器(Max/Mini)提供了8路独立继电器输出和完整的HTTP API接口,可以很好地解决这个问题——核心思路是一个包间部署一台控制器,将麻将机、空调、门禁分别接入不同线路,再通过API进行分组管理和独立控制。以下方案涵盖硬件接线、接口调用和业务逻辑实现。
解决方案:基于芯步开放接口的包间设备分组独立管理
一、 背景与需求
在共享棋牌室、轰趴馆或高端会所的经营中,管理者常常面临以下痛点:顾客离开现场时后忘记关空调导致电费浪费;保洁人员需要逐间打扫,门禁管理混乱;多个包间设备状态无法在后台统一可视化监控。
为解决上述问题,本方案基于芯步智能包间控制器(Max/Mini) 及其开放HTTP API接口,实现对麻将机、空调、门禁、照明等设备的分组独立管理与远程精细化控制。
二、 硬件选型与接线方案
目前芯步提供两款核心控制器,本方案以功能最全的 “智能包间控制器|Max” 为主进行说明,该设备拥有8路输出,足以覆盖主流电器。
设备接线拓扑规划:
| 控制器端口 | 类型与规格 | 对接设备 | 管理逻辑 |
|---|---|---|---|
| 第1-3路 | 10A开关 | 照明灯、排气扇、吸烟灯 | 环境设备,订单开始自动开启,结束后联动关闭 |
| 第4-6路 | 16A插座 | 麻将机、饮水机、按摩椅 | 核心娱乐设备,支持独立通断,防止偷电 |
| 第7路 | 10A门禁接口 | 电磁锁/电插锁 | 门禁控制,与订单状态深度绑定 |
| 第8路 | 30A大功率 | 2匹空调 | 高负载设备管理,重点节能监控 |
注: 如果是小型包间,可选择 Mini版(4路输出),同样支持空调和麻将机接入。
通过上述接线,每个包间只需部署一台控制器,所有强电设备均通过控制器集中管理,避免了传统布线的复杂性和安全隐患。
三、 软件层对接与接口调用逻辑
芯步开放平台提供标准的 HTTP API 接口,支持云端调用及局域网控制。开发者可基于以下核心接口实现业务闭环。
1. 基础指令集(以Python/任何后端语言调用为例)控制任意线路的核心参数是 order 字段。
开关空调(第8路):
{"power8": 1}(1为开,0为关)开关麻将机(第4路):
{"power4": 1}门禁控制(第7路):
{"power7": 0}(断电开锁/通电上锁根据门锁类型调整)批量控制:同时关闭第1、2、3、4路,指令为
{"batch": {"relay": [1,2,3,4], "power": 0}}
2. 实现“包间分组独立管理”针对“多包间”场景,必须使用 分组管理接口,将物理设备映射为逻辑包间。
创建设备分组:调用
/device/group/接口,将设备ID 绑定到特定的Group ID(例如:将设备SN:10086绑定至Group_ID: 101 即“VIP1包间”)。分组控制:一旦分组建立,管理员无需记住具体的设备ID和线路号,只需向
/group/control/接口发送指令即可。场景示例:当“VIP1包间”订单结束,后台调用:
四、 关键业务场景详解
第一种场景:顾客扫码自助开房(门禁与通电联动)
用户在小程序下单支付。
后端系统调用芯步API:
{"power7": 0}(第7路门禁断电,电磁锁失电开门)。延迟2秒后,调用场景模式:
{"batch": {"relay": [1,4,8], "power": 1}}(开启照明、麻将机、空调)。技术优势:利用控制器的“先通后断”或定时任务功能,可实现开门瞬间设备即启,提升无感体验。
第二种场景:包间设备独立计费与管理(防止A包间用B包间电)痛点:传统模式下,麻将机插座若与隔壁包间混线,易产生纠纷。对策:由于每台麻将机接入的是指定控制器的指定线路(如第4路),后台系统在计时开始时记录该线路的通电时间,结束时切断电源。物理线路的独立性确保了即使隔壁房间原住客未退房,也无法使用本包间的电器,实现了真正的独立管理。
第三种场景:保洁与复位模式顾客离开现场时后,后台并不立即全断,而是执行“保洁模式”:
关闭空调、麻将机(第8、4路)。
保持照明(第1路)和门禁(第7路)常开/解锁状态,方便保洁进入。
保洁完成后,保洁员点击“完成”,后台最后调用全关指令,门禁恢复上锁等待下一单。
五、 总结
结合芯步智能包间控制器(Max/Mini)的 8路独立大功率继电器 与 开放API接口,开发者能够轻松构建高可用性的共享空间管理系统。
硬件层:利用多路物理隔离,实现空调(大功率)、麻将机、门禁的安全独立接入。
接口层:通过标准的HTTP协议和分组接口,实现设备的逻辑隔离与大批量调度。
管理层:解决共享场景下最核心的“节能”与“安全”痛点,实现降本增效。