包间场景的智能化改造，核心挑战往往不在于设备本身，而在于如何让门禁、电器、订单系统协同工作——有人下单后自动解锁，时间到了自动断电。这篇方案围绕芯步4路控制器的开放接口，梳理具体的硬件选型、接口对接逻辑和典型联动，可直接用于技术方案设计。
1. 背景与需求分析
在共享棋牌室、茶室、影院式足浴、自习室及部分公司的小型会议室/包间管理中，管理者常常面临人力成本高、监管不及时、夜间营业安全隐患大等问题。传统的管理方式依赖人工开关门、手动送电，不仅效率低下，且容易出现“跑单”或电器空耗现象。
为了解决上述痛点，本方案基于芯步智能包间控制器MINI（型号：UNI-KZQ-BJ-MINI-TTS，带语音播报版）的开放接口能力，设计一套自动化门禁联动管理系统。通过HTTP接口对接现有SaaS系统或小程序，实现“订单支付即授权、扫码开门即通电、时间届满即预警、超时自动断电解权”的无人化、智能化闭环管理。
2. 硬件选型与功能分配
本方案的核心控制设备是4路场景联动控制器MINI，其4路输出在包间场景中的具体功能分配如下表所示：
| 输出线路 | 负载能力 | 对接设备 | 在联动管理系统中的作用 |
|---|---|---|---|
| 第1路 | 16A | 照明/换气扇 | 环境控制： 包间通电逻辑开启。门锁开启时，照明自动亮起，营造营业环境。 |
| 第2路 | 16A | 麻将机/饮水机 | 娱乐设备控制： 用户扫码开门后通电，订单结束后自动断电，杜绝电器待机电费。 |
| 第3路 | 10A | 门禁电磁锁 | 门禁核心： 直接控制磁力锁或电插锁的断电开锁与通电闭锁。这是实现远程开门的关键。 |
| 第4路 | 30A | 空调（2匹） | 能耗大户管控： 单独控制空调，支持远程调温或与PIR传感器联动，人走空调未关时自动保护。 |
硬件部署补充
出门按钮：包间内部安装物理出门开关（接入第3路干结点或独立通过API逻辑触发）。
语音播报（TTS）：利用MINI控制器的TTS能力，在订单即将结束、或识别到非法闯入时，通过设备自带喇叭播放提醒。
感知层：选配芯步人体传感器（通过WiFi/API联动），用于判断包间内是否有人。若无人且订单结束，立即执行全断（全关）指令；若有人在超时，仅关闭门锁但保留照明，避免尴尬。
3. API接口对接架构
该系统通过HTTP API实现业务层与设备层的通信，支持公网或局域网（支持私有化部署）两种模式，响应时间约80-120ms。
3.1 接口核心逻辑
芯步提供标准的API接口，请求方式为 HTTP POST。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}核心参数
device：目标包间控制器的唯一ID。order：具体指令JSON，如{"power3": 0}（断开第3路门锁）。
3.2 签名与安全机制
为了防止恶意攻击，所有指令均需动态签名（Sign）：
拼接字符串
str = md5(AppSecret) + ts。计算最终签名
Sign = md5(str)。注：其中 ts 为时间戳，AppSecret 由芯步控制台生成。该机制确保了即使在同一局域网内，指令也难以被篡改。
4. 门禁联动管理流程设计
结合上述硬件与接口，设计“小程序扫码——包间使用——自动退场”的完整闭环流程。
4.1 状态一：空闲待租
设备状态：第3路（门锁）处于 闭合（通电） 状态，电磁锁强力吸合，门打不开。第1、2、4路均为 断开 状态。
系统表现：服务器数据库中该包间状态为“空闲”。
4.2 状态二：用户下单与开门
用户操作：用户在小程序端完成支付。
服务器触发：后台系统接收到支付成功回调。
API联动（开锁） ：
系统向智能包间控制器MINI发送指令：
{"power3": 0}。接口语义：POWER3对应第3路，0代表关闭输出。
物理动作：第3路关闭输出 -> 电磁锁断电 -> 磁力消失 -> 门锁打开。
API联动（通电） ：
紧接着（或为了安全延迟2秒）发送指令：
{"power1": 1, "power2": 1, "power4": 1}。物理动作：照明亮起，麻将机/按摩椅通电，空调启动。
反馈：语音模块播报：“欢迎光临，祝您体验愉快” 。
4.3 状态三：使用中与管理
临时暂停/续费：若用户中途需要临时锁门（如隐私场景），可通过小程序点击“暂离”。系统发送
{"power3": 1}（上锁），但内部电器保持通电。注：出门按钮物理按下时，控制器会暂时断开第3路几秒，门开后复位，此为本地逻辑，不影响接口管理。
预约占用：当用户即将到达前，系统可定时发送
{"power4":1}给空调，提前制冷，提升体验。
4.4 状态四：结束与清场
时间预警：订单结束前10分钟，系统调用TTS接口：
{"play:gbk:16":"尊敬的用户，您的包间时间还剩10分钟，如需续费请尽快操作"}。
自动断电解权：订单时间归零且未续费。
第一步（强制驱逐） ：发送
{"power3": 1}。此时第3路重新通电，电磁锁吸合锁门。同时发送{"power1": 0}关闭照明。此时场景：灯灭了，门锁了，但为了客户安全拿东西，空调和麻将机暂时未断，或者设定一段缓冲期。
深度节能：延迟2分钟后，发送
{"power2": 0, "power4": 0}。切断所有插座电源，空调关闭。状态同步：服务器更新设备状态。
5. 特色功能扩展
5.1 防重复订单与防占座
在不连接地磁或门磁的情况下，可通过功率检测实现物理防占座。
场景：如果有人恶意不下单强行撬门进入（物理破坏除外）或前一订单未关门。
逻辑：服务器未授权状态下，轮询查询设备状态（该功能需配合平台轮询或使用芯步的消息推送机制）。虽然Mini主打控制，但如果电路中接入的是可变负载，可通过旁路的功率计量插座判断包间是否“异常占用”，并告警。
5.2 消防联动
通过开放接口与大楼消防系统对接。
触发：消防系统发送HTTP指令。
执行
{"power1": 0, "power2": 0, "power3": 0, "power4": 0}（全断）。同时门锁断电（power3=0），包间门全部自动弹开，满足消防疏散要求。
5.3 定时任务与节能
利用控制器支持的“远程定时任务”功能。
设置凌晨2：00-6：00，若空调（第4路）处于开启状态，强制下发关闭指令，防止客人离开现场时后空转。
6. 总结
快速接入：芯步提供的API接口非常标准化，支持cURL、Python、Java等各类语言，普通SaaS后台工程师十分钟即可完成对接原型。
无需网关，组网简单：设备直接通过WiFi 2.4GHz联网，无需单独购买网关，降低了棋牌室等场景的硬件部署成本和故障点。
高负载安全：第4路专门针对空调设计，承受高达30A电流，直接支持2匹商用空调直接接入，无需外挂交流接触器，安全性高。
成本低廉：该方案利用一个Mini设备替代了“智能门禁主机+电源+情景面板”的组合，4路合一，极大节省了安装空间和硬件采购成本。
通过以上方案，无论是将设备用于共享棋牌室（休息室） ，还是公司内部会议室（沐浴房/琴房） ，均可实现全流程的无人化智能管理。