怎样二次开发4路共享空间智能控制器MINI以实现包间预约联动通电_解决方案

CATALOG

芯步4路Mini控制器通过开放HTTP API，可将包间预约与通电流程无缝联动。以下方案以“用户下单→自动通电→计时结束→自动断电并清场”为闭环，覆盖接口调用、硬件接线和异常处理等关键环节。

解决方案：基于芯步4路智能控制器Mini的包间预约联动系统

1. 概述与硬件映射

本方案的目标是通过二次开发，将用户的线上预约订单与线下包间物理设备绑定。利用 4路智能控制器Mini 的4路独立继电器输出，分别控制包间内的关键设备。当用户下单后，系统自动为对应的包间通电并开启门禁；订单结束后，自动断电清扫。

硬件角色映射：

第1路 (16A)：控制 照明/氛围灯。预约开始前5分钟自动开启预热，结束后关闭。
第2路 (16A)：控制 核心电器（麻将机/饮水机/按摩椅）。同步订单时间通电。
第3路 (10A)：控制 门禁电磁锁。这是联动核心——用户支付成功后门锁断电（开锁），用户进入后门锁通电（锁门），确保只能在使用时段内进入。
第4路 (30A)：控制 2匹空调。预约开始自动打开，或由用户通过小程序远程开关。

2. 业务流程设计

系统在接收到前端（小程序/公众号）回调后，请求后端业务系统，后端业务系统再调用芯步开放 API，流程如下：

sequenceDiagram
    participant User as 用户端
    participant Biz as 业务后端
    participant Yoyo as 芯步API
    participant Device as 包间控制器(Mini)

    User->>Biz: 1. 支付下单/扫码签到
    Biz->>Biz: 2. 校验订单与包间映射
    Biz->>Yoyo: 3. 请求指令:开门+通电
    Note right of Yoyo: POST /device/control/
    Yoyo-->>Biz: 4. 返回成功状态
    Biz-->>User: 5. 提示"门锁已开，开始计时"
    
    loop 使用中轮询检查
        Yoyo->>Device: 保持心跳与状态
    end

    Note over Biz: 订单时间结束 / 用户点击退场
    Biz->>Yoyo: 6. 请求指令:断电+锁门
    Yoyo->>Device: 下发关闭所有继电器指令

3. 详细开发与接线指南

3.1 硬件接线规范

在进行二次开发前，需由电工完成物理接线：

控制器端口	推荐接线设备	接线说明
L / N	220V 市电输入	控制器本身供电，需注意Mini版为5V1A DC适配器供电（需接入强电箱）。
第1路输出	包间顶灯	零火线接入继电器常开端，实现远程关灯（省电）和开灯（迎宾）。
第2路输出	插座回路	接麻将机、新风系统。为防止设备频繁启停损坏，插座回路保持通电或跟随订单。
第3路输出	电磁锁 (常闭型)	关键点：通常选用断电开锁的磁力锁。控制器的“常闭”端接锁电源，用户付款后断开电路，门弹开。
第4路输出	空调	接空调电源，配合红外遥控器（需额外学习码）或直接通断电（仅限部分机型）。

3.2 接口鉴权与二次开发封装

芯步采用动态签名认证，不前端直接调用，请一定要由后端服务完成以避免 AppSecret 泄露。

签名算法（伪代码示例）：

3.3 核心命令下发逻辑

你需要对接以下三个核心场景的指令：

第一种场景：预约开始（用户支付成功）

目标：开门 + 全屋通电。
指令内容：使用批量控制。
- order 字段：{"batch":{"relay":[1,2,4], "power":1}} （第3路门锁单独处理逻辑）
- 门锁逻辑：通常第3路接电磁锁，需设置几秒的断电开锁时间，然后立刻恢复供电以锁门。
- 推荐流程：{"power3":0}（开锁） -> sleep 3s -> {"power3":1}（闭锁）。

第二种场景：倒计时提醒（订单即将结束）

目标：TTS语音播报提醒用户续费。
适用版本：仅限 UNI-KZQ-BJ-MINI-TTS 版本。
指令内容
- order 字段：{"play:gbk:16":"您还剩10分钟，请及时续费"}

第三种场景：订单结束/强制清退

目标：切断所有电器电源，确保安全。
指令内容
- order 字段：{"power":0} （一键全关）

4. 关键运维与优化

1. 防“跳闸”与浪涌保护由于控制器支持 6600W 高功率，在包间集中通电瞬间可能产生大电流。在二次开发逻辑中增加“分批启动”功能，避免所有电器同时启动导致线路过载：

0秒：开照明（第1路）
3秒：开空调（第4路）
10秒：开插座电器（第2路）

2. 局域网直连模式（私有化）若你的棋牌室或办公楼网络环境不稳定，或担心云端延迟，可启用控制器的局域网 API 功能。控制器连接 WiFi 后，业务服务器可直接向控制器的 IP 地址发送 HTTP 请求，绕开云端，响应速度可达毫秒级。

3. 状态同步与异常处理

防“霸座”机制：增加定时任务（Cron Job），每 5 分钟扫描一次数据库。若发现订单超时但设备仍处于通电状态，自动调用 {"power":0} 强制断电。
断网重连：由于设备仅支持 2.4G WiFi，开发时可配置多组 WiFi 备份，确保设备在网络波动后自动重连。

5. 总结

通过对接芯步 4路 Mini 控制器的开放 API，你可以用极低的开发成本（仅需处理 HTTP 请求和签名）将硬件纳入原有的 SaaS 系统。这套方案不仅实现了 “预约即通电，关门即断电” 的无人值守闭环，其高达 30A 的空调专用接口也彻底解决了共享空间最大的能耗管理问题。