怎样在4路包间电源控制器MINI中对接智能硬件以实现自定义联动操作_解决方案

CATALOG

包间控制器MINI的开放接口支持单路通断、批量控制、时序联动等指令，结合人体传感器、门禁开关等设备，可以实现“人来开灯、人走断电”等自定义场景。以下方案涵盖API对接、签名计算、典型场景代码实现和配置。

解决方案：基于芯步4路包间电源控制器MINI的智能联动场景构建

1. 概述

芯步的 4路包间电源控制器MINI（UNI-KZQ-BJ-MINI） 是一款支持 HTTP API 接口 的智能硬件。本方案的目标是通过调用其开放接口，结合第三方传感器（如人体红外、门磁）或业务软件（如订单系统），实现去中心化或云端逻辑的自定义联动。

核心目标：利用API接口，将物理世界的电器控制与虚拟世界的业务逻辑（如用户下单、超时提醒）无缝连接。

2. 核心技术基础

在构建联动之前，需掌握该硬件的两个核心能力：

指令下发（控制）：即服务器向设备发送“通/断”指令。
状态上报（感知）：设备状态改变（手动按钮或继电器动作）时主动向服务器推送数据，或通过轮询获取。

2.1 接口概览

请求方式：POST
URL结构https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
核心参数说明
- device：设备唯一ID（如上述文档中的“1878”示例，实际从控制台获取）。
- order：JSON命令串。针对MINI版，主要操作 power1 至 power4。

2.2 鉴权机制（签名计算）这是对接中最关键的一环。为防止接口被恶意调用，所有请求必须携带动态签名。

算法步骤
1. 将开发者密码 AppSecret 进行一次 MD5 加密。
2. 将加密后的字符串拼接上当前的 时间戳（ts） 。
3. 将拼接后的字符串再次进行 MD5 加密，得到最终的 sign。
公式sign = MD5( MD5(AppSecret) + ts )

注意：时间戳 ts 需同步放入 URL 参数中，且服务器时间与客户端时间误差不宜过大。

3. 自定义联动场景设计与实现

结合包间的实际运营场景（如共享棋牌室、茶室），设计“订单与电源联动”及“安防联动”。

第一种场景：用户下单自动通电（“一键开台”）

需求：用户在小程序支付套餐后，包间门禁解锁（第3路），照明和麻将机通电（第1、2路），空调启动（第4路）。
逻辑：业务后端收到支付回调 -> 调用控制接口 -> 发送组合命令。
代码示例（Python - 核心逻辑）

import hashlib
import time
import requests
import json

# 配置信息
APP_ID = "Your_App_Id"
APP_SECRET = "Your_App_Secret"
DEVICE_ID = "1878"  # 实际包间的设备ID

# 1. 生成签名
def generate_sign(secret):
    ts = str(int(time.time()))
    # 第一层MD5
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 拼接时间戳
    sign_str = md5_secret + ts
    # 第二层MD5
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

# 2. 下发联动命令 (全开 + TTS语音播报)
def turn_on_party_room():
    sign, ts = generate_sign(APP_SECRET)
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 构建指令:
    # power1=1 (照明/麻将机)
    # power3=1 (门禁解锁)
    # power4=1 (空调)
    # play:gbk:16 (TTS语音播报，例如:"欢迎光临，房间已通电，祝您愉快")
    order = {
        "power1": 1, 
        "power3": 1, 
        "power4": 1,
        "play:gbk:16": "[message_3]欢迎光临，祝您使用愉快"  # TTS版支持
    }
    
    payload = {
        "device": DEVICE_ID,
        "order": order
    }
    
    response = requests.post(url, json=payload)
    print(response.json())

第二种场景：无人值守自动断电（“一键关台”）

需求：套餐时间结束前10分钟提醒，时间到后自动切断所有电源并锁门。
优化：使用批量控制指令 batch，减少网络请求。
批量指令示例

第三种场景：传感器联动（环境自适应）

前提：需配合芯步生态的传感器（如人体存在传感器）。
联动逻辑
1. 人来开灯：传感器检测到人 -> 上报状态至服务器 -> 服务器判断当前时段 -> 下发 {"power1":1}。
2. 人走断电：传感器持续检测无人状态（如15分钟） -> 触发自动断电逻辑。
数据流处理：服务器需接收传感器的回调事件，在事件处理函数中调用控制器接口。

场景四：防夹手与电机保护（高级指令）

需求：控制窗帘机或卷闸门（感性负载）。
应用：利用 先通后断（point） 或 先断后通（reset） 指令，避免电机突然反转烧毁。
指令示例：控制第2路连接的电机正转停止后，延迟1秒再反转。

该功能利用了控制器支持的高级开关时序逻辑。

4. 实时状态同步机制

为实现精准联动，系统需要知道设备目前是开还是关。

配置消息推送（推荐）
- 在芯步控制台中配置“API推送”URL。
- 当有人按动包间内的物理开关，或设备自动断电时，平台会主动将当前状态 POST 到你的服务器。
- 接收示例：服务器收到 {"device_id":"1878","power1":"0"}，即可更新数据库状态。
定时轮询
- 如果不具备公网API接收条件，可定时调用设备状态查询接口，获取最新属性值。

5. 物理开关的自定义配置

MINI控制器面板自带4个物理按钮，默认是短按反转对应线路状态（开变关，关变开）。但通过配置接口进行修改，可以实现更复杂的本地联动。

配置项设定
- 例如：将按钮1的动作设为 point（点动模式）。适用于门铃或电机点动控制。
- 将按钮3（门禁）的 mode 设为 long（长按），防止误触开门。
配置下发：通过API发送特定配置JSON修改设备Flash参数（通常需设备在线）。

6. 疑难排查与优化

签名失败（403错误）
- 检查时间戳是否为秒级（10位）而非毫秒级。
- 确认 md5() 结果为32位小写十六进制字符串。
控制延迟
- 如果是公网API，延迟约 80-120ms 。若要求极低延迟（如产线控制），使用局域网私有化部署功能，控制器直接连接本地服务器IP，不走云端。
负载注意
- 第4路虽支持30A（6600W），但若接空调等感性负载，降额至80%使用，避免继电器粘连。

7. 总结

通过在业务系统中集成芯步标准的 HTTP API，开发者可以像调用本地函数一样远程控制包间内的4路电源。无论是针对共享经济场景的“按时计费断电”，还是针对智慧办公的“传感器联动”，该控制器都提供了灵活、低成本的解决方案。开发者只需关注业务逻辑，无需关心底层无线通信协议。