怎样在4路包间灯光空调控制器MINI中对接智能硬件以实现包间预约联动通电_解决方案

CATALOG

芯步的MINI控制器支持HTTP接口直接调用，这为“预约-通电”联动提供了标准化的技术基础。以下方案从接口鉴权、设备控制到业务逻辑串联，给出完整的对接路径，你可根据实际预约系统进行适配。

——基于芯步智能包间控制器MINI的开放接口

1. 项目概述

在共享棋牌室、茶室、剧本杀店等无人值守场景中，痛点是包间用电管理与订单同步的脱节。传统模式下，顾客预约后仍需联系前台通电，或者包间设备在空闲期长期待机造成浪费。

本方案的目标是通过对接 芯步智能包间控制器MINI 的开放 HTTP API 接口，将商业场地原有的预约软件（小程序/公众号/SaaS系统）与硬件设备打通，实现 “预约即准备，断电即结算” 的全自动化流程。

2. 硬件功能解析

在开发对接前，需明确硬件的电路属性，本方案利用MINI控制器的4路独立控制能力实现不同电器的策略管理

输出线路	接口类型	推荐接入设备	联动策略说明
第1路	16A 开关	照明灯、换气扇	随订单通断：用户下单成功即通电，订单结束即断电。
第2路	16A 插座	麻将机、饮水机	随订单通断：主设备电源，订单开始时通电，结束时切断。
第3路	10A 门禁	电磁锁、电插锁	逻辑取反控制：未下单时通电上锁，下单成功后断电开锁（门禁通常是断电开锁）。
第4路	30A 空调插座	2匹空调	特殊逻辑控制：为避免压缩机频繁启动损坏，预约开始前提前送电，但不直接关机，需配合红外遥控或逻辑优化。

注意：该设备仅支持 WiFi 2.4G 频段，无需网关，部署时需确保包间 WiFi 信号覆盖。

3. 接口对接技术方案

3.1 鉴权与签名机制

芯步的接口采用动态签名鉴权，所有设备控制请求必须携带 sign 和 ts 参数。后端必须严格在服务器端计算签名，严禁在前端代码中暴露 AppSecret。

签名算法步骤

将 AppSecret 进行第一轮 MD5 加密： md5_str = md5(AppSecret)
拼接时间戳： enc_str = md5_str + ts （ts为当前Unix时间戳秒）
计算最终签名： sign = md5(enc_str)

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3.2 核心指令下发逻辑

预约系统需要向指定设备（Device ID）下发 JSON 格式的 order 指令。

场景 A：用户下单成功（预约时间开始）系统需批量下发指令，实现“通电开门”：

：对于空调（第4路），在预约时间 提前10-15分钟 下发此指令，实现预冷/预热，提升用户体验。

场景 B：用户订单结束/超时系统需切断所有非必要电源，并锁门，同时确保门禁恢复供电锁门。

3.3 关键难点处理：第3路（门禁锁）的对接逻辑

这是一个容易出错的点。物理门禁锁（磁力锁/电插锁）通常是 断电开锁。

逻辑定义：当 power3 = 1 时，锁体通电，门吸住（锁门状态）； power3 = 0 时，锁体断电，门可打开。
业务代码在数据库或状态机中，不要用“通断电”来思考，要用“开门/关门”来思考。
- call_unlock_door() 函数应调用 {"power3":0}
- call_lock_door() 函数应调用 {"power3":1}

3.4 空调精细化控制

由于硬件仅控制空调插座通断电，直接断电会导致空调失去记忆功能或强行关机。：

配合红外/万能遥控器：如果有 TTS 版本，可配合红外发射头，先通过 HTTP 下发关闭空调指令，延时 2 分钟后再切断第4路电源。
基础方案：直接断电。仅适用于支持断电记忆的机械式旋钮空调或低成本场景。

4. 业务逻辑流程设计

4.1 预定-通电时序图

sequenceDiagram
    participant 用户
    participant 小程序/预约系统
    participant 云端服务器(芯步API)
    participant MINI控制器

    用户 ->> 小程序/预约系统: 1. 提交订单并支付
    小程序/预约系统 ->> 小程序/预约系统: 2. 记录订单状态(待服务)
    Note over 小程序/预约系统: 定时任务触发(预约时间前10分钟)
    小程序/预约系统 ->> 云端服务器(芯步API): 3. POST /device/control (预冷空调+开灯)
    云端服务器(芯步API) ->> MINI控制器: 4. 下发指令(power4=1, power1=1)
    MINI控制器 ->> MINI控制器: 5. 执行继电器吸合
    Note over 用户: 用户到达现场
    用户 ->> 小程序/预约系统: 6. 点击"开门/开始"
    小程序/预约系统 ->> 云端服务器(芯步API): 7. 下发开锁指令(power3=0)
    云端服务器(芯步API) ->> MINI控制器: 8. 断开第3路电
    MINI控制器 ->> 门禁锁: 9. 门锁断电，门体弹开
    用户 ->> 包间: 10. 进入包间
    用户 ->> 小程序/预约系统: 11. 手动控制设备(可选)
    小程序/预约系统 ->> MINI控制器: 12. 独立控制照明/麻将机

4.2 异常处理机制

断网重连：MINI 控制器支持设定 5 组 WiFi，会自动重连。软件层需设计下发失败重试队列（如重试3次，间隔5秒）。
超时自动断电：监听预约系统的 Webhook 订单结束事件，主动调用断电接口。
急停按钮：虽然无附件，但在方案设计中，物理端仍需保留墙面开关作为 HTTP 控制的备份，以便现场维护。

5. 实施方案步骤

第一步：硬件部署与配网

将 MINI 控制器安装于包间配电箱内（注意：第4路负载可达 6600W，需使用专用空调插座接线）。
通过设备热点将其连接至包间 2.4G WiFi。

第二步：获取 API 凭证

登录芯步控制台，获取 AppID 和 AppSecret。
获取设备的唯一 Device ID（通常在配网后可见）。

第三步：中间件开发编写一个独立的 Service （如 YoyoControlService），封装 MD5 签名生成逻辑和 HTTP Client，供预约系统调用。

第四步：业务系统对接在现有预约管理后台添加“硬件管理”模块：

创建包间：绑定包间名称与 Device ID。
策略配置：配置提前送电时间（如下单即送电 vs 提前10分钟送电）。

第五步：测试验证“发起订单 -> 空调启动”和“点击结束 -> 全屋断电上锁”的闭环。

6. 总结

利用芯步 MINI 控制器提供的标准 HTTP 接口，可以较低成本实现无人值守包间的自动化改造。开发人员无需关注底层通讯协议，只需专注于业务逻辑层对 4路继电器 的时序控制，特别是处理好 门禁（第3路）的逻辑反转 和 空调（第4路）的保护策略，即可实现稳定可靠的包间预约联动通电解决方案。