基于芯步的设备文档，这款智能包间控制器Mini提供标准HTTP接口，可通过4路继电器独立控制灯光、空调、门锁等设备。以下方案涵盖硬件接线、接口调用流程以及独立控制、批量操作、脉冲控制等常见场景的代码示例。
解决方案：无人值守包间设备控制 —— 4路灯光空调控制器MINI接入指南
1. 产品选型与参数确认
在开始集成之前，首先需要明确“智能包间控制器Mini”的硬件特性，以确保其满足项目需求。
根据产品手册，该型号（UNI-KZQ-BJ-MINI）专为服务型门店包间设计，具有以下核心参数：
核心优势：支持WiFi 2.4G直连，无需网关，降低硬件成本；开放全量HTTP API接口。
负载能力：提供4路继电器输出。
第1/2路：16A继电器，适合控制照明、排气扇、麻将机。
第3路：10A（直流），专门用于门禁电磁锁/电插锁。
第4路：30A继电器，专门用于空调（2匹以内无需额外交流接触器）。
环境要求：DC 5V1A供电，需覆盖2.4G WiFi信号。
2. 硬件部署与接线
在集成代码之前，物理接线是决定性的一步。针对无人值守场景，标准接线方案如下：
| 端口 | 接入设备 | 接线说明 |
|---|---|---|
| L / N | 电源输入 (220V) | 接入零火线为设备供电。 |
| OUT 1 | 照明/氛围灯 | 火线进，火线出至灯具（16A容量）。 |
| OUT 2 | 麻将桌/插座 | 用于控制麻将桌电源或普通插座。 |
| OUT 3 | 门锁 (12V DC) | 注意：此路为直流输出，直接接门禁锁的电源正负极即可。 |
| OUT 4 | 空调 (插座) | 接入空调专用插座回路。 |
| SW 1-4 | 门磁/物理开关 | 可接入门口物理开关，实现本地一键开关灯。 |
部署提示：请一定要确认设备已连接WiFi。设备支持5组WiFi配置，会自动选择信号最强的连接，包间内确保信号强度。
3. 软件集成：接口调用详解
芯步的开放接口基于HTTP协议，这意味着任何支持HTTP请求的编程语言（Java, Python, PHP, Node.js, Go等）甚至低代码平台都可以轻松集成。接口地址结构通常为： http(s)://api.thingboot.com/{AppID}/device/control/
3.1 鉴权与签名
每次HTTP请求需携带 sign（签名）和 ts（时间戳）。
原理：防止接口被重放攻击或非法调用。需将
AppID、AppSecret（在控制台获取）与请求参数按规则进行MD5加密。注意：官方文档要求携带sign和ts，具体加密算法需参考通用文档，通常是对参数排序后拼接密钥进行MD5。
3.2 核心指令集
设备ID（device）位于设备外壳或控制台。向设备下发指令时，order 参数为核心控制字段。
基础控制（开关灯/空调）这是最常用的场景，通过 power1 到 power4 直接控制对应路数的通断。
开第1路（照明） ：
关第4路（空调） ：
请求示例（POST方式） ：
场景控制（欢迎模式 / 清场模式）为了在订单开始时一键启动所有设备，使用批量控制功能。
全开/全关：使用
{“power”: 1}或{“power”: 0}。选择性开：仅开照明（1路）和空调（4路），关麻将机（2路）。
(逻辑：将继电器的第1路和第4路设置为通电状态)
门禁控制（脉冲开锁）用户通过手机小程序点击“开门”，需触发一个短暂的脉冲信号（通电后迅速断电）。
实现的方式是：使用
reset指令。(逻辑：第3路先断电（如果原本是通的），然后通电，再自动断开通电，形成500毫秒的脉冲，通常用于触发门锁)
定时清理与断电复位在用户订单结束后（如包间时间用完），系统需自动清理房间，关闭所有设备并暂时锁定空调。
操作：下发全关指令并配合数据库状态更新。
4. 业务逻辑流程设计
在无人值守（如共享棋牌室）项目中，按以下时序设计代码逻辑：
用户下单
系统订单模块创建订单。
调用接口：给对应包间的控制器发送
order {“power”: 1}（全开）或{“power1”:1, “power4”:1}（开灯开空调）。可选：如果是TTS版本，发送语音播报指令：“欢迎光临，设备已开启”。
使用中
用户在小程序端点击“开锁/关门”。
调用接口：发送
{“reset”: {“relay”: [3], “interval”: 500}}控制门锁开合。
订单结束/超时
定时任务检测到订单结束。
调用接口：发送
{“power”: 0}（全关，切断麻将机、灯、空调电源）。逻辑强化：为防止用户卡时赖着不走，系统可每5分钟重试一次全关指令，确保空调被强制关闭。
5. 高级特性和需要注意的点
异步反馈机制HTTP接口的
code 200仅代表指令已送达云端，不代表设备已执行。如果需要严格确认“灯真的亮了”，可以监听设备上报的状态消息。可以使用MQTT订阅api/{AppID}/device/status主题，或配置HTTP回调（Webhook），芯步会在设备状态变更时推送消息。私有化部署如果你的项目运行在纯内网环境（如企业内部、保密单位），该设备支持私有化部署。你可以修改设备的连接地址，使其指向你自己的消息服务器，数据完全不经过芯步官方云。
分组管理如果项目涵盖几十个包间，不要在业务中直接操作几十个
device_id循环。可以在芯步控制台预先设置分组（例如“A栋3楼”），通过调用分组控制接口，一行代码控制整个楼层的总闸。
6. 总结
将芯步4路控制器Mini接入项目，主要涉及三步：
物理极联：接好220V电、WiFi天线和空调/灯负载。
接口对接：处理好
sign签名，区分power1（灯控）和power4（空调大功率）的指令差异。场景逻辑：利用
batch实现一键开店/一键清场，利用reset实现脉冲开锁。
该方案因其接口简洁（标准HTTP）且无需网关，是目前无人自习室、共享棋牌室及公寓门禁集成性价比较高的选择之一。