4路包间电源控制器MINI是专为棋牌室、茶室等场景设计的嵌入式智能硬件，核心价值在于通过HTTP API将传统包间电器（空调、麻将机、门锁等）纳入统一软件系统管理。以下方案涵盖设备选型、接口对接、业务场景及部署架构，供技术团队参考。
1. 背景与概述
在无人值守服务型门店（如共享棋牌室、茶室、自习室）的数字化改造中，痛点在于对分散包间内多种电器的集中控制与计时计费。传统的解决方案往往需要复杂的布线、昂贵的中控主机或针对不同电器（空调、麻将机、门锁）采用不同供应商导致的系统割裂。
芯步推出的 “4路包间电源控制器MINI” （以下简称“MINI控制器”）是一款专为上述场景设计的嵌入式智能硬件。其核心优势在于极小的体积（72*90mm）、强大的带载能力（第4路最高支持6600W，可接2匹空调） 以及全开放的标准HTTP API接口。
本方案的目标是指导开发者、系统集成商如何将MINI控制器快速对接到现有的SaaS系统、小程序或APP中，实现包间管理的自动化。
2. 硬件选型与端口规划
在开始集成之前，首先需明确硬件的物理接线与逻辑映射。MINI控制器提供4路独立的继电器输出，不同的端口适用于不同功率的电器。
2.1 端口功能定义
为了在软件层实现精准控制，将物理端口与业务逻辑做如下标准映射：
| 端口编号 | 额定负载 | 典型对接设备 | 软件控制属性 |
|---|---|---|---|
| 第1路 | 16A / 3500W（阻性） | 照明灯光、换气扇、吸烟灯 | 即时控制，随订单开启/关闭 |
| 第2路 | 16A / 3500W（阻性） | 麻将机、饮水机、按摩椅 | 重点监控：需检测运行电流防止未断电退单 |
| 第3路 | 10A（门禁专用） | 电磁锁、电插锁 | 逻辑反逻辑：通常通电开锁或断电开锁需配置 |
| 第4路 | 30A / 6600W（阻性） | 2匹空调、取暖器 | 高负载保护，需配合红外/或直接通断控制 |
2.2 版本选择
普通版 (UNI-KZQ-BJ-MINI)：适用于基础通断控制场景。
TTS版 (UNI-KZQ-BJ-MINI-TTS)：如果你需要在订单开始/结束时通过包间内音响播报“欢迎光临”或“订单即将超时”，应选择此版本，它支持远程推送语音播报指令。
3. 集成设计
MINI控制器采用WiFi 2.4G直连路由器的方式，无需额外的网关硬件，极大地降低了集成成本。
3.1 网络拓扑
设备层： MINI控制器、电磁锁、照明灯、空调。
网络层： 门店路由器（需2.4G频段） + 公网/私有化服务器。
业务层： 你的应用服务器（SaaS后台）。
3.2 通信流程
下发指令： 用户小程序点击“开灯” -> 商家服务器 -> 调用芯步开放API（或本地API） -> MINI控制器第1路闭合。
状态上报： 设备状态改变 -> 推送到开发者预设的URL（回调）。
私有化部署支持： 如果你的项目对数据安全要求比较高（如政务休息室、高端私人会所），MINI控制器支持局域网纯内网运行，API请求可不经过公网。
4. API对接开发指南
芯步的开放接口基于HTTP/HTTPS协议，这是目前跨平台开发兼容性最好的方案。
4.1 接口基础信息
请求地址：
http(s)://api.thingboot.com/{AppId}/device/control/请求方法：
POST数据格式：
JSON鉴权方式： 动态签名（Sign） + 时间戳（Ts）。
4.2 业务接口示例
单路控制（最常用场景）
场景：用户下单成功后，系统自动打开包间总电和灯光。
请求参数示例：
*注: power1 至 power4 分别对应控制器上的4路物理接口。 *
门禁逻辑集成（关键点）
包间控制器通常配合门禁使用。第3路默认为常开/常闭干触点。场景：用户点击“开锁”或“结束订单”。
开锁: 下发指令让第3路断开（如果是通电开锁）或闭合。
关门检测: 通常需要配合“门磁传感器”（需额外采购），读取门状态防止“挂单”。
场景联动（高级功能）
利用TTS语音播报功能，提升用户体验。场景：订单结束前5分钟，提醒顾客续费。指令逻辑:
下发设备控制指令，调用TTS语音接口。
播报内容示例：“您的订单即将在5分钟后结束，如需续费请扫码。”
4.3 数据回调与状态同步
不单纯依赖“下发指令即成功”的逻辑，必须集成状态同步机制。
事件推送： 当用户在包间内按下物理开关（如果接入了物理开关），或者设备因过载保护跳闸，硬件会主动上报当前状态至你设定的服务器。
集成动作： 在后台管理系统中，需开发接收状态更新的接口，用于在前端（用户端）实时显示“空调正在运行”或“设备离线”。
5. 实施部署步骤
第一阶段：环境准备 (30分钟)
注册开发者账号： 访问芯步开放平台，获取专属
AppId和AppKey。硬件供电与配网
将MINI控制器接入DC 5V1A电源。
设备上电后，通过官方提供的配网工具（或SDK集成配网功能）将其连接到门店的2.4G WiFi网络。
关键点: 静态DHCP分配，确保设备IP不经常变动（若使用公网透传则无需固定IP）。
第二阶段：业务逻辑开发 (2-3天)
编写设备控制中间件
封装芯步的API签名算法。
编写业务逻辑：例如
createOrder()函数中调用deviceOn()。
计时计费逻辑
由于该设备支持功率检测（需确认具体固件版本），可以读取实时电流。若用户点击“断电退单”但麻将机未断电（电流仍存在），系统应报错并拒绝退单，防止纠纷。
第三阶段：安装与接线 (现场施工)
强电接入
第4路（空调）： 必须使用符合30A标准的铜芯线，直接串联在空调插座的火线上。
第3路（门锁）： 确认锁是断电开还是通电开。MINI控制器输出的是干触点信号，需与门禁电源配合接线。
弱电信号测试
使用Postman模拟服务器发送
power1=1，观察继电器是否吸合（通常伴随“滴答”声）。
6. 常见问题与优化
关于负载功率： 虽然第4路标称6600W，但在集成空调这类感性负载时，启动瞬间电流极大。单台MINI控制器对应一台1.5P-2P空调，不要并联多台大功率设备，否则容易烧毁触点。
网络稳定性： WiFi连接在公共网络环境下可能受干扰。
方案： 利用控制器支持“5组WiFi”备用的特性，设置主用和备用SSID（如门店主路由+备用路由）。
容灾： 增加断网重连机制。如果网络断开，用户无法通过扫码控制，应保留基础的物理开关作为应急。
语音播报延迟： TTS版本通过网络获取音频流，如果公网带宽不足，播报会有延迟。若对实时性要求比较高，仅将TTS用于提示音，关键信息依赖用户手机推送。
7. 总结
通过集成芯步4路包间电源控制器MINI，开发者可以利用其 “4路独立大功率继电器+开放API+可选语音” 的特性，在不编写嵌入式固件的情况下，仅通过几行HTTP代码，构建一套完整的共享空间无人值守系统。该方案平衡了成本（无需网关）与可靠性（支持私有化），是当前服务型门店数字化转型的优选方案。