怎样二次开发4路包间电源控制器MINI以实现包间温湿度联动控制_解决方案

CATALOG

4路包间电源控制器MINI本身不具备温湿度传感能力，但通过其开放的HTTP接口对接第三方传感器，即可实现包间环境的自动化联动控制。以下方案涵盖硬件选型、接口调用逻辑和核心代码实现。

解决方案：基于芯步4路控制器MINI的包间温湿度联动控制系统

1. 概述与系统架构

本方案的目标是利用芯步智能包间控制器Mini（型号：UNI-KZQ-BJ-MINI）的开放HTTP API接口，结合外接的温湿度传感器，实现包间（如棋牌室、茶室、KTV包间）内电器的全自动环境联动控制。

该系统通过实时监测环境数据，自动调整空调、排风扇、除湿机等设备，以达到节能降耗与提升用户体验的双重目的。

核心逻辑：系统通过第三方服务器（或云平台）周期性获取包间内的温湿度数据，并与预设的阈值进行比较。当环境数据超出舒适范围时，服务器自动向4路控制器Mini下发HTTP指令，闭合或断开对应电路，从而控制空调制冷/制热、排风扇启停等动作。

系统架构图描述：

感知层：温湿度传感器（第三方Modbus/RS485/蓝牙/WiFi）。
处理层：本地服务器 / 云服务器（运行联动逻辑，调用芯步API）。
执行层：芯步4路包间控制器Mini（执行断电/通电）。
传输层：HTTP/HTTPS协议（签名验证机制）。

2. 硬件连接与配置

在开始二次开发前，需完成以下基础配置，这是实现联动控制的物理基础。

2.1 设备选型与接线

控制器：芯步4路包间控制器Mini。
- 第4路（30A）：接空调（支持2匹，直接控制强电通断或通过红外转发器间接控制，本方案以直接通断为例）。
- 第1路（16A）：接排风扇/换气扇。
- 第2路（16A）：接除湿机或加湿器。
- 第3路（10A）：可接门禁或灯光（作为辅助）。
传感器：如RS485型温湿度传感器（Modbus协议）或米家/其他品牌支持API回调的WiFi温湿度计。

2.2 网络配置

控制器通过WiFi 2.4G接入网络，无需网关，直接连接路由器。
确保服务器（运行二次开发脚本的电脑/云主机）与控制器网络互通。

2.3 接口准备

在芯步开放平台获取 AppID 和 AppSecret。
获取控制器的 Device ID（通常印于机身或可在控制台查询）。

3. 温湿度联动控制逻辑设计

本方案的核心在于策略设计（PID控制或阈值控制），鉴于包间环境的滞后性，使用滞后回差控制，防止继电器在阈值边界频繁跳动（震动）。

控制策略示例表：

场景	触发条件（温度）	触发条件（湿度）	执行动作	对应接口指令
高温高湿	> 28℃	> 75%	开启空调制冷、开启排风	`{"power4":1}`, `{"power1":1}`
温度达标	< 24℃	-	关闭空调压缩机	`{"power4":0}`
湿度过高	-	> 80%	开启排风或除湿机	`{"power1":1}` 或 `{"power2":1}`
湿度恢复	-	< 65%	关闭除湿设备	`{"power2":0}`
无人/节能	-	-	关闭所有大功率设备	`{"power4":0}`

4. 二次开发核心实现（接口调用）

芯步开放接口非常简洁，支持任何支持HTTP请求的语言。接口签名规则为：sign = md5(md5(AppSecret) + ts)。

以下以 Python 为例，编写一个温湿度联动控制的核心调度逻辑。

import requests
import time
import hashlib
import random  # 模拟读取传感器，实际中替换为真实传感器库如 minimalmodbus

# --- 配置信息 ---
APP_ID = "你的AppID"          # 芯步平台获取 [citation:3]
APP_SECRET = "你的AppSecret"   # 芯步平台获取
DEVICE_ID = "设备ID"           # 控制器Mini的设备ID

API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

# --- 辅助函数:生成签名 ---
def generate_sign(ts):
    # 1. md5(AppSecret)
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 2. md5(md5(AppSecret) + ts)
    sign_str = md5_app_secret + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign

