4路包间智能开关控制器MINI：怎样将4路包间设备控制器MINI接入到项目中_解决方案

CATALOG

4路包间智能开关控制器MINI是一款专为棋牌室、茶室等场景设计的轻量级设备，支持4路独立控制（照明、插座、门锁、空调）及TTS语音播报。以下方案涵盖硬件准备、接口对接、核心功能实现及典型场景。

解决方案：4路包间智能开关控制器MINI接入项目实战

1. 产品概述与准备工作

1.1 设备核心功能

4路独立控制
- 第1路（16A）：控制照明、排风扇、吸烟灯。
- 第2路（16A）：控制饮水机、麻将机、按摩椅。
- 第3路（10A）：控制门禁电磁锁（直流）。
- 第4路（30A）：控制2匹空调。
TTS语音播报（可选）：订单播报、服务提醒。
网络连接：仅支持2.4G WiFi直连，无需网关。

1.2 接入前的准备工作在芯步控制台完成以下三步：

注册与创建应用：登录后获取 AppID 和 AppSecret（API密钥）。
设备配网：将设备通电，通过控制台或小程序为其配置现场WiFi（需2.4G频段）。
获取设备ID：配网成功后，在设备列表页面获取 Device ID（例如：1878）。

2. API接入核心：签名机制与指令集

设备开放标准HTTP API，适用于任何编程语言（PHP/Java/Python/Go）。

2.1 签名计算规则为防止接口篡改，每次请求需携带动态签名sign和时间戳ts。注意：时间戳相差不能太大，否则请求失效。

计算步骤（以设备ID=1878，打开第1路为例）：

准备参数
- AppSecretabc123
- ts1715328000（当前Unix时间戳）
拼接字符串
- 第一步：md5(abc123) = e99a18c428cb38d5f22e03
- 第二步：md5(e99a18c428... + "1715328000") = f25a2fc7e639a123...
发起请求
- URL：https://api.thingboot.com/{AppID}/device/control/?sign=f25a2fc7...&ts=1715328000
- POST Body：
  { "device": "1878", "order": {"power1": 1} }

2.2 完整控制指令表请参考下表构建 order 参数：

功能描述	指令示例 (`order`)	适用场景
单路开关	打开第1路：`{"power1":1}`关闭第3路：`{"power3":0}`	单独开灯、关空调
批量全控	全开：`{"power":1}`全关：`{"power":0}`	包间断电清洁、上电迎客
自定义组合	只开1和4路：`{"batch":{"relay":[1,4],"power":1}}`	预设场景（照明+空调，插座断电）
复位/点动	第2路断开2秒后复位：`{"reset2":"2000"}`	麻将机重启、设备复位
语音播报	`{"play:gbk:16":"欢迎光临，祝您愉快"}`	客人进/出门店时播报

3. 深度集成：场景实战与进阶配置

对接不仅是发指令，还要考虑业务流闭环。

3.1 典型场景：用户扫码开单

用户支付：小程序/网页收到支付回调。
下发指令：后端调用API，发送 {"power":1}（全开）。
语音联动：调用TTS接口，播报“您好，包间已通电，祝您用餐愉快”。
计时开始：数据库记录订单开始时间。

3.2 典型场景：无人值守自动断电

门磁逻辑：第3路接电磁锁。
实现：用户点击“结束订单”。
1. 发送命令：{"power":0}（关闭所有电器）。
2. 延迟3秒后（待空调压缩机停稳）发送：{"power3":0}（断电开锁，方便顾客离开）。
3. 全店断电完成。

3.3 进阶：设备状态同步与私有化

状态同步（Webhook）在控制台配置“设备状态推送URL”。当设备状态改变时，芯步服务器会主动 HTTP POST 请求你的服务器，更新当前设备功率或开关状态。
局域网/私有化部署若项目要求纯内网环境，设备端可配置局域网IP，api.thingboot.com 可替换为设备局域网IP进行通信，保障数据不外流。

4. 代码实战（PHP 示例）

以下代码展示了如何在实际业务中封装函数来控制设备开关。

<?php
// 配置信息
$appId = '你的应用ID';
$appSecret = '你的应用Secret';
$deviceId = '1878'; // 包间A的设备ID

// 函数:控制设备
function controlDevice($appId, $appSecret, $deviceId, $orderData) {
    $ts = time();
    // 1. 生成签名:md5( md5(Secret) + ts )
    $step1 = md5($appSecret);
    $sign = md5($step1 . $ts);
    
    // 2. 构建请求
    $url = "https://api.thingboot.com/{$appId}/device/control/?sign={$sign}&ts={$ts}";
    
    $postData = json_encode([
        'device' => $deviceId,
        'order' => $orderData
    ]);
    
    // 3. 发送CURL请求 (此处省略curl_setopt详细配置)
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    $response = curl_exec($ch);
    curl_close($ch);
    
    return $response;
}

// 业务场景1:客人续费，再开1小时空调（假设第4路是空调，当前是关的0）
if ($needExtend) {
    controlDevice($appId, $appSecret, $deviceId, ["power4" => 1]);
    // controlDevice($appId, $appSecret, $deviceId, ["play:gbk:16" => "已为您续费成功，空调已开启"]); // TTS播报
}

// 业务场景2:检查门锁状态（假设第3路是门锁，状态保持1秒后自动断）
// 实现点动开门:{"point3":"1000"}
if ($openDoor) {
    controlDevice($appId, $appSecret, $deviceId, ["point3" => "1000"]);
}
?>

5. 疑难排查和需要注意的点

感性负载限制MINI版第1、2路最大感性负载为 500W。如果接麻将机或电机，请确认功率不超过此值，否则触点易粘连。
空调接法第4路虽然支持30A直接控制2匹空调，配合空调的“得电开机”功能使用。即空调遥控器设置好模式，控制器只负责通断电。
WiFi稳定性若设备频发掉线，请检查现场WiFi 2.4G信道是否拥堵（避开信道6/11），并开启DHCP确保IP不冲突。
时间戳同步服务器时间若与标准时间偏差超过 5分钟，签名会验证失败，请确保服务器时间已同步。

通过以上步骤，可快速将芯步Mini控制器集成进现有系统，实现共享棋牌室、茶室的智能化改造。