智能包间控制器Mini是专为棋牌室、茶室等场景设计的4路继电器控制设备，开放HTTP接口支持局域网直连控制。以下方案涵盖电气接线、接口调用流程和前后端代码示例，帮助快速实现照明和换气扇的远程通断控制。
1. 概述
本方案基于芯步 “智能包间控制器|Mini” 的开放HTTP接口，旨在指导开发者或集成商如何通过软件系统（如SaaS后台、小程序、App）远程控制包间内的照明灯和换气扇设备。
核心目标：利用控制器的第1路输出控制照明，第2路输出控制换气扇，实现独立的远程通断控制。
2. 硬件选型与接线定义
在开始对接前，需明确Mini控制器的端口定义。该设备共提供4路输出，针对照明和换气扇的控制，我们通常使用前两路。
| 端口标识 | 类型 | 负载能力 | 本方案用途 | 接线 |
|---|---|---|---|---|
| 第1路 | 16A 继电器开关 | 阻性≤3500W | 照明灯控制 | 接包间主照明灯或氛围灯。 |
| 第2路 | 16A 继电器开关 | 阻性≤3500W | 换气扇控制 | 接排风扇或新风机。 |
| 第3路 | 10A 门禁接口 | 2200W | 预留 | 可接门锁或广告牌。 |
| 第4路 | 30A 专用接口 | 6600W | 预留 | 通常接2匹空调。 |
关键参数注意
负载匹配：照明和换气扇属于感性负载（或阻性负载）。实际带载能力相比阻性负载有降额（感性负载约500W），请确保电器功率不超过设备额定值。
供电网络：设备需要稳定的 DC 5V1A 供电（Micro USB接口），且必须连接 2.4GHz WiFi 网络。
3. 对接方案技术架构
芯步的开放接口采用了局域网直连模式，无需经过云端中转，延迟低且支持私有化部署。
通信流程
设备配网：控制器上电后，通过AP模式配置连接店铺WiFi。
获取IP：设备获取局域网IP地址。
软件发起请求：管理后台或小程序向该IP地址发送HTTP POST请求。
执行与反馈：设备解析JSON命令，闭合/断开继电器，返回执行结果。
流程图解
sequenceDiagram
participant App as 管理软件/小程序
participant Server as 本地局域网 / 云端代理
participant Mini as 包间控制器Mini
participant Device as 照明灯/换气扇
App->>Server: 1. 点击"开灯"按钮
Server->>Mini: 2. POST /control (JSON: {"power1":1})
Mini->>Device: 3. 第1路继电器吸合，通电
Mini-->>Server: 4. 返回 {"code":200, "state":{...}}
Server-->>App: 5. 界面显示"已开启"4. API接口调用详解
4.1 基础信息
请求方式
POSTContent-Type
application/jsonURL结构
http://[设备IP地址]/control注：如果配置过端口，需加端口号，如
http://192.168.1.100:1998/control
4.2 鉴权机制
在私有化部署模式下，使用签名机制防止非法访问。
参数
sign生成规则：对预设的
secret进行MD5加密。示例：若
secret=123，则sign=md5("123")=202cb962ac59075b964b07152d234b70。
请求示例
http://192.168.1.100/control?sign=202cb962ac59075b964b07152d234b70
4.3 核心命令字典
针对照明和换气扇的控制指令如下：
| 功能描述 | JSON命令内容 | 备注 |
|---|---|---|
| 开启照明 | {"power1": 1} | 1代表开启，0代表关闭。 |
| 关闭照明 | {"power1": 0} | - |
| 开启换气扇 | {"power2": 1} | 第2路控制。 |
| 关闭换气扇 | {"power2": 0} | - |
| 查询所有状态 | {"state": ""} 或 {"status": ""} | 返回各路开关状态。 |
4.4 成功返回示例
当 code 为 200 时代表指令执行成功。
5. 代码实现片段
以下示例演示如何通过Python和JavaScript（小程序/Web）向设备下发命令。
5.1 Python 后端实现（局域网直连）
5.2 微信小程序前端实现（需代理中转）
由于小程序无法直接访问局域网IP，需经由云函数或自有服务器中转。
6. 实施步骤指南
6.1 部署与配网
安装：将控制器固定在包间配电箱内。注意强电接线需由专业电工操作，断电施工。
配网：使用芯步官方提供的“设备配网”工具或SDK，将设备加入店铺的2.4G WiFi网络。
技巧：设备支持设定5组WiFi，会自动切换最强信号。
定位：在路由器后台或通过官方调试工具，固定控制器的IP地址（DHCP绑定） 。这是保证后台稳定控制的关键。
6.2 软件对接调试
获取开发凭证：登录芯步工作台（Console），在“开发设置”中获取
AppID和AppSecret（私有化部署时对应sign的密钥）。调试模式：前期开发可开启“调试模式”暂时忽略签名校验，提高测试效率。
协议适配：按照第4节的API格式，封装设备控制服务类。
6.3 场景联动逻辑
为了更好的用户体验，结合定时任务和触发机制：
定时任务：利用控制器的“内部定时任务”功能，设定换气扇在每天固定时段自动开启，改善包间空气。
门锁联动：利用第3路门禁接口，实现“客人扫码付款 -> 自动开灯 + 关电磁锁”的自动化流程。
7. 常见问题与排障
控制无响应（超时）
排查：检查软件请求的IP地址是否为控制器最新的局域网IP（设置DHCP地址池保留）。
网络：确保手机/服务器与控制器在同一个局域网网段内，或者路由策略允许互通。
语音播报乱码（TTS版本）
该系列产品 “不支持UTF-8” 。发送语音命令时，需将中文字符串转换为 GBK 编码，并转义为16进制字符串发送。
错误示例
{"play":"你好"}正确示例
{"play:gbk:16":"c4e3bac3"}
设备离线
确认WiFi密码未变更。该设备仅支持 2.4G频段，不支持5G WiFi。
8. 总结
通过芯步智能包间控制器Mini的开放接口，对接照明与换气扇控制是一项标准、低门槛的开发工作。开发者仅需掌握 HTTP POST 请求方法和 JSON 数据结构，配合设备提供的强大继电器负载能力（单路高达3500W），即可快速实现“智能包间”的硬件改造与软件集成。这一方案不仅提升了包间的自动化管理水平，也为后续接入空调、门禁等更多设备预留了扩展空间。