4路包间电器覆盖控制器MINI是一款专为服务型门店设计的智能硬件，通过HTTP接口可快速接入各类软件项目。以下方案涵盖硬件准备、接口对接、命令调用到场景的完整流程。

1. 产品认知与适用场景

在开始接入前，首先需要明确 4路包间电器覆盖控制器MINI 的硬件特性与应用边界。这款产品设计极为紧凑（72mm x 90mm），非常适合安装在空间有限的包间内，如共享棋牌室、茶室、自习室或小型琴房。

它的核心优势在于“麻雀虽小，五脏俱全”，提供了4路独立的电路控制：

• 第1路 (16A)：通常接照明、换气扇或吸烟灯。

• 第2路 (16A)：通常接饮水机、麻将机等插座类电器。

• 第3路 (10A)：专门设计用于门禁电磁锁，支持直流电磁锁和电插锁，便于实现自助包间的门禁管理。

• 第4路 (30A)：专为空调设计，最大支持2匹空调的接入。

选型提示：该设备有“标准版”和“TTS版”两种。如果需要远程语音播报功能（如订单提醒、超时提示），请请一定要采购TTS版本。

2. 接入前的准备工作

在编写代码之前，需要完成物理设备的安装与云端配置。这一步是确保后续网络通信稳定的基础。

1. 注册与创建应用：访问芯步官网，注册开发者账号，进入“物联网控制台”。在“开发设置”中，获取两个关键凭证：AppID（应用ID）和 AppSecret（开发者密码）。这两个凭证将用于后续所有API请求的身份验证。

2. 设备配网

   • 确保现场WiFi信号覆盖良好，且为 2.4GHz 频段（不支持5G WiFi）。

   • 接通控制器电源（DC 5V1A）。此时指示灯应处于闪烁状态。

   • 使用微信小程序“芯步”或登录PC控制台，选择“网络配置”，添加现场WiFi的SSID和密码，通过声波或热点模式将网络凭证推送给设备。

3. 获取设备ID：配网成功后，设备会自动出现在控制台的“设备列表”中。每个设备对应唯一的 Device ID（例如：1878），这是后续API操作的目标对象。

3. 接口鉴权与签名机制

芯步的开放接口采用标准的HTTP POST请求，核心难点在于 Sign（签名） 的计算。为了服务器安全，所有指令都必须携带动态签名。

签名生成规则（伪代码逻辑）：

1. 获取当前Unix时间戳（秒级）定义为 Ts。
2. 第一步加密:S1 = md5(AppSecret)  
   // 将你的开发者密码进行一次MD5哈希
3. 拼接字符串:S2 = S1 + Ts  
   // 将上一步的结果与时间戳拼接成字符串
4. 最终签名:Sign = md5(S2)  
   // 将拼接后的字符串再次进行MD5哈希

实际请求示例：

• URL： https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Ts}

• Method： POST

• Content-Type： application/json

核心逻辑解读：这种双重MD5加时间戳的机制，能有效防止接口被恶意重放攻击。由于时间戳（Ts）参与运算，签名通常在短时间内（几百毫秒至几分钟内）有效，确保了通信的时效性。

4. 核心API指令详解

接入项目时，开发者只需关注 order 参数的构造。根据业务场景，你需要下发不同的JSON指令。

4.1 单路独立控制

这是最基础的操作，适用于用户点击“开灯”、“关空调”等按钮。

• 开第1路（照明）： {"power1": 1}

• 关第2路（插座）： {"power2": 0}

• 开第3路（门锁）： {"power3": 1}

• 关第4路（空调）： {"power4": 0}

4.2 语音播报

（仅限TTS版本）当顾客下单或超时时，系统可自动触发语音。

• 命令示例： {"play:gbk:16":"欢迎光临，请扫码入座"}

• 参数解读play:gbk:16 中的16代表音量或编码格式，后跟要播报的中文字符串。

4.3 场景联动与批量控制

在“离店断电”或“打扫模式”场景下，需要一次性操作多个继电器。

• 全部关闭： {"power": 0}

• 批量操作（仅关闭第1路和第3路）

  {"batch": {"relay": [1,3], "power": 0}}

  注意：relay参数通常对应数组[1,3]，代表第1路和第3路。

4.4 门禁专用逻辑（先断后通）

针对第3路门锁，通常需要“通电开门”并在几秒后自动断电以保护电磁锁。

• 命令示例： {"reset": {"relay": [3], "interval": 3000}}

• 逻辑：先断开第3路，等待3秒后自动接通（或反之，视具体锁型而定）。这种脉冲控制可防止锁体长时间通电发热。

5. 代码集成示例

以下是一个基于Bash/Curl的集成示例，展示了如何在项目中封装上述逻辑。

*注意：在实际开发中（如Java/Python/PHP），请请一定要使用原生的加密库来计算MD5，避免字符串转义错误。*

6. 高级集成：局域网与私有化

如果你的项目运行在纯内网环境（如工厂、本地服务器），且不希望数据经过外网，该设备也支持局域网（LAN）模式。

• 原理：设备通过广播或轮询机制暴露本地IP。

• 优势：零延迟、不依赖外网带宽。

• 实施：在控制台开启“局域网”功能后，你可以直接向 http://{设备本地IP}/api/... 发送指令，鉴权方式与云端一致，但更稳定。

7. 联调与排错指南

在集成过程中，如果遇到指令下发失败，可按照以下清单排查：

1. 检查Sign：签名错误是99%的问题来源。请核对AppSecret是否复制了多余空格，以及时间戳（Ts）是否为Unix秒级且与服务器时间误差不大。

2. 检查WiFi：如果控制器离线，API会返回设备不在线错误。观察设备指示灯是否常亮（代表已联网）或闪烁（代表离线）。

3. 负载匹配：接入空调或大功率设备时，请一定要确认第4路接了30A接口，不要错接到第3路（10A）上，否则极易烧毁保险丝。

4. TTS测试：首次测试TTS时，音量不要设置过大，确保设备喇叭口未被遮挡。

通过以上步骤，你应该可以将芯步的这款MINI控制器无缝对接到网页、小程序或后台管理系统中，实现包间电器的全自动化管理。