如何在4路包间设备控制模块MINI中接入智能硬件来实现远程重置包间设备状态_解决方案

CATALOG

芯步的4路Mini控制器支持通过HTTP接口远程控制每路电路的独立开关，非常适合棋牌室、茶室等场景。以下方案围绕“一键重置”这一典型运维需求展开，涵盖下单、调用、校验到反馈的完整流程。

1. 背景与需求分析

在共享棋牌室、足浴SPA、剧本杀等计时消费场景中，用户离开现场时后，服务人员需要进入包间手动关闭麻将机、空调、照明并给门禁断电。这种传统方式效率低下，且容易因电器未关（尤其是空调）造成巨额能源浪费。

痛点：无法在用户离开现场时结算后，实时、可靠地将包间内所有电器恢复至初始状态（全关状态）。

解决目标：利用芯步 4路包间设备控制模块 MINI 的开放接口，将“一键重置”功能集成到商家SaaS系统（收银系统/小程序管理端）中，实现远程全量复位。

2. 硬件与接口特性

在实施对接前，需明确所使用硬件的底层能力。

硬件型号：智能包间控制器 Mini (UNI-KZQ-BJ-MINI)。
实际负载
- 第1/2路：16A，适用于麻将机、饮水机、照明。
- 第3路：10A，专用于门禁电磁锁（直流）。
- 第4路：30A，适用于2匹空调挂机/柜机。
通讯协议：支持 HTTP API（最常用）及 MQTT。
对接优势：设备直连WiFi 2.4G，无需额外网关，支持私有化部署。

3. 技术实现方案：远程重置流程

要实现“远程重置”，不仅仅是将所有路数设为0，还需要处理业务逻辑（如：是否先关闭空调再关闭门禁，防止压差过大），并验证指令是否真实执行。

3.1 签名机制（鉴权）

所有指令都需要通过签名验证，防止非法调用。计算公式如下：

参数AppID， AppSecret， ts（当前Unix时间戳秒）。
算法Sign = MD5( MD5(AppSecret) + ts )

3.2 接口调用端点

URLhttp(s):// api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}
Method：POST
HeaderContent-Type: application/json

3.3 核心指令设计：“重置”与“全关”

针对“重置包间设备状态”，推荐两种指令下发模式，可根据具体场景（如清扫期间不断电VS离开现场时必须断电）选择：

方案A：标准全关指令（最常用）

场景：用户离开现场时结账后。逻辑：直接将所有线路断开。

方案B：先断后通（Reset）指令（高级保护）

场景：某些老旧设备需要复位或清除故障码（如某些麻将机主板需短暂断电重启）；或者门禁复位逻辑——先断电，再通电（为了触发开锁信号）。MINI控制器原生支持reset复合命令：

3.4 结果验证机制（可靠性保障）

仅仅收到HTTP 200并不代表设备真的断电了（设备可能离线）。为了确保“远程重置”真实有效，必须结合异步消息推送。

命令接收：调用接口后收到 {"code": 200}，代表平台接收指令。
设备执行反馈：配置接收上行消息的URL。设备执行命令后会向该URL推送执行结果。
超时重试机制：若未收到设备推送的成功执行回执（如设备掉线），SaaS系统应启动定时任务，5秒后再次尝试发送“状态查询”指令或再次发送重置指令。

4. 业务场景流程

以下是“远程重置”在无人值守棋牌室中的完整时序逻辑：

第一步：用户下钟

用户在手机端点击“请求离开现场时/结账”，SaaS系统冻结订单，暂不断电（给用户5分钟离开现场时缓冲）。

第二步：清场检测（可选）

商家后台触发“清场模式”。系统调用接口查询MINI控制器当前状态（如空调是否被用户恶意调至16度），确认无误。

第三步：执行远程重置

SaaS系统后台发起HTTP POST请求。

先发门禁（第3路）：有的方案需要先让门锁断电以无法从内部开门，但第3路通常接电插锁（断电开锁），故重置阶段通常保持第3路断开以让门处于闭锁状态，待下一位客人下单时再通电开锁。
后关电器（1，2，4路）
- 关闭第1路（麻将机/照明）。
- 关闭第2路（饮水机/新风）。
- 延迟关闭第4路（空调）：为了保护空调压缩机，先发送power4=0指令，或者通过协议设置延迟。

阶段四：状态同步

系统收到设备返回的power1=0等确认信息后，运营后台界面显示“包间已复位，待租”。

5. 代码实现示例（伪代码/后端逻辑）

以下以Node.js为例，展示封装“重置包间”函数的核心逻辑：

const crypto = require('crypto');
const axios = require('axios');

// 初始化芯步配置
const AppID = 'YOUR_APP_ID';
const AppSecret = 'YOUR_APP_SECRET';

// 生成签名
function generateSign(ts) {
    const step1 = crypto.createHash('md5').update(AppSecret).digest('hex');
    const step2 = crypto.createHash('md5').update(step1 + ts).digest('hex');
    return step2;
}

// 远程重置包间设备 (Mini 4路)
async function resetRoomDevice(deviceId) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(ts);
    const url = `https://api.thingboot.com/${AppID}/device/control/?sign=${sign}&ts=${ts}`;

// 构造关闭所有4路设备的指令
    const payload = {
        device: deviceId,
        order: {
            power1: 0, // 关麻将机/照明
            power2: 0, // 关插座
            // power3: 0, // 门禁通常保持在断电上锁状态，根据实际接线决定
            power4: 0  // 关空调
        }
    };

try {
        const response = await axios.post(url, payload, {
            headers: { 'Content-Type': 'application/json' }
        });
        
        if (response.data.code === 200) {
            console.log(`指令已下达，设备 ${deviceId} 正在执行复位`);
            // 此处记录日志，并等待设备回调确认最终状态
            return true;
        } else {
            console.error(`控制失败: ${response.data.code}`);
            return false;
        }
    } catch (error) {
        console.error('网络请求异常', error);
        return false;
    }
}

6. 关键注意事项

空调保护机制：频繁远程断电会损坏空调压缩机。如果业务允许，在重置逻辑中加入“软关”逻辑（如通过红外遥控发送关机指令）或仅关闭空调插座但在关机后保持待机，或者利用MINI控制器的定时任务功能延迟断电。
门禁安全逻辑：切勿在用户还在包间内时远程切断门禁电源（若电锁是断电开锁类型），否则门会打开导致安全隐患。重置逻辑应在用户结账离开现场时确认后触发。
网络稳定性：MINI使用2.4G WiFi，若包间信号弱，可能导致指令丢失。部署时开启设备的“多WiFi设定”功能，确保信号覆盖。
私有化部署：数据涉密的场所，可使用芯步支持的私有化部署方案，将API切换至局域网地址，降低公网延迟。

通过以上方案，商家可在用户离开现场时后一键完成包间复原，极大提升翻台率，实现真正的无人值守化管理。