芯步的MINI控制器支持HTTP API和分组管理，可以通过“分组”将同一包间的4路输出打包为逻辑单元，再按“包间”维度进行独立控制。以下方案涵盖分组创建、设备绑定、API调用及业务落地流程。

解决方案：基于芯步MINI控制器的包间电器分组独立管理

1. 背景与目标

在棋牌室、茶室、影音房等场景中，管理者通常需要按“包间”维度对电器进行独立管理。例如，A包间客人离开后，仅需关闭A包间的麻将机、空调、照明，而B包间仍在正常使用。

芯步推出的4路包间电器覆盖控制器MINI（型号 UNI-KZQ-BJ-MINI）提供了4路大功率输出接口，但单台设备仅代表一个物理硬件。为了实现“分组独立管理”，需要利用其开放接口（HTTP API） 与分组机制，将不同包间的设备或同一包间多台控制器进行逻辑隔离。

本方案的目标是详细阐述如何通过该产品的HTTP API，在您的自有管理系统（如小程序、PC管理后台）中实现按包间独立控制。

2. 核心逻辑架构

要实现“包间设备分组独立管理”，核心逻辑是利用芯步的 “设备分组” 功能。

• 物理层：每个包间安装一台或多台MINI控制器。每台控制器拥有唯一的 Device ID。

• 逻辑层：在云端或管理后台创建“包间分组”（Group），将对应包间的设备ID绑定到该分组下。

• 应用层：管理员在系统中点击“包间A-关灯”，系统调用API并携带 Group ID，云端向该分组下的所有设备下发指令。

3. 接入准备

在开发前，需要完成以下硬件与软件准备工作：

1. 硬件部署

   • 为每个包间安装MINI控制器。

   • 接线方案

     • 第1路：接照明/换气扇（16A）。

     • 第2路：接麻将机/按摩椅（16A）。

     • 第3路：接门禁电磁锁（10A，需配合直流电源）。

     • 第4路：接2匹空调（30A）。

   • 确保设备配置了2.4GHz Wi-Fi并连网。

2. 开发者后台准备

   • 注册芯步开发者账号。

   • 在控制台获取 AppID 和 AppSecret。

   • 在控制台绑定现场的MINI控制器，获取每个设备对应的 Device ID。

4. 实施方案：分组与独立控制

本方案主要包含两大步骤：创建/维护分组 和 执行分组控制。

4.1 第一步：创建包间分组（逻辑隔离）

为了在软件中区分“202包间”和“VIP1包间”，需要对设备进行分组。

• 接口地址http(s)://api.thingboot.com/{AppID}/device/group/

• 核心逻辑：将物理设备划归到包间分组ID下。

• 请求参数示例

  • 假设 Device ID 为 1878（202包间的设备），系统内设定的 Group ID 为 1001（代表VIP包间）。

  • device: "1878"

  • group: "1001"

• 开发在您的管理后台中，创建“包间管理”页面，新增包间时自动创建一个云端分组ID，并将该包间内的MINI控制器添加进该分组。这可以实现即便一个包间有多个扩展控制器，也能一键控制。

4.2 第二步：实现包间内独立控制

每个包间通常有多个电器，MINI控制器的4路输出正好对应这些电器。本方案利用 “分组命令下发” 接口，实现对特定包间特定电器的独立操作。

• 接口地址http(s)://api.thingboot.com/{AppID}/group/control/

• 签名机制接口安全性采用 sign 校验。算法为：sign = md5( md5(AppSecret) + ts )。

  • 例如在Node.js/PHP中，需将 AppSecret 进行一次MD5，拼接当前时间戳 ts，再进行一次MD5。

• 实现“关闭包间A的照明”假设服务生在前端点击“关闭202包间灯光”。在您的后端代码中，应组建设置如下参数的请求：

  • Method: POST

  • URL: https://api.thingboot.com/你的AppID/group/control/?sign=xxxx&ts=当前时间戳

  • Body (JSON):

    { "group": 1001, // 对应202包间的分组ID "power1": 0 // 关闭该分组下所有设备的第1路（照明） }

  • 效果：系统会将指令自动下发到属于分组 1001 的所有MINI控制器，并执行关闭第一路操作。

• 实现“给包间A解开门锁”客人自助扫码后，系统应仅开启第3路（门禁），且延迟关闭。

  { "group": 1001, // 包间分组ID "order": { "point": { // 使用先通后断模式 "relay": [3], // 仅操作第3路（门锁） "interval": 5000 // 通电5秒后自动断开，自动关门 } } }

4.3 第三步：高级联动场景“一键上钟/下钟”

利用该接口，可以设计自动化场景（需本地服务器做逻辑编排）：

1. 下钟场景（客人离开）系统调用 group/control，一次请求中包含全部关断指令：

   { "group": 1001, "power1": 0, // 关灯 "power2": 0, // 关麻将机 "power4": 0 // 关空调 }

2. 语音提醒如果采购的是 TTS版本，在接入新订单时，可以向该分组发送语音指令，提醒客人“欢迎光临”或“时间快到了”。

   { "group": 1001, "play:gbk:16": "您好，您本次使用时间剩余15分钟" }

5. 详细技术参数参考

在实际开发对接中，需要关注以下接口参数细节以确保兼容性：

6. 方案总结

通过芯步4路包间控制器MINI的开放接口实现分组管理，本质是 “物理设备直连+逻辑分组隔离”。

1. 高效：利用 group/control 接口，只需维护包间ID与设备ID的映射关系，即可实现“一包间一指令”。

2. 灵活：MINI控制器的4路独立设计，配合API的 relay 参数，让门禁、空调、照明彻底解耦，互不干扰。

3. 落地：开发者只需关注签名算法（MD5嵌套）和JSON报文组装，无需复杂的硬件嵌入式开发，即可快速集成到现有的共享棋牌室或茶室系统中。

通过以上步骤，您可以在现有管理系统中无缝接入芯步的硬件，实现多包间、多电器的集群化独立管理。