如何接入4路智能包间集中控制模块MINI以实现照明换气扇电源控制_解决方案

CATALOG

4路智能包间控制模块Mini是一款专为棋牌室、茶室等场景设计的WiFi控制器，支持通过HTTP接口独立控制照明、换气扇等4路电器。以下从硬件接线、接口调用、代码示例到业务集成，给出完整接入方案。

1. 解决概述

1.1 设备简介

智能包间控制器 Mini 是芯步专为服务型门店（如共享棋牌室、茶室、剧本杀包间）设计的 4 路智能控制硬件。其核心优势在于无需网关，直连 WiFi 2.4G，并提供标准 HTTP API 接口，支持开发者快速集成到现有的 Web、小程序或 SaaS 平台中。

1.2 控制目标

针对本主题需求，我们将利用该模块的 4 路继电器输出，实现对包间内以下环境的精细化控制：

照明控制：控制包间主照明或装饰灯的开关；
换气扇控制：控制换气扇定时通风，改善空气质量；
电源插座控制：控制麻将机、饮水机等设备的通断电，避免待机电耗；
门禁/空调联动：第3、4路还可对接门磁锁或空调（第4路支持30A大功率）。

方案整体架构如下：业务系统（小程序/后台）发送HTTP请求至芯步开放平台，平台经鉴权后将指令推送到设备所在WiFi网络，设备执行通断操作并可选地上报状态。

2. 硬件选型与接线规划

在开发前，需明确物理线路的分配逻辑。以下是一种标准的分区控制规划：

通道序号	输出类型	最大负载能力（阻性）	推荐接入设备	控制指令参数（示例）
第1路	16A 继电器	3500W	照明总成（LED灯/筒灯）	`"power1"`
第2路	16A 继电器	3500W	换气扇（排气风机）	`"power2"`
第3路	10A 继电器	2200W	麻将机/桌台电源	`"power3"`
第4路	30A 继电器	6600W	空调内机（2匹以内）	`"power4"`

接线注意：模块需要 DC 5V1A 供电（Micro USB 接口）。接线时请请一定要断电操作，将对应电器的火线（L）串入对应继电器的“公共端”与“常开端”。

3. API 接口对接流程

芯步的开放接口文档明确指出，平台兼容 HTTP/HTTPS 请求，任何支持 HTTP 的编程语言均可接入。

3.1 准备工作：获取凭证

你需要先在 [芯步开放平台]（https://）注册开发者账号。

AppID：在控制台创建应用后获取，用于唯一标识你的 SaaS 系统。
设备ID （Device ID）：扫码添加设备后，在控制台获取的 6 位以上数字，用于定位具体的包间控制器。
Sign （签名） & Ts （时间戳）：为了接口安全，每次请求需携带动态签名，防止重放攻击。

3.2 核心接口：下发控制指令

接口地址： http（s）：//api.thingboot.com/{AppID}/device/control/请求方式： POST （推荐）或 GET鉴权方式： sign={sign}&ts={ts}

3.3 指令格式说明

对于 智能包间控制器 Mini，控制继电器通断的命令映射逻辑如第2节表格所示。官方推荐使用 JSON 格式传递 order 参数

开启照明： {"power1"： 1}
关闭换气扇： {"power2"： 0}
开启麻将机电源： {"power3"： 1}
关闭空调： {"power4"： 0}

4. 代码实战：集成到管理后台

以下示例展示如何通过 Python （后端）和 JavaScript （前端/云函数）实现对换气扇的控制。

4.1 场景示例：用户开包间自动开启照明和换气

当用户在小程序下单后，系统自动执行“通电”动作。

Python （Flask/Django）后端实现签名与请求

import requests
import time
import hashlib

# 配置信息
APP_ID = "Your_App_ID"
API_KEY = "Your_API_Secret"  # 在开放平台获取
DEVICE_ID = "12345678"
BASE_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

def control_device（power1_status, power2_status）:
    # 1. 生成时间戳和签名 （参考官方文档逻辑）
    ts = int（time.time（））
    # 假设签名算法为 md5（API_KEY + ts）
    sign_str = f"{API_KEY}{ts}"
    sign = hashlib.md5（sign_str.encode（））.hexdigest（）
    
    # 2. 构造请求参数
    # 接口调用要求:携带 device 和 order
    payload = {
        "device": DEVICE_ID,
        "order": {
            "power1": power1_status,  # 1 开 0 关
            "power2": power2_status   # 控制换气扇
        }
    }
    
    params = {
        "sign": sign,
        "ts": ts
    }
    
    # 3. 发起请求
    try:
        response = requests.post（BASE_URL, params=params, json=payload, timeout=5）
        if response.status_code == 200 and response.json（）.get（"code"） == 200:
            print（"指令下发成功，设备将立即响应。"）
        else:
            print（f"下发失败: {response.text}"）
    except Exception as e:
        print（f"网络异常: {e}"）

# 示例:用户下单，开启照明 （power1） 和 换气扇 （power2）
control_device（power1_status=1, power2_status=1）

注意：代码中的签名算法仅为示例逻辑，实际开发请请一定要查阅官方最新的《接口文档》中关于 sign 生成的规则。

4.2 更优雅的调用：支持特性反馈（Extra字段）

在一些计费场景中，你可能需要确保指令确实执行了（如计时开始）。接口支持在 order 中携带 extra 字段（如订单号），平台在异步消息推送中会原样返回，方便你进行对账与状态确认。

5. 高级业务逻辑设计：实现照明与换气扇联动

单纯的远程开关只是基础，我们可以利用开发接口构建智能化策略：

定时任务与控制逻辑
- 场景1 （高峰时段）：设定每日 10：00-22：00，换气扇每隔 45 分钟开启 10 分钟。实现代码可使用服务器的 Cron 任务，定时调用上文提到的 control_device 接口，仅针对 power2 发送开/关指令。
- 场景2 （无人自动节能）：配合芯步人存在传感器，当检测包间无人超过 15 分钟，系统自动调用本接口关闭 第1路（照明） 和 第2路（换气扇），并断开第3路麻将机电源，实现 0 待机电耗。
上电状态恢复策略（断点续传）：若 WiFi 网络不稳定，模块支持私有化部署和断网重连，也可设定重连策略。在服务器层面，维护一个“设备期望状态表”。当设备重连上线时，系统主动下发当前会话应有的状态（例如：虽然断电重启了，但立刻将换气扇再次开启）。

6. 总结与部署要点

通过接入芯步 智能包间控制器 Mini，开发者仅需处理简单的 HTTP 请求即可完成复杂的强电控制任务。

安全性：请请一定要将 API_KEY 存储在后端，前端（小程序）通过云函数或业务后台转发控制指令，避免密钥泄露导致设备被恶意控制。
私有化部署：如果你的客户对数据安全要求比较高（如涉密单位），该模块支持 私有化部署。你可以将 API 地址指向本地服务器，所有控制数据不经过公网，仅在内网传输，这极大地降低了响应延迟。

此方案可直接复制到你的技术设计文档或实施方案中。