4路包间电源控制器MINI：如何把4路包间电器覆盖控制器MINI集成到软件项目中_解决方案

CATALOG

4路包间电源控制器MINI是一款专为服务型门店设计的智能硬件，通过HTTP API可快速集成到现有软件系统中。以下从硬件选型、接口对接、业务第三种场景个层面展开说明。

1. 硬件概述与选型

芯步的智能包间控制器MINI，核心价值在于将包间内所有强电设备集中管控。它支持WiFi 2.4G直连，无需额外网关，部署成本低。

核心优势
- 4路独立控制：覆盖照明、麻将机、门禁、空调等主流设备。
- 接口开放：提供标准的HTTP API接口，兼容任何能发起HTTP请求的编程语言或SaaS平台。
- 双版本选择：标准版（控制通断）与TTS版（控制通断+语音播报）。
四路接口功能定义
- 第1路：16A继电器，控制照明、换气扇、吸烟灯。
- 第2路：16A继电器，控制饮水机、麻将机、按摩椅。
- 第3路：10A继电器，专用于门禁（直流电磁锁/电插锁），实现远程开门。
- 第4路：30A继电器，专用于空调（支持2匹）。

2. 接口集成方案：从技术对接到底层实现

集成过程主要分为获取凭证、签名验证、下发指令三个步骤。

2.1 通信机制与鉴权

接口采用双重MD5签名机制，确保设备控制的安全性。

核心参数：AppID（开发者ID）、AppSecret（开发者密码）、ts（Unix时间戳）。
签名算法Sign = md5( md5(AppSecret) + ts )。
- 注意：先将AppSecret进行一次MD5加密，再将结果字符串拼接时间戳，最后整体做MD5.

2.2 核心接口详解：设备控制

这是集成过程中最关键的接口，用于向指定设备下发指令。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}
请求方式：POST (Content-Type: application/json)
请求体示例
{ "device": "1878", // 设备唯一ID，可在控制台查看 "order": { "power1": 1, // 打开第一路照明 "power4": 0 // 关闭第四路空调 } }
支持的控制命令（Order字段）：

功能场景	命令示例（JSON）	说明
单路控制	`{“power1”： 1}`	单独控制第1路开启（1开/0关）
批量控制	`{“batch”： {“relay”： [1,3], “power”： 0}}`	同时关闭第1路和第3路
临时断电/复位	`{“reset”： {“relay”： [4], “interval”： 5000}}`	适用于空调：断开第4路，5秒后自动重新通电，实现空调重启
语音播报（TTS版）	`{“play：gbk：16”： “欢迎光临，您的订单已开始”}`	包间喇叭播报提醒

3. 典型业务场景集成与逻辑实现

将控制器融入实际软件业务流程，是实现商业价值的关键。

3.1 第一种场景：无人值守与自助服务

痛点：用户下单后需人工去开灯、开空调，效率低。解决方案

用户在小程序完成支付（订单开始）。
后端服务接收到支付回调，调用控制器API：
- {“power1”： 1} （开灯）
- {“power4”： 1} （开空调）
- {“power3”： 0} （门禁断电，解锁房门）
用户使用结束，订单结算后：
- 调用API全关：{“batch”： {“power”： 0}}

3.2 第二种场景：设备联动与自动化

痛点：客人离开忘关空调，导致电费浪费。解决方案：配合人体传感器，构建“人来灯亮、人走灯灭”逻辑。逻辑流程

传感器检测到“无人”状态，推送消息至服务器。
服务器校验该包间当前订单状态为“空闲”。
服务器执行安全策略：先发送{“power4”： 0}（关闭空调），5分钟后发送{“power1”： 0}（关闭照明），最后发送{“power3”： 1}（锁门）。

3.3 第三种场景：远程协助与异常处理

痛点：客人反映空调不制冷（可能是外机保护），或需要远程开门。解决方案

重启空调：调用复位指令 {“reset”： {“relay”： [4], “interval”： 3000}}。这等同于拔掉电源插头等待3秒再插上，强制重启空调外机。
远程开门：仅需操作门锁继电器，{“power3”： 0} 保持1秒后自动恢复闭合，或保持常开。

4. 集成中的关键注意事项

感性负载限制：第1、2路接电机（麻将机、风机）时，功率限额为500W；第4路接空调（压缩机）时，限额为1100W。请一定要核对设备功率，防止继电器粘连。
异步反馈机制：API返回code：200仅代表指令被云端接收，不代表设备已执行。若需确认设备状态（如门是否真的锁了），需实现云端的消息推送接收或设备状态查询接口来获取真实结果。
局域网私有化部署：若对公网稳定性有顾虑，或需在内网环境运行，该设备支持私有化部署。可将API地址指向本地服务器，实现纯内网控制，降低延迟并规避公网抖动。

5. 代码集成示例（Python FastAPI风格）

以下示例展示如何在后端服务中封装控制器逻辑：

import hashlib
import time
import requests

class MiniController:
    def __init__(self, app_id, app_secret, device_id):
        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 _gen_sign(self):
        ts = str(int(time.time()))
        # 两次MD5加密
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        step2 = hashlib.md5((step1 + ts).encode()).hexdigest()
        return step2, ts

def control(self, order_json):
        sign, ts = self._gen_sign()
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {
            "device": self.device_id,
            "order": order_json
        }
        response = requests.post(url, json=payload)
        return response.json()

# 业务调用示例
controller = MiniController("YourAppID", "YourAppSecret", "Device_123")

# 1. 用户下单:开灯(1)、开空调(4)、开门锁(3断开则为开锁)
controller.control({"power1": 1, "power4": 1, "power3": 0})

# 2. 无人断电:关空调、关灯
controller.control({"batch": {"relay": [1,4], "power": 0}})

总结

将芯步4路包间电源控制器MINI集成到软件项目中，本质上是通过 RESTful API 将物理设备的继电器操作映射到软件的业务逻辑上（如订单状态流转）。开发者只需关注 签名鉴权 和 指令映射（哪一路对应什么电器），即可快速实现共享空间或包间服务的智能化改造。