怎样在4路远程包间电源管理模块MINI中对接智能硬件以实现空调电源控制_解决方案

CATALOG

一、概述

KTV包间、棋牌室、茶室等共享空间的空调控制是运营管理的核心环节。传统方案中，顾客离开现场时后空调容易遗忘关闭，造成严重能耗浪费；管理员也无法远程控制空调温度和服务模式。芯步4路远程包间电源管理模块MINI专为包间场景设计，第4路专为30A空调插座接口，可接2匹空调，通过开放HTTP接口实现空调电源的远程独立控制。

核心能力

第4路专用空调接口：30A插座接口，可接2匹空调，负载高达6600W
开放HTTP API：适用于任何支持HTTP请求的编程语言，10分钟完成对接
多种控制模式：支持直接通断、批量控制、先通后断（脉冲）、先断后通（重启）
私有化部署：支持局域网运行，数据安全可控
无网关设计：WiFi直连，可设定5组WiFi自动切换
TTS版本可选：支持远程语音播报，可用于订单提醒或服务说明

KTV包间4路电源分配方案

回路编号	接口类型	控制对象	负载能力	管理策略
回路1	16A开关	主照明/换气扇/吸烟灯	阻性≤3500W / 感性≤500W	订单开始自动开，结束自动关
回路2	16A插座	饮水机/麻将机/按摩椅	阻性≤3500W / 感性≤500W	按需开启或常开
回路3	10A门禁	电磁锁/电插锁	阻性≤2200W / 感性≤350W	一键开门
回路4	30A插座	2匹空调	阻性≤6600W / 感性≤1100W	订单联动、温度联动、定时控制

二、核心产品选型

2.1 智能包间控制器|MINI

芯步智能包间控制器|MINI（型号：UNI-KZQ-BJ-MINI）专为服务型门店包间场景设计，小尺寸版本，共提供4路输出，可基本覆盖包间内所有电器。第4路为30A插座接口，可接2匹空调。

特性	参数
产品型号	UNI-KZQ-BJ-MINI / UNI-KZQ-BJ-MINI-TTS（语音版）
控制路数	4路独立分控
工作电压	DC 5V1A（直流）
无线连接	WiFi IEEE 802.11 b/g/n 2.4GHz
外壳材质	防火V0级PC，耐高温，符合安规标准
产品尺寸	宽：72.0mm；长：90.0mm；厚：62.8mm
产品净重	211g
待机功耗	1.1（全断）- 5.2（全通）W

数据来源：

2.2 四路负载能力详解

回路	接口类型	阻性负载	感性负载	用途
回路1	16A开关	MAX 3500W	MAX 500W	照明、换气扇、吸烟灯
回路2	16A插座	MAX 3500W	MAX 500W	饮水机、麻将机、按摩椅
回路3	10A门禁	MAX 2200W	MAX 350W	电磁锁、电插锁（直流）
回路4（空调）	30A插座	MAX 6600W	MAX 1100W	2匹空调

数据来源：

2.3 版本选择

版本	适用场景	特点
标准版	仅需电源控制	4路独立通断控制
TTS语音版	需要语音播报提醒	支持订单提醒、服务说明等语音播报

三、整体架构

3.1 系统架构图

┌─────────────────────────────────────────────────────────────────┐
│                    KTV管理系统 / 小程序后台                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  订单处理   │  │  设备控制   │  │  定时任务   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 包间A    │       │ 包间B    │       │ 包间C    │
    │ 4路MINI  │       │ 4路MINI  │       │ 4路MINI  │
    │ ┌──────┐ │       │ ┌──────┐ │       │ ┌──────┐ │
    │ │照明  │ │       │ │照明  │ │       │ │照明  │ │
    │ │麻将机│ │       │ │麻将机│ │       │ │麻将机│ │
    │ │门禁  │ │       │ │门禁  │ │       │ │门禁  │ │
    │ │空调  │ │       │ │空调  │ │       │ │空调  │ │
    │ └──────┘ │       │ └──────┘ │       │ └──────┘ │
    └──────────┘       └──────────┘       └──────────┘

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

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

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名	`c484eb97...`

签名计算公式

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令详解

4.2.1 空调电源控制——核心命令

空调电源接在回路4，通过HTTP API控制：

命令格式参考：

4.2.2 先断后通（空调远程重启）

适用于空调主机死机时的远程复位：

先断后通命令说明：

4.2.3 批量控制（一键场景切换）

同时控制空调及其他设备：

批量控制命令说明：

4.2.4 门禁控制（先通后断）

回路3接电磁锁，开门时先接通、延时自动断开：

