芯步的智能包间控制器和密码门禁均开放标准HTTP接口，可通过API直接调用实现设备联动。以下方案围绕“8路包间场景”设计，涵盖设备选型、接口对接逻辑及落地部署要点。
1. 项目概述与目标
在棋牌室、KTV、影吧或茶室等拥有多个独立包间的商业场景中，管理者常面临非法闯入、夜间收银安全、以及房态管理混乱的痛点。
本方案基于芯步的智能硬件及开放接口，旨在解决以下核心问题：
权限管控：用户需通过合法凭证（动态密码/远程指令）才能进入包间，防止逃单或闲杂人员占用。
联动管理：用户下单支付成功自动开门，消费时长结束自动锁定并切断电源，实现“无人值守”。
集中控制：管理者可通过自有SaaS系统，远程查看所有包间的门锁状态、实时控制8路电源通断。
2. 硬件选型与功能
为了实现“门禁+电源”的场景联动，我们选型以下两款核心设备，所有设备均支持HTTP接口控制。
| 硬件产品 | 型号参考 | 扮演角色 | 关键特性 |
|---|---|---|---|
| 智能包间控制器 | UNI-KZQ-BJ | 大脑 | 集成8路继电器，控制包间内的灯光、插座、总电源；支持Wi-Fi，开放API。 |
| 智能密码门禁 | 68型触摸款 | 门卫 | 控制磁力锁或电插锁；支持动态密码下发、触摸按键、断电记忆。 |
| 电磁锁 | 280kg级 | 执行器 | 安装在包间门框上，接收门禁控制器的断电/通电指令来完成开关门。 |
场景关联逻辑系统将包间控制器的一路继电器（如第8路）专门用于控制门禁锁的电源。
开门逻辑：控制门禁锁的继电器瞬间断电2秒（门锁弹开），然后恢复供电。
总控逻辑：控制其他7路继电器控制电视、空调、机麻等设备。
3. 接口对接设计
芯步的设备无需网关，直接通过Wi-Fi联网，利用数据签名机制保障通信安全。
3.1 对接流程图解
用户端动作：用户在小程序下单支付 → 商家SaaS系统确认订单。
系统处理：SaaS系统调用芯步API接口，向指定包间的智能门禁下发“时效密码”或“远程指令”。
硬件执行
包间密码锁屏幕亮起，显示动态密码。
用户输入密码，锁内继电器动作，门打开。
状态回传：门禁锁触发后，通过HTTP接口向服务器上报“门锁开启”事件，系统开始计时。
结束清理：订单时间耗尽 -> 调用接口 -> 包间控制器切断第1-7路电源（关闭娱乐设备），并强制锁门。
3.2 HTTP接口调用示例
第三方服务器调用设备的核心语法如下（以释放门锁为例）：
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法
POST请求Body（JSON）
说明：开发者仅需在请求头中携带动态签名和时间戳，即可实现毫秒级响应**。
4. 核心场景联动逻辑
我们定义“8路包间控制器”的接口映射如下：1-7路接娱乐设备，第8路接门禁电源。
第一种场景：用户自助入住
用户小程序预定“包间A”，支付。
后端系统请求门禁设备API，生成一个有效期仅为“30分钟”的临时密码，用于首次进入。
用户输入密码，门开。
系统检测到开门事件，自动调用包间控制器API，开启第1-7路继电器，设备通电。
第二种场景：时长管理（防逃单）
计费提醒：在订单剩余10分钟时，系统调用包间控制器的“先通后断（point）”指令，让灯光闪烁3次进行提醒。
强制结束：用户未续费，时间归零。
动作1 (断娱乐)
{“device”:“80001”, “order”:{“power1”:“off”, “power2”:“off”...}}关闭所有插座（麻将机、电视断电）。动作2 (锁门)：切断第8路继电器电源，磁力锁失电吸合（或得电锁门，视锁型而定），此时外部无法开门，必须由前台远程“强制复位”才能再次开启。
第三种场景：远程协助（管家模式）
若客户在包间内需要打扫或维修，前台可点击“清洁模式”。
后台调用门禁接口：
{“device”:“门禁ID”, “order”:{“power”:“on”}}或者直接发送“常开指令”，让门保持敞开状态，方便进出。清洁完毕，点击“恢复”，门关闭并恢复加密状态。
5. 关键配置与部署要点
5.1 网络环境要求
频段限制：芯步硬件仅支持 Wi-Fi 2.4GHz，部署时需确保路由器开启2.4G频段，避免连接5G WiFi导致设备离线。
网络冗余：设备支持配置5组WiFi，当信号不稳定时自动切换。
5.2 门锁接线逻辑（重点）
切勿直接接入220V高压！
将智能密码门禁的“COM/NC/NO”接口串联到电磁锁的电源回路中。
若使用包间控制器控制门锁（推荐），将控制器第8路的输出端接入电磁锁的12V电源线。当继电器断开时，锁断电即开门。
5.3 私有化部署
如果是高端商务KTV或对数据安全要求比较高的场所，芯步支持局域网私有化部署。
在店内本地服务器部署“软网关”，所有API请求在局域网内闭环，即使外网断开，包间控制与门禁系统依然正常运行。
6. 方案收益
节省人力：实现7x24小时无人值守，用户自助扫码开门。
安全防损：物理层面联动“断电即锁门”，避免用户超时占用或暴力破坏设备后逃单。
接口友好：标准HTTP协议，无论您的后台是用Java、Python还是PHP开发，均可通过几行代码快速接入，无需复杂硬件驱动。