这四路控制模块的核心价值在于：用最简单的方式（HTTP接口）把包间里的照明、门锁、空调、麻将机等设备统一接入你的软件系统。以下是完整的对接方案。
解决方案：基于芯步MINI控制器的包间设备集中对接指南
1. 产品核心概述与对接价值
智能包间控制器MINI 是一款专为服务型门店（如棋牌室、茶室、共享会议室）设计的4路继电器控制设备。它的核心价值在于通过WiFi联网，提供开放的HTTP API接口，允许开发者将传统电器快速升级为可通过软件（小程序/APP/PC）控制的智能设备。
对接本项目后可实现：
自动化计费联动：用户下单自动通电，时间耗尽自动断电。
远程运维：服务员无需进入包间即可远程处理设备故障（如重启路由器、重置麻将机）。
场景化控制：一键执行“开场模式”（开灯、开空调、关门锁）或“打扫模式”。
2. 硬件安装与电气接线规范
在开始API对接前，需由电工完成硬件安装。MINI控制器采用AC 100-265V 宽电压供电，内置4路继电器。
各端口功能定义与接线：
| 端口 | 属性 | 典型负载 | 对接用途 | 技术限制 |
|---|---|---|---|---|
| 第1路 | 16A开关 | 照明/换气扇/吸烟灯 | 灯光控制：检测到人活动时自动亮灯 | 感性负载限500W |
| 第2路 | 16A插座 | 麻将机/饮水机/按摩椅 | 主设备电源：订单开始供电，结束断电 | 感性负载限500W |
| 第3路 | 10A门禁 | 电磁锁/电插锁 | 门禁控制：用户自助扫码开门，远程开门 | 直流电磁锁专用 |
| 第4路 | 30A大功率 | 2匹空调/取暖器 | 空调智控：配合红外转发器实现恒温 | 阻性负载6600W |
注意：由于第3路（门禁）通常为常闭供电，接线时请区分“断电开门”与“通电开门”的逻辑，并在软件层面做相应取反处理。
3. 网络配置与开发准备
MINI控制器使用 WiFi 2.4G 直连，无需额外网关。第一步：设备配网
给控制器上电。
下载“芯步”官方App或通过工作台，依据《产品手册》引导，将设备连接至门店所在区域的2.4G WiFi网络。
关键点：记录下分配给该设备的 Device ID（设备ID），这是后续接口调用的唯一标识。第二步：获取密钥
登录芯步控制台，进入“开发设置”。
获取 AppID（开发者ID）和 AppSecret（开发者密码）。
调试：开发阶段可在控制台打开“调试模式”，暂时忽略签名校验以加快开发速度；上线前请一定要关闭。
4. API接口对接实战
控制器的接口采用标准的 HTTP POST 请求，支持任何编程语言。
请求基础信息：
请求地址：
https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}请求方式： POST
请求头：
Content-Type: application/json参数位置： Body
签名算法：为了保证安全性，请求需要携带签名。算法规则为 Sign = md5(md5(AppSecret) + ts)。
ts：当前Unix时间戳（秒）。将
AppSecret进行一次MD5加密，再拼接上时间戳，最后整体进行一次MD5加密。
核心命令示例（开发必备）：
A. 单路控制（最常用）需求：用户点击“开灯”，控制第1路接通。
B. 全开/全关需求：用户结算离开现场时，关闭所有设备。
C. 场景联动：先断后通（Reset模式）需求：麻将机死机，需要断电重启（先断开第2路，等待5秒，再接通）。
D. TTS语音播报（如为TTS版本）需求：订单即将超时，喇叭提醒顾客。
注：
gbk:16代表音量音色参数，可根据产品手册调整。
5. 典型业务逻辑落地场景
第一种场景：自助扫码开单流程
扫码：用户微信扫码包间二维码。
拉取状态：调用API查询设备当前状态。
开门：如果房间空闲，调用 API 发送
{"power3":0}（假设为通电开锁）或{"power3":1}（假设为断电开锁）开启门锁。上电：用户选择时长并支付后，调用
{"power1":1, "power2":1, "power4":1}开启灯光、麻将机和空调。倒计时：本地服务器记录结束时间戳。
到期处理：时间到，调用
{"power":0}全关设备，并调用TTS接口提示离开。
第二种场景：局域网/私有化部署（高稳定性要求）对于网络环境要求比较高的棋牌室，MINI控制器支持 私有化部署。开发者可以搭建本地自建消息服务器（MQTT Broker或HTTP Server），让设备完全在局域网内运行，彻底摆脱因外网宽带故障导致的无法控制问题。
6. 常见问题与避坑指南
感性负载问题
控制器不能直接带载大功率电机或老旧日光灯（启辉器闪烁会产生高压），否则可能导致触点粘连。加装中间继电器进行隔离。
WiFi信号强度
设备虽然支持设定5组WiFi自动切换，但金属包间（如KTV）信号衰减严重。确保包间内2.4G信号强度在-60dBm以上，或使用Mesh组网。
门禁逻辑
电磁锁通常需要持续的直流电（DC 12V/24V）。MINI控制器的第3路仅是开关信号，必须串联进电磁锁的电源回路中，不能直接输出12V电压给锁，需要外接对应电压的电源适配器。
签名调试
如果返回签名错误，请检查时间戳
ts是否为整数秒（如1704067200），且服务器时间与标准时间误差不宜过大。
通过以上步骤，你可以将芯步MINI控制器平滑地集成到现有的SaaS系统中，实现包间设备从“人工巡管”到“全自动无人化”的升级。