怎么二次开发4路包间灯光空调控制器MINI以实现包间消费时长电源联动_解决方案

CATALOG

芯步Mini控制器提供完整的HTTP API接口，可基于订单状态自动控制空调、照明等设备电源——核心逻辑是：订单开始→通电，订单结束/超时→断电。以下方案涵盖接口调用流程、签名算法、关键代码实现及典型场景配置。

解决方案：基于芯步Mini控制器实现包间消费时长与电源联动控制

1. 概述

为了实现“顾客下单即通电，订单结束即断电”的无人化、自动化管理，我们可以利用芯步智能包间控制器Mini的开放HTTP API接口，将您的业务系统（如SaaS、小程序后台、收银系统）与包间内的物理硬件（空调、麻将机、灯光）进行深度绑定。

核心逻辑：

订单开始：系统自动调用接口，开启第2路（插座/麻将机）和第4路（空调）。
订单进行中：系统可定时检测订单剩余时间，通过TTS语音播报提醒顾客。
订单结束/超时：系统自动切断所有电源，防止资源浪费和安全隐患。

2. 硬件选型与接线定义

基于 Mini 控制器的4路独立继电器特性，按以下标准进行硬件部署：

通道	接口类型	额定负载	推荐连接设备	控制逻辑
第1路	16A 开关	3500W	照明灯光/换气扇	跟随主逻辑，也可独立控制（如有人移动即开灯）
第2路	16A 插座	3500W	麻将机/饮水机	消费时长联动 (核心)：订单生效时通电
第3路	10A 门禁	2200W	电插锁/电磁锁	门禁控制（配合扫码开门）
第4路	30A 插座	6600W	2匹空调	消费时长联动 (核心)：订单生效时通电/允许开启

注意：空调（第4路）属于感性负载，且启动电流大，请一定要接在专用的30A端口上。

3. 二次开发接口调用流程

要实现联动，您需要打通“业务系统 — 芯步云平台 — Mini控制器”的链路。

步骤 1：获取密钥与设备ID

登录[芯步控制台]，在“开发设置”中获取 AppID 和 AppSecret。
在设备列表中找到对应的包间控制器，获取唯一的 Device ID。

步骤 2：计算签名 (Sign)所有API请求均需携带动态签名以确保安全。签名算法为：Sign = md5( md5(AppSecret) + ts )

ts：当前Unix时间戳（秒）。
即将 AppSecret 进行一次MD5加密，将结果拼接上时间戳，再对整个字符串做一次MD5。

步骤 3：触发控制指令业务系统需发起一个HTTP POST请求，向 https://api.thingboot.com/{AppID}/device/control/ 发送指令。

4. 核心代码实现示例

以下代码演示了如何在订单状态变更时，通过Python向指定包间的Mini控制器发送指令。

场景定义：

device_id = “123456” （该包间的设备ID）
开机指令：订单支付成功 -> 开启空调（线路4）和麻将机（线路2）。
关机指令：订单超时/手动结账 -> 关闭所有线路。

import requests
import hashlib
import time
import json

# 配置信息
AppID = "YOUR_APP_ID"
AppSecret = "YOUR_APP_SECRET"
DeviceID = "DEVICE_ID_OF_ROOM"
BaseUrl = f"https://api.thingboot.com/{AppID}/device/control/"

def generate_sign(ts):
    """生成签名:md5(md5(secret) + ts)"""
    step1 = hashlib.md5(AppSecret.encode()).hexdigest()
    step2 = hashlib.md5((step1 + str(ts)).encode()).hexdigest()
    return step2

def control_device(order_command):
    """
    控制Mini控制器
    :param order_command: 命令字典，例如 {"power4": 1} 开启第4路
    """
    ts = int(time.time())
    sign = generate_sign(ts)
    
    url = f"{BaseUrl}？sign={sign}&ts={ts}"
    payload = {
        "device": DeviceID，
        "order": json.dumps(order_command)  # order必须是JSON字符串
    }
    
    response = requests.post(url， data=payload)
    return response.json()

# ========== 业务逻辑对接 ==========
def on_order_start(room_id):
    """订单开始时的回调函数"""
    print("订单开始，开启包间电源...")
    
    # 1. 开启空调 (第4路通电，设为1)
    control_device({"power4": 1})
    
    # 2. 开启麻将机/插座 (第2路通电)
    control_device({"power2": 1})
    
    # 3. (可选)开启照明
    control_device({"power1": 1})
    
    # 4. TTS语音播报:"欢迎光临，设备已通电，祝您消费愉快"
    # 注意:TTS版本才支持该命令
    # control_device({"play:gbk:16":"欢迎光临，设备已通电"})

def on_order_end(room_id):
    """订单结束/超时的回调函数"""
    print("订单结束，切断所有设备电源...")
    
    # 批量关闭所有线路:使用batch命令
    # 全关指令为 {"power": 0}
    control_device({"power": 0}) 
    
    # 或者单独逐路关闭:
    # control_device({"power4": 0}) # 关空调
    # control_device({"power2": 0}) # 关麻将机

# 模拟触发
if __name__ == "__main__":
    # 假设这里监听了数据库或支付回调
    # on_order_start("A01")
    # ......
    # on_order_end("A01")
    pass

5. 实战技巧：解决空调频繁启停与节能问题

在棋牌室/KTV场景中，直接切断空调电源（硬关机）可能导致压缩机损坏或无法自启动。

优化方案：

不切死线，只控逻辑：将空调电源接在第4路，但业务上不直接断电。而是在订单结束前5分钟，调用API给第4路断电，随后立即通电。
- 效果：相当于模拟按了一下空调遥控器的开关。如果空调默认是“断电后来电恢复”模式，这会导致空调关闭；如果默认是“待机”，这会产生一个关闭信号，而不彻底切断压缩机电源，保护设备。
推荐做法：订单结束后，仅关闭照明和麻将机（第1、2路）。第4路（空调）保持通电，但通过红外/逻辑告知空调关闭。这样既能节能，又能避免客人因闷热给差评（如果客人续费，只需重新发送开机信号，无需重启空调压缩机）。

6. 定时任务与防逃单机制

利用控制器的“支持远程定时任务”特性，可以设置多重保险：

订单倒计时联动
- 剩余15分钟：调用API进行TTS语音播报：”您的订单即将结束，如需续费请扫码”。
- 剩余0分钟：执行 on_order_end 逻辑。
二次开发防逃单
- 如果网络断开，控制器无法接收云指令。业务系统应在本地数据库设置一个“心跳检测”。如果检测到订单超时且本地网络恢复，系统必须重新发送关机指令，确保包间电源被切断。

7. 总结

通过芯步Mini控制器的标准HTTP API，您可以轻松实现以下集成效果：

消费即通电：对接支付系统，支付成功瞬间电器通电。
全屋智控：分开控制空调（大功率）和麻将机（小功率），适应不同负载需求。
无人值守：彻底解决包间空调忘关、麻将机常亮导致的电费亏损问题。

开发时请注意：生产环境下请一定要关闭“调试模式”并严格校验Sign签名，以防止重放攻击。