芯步的4路包间控制器MINI通过开放HTTP API接口，支持单路独立控制和批量并行管理。以下方案从设计、接口调用、签名鉴权到异常处理，给出完整的技术实现路径，适用于棋牌室、茶室等多包间场景的集中管控。

1. 背景与需求

在现代服务型门店（如共享棋牌室、茶室、自习室）中，运营者通常面临多包间、多电器的管理难题。传统的人工巡检开关不仅效率低下，且容易出现“忘记关空调”、“客人未断电”等导致的高额能耗。

本方案基于芯步智能包间电器覆盖控制器MINI的开放HTTP API接口，旨在构建一套中心化控制平台，实现以下核心目标：

• 单点精准控制：随时随地对单个包间的照明、麻将机、门锁、空调进行独立开关。

• 多包间批量操作：在营业结束或集中清场时，一键批量关闭所有包间的高能耗电器（如空调）。

• 自动化联动：结合传感器或订单系统，实现自动断电或上电。

2. 核心技术架构

本方案采用标准的 SaaS + 智能硬件 架构，所有通讯均基于HTTP协议。

• 硬件层：部署“智能包间控制器Mini”在每个包间，负责控制4路电路的通断（照明、插座、门锁、空调）。

• 网络层：设备通过WiFi 2.4GHz连接至云端或局域网服务器。

• 云平台层：芯步开放API（api.thingboot.com）负责承载指令转发。

• 应用层：您的自有管理系统（Web/小程序/APP），用于触发控制指令。

3. 关键接口定义与对接

解决“批量开关”的核心在于如何高效利用Mini控制器的接口特性。该控制器支持单路操作与批量操作两种模式。

3.1 接口鉴权机制

所有接口调用需携带动态签名，以保障安全性。签名算法逻辑如下：

1. 拼接字符串：Str = md5(AppSecret) + ts（其中ts为Unix时间戳）。

2. 计算签名：Sign = md5(Str)。

3.2 单包间精细控制

该接口用于客人下单后自动通电，或离店时检查特定设备。

• 请求地址： POST https://api.thingboot.com/{AppID}/device/control/

• 核心参数

  • device：设备唯一ID（即包间对应的Mini控制器ID）。

  • order：控制指令，采用JSON格式。

实例场景：开启包间照明与麻将机，关闭空调

3.3 多包间批量控制【核心功能】

针对主题“多包间批量开关控制”，利用接口的批量设备ID支持特性，可实现多包间的并发控制，无需循环调用。

方案A：多设备单指令批量下发在同一HTTP请求中，通过逗号分隔多个设备ID。

• 场景：闭店时，一次性关闭全场所有包间的空调（第4路）。

• 请求示例

方案B：单设备批量继电器控制利用batch命令，对单个包间内的多线路执行组合控制。适用于“欢迎模式”（灯光全开）或“离店模式”（除门锁外全关）。

• 场景：客人开始计费，全开该包间所有电器（除门锁）。

• 请求示例

3.4 自定义联动与定时任务

除了主动调用，Mini控制器支持云端定时任务和自定义联动。

• 定时批量关：在管理后台设定每晚23:00，系统自动向所有注册的Mini设备下发{"power4":0}指令，确保无人包间空调不再空转。

• 传感器联动：结合芯步的人体传感器，当包间检测到长时间无人且订单状态为“已结束”时，自动触发批量全关指令。

4. 实施步骤

第一阶段：设备部署与配网

1. 安装接线：根据产品手册，将控制器接入包间电路。

   • L1：接照明/换气扇（16A）。

   • L2：接麻将机/饮水机插座（16A）。

   • L3：接门禁电磁锁（10A）。

   • L4：接空调（30A，需注意空调功率匹配）。

2. 网络配置：设备连接2.4G WiFi。Mini控制器支持配置5组WiFi，具备断网重连能力 。

第二阶段：软件对接开发

1. 获取凭证：登录芯步控制台，获取 AppID 与 AppSecret。

2. 封装SDK：如果您不想处理底层的签名逻辑（MD5加密），可以使用官方推荐的PHP/Python/NodeJS封装库。

   • 代码逻辑参考：构建POST请求，Header包含Content-Type，Body包含device和order，URL携带动态Sign。

3. 构建业务逻辑

   • 打通订单系统：用户支付成功 -> 调用接口 {"power1":1, "power2":1, "power3":1}（通电开门）。

   • 构建管理界面：设计一个“全选”按钮，触发全部门店设备的批量关闭指令。

第三阶段：压力测试与优化

芯步接口响应时间约为 80ms-120ms。

• 单设备控制：延迟极低，体验流畅。

• 批量控制：如果在一次请求中携带超过50个设备ID，分批调用或异步处理，避免HTTP包体过大导致的网络超时。

5. 故障排查与运维

1. 签名失败：检查ts时间戳是否与服务器标准时间相差过大（通常不能超过5分钟），以及MD5加密后的字符串大小写是否一致 。

2. 局域网还是云端？

   • 如果您的门店网络不稳定，推荐使用局域网私有化模式。芯步Mini控制器支持私有化部署，指令直接在门店本地服务器和硬件间传输，不经过外网，即便宽带故障也能本地控制 。

3. 门锁逻辑：第3路（门禁）通常接电磁锁。请注意，电磁锁需要断电开锁，因此开门指令应为{"power3":0}。

6. 方案价值总结

通过对接芯步4路控制器的开放接口，您能够：

• 节省人力：无需保安逐间房巡检，后台可视化管理。

• 降低能耗：通过定时任务和批量关空调，预计节约电费20%-30%。

• 提升体验：客人自助下单即通电，到点自动断电，实现全自动化无人值守运营。