先通后断命令说明：

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class MiniRoomController:
    """4路MINI包间控制器"""
    
    # 回路编号映射
    RELAY_MAP = {
        "light": 1,     # 照明/换气扇（回路1）
        "device": 2,    # 饮水机/麻将机（回路2）
        "door": 3,      # 门禁电磁锁（回路3）
        "ac": 4         # 空调（回路4）
    }
    
    def __init__(self, app_id: str, app_secret: str, device_id: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts: int) -> str:
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, order: dict) -> dict:
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": self.device_id, "order": order}
        
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    
    # ========== 空调控制（核心功能）==========
    def ac_on(self) -> dict:
        """开启空调（回路4通电）"""
        return self._send_command({"power4": "1"})
    
    def ac_off(self) -> dict:
        """关闭空调（回路4断电）"""
        return self._send_command({"power4": "0"})
    
    def ac_restart(self, delay_ms: int = 10000) -> dict:
        """空调远程重启（先断后通）"""
        return self._send_command({
            "reset": {"relay": [4], "interval": delay_ms}
        })
    
    # ========== 订单联动 ==========
    def start_booking(self, with_ac: bool = True) -> dict:
        """订单开始:开启设备"""
        # 开启照明和门禁供电
        order = {"power1": "1", "power3": "1"}
        self._send_command(order)
        
        # 如需开启空调
        if with_ac:
            return self.ac_on()
        return {"status": "ok"}
    
    def end_booking(self) -> dict:
        """订单结束:关闭所有设备"""
        return self._send_command({
            "batch": {"relay": [1, 2, 4], "power": "0"}
        })
    
    # ========== 门禁控制 ==========
    def unlock_door(self, duration_ms: int = 3000) -> dict:
        """一键开门（先通后断）"""
        return self._send_command({
            "point": {"relay": [3], "interval": duration_ms}
        })
    
    # ========== 单路控制 ==========
    def control_device(self, device_name: str, on: bool) -> dict:
        """控制单个设备"""
        relay = self.RELAY_MAP.get(device_name)
        if relay:
            return self._send_command({f"power{relay}": "1" if on else "0"})
        return {"error": "invalid device name"}

# 使用示例
controller = MiniRoomController("your_app_id", "your_app_secret", "ktv_room_101")

# 顾客扫码下单，开启空调
controller.start_booking(with_ac=True)

# 顾客一键开门
controller.unlock_door()

# 空调死机，远程重启
controller.ac_restart(10000)

# 订单结束，关闭空调
controller.end_booking()

JavaScript/Node.js

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

class MiniRoomController {
    constructor(appId, appSecret, deviceId) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.deviceId = deviceId;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }
    
    async sendCommand(order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const payload = { device: this.deviceId, order };
        const response = await axios.post(url, payload);
        return response.data;
    }
    
    // 空调控制
    async acOn() {
        return this.sendCommand({ power4: "1" });
    }
    
    async acOff() {
        return this.sendCommand({ power4: "0" });
    }
    
    async startBooking() {
        // 开启照明和第4路（空调）
        await this.sendCommand({ power1: "1", power4: "1" });
        return this.sendCommand({ power3: "1" });
    }
    
    async endBooking() {
        return this.sendCommand({
            batch: { relay: [1, 2, 4], power: "0" }
        });
    }
}

Shell（curl）- 快速测试

五、空调控制场景实战

5.1 第一种场景：订单联动自动控制空调

需求：顾客扫码下单成功后，包间空调自动通电；订单结束时自动断电。

设备配置：第4路接2匹空调

5.2 第二种场景：空调远程重启（死机恢复）

需求：空调主机死机、遥控无响应时，远程断电重启恢复。

5.3 第三种场景：空调定时开关机

需求：根据营业时间自动开关空调，节约能耗。

实现的方式是：平台定时任务

任务名称	执行时间	命令	说明
早间预冷	07:30	`{"power4":"1"}`	营业前开启空调
晚间关机	23:00	`{"power4":"0"}`	营业结束后关闭

5.4 场景四：批量管理多包间空调

需求：运营人员后台统一控制所有包间的空调。

六、TTS语音播报版扩展功能

TTS版本支持远程语音播报，可用于订单提醒或服务说明。

语音播报命令示例

应用场景

空调开启时播报提示
订单即将结束时提醒续费
服务呼叫提醒工作人员

七、私有化部署方案

KTV运营方对数据安全要求较高，芯步4路MINI控制器支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接KTV内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出门店
网络依赖	需要互联网	仅需局域网

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

八、设备安装部署指南

8.1 安装要求

项目	要求
安装方式	标准配电箱安装
工作电压	DC 5V1A（直流，产品附带电源）
第4路负载	2匹空调，6600W（阻性）/ 1100W（感性）
网络要求	WiFi 2.4GHz信号覆盖良好
外壳材质	防火V0级PC，耐高温

数据来源：

8.2 KTV包间4路电源分配

