怎样在4路10A/16A/30A多规格输出控制器MINI中对接智能硬件以实现空调电源控制_解决方案

CATALOG

针对芯步4路多规格输出控制器MINI，给出空调电源控制的完整对接方案，包含硬件选型、接口调用、业务逻辑与异常处理。

1. 解决概述

在商业场景（如棋牌室、办公室、公寓）中，空调往往是最大的能耗来源，且常因忘记关闭而导致严重浪费。芯步推出的 4路多规格输出控制器MINI 是一款具备混合负载能力的智能硬件，其第4路专门配备了大功率继电器，非常适合用于空调的电源级控制。

本方案的目标是通过该设备开放的 HTTP API接口，将传统空调升级为可远程管控、可定时的智能设备，解决长明灯、长转空调带来的电费损失问题。

2. 硬件选型与接线指南

2.1 为什么选用此设备？

针对空调控制，市面上很多10A控制器无法承受空调启动时的瞬时高电流。该MINI控制器的核心优势在于混合输出：

场景适配：尺寸极小（72mm*90mm），易于隐藏在空调附近的天花板或弱电箱中。
多规格负载：提供4路输出，其中第4路支持高达 30A 的电流，可直接承载2匹甚至更大功率的空调柜机/挂机。
通信方式：直连WiFi 2.4GHz，无需额外购买网关，降低部署成本。

2.2 接线方案

在对接空调时，通常有两种模式，请根据实际场景选择：

方案A：电源级通断控制（适配：普通壁挂/柜机空调）
- 操作：将空调的电源插头插入或并联至控制器的第4路输出接口（30A继电器）。
- 逻辑：软件直接控制220V市电的通断。
- 优点：安装最简单，彻底断电零耗电。
- 注意：断电再通电后，部分空调需要手动按遥控器开机（视空调上电自启功能而定）。配合红外遥控器或空调的“上电自启”设置使用。
方案B：强电检测 + 红外控制（适配：需保留原厂功能的场景）
- 操作：第4路保持常通，仅作为状态监测；利用控制器其他线路联动红外转发器。
- 逻辑：通过HTTP接口发送指令给红外设备，模拟遥控器信号进行温度、模式调节。

3. 开放接口对接原理

该设备支持通过芯步开放平台进行远程调用。核心流程遵循：业务系统 -> HTTP请求 -> 芯步云平台 -> WiFi -> 控制器MINI -> 空调。

3.1 核心接口与鉴权

所有控制指令均需通过签名（Sign）验证，以防止接口被恶意篡改。

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

签名算法（基于官方通用规则）sign = md5( md5(AppSecret) + ts )其中 ts 为Unix时间戳（秒），AppSecret 为开发者密码。

3.2 控制指令（Order）定义

针对本方案中的“空调控制”，我们主要操作第4路。根据芯步的产品手册，控制指令的JSON格式如下

开启空调电源{"power4":1} （其中4代表第4路，1代表接通/开启）
关闭空调电源{"power4":0}

注意：如果用户需要控制照明或排风扇（1-3路），只需将power4改为power1、power2或power3即可，其中第3路通常用于门禁或小功率设备。

4. 代码实施示例

无论您使用哪种后端语言，只需支持HTTP请求即可。以下是基于两种主流语言的对接示例（参考芯步通用API规范）：

4.1 Java 实现（使用Unirest）

适用于Spring Boot等后端服务。核心在于动态计算签名。

import com.konghq.unirest.http.HttpResponse;
import com.konghq.unirest.http.Unirest;
import org.apache.commons.codec.digest.DigestUtils;

public class AirconController {
    public static void main(String[] args) {
        String AppID = "YOUR_APP_ID";
        String AppSecret = "YOUR_APP_SECRET";
        long ts = System.currentTimeMillis() / 1000;
        
        // 1. 计算签名（官方标准算法）
        String sign = DigestUtils.md5Hex(DigestUtils.md5Hex(AppSecret) + ts);
        
        // 2. 构建URL
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", AppID, sign, ts);
        
        // 3. 构建Body: device是贴在设备上的ID，order是指令
        String deviceId = "11360045"; // 替换为你的控制器ID
        String order = "{\"power4\":1}"; // 开启第4路空调电源
        
        String body = String.format("{\"device\":\"%s\",\"order\":%s}", deviceId, order);
        
        // 4. 发送请求
        HttpResponse<String> response = Unirest.post(url)
                .header("Content-Type", "application/json")
                .body(body)
                .asString();
        
        System.out.println("控制结果:" + response.getBody());
    }
}

4.2 Python 实现（使用HTTP.client）

适用于脚本、自动化工具或云函数。

关于异步反馈：接口返回200仅代表指令下达成功。若需确认空调是否真的执行了动作（例如继电器是否吸合），在业务系统中配合设备状态查询接口或接收芯步的消息推送（Webhook）来更新设备状态。

5. 业务场景闭环设计

单纯的远程开关过于“原始”，结合开放接口，可以构建更智能的“防呆”机制

5.1 定时任务与无人值守

场景：棋牌室/包间结束后，店员忘记关空调。解决方案

退单联动：在您的SaaS系统中，当用户点击“退单/结账”时，触发HTTP请求，向MINI控制器发送{"power4":0}指令。
硬定时：利用控制器的内置定时功能或您的云服务器定时任务，设置凌晨2:00强制断电第4路，避免过夜浪费。

5.2 电流检测与状态回执（进阶）

MINI控制器支持采集负载功率（第4路阻性负载最高6600W）。

逻辑：下发开机指令 -> 等待30秒 -> 读取设备当前功率。
应用：如果功率为0，说明空调未启动或跳闸，系统自动重试或报警。

5.3 语音播报联动（TTS版）

如果您选购的是TTS版本（带语音播报）

场景：当系统检测到空调已运行2小时且包间无人移动时，可以通过HTTP接口下发语音指令，如{"play:gbk:16":"亲，空调已运行2小时，需要为您关闭吗？"}，提醒顾客或保洁。

6. 方案价值总结

通过对接芯步MINI控制器的开放接口，您可以实现：

无损改造：无需破坏空调原有内部电路，仅控制电源或搭配红外，施工简单。
精细化运营：可视化的电量统计与远程控制，帮助商业体降低20%-30%的无效空调能耗。
高安全性：第4路30A的高负载能力保证了继电器触点留有足够余量，避免大电流烧毁设备的风险。

实施步骤：确认空调功率（是否≤2匹） -> 购买MINI控制器 -> 安装接线至第4路 -> 在芯步控制台获取AppID/Secret -> 调用上述接口代码测试通断。