# --- 核心函数:控制继电器 ---
def control_device(power_cmd):
    """
    向控制器下发指令
    :param power_cmd: dict, 例如 {"power4": 1} 开启第4路
    """
    ts = int(time.time())
    sign = generate_sign(ts)
    
    params = {
        'sign': sign,
        'ts': ts
    }
    # 请求体格式 {"device": "xxx", "order": {...}} [citation:5]
    payload = {
        "device": DEVICE_ID,
        "order": power_cmd
    }
    
    try:
        response = requests.post(API_URL, params=params, json=payload, timeout=5)
        # 判断返回，200代表平台接收成功，不代表设备执行成功 [citation:8]
        if response.status_code == 200:
            print(f"指令下发成功: {power_cmd}")
        else:
            print(f"指令下发失败: {response.text}")
    except Exception as e:
        print(f"网络错误: {e}")

# --- 模拟传感器读取（实际开发需替换为真实传感器读取逻辑）---
def get_temperature_and_humidity():
    """
    实际开发中，这里应调用 Modbus RTU (RS485) 读取 或 第三方API。
    本示例返回模拟数据。
    """
    # 模拟读取温度 22~32度，湿度 40~90%
    temp = round(random.uniform(22.0, 32.0), 1)
    humi = round(random.uniform(40.0, 90.0), 1)
    print(f"当前环境: 温度 {temp}°C, 湿度 {humi}%")
    return temp, humi

# --- 联动逻辑处理 ---
def auto_control_environment():
    temp, humi = get_temperature_and_humidity()
    
    # 1. 高温逻辑（温度 > 27度）
    if temp > 27.0:
        print("温度过高，开启空调（第4路）")
        control_device({"power4": 1})  # 开启空调
        
        # 如果湿度同时过高，开启排风（第1路）
        if humi > 75.0:
            print("湿度也高，开启排风（第1路）")
            control_device({"power1": 1})
    # 2. 低温逻辑（温度 < 23度）
    elif temp < 23.0:
        print("温度过低，关闭空调（第4路）")
        control_device({"power4": 0})
    
    # 3. 独立湿度逻辑（温度适中但湿度高）
    if 23.0 <= temp <= 27.0 and humi > 80.0:
        print("单独除湿，开启排风（第1路）")
        control_device({"power1": 1})
    elif humi < 60.0:
        # 湿度恢复正常后关闭排风（可根据需要增加延时关闭逻辑）
        print("湿度正常，关闭排风")
        control_device({"power1": 0})

# --- 主循环 ---
if __name__ == "__main__":
    print("启动包间智能联动控制系统...")
    while True:
        auto_control_environment()
        time.sleep(60)  # 每60秒检测一次

关键点说明：

设备ID (Device ID)：可以在芯步控制台或设备外壳上找到，支持批量控制（用逗号分隔）。
命令格式 (Order)
- 控制第一路：{"power1": 1} (开) / {"power1": 0} (关) 。
- 控制第四路空调插座：{"power4": 1}。
- 注意：针对空调，如果你的控制器Mini接的是红外转发器而非直接切断电源，指令需改为红外码库对应的编码。

5. 高级联动与优化策略

空调软关闭保护：为了保护空调压缩机，在通过power4关闭空调时，程序逻辑中应避免在关断后3分钟内再次开启，防止损坏压缩机。
门磁联动：结合第3路门禁接口，当检测到门磁信号（客人离店）时，自动调用接口关闭所有回路（{"power1":0,"power2":0,"power4":0}），实现“人走断电”。
语音播报提醒：如果采购的是TTS版本，可以在检测到温湿度异常时下发语音指令，如：{"play:gbk:16":"当前包间湿度较高，已为您开启除湿模式"}。
私有化部署：如果对数据安全要求比较高（如政府单位或高端私人会所），由于该设备支持局域网私有化，你可以将API请求地址指向局域网内的服务器IP，不经过外网云平台。

6. 总结

通过芯步4路包间控制器Mini的开放接口，开发者可以轻松地将“环境感知”与“电力控制”结合起来。本方案采用的HTTP接口调用方式，极大地降低了物联网开发的门槛，无论是对接RS485传感器还是简单的阈值判断，代码逻辑都清晰可控，非常适合共享棋牌室、茶室等场景的智能化改造。