怎么在4路HTTP接口包间控制器MINI中对接智能设备来实现照明换气扇电源控制_解决方案

CATALOG

基于芯步智能包间控制器Mini的开放HTTP接口，以下方案详细介绍如何对接并实现对照明、换气扇的远程电源控制。

1. 解决概述

本方案基于芯步智能包间控制器Mini（型号：UNI-KZQ-BJ-MINI）及其开放API。该设备直接支持通过HTTP请求进行控制，无需额外的网关硬件。

核心逻辑为：通过编程语言（Python/PHP/Go等）发送HTTP POST请求到芯步的云端API，携带签名鉴权信息和命令参数。云端收到指令后，将命令下发给包间内的控制器Mini，控制器执行对应继电器的通断，从而实现对物理电路的开关控制。

适用场景：共享棋牌室、茶室、自习室/休息室、琴房等需要独立包间管理的空间。

2. 硬件接线方案：照明与换气扇

根据官方产品手册，控制器的4路接口均支持独立控制。对于照明灯和换气扇（通常为阻性或小功率感性负载），将其接入第1路或第2路。

第1路：16A开关接口。推荐用于主照明或换气扇。
第2路：16A插座接口。可用于饮水机、麻将机或辅助照明。

具体操作步骤

断电操作：接线前请一定要切断总闸，确保安全。
区分零火线：控制器仅控制火线（L）的通断。将总电源的火线接入控制器的输入端（通常标为IN或L），将照明灯/换气扇的火线接入第1路的输出端（通常标为OUT1或L1）。
零线直连：所有照明灯、换气扇的零线（N）与总零线排直接相连。
供电：控制器需接入DC 5V 1A电源供电或特定的供电端子。
联网：设备仅支持2.4G WiFi，上电后通过配网模式将其连接至门店网络。

3. API对接逻辑与鉴权机制

包间控制器Mini提供了开放性的HTTP API接口，支持私有化部署和局域网直接控制。所有控制命令通过向指定URL发送POST请求实现。

3.1 请求地址

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

3.2 核心鉴权参数

为防止接口被恶意调用，接口采用动态MD5签名机制。

AppID：开发者ID（在芯步控制台获取）。
AppSecret：开发者密码（用于生成签名）。
ts：当前Unix时间戳（秒）。
sign：签名字符串，生成算法为sign = md5( md5(AppSecret) + ts)。

3.3 请求体结构

device：包间控制器的唯一ID（可在控制台查看设备列表获得）。
order：控制命令（JSON字符串）。

4. 照明与换气扇的具体控制指令

针对4路控制器对照明和换气扇的操作，order字段的标准指令如下

操作意图	对应接口路数	Order JSON 值	功能描述
打开照明	第1路	`{"power1":1}`	闭合继电器，照明灯亮
关闭照明	第1路	`{"power1":0}`	断开继电器，照明灯灭
打开换气扇	第2路	`{"power2":1}`	闭合继电器，风扇启动
关闭换气扇	第2路	`{"power2":0}`	断开继电器，风扇停止
全关/场景	批量	`{"power":0}`	一键关闭所有设备（包含空调）
自定义场景	批量	`{"batch":{"relay":[1,2],"power":1}}`	同时打开照明和换气扇

5. 代码对接示例

以下是使用Python语言的对接示例，包含自动生成签名和发送控制指令的全过程。

import requests
import hashlib
import time
import json

# 1. 配置参数 (从芯步控制台获取)
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID"  # 如 "12345678"

# 2. 生成动态签名
def generate_sign():
    ts = str(int(time.time()))
    # 第一步: MD5( AppSecret )
    step1 = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 第二步: MD5( step1 + ts )
    step2_str = step1 + ts
    sign = hashlib.md5(step2_str.encode()).hexdigest()
    return sign, ts

# 3. 发送控制命令
def control_device(order_cmd):
    sign, ts = generate_sign()
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": DEVICE_ID,
        "order": order_cmd  # 传入JSON对象
    }
    
    headers = {
        "Content-Type": "application/json"
    }
    
    response = requests.post(url, json=payload, headers=headers)
    print(f"命令: {order_cmd} -> 响应: {response.text}")

# 4. 业务逻辑调用示例
if __name__ == "__main__":
    # 场景A: 客人进入包间，打开照明和换气扇
    # 使用批量指令，同时开启第1路和第2路
    control_device({"batch":{"relay":[1,2],"power":1}})
    
    # 场景B: 客人暂时离开，只关灯，保留风扇通风
    # 单独关闭第1路
    # control_device({"power1":0})
    
    # 场景C: 客人离店，关闭所有电器
    # control_device({"power":0})

6. 私有化部署与内网直连（进阶）

若门店网络环境不稳定或对数据安全要求比较高，该控制器支持局域网直连控制

发现设备：在同一局域网下，通过UDP广播或扫描端口查找控制器IP。
本地调用：找到IP后，可直接对http://{设备IP}/control路径发送POST请求，无需经过云端API，响应速度更快（毫秒级），断外网也能用。

7. 总结

部署灵活：直连Wi-Fi，无需网关，极大降低了布线成本和硬件投入。
接口友好：标准的HTTP协议，支持PHP、Java、小程序、Vue.js等任意技术栈对接，SaaS系统集成方便。
负载适配：第1、2路支持最大3500W阻性负载或500W感性负载，足以覆盖绝大多数商用照明和大功率排气扇。
扩展性强：剩余的3、4路可接门锁（电磁锁）和空调，实现真正的无人值守包间管理。

通过以上部署与对接，开发者或集成商可在2小时内完成从硬件接线到软件调通的全过程，实现对照明和换气扇的远程智能化控制。