如何二次开发4路包间智能远程控制器MINI以实现照明换气扇电源控制_解决方案

CATALOG

芯步智能包间控制器Mini提供了标准HTTP接口，四路输出可分别接照明、换气扇、门禁和空调。以下方案涵盖接口鉴权、单路/批量控制实现，以及扫码点单联动关断等典型场景的代码示例。

解决方案：基于芯步开放接口的4路包间控制器二次开发（照明与换气扇控制）

1. 背景与目标

在共享棋牌室、茶室或无人值守包间场景中，通常需要通过软件系统自动控制环境设备。本方案的目标是利用 芯步智能包间控制器Mini （UNI-KZQ-BJ-MINI） 的开放API接口，将其无缝集成到现有的SaaS系统（如扫码点单系统、计费系统）或小程序中。

核心目标：

实现包间内 照明灯 和 换气扇 的远程通电与断电。
实现“一键撤单”全关功能（关灯、关排风、断电）。
确保控制链路的实时性与安全性。

2. 设备选型与接线定义

根据产品手册，智能包间控制器Mini 提供4路独立输出。针对照明与换气扇场景，物理接线方案如下：

第1路（Power1）：连接 照明灯。
- 接口规格：16A开关接口。
- 负载类型：感性/阻性负载。适用于LED灯、节能灯。
第2路（Power2）：连接 换气扇/排风扇。
- 接口规格：16A插座接口。
- 适用场景：排风系统。
第3路（Power3）可选门磁/电锁（本方案暂不涉及，可保留给门禁）。
第4路（Power4）：空调或其他大功率设备。

二次开发基础：设备支持 HTTP API 及 私有化部署（局域网直连），无需网关，上电即连WiFi 。

3. API 接口调用流程

芯步的开放接口采用标准的 HTTP POST 请求，签名机制为 MD5 ( MD5 (AppSecret) + ts )。

3.1 准备工作

在芯步控制台获取以下凭证：

AppID：应用唯一标识。
AppSecret：应用密钥（请勿泄露）。
Device ID：目标包间控制器的设备编号。

3.2 签名算法（核心逻辑）

在发起请求前，必须动态计算 sign 参数：

将 AppSecret 进行第一次 MD5 加密，得到 encode_secret。
将 encode_secret 与当前时间戳 ts （单位：秒）拼接成字符串 encode_secret + ts。
对上一步的字符串进行第二次 MD5 加密，得到最终的 sign。

公式sign = MD5 ( MD5 (AppSecret) + ts )

4. 核心功能实现逻辑

以下是针对照明和换气扇控制的具体代码逻辑实现（伪代码/思路）。

4.1 单独控制（开/关照明或换气扇）

场景：用户下单后自动开灯、开排风；或用户在小程序上点击“关闭换气扇”。

请求地址https://api.thingboot.com/{AppID}/device/control/？sign={sign}&ts={ts}
请求方式：POST （Content-Type： application/json）
请求Body示例

注意：第1路照明、第2路换气扇的开关状态完全独立，互不干扰。

4.2 场景化联动（一键上钟/下钟）

场景1：用户下单/开台（上钟）动作：开启包间照明+开启换气扇。Order命令：

场景2：用户结算/离开现场时（下钟）动作：关闭所有设备（照明、排风等）。Order命令：

利用 batch 命令可以一次性切断所有电源，避免逐一发送多个指令，提高系统效率。

4.3 定时任务与自动化（高级特性）

场景：为防止用户离开现场时后未关空调或忘记关排风导致耗电。实现方案

应用层定时：在您的业务服务器上设置定时器（如使用 Quartz 或 Linux Crontab）。
用户下单时，设定一个“预计结束时间”。
若用户未续费，时间到达后，服务器自动调用 API 发送 {“power2”：0} （关排风）或 {“power1”：0} （关灯）。
硬件级备份：利用设备支持的“远程定时任务”功能，在云端预设策略，即使服务器断网也可执行。

5. 代码示例：使用 Java 实现控制层

以下是一个简化的 Spring Boot 示例，演示如何封装调用逻辑来控制照明和换气扇。

// 1. 引入必要的库 （HttpClient， JSON）
import okhttp3.*;
import java.security.MessageDigest；

// 2. 配置常量
public class DeviceConfig {
    private static final String APP_ID = "YOUR_APP_ID"；
    private static final String APP_SECRET = "YOUR_APP_SECRET"；
    
    // 计算签名的方法
    private static String getSign (String secret， long ts) throws Exception {
        // 第一次加密 AppSecret
        String md5Secret = md5 (secret)；
        // 拼接时间戳
        String signStr = md5Secret + ts；
        // 第二次加密
        return md5 (signStr)；
    }
    
    private static String md5 (String input) throws Exception {
        MessageDigest md = MessageDigest.getInstance ("MD5")；
        byte[] digest = md.digest (input.getBytes ())；
        // 转换为十六进制字符串（省略具体转换代码，开发时可用工具类）
        return bytesToHex (digest)；
    }
}

// 3. 控制照明与排风的服务类
public class DeviceControlService {
    public static void controlFanAndLight （String deviceId， int lightStatus， int fanStatus） {
        long ts = System.currentTimeMillis () / 1000；
        String sign = getSign (APP_SECRET， ts)；
        String url = "https://api.thingboot.com/" + APP_ID + "/device/control/？sign=" + sign + "&ts=" + ts；

OkHttpClient client = new OkHttpClient （)；
        
        // 构建 JSON 命令:同时控制第1路（照明）和第2路（排风）
        JSONObject orderJson = new JSONObject （)；
        orderJson.put ("power1"， lightStatus)； // 1或0
        orderJson.put ("power2"， fanStatus)；   // 1或0
        
        JSONObject bodyJson = new JSONObject （)；
        bodyJson.put ("device"， deviceId)；
        bodyJson.put ("order"， orderJson)；
        
        Request request = new Request.Builder ()
                .url (url)
                .post (RequestBody.create (MediaType.parse ("application/json")， bodyJson.toString ()))
                .build ()；
                
        // 执行请求（同步或异步）
        client.newCall (request).enqueue （...)；
    }
}

注：以上代码示例参考了芯步提供的Java对接规范。

6. 私有化部署与局域网控制（可选）

如果您的棋牌室运营系统部署在门店本地服务器，且对公网依赖性要求低：

该控制器支持 纯局域网环境 运行。
您可以将 API 请求地址指向设备的内网 IP 或通过自建消息服务器接收设备状态，实现“断网”情况下的本地控制，进一步提升稳定性。

7. 总结

通过上述二次开发方案，开发者可以利用芯步标准的 HTTP API，仅需 3-5 个工作日 即可完成照明与排风系统的对接。此方案不仅降低了硬件研发成本，还能通过软件算法（如定时关灯、离店全关）为共享包间场景实现 15%-20% 的节能。

关键点回顾

利用 Power1 与 Power2 接口分别对接照明与换气扇。
严格遵循 MD5（MD5（Secret）+ts） 签名机制。
使用 Batch 命令实现离开现场时一键全关。
结合业务系统定时器实现自动化巡检与节能。