回路	推荐用途	负载类型	注意事项
回路1	主照明/换气扇/吸烟灯	16A开关	LED灯负载<300W
回路2	麻将机/饮水机/按摩椅	16A插座	阻性负载<3500W
回路3	门禁电磁锁	10A门禁	直流供电，直接接线
回路4	2匹空调	30A插座	需配置专用大功率回路

8.3 空调接线注意事项

空调功率匹配：2匹空调制冷功率约1500-2000W，第4路负载6600W完全满足
进线电缆：第4路需匹配≥2.5mm²铜芯电缆
接线方式：空调插头直接插入30A插座，即插即用
电磁锁接线：回路3接电磁锁时，注意区分直流正负极
WiFi信号：金属配电箱可能屏蔽信号，使用外置天线版本

九、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号被屏蔽	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
空调无法通电	负载超限/接线问题	检查空调是否≤2匹，检查30A插座接线
空调运行时跳闸	电流过大	确认空调功率是否超过6600W
命令下发成功但设备无响应	设备离线	200仅表示平台接收，需确认设备在线状态
门禁锁无法开门	接线或锁类型问题	确认电磁锁为直流12V，回路3直接控制
语音播报不生效	非TTS版本	确认购买的是带TTS版本的型号

十、总结

本方案基于芯步4路远程包间电源管理模块MINI，实现了KTV包间空调的远程电源控制与订单联动管理

能力	实现的方式是
空调远程开关	`power4`命令独立控制第4路
空调死机重启	`reset`先断后通命令
订单联动断电	定时任务+批次控制
批量多包间管理	逗号分隔多个设备ID
门禁一键开门	`point`先通后断命令
语音播报提醒	TTS版支持远程语音
私有化部署	内网运行，数据安全可控

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
规划包间4路电源分配（第4路接2匹空调）
开发HTTP调用模块，封装空调控制命令
对接订单系统，实现支付→空调通电→定时关电闭环
物理安装控制器，空调插头接入回路4

方案优势

✅ 专用空调接口：第4路30A插座，6600W负载，专为2匹空调设计
✅ 接口统一：标准HTTP API，10分钟完成对接
✅ 订单全流程联动：从下单到离店自动化空调管理
✅ 超低延迟：80-120ms响应，操作即时生效
✅ 多种控制模式：通断、批量、脉冲、重启，适配全场景
✅ 私有化支持：数据安全可控，适合连锁门店部署

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。

一、概述

二、核心产品选型

2.1 智能包间控制器|MINI

2.2 四路负载能力详解

2.3 版本选择

三、整体架构

3.1 系统架构图

四、API接口接入详解

4.1 接口地址与签名计算

4.2 核心命令详解

4.2.1 空调电源控制——核心命令

4.2.2 先断后通（空调远程重启）

4.2.3 批量控制（一键场景切换）

4.2.4 门禁控制（先通后断）

4.3 多语言代码示例

Python

JavaScript/Node.js

Shell（curl）- 快速测试

五、空调控制场景实战

5.1 第一种场景：订单联动自动控制空调

5.2 第二种场景：空调远程重启（死机恢复）

5.3 第三种场景：空调定时开关机

5.4 场景四：批量管理多包间空调

六、TTS语音播报版扩展功能

七、私有化部署方案

八、设备安装部署指南

8.1 安装要求

8.2 KTV包间4路电源分配

8.3 空调接线注意事项

九、常见问题与排障

十、总结

控制器产品方案：

无人值守包间设备控制：怎么将8路包间设备集中控制器集成到软件项目中

户外亮化工程控制中：如何把智能 24 路远程信号控制器接入到软件项目中

如何二次开发4 路智能照明控制器来实现定时开关照明设备电源

怎样在照明控制中对接智能硬件以实现多达24路独立线路控制

如何接入智能 24 路远程开关控制模块来实现远程控制24路线路

空调场景方案：

共享台球室三路灯光空调控制：如何将86型3路翘板开关接入到软件项目中

怎么在医院病房空调管理中接入智能设备来实现断电记忆恢复控制

怎么在智能化改造空调场景中集成智能设备来实现定时任务控制空调

如何在共享台球室灯光空调控制中接入智能设备以实现远程控制16路线路

共享桌游室灯光空调控制：如何把智能控制器8路|交流电压版集成到软件项目中

包间用途方案：

怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断

剧本杀密室包间场景：怎样把HTTP接口包间控制器接入到自己的项目中

4路远程包间电源管理模块MINI：怎么把4路包间电器覆盖控制器MINI接入到自己的项目中

如何在4路包间综合管理控制器MINI中接入智能硬件以实现门禁电磁锁接口控制

共享自习室独立包间控制：怎样把共享空间智能控制器对接到软件项目中