如何接入4路智能包间集中控制模块MINI来实现包间设备分组独立管理_解决方案

CATALOG

芯步智能包间控制器Mini提供了4路独立控制输出和开放的HTTP接口，可以通过设备分组功能实现对多个包间、多路电器的分层级管理。以下方案从分组设计到接口调用示例，说明如何构建一套灵活的分组独立控制系统。

解决方案：基于芯步4路智能包间集中控制模块（Mini）实现包间设备分组独立管理

1. 背景与目标

在许多场景中（如共享棋牌室、足浴店、KTV包间、月子中心、公寓等），运营方不仅需要远程控制单个设备的开关，更需要对多个包间进行“分组管理”。痛点

不同包间的电器配置类似（灯、空调、门锁、插座），但需要独立计费和管控。
管理员需要能够“一键开/关”某个包间的所有设备，也要能控制某个包间的特定设备（如单独开空调）。

解决方案目标利用芯步 智能包间控制器Mini 的4路独立输出和开放API能力，结合其设备分组功能，实现“包间级”（房间整体控制）和“设备级”（单路电器控制）的双重精细化管理。

2. 硬件与接口能力分析

硬件选型：智能包间控制器Mini根据官方硬件手册，该设备具备以下关键特性，是方案的基础

4路独立控制
- 第1/2路：16A，适用于照明、排风扇、麻将机、饮水机等常规电器。
- 第3路：10A/16A，专用于门禁电磁锁/电插锁。
- 第4路：30A，大功率接口，直接控制2匹空调或暖气。
网络连接：支持WiFi 2.4GHz直连，无需额外网关，降低硬件成本。
开放接口：提供标准的HTTP API接口，支持任何后端语言（Java, Python, PHP, Node.js等）或小程序/APP调用。

核心API能力

单路控制：通过 power1、power2、power3、power4 精准控制每一路通断。
批量控制：通过 batch 命令实现一键全开/全关。
状态查询：通过设备列表接口实时获取当前各路开关状态及在线状态。

3. 设计

本方案采用 SaaS服务平台 + 设备直连 的架构：

设备层：每个包间部署一台Mini控制器，分别接入本包间的灯、空调、门锁、插座。
云平台层：芯步开放平台。负责设备连接、指令转发、设备状态存储。
业务应用层：客户的第三方管理系统（如棋牌室SaaS系统、微信小程序、公众号）。
管理逻辑：在业务应用层建立“分组”概念，将设备ID与业务系统的“包间ID”绑定。

4. 详细实施步骤

由于您需要“分组独立管理”，关键在于将物理设备与逻辑分组（包间）进行映射。

第一步：设备部署与配网

在每个包间安装Mini控制器。
接线
- 路1：接照明灯或氛围灯。
- 路2：接麻将机/电视/插座（客人离开现场时可自动断电）。
- 路3：接门禁锁（实现客人手机一键开门/自助入住）。
- 路4：接空调（大功率专用接口，保障安全）。
通过设备热点配网，将设备绑定至芯步控制台。

第二步：通过API获取设备标识

登录芯步控制台，获取 AppID 和 AppSecret。
调用 获取设备列表 接口，获得每个包间对应的 device_id（例如：包间A的ID是 1001，包间B的ID是 1002）。
代码示意：查询设备列表
// 请求 GET https://api.thingboot.com/{AppID}/device/list/?sign={sign}&ts={ts} // 返回数据中包含 ID 及当前状态 { "id": 1001, "name": "VIP包间1号控制器", "state": { "power1": "0", "power2": "0", "power3": "0", "power4": "0" } }

第三步：建立业务分组（实现包间独立管理）这是实现“分组独立管理”的核心。您不需要在硬件层面做物理改动，而是在软件层进行逻辑分组。

方案A：利用云平台原生分组（推荐，省去数据库维护）：调用芯步的 维护设备分组 接口，将设备ID添加到对应的分组ID中。例如：创建分组ID 101 对应“桃花厅包间”，并将 1001 设备加入。
方案B：在自己的业务数据库建立映射在您的本地数据库中建立 rooms 表，字段包含 room_id（包间号）、device_id（Mini设备ID）、relay_map（继电器映射关系，比如哪一路接的是什么）。

第四步：实现“包间级”集中控制逻辑当客人预定包间时间到，或前台需要强制断电时，通过 分组控制接口 批量操作该包间下的设备。

场景1：客人下单成功，自动开电需求：客人支付成功后，包间通电，门锁打开（第3路），灯光打开（第1路）。技术实现：调用 向设备下发指令 接口，指定 device 为该包间设备ID，order 包含开门和开灯指令。

场景2：客人离开现场时/超时，全屋断电需求：点击“打扫模式”或“结束订单”，关闭该包间所有电器（灯、空调、麻将机），但保留门锁电源以便下一位客人开门（或给保洁卡供电）。技术实现

单控方式：分别发送 power2=0 (断电麻), power4=0 (关空调)。
批量方式：利用 batch 命令快速关闭前3路。

场景3：温控与感应联动（高级应用）需求：根据人体传感器或前台设置，远程调节空调温度（仅限红外/串口空调配合使用）或定时通风。技术实现：利用TTS语音版（带TTS功能的Mini型号），可以在特定时间播报“您的包间时间还剩15分钟”，提醒客人续费。

5. 接口安全与签名机制

为了保证API调用的安全性，所有请求必须携带动态签名（Sign），有效防止伪造请求控制设备。

签名生成逻辑

将您的 AppSecret 进行一次MD5加密。
将加密结果拼接上当前Unix时间戳 ts。
对拼接后的字符串再进行一次MD5加密。

Python 示例代码（签名生成）

6. 总结

高性价比：Mini尺寸小、成本可控，4路输出足以覆盖标准包间的主要电器，且无需网关。
分层级管理灵活
- 宏观层：通过 分组 接口，一键处理“退房断电”、“打扫模式”。
- 微观层：通过 单路控制，解决“客人只想关灯不想关空调”等个性化需求。
私有化部署支持：芯步支持私有化部署，数据可存储在企业自己的服务器，保障商业数据安全（局域网环境也可运行）。
语音扩展能力：TTS版本支持远程语音播报，适合用于到店提醒、喊麦、催钟提醒等场景，增加互动体验。

通过以上步骤，您即可利用芯步智能包间控制器Mini的开放接口，快速构建一套稳定、可扩展的包间设备集中控制与分组独立管理系统。