如何接入4路包间智能开关控制器MINI来实现照明换气扇电源控制_解决方案

CATALOG

4路智能开关控制器MINI的核心价值在于：用一路设备同时管理照明、换气扇、门锁和空调，通过HTTP接口即可完成远程控制和状态联动。以下方案涵盖接口接入、设备配网、指令设计和业务场景。

在共享棋牌室、茶室、自习室或KTV包间等场景中，环境控制系统需要同时管理照明、通风、门禁及电源设备。芯步的智能包间控制器MINI提供了4路独立控制的输出接口。

本方案的目标是利用其开放的HTTP API接口，将控制器无缝对接到现有的SaaS系统或小程序后台，实现对包间内 “照明灯”、“换气扇” 的远程开关，并联动门锁与空调，最终形成“一键启动/清空包间”的自动化流程。

在开始对接前，需明确MINI控制器的物理端口规划。根据其硬件规格，的接线方案如下：

注意：换气扇属于感性负载，启动瞬时电流较大。MINI的第1、2路设计针对500W以内的感性负载进行了优化，适配标准换气扇无压力。

控制器依赖2.4GHz WiFi连接网络，无需额外网关。需按以下步骤完成配网：

注册与创建：在芯步官网注册开发者账号，并在“物联网控制台”创建应用（工作台），获取核心凭证：AppID 和 AppSecret。
配网操作
- 在控制台的“网络配置”中录入包间现场WiFi的SSID和密码（需2.4G频段）。
- 给MINI控制器通电，长按配网键直至指示灯进入快闪状态。
- 使用手机热点或小程序完成设备配网与网络同步。
获取设备ID：配网成功后，控制台会显示该设备的唯一标识符（Device ID），这是后续API调用的目标地址。

芯步提供了标准的HTTP API，主要通过POST请求向设备下发命令。

为了安全，每次请求必须携带签名。签名算法如下Sign = MD5( MD5(AppSecret) + ts )

请求URLhttps://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}
请求方式：POST
HeaderContent-Type: application/json
Body参数
- device：从控制台获取的设备ID（字符串，支持多个用逗号隔开）。
- order：具体的控制命令（JSON对象）。

针对“照明+换气扇”的控制场景，主要使用以下order指令。

第一种场景：独立控制用户进入包间，需要打开照明：

(power1为第1路，1代表开启，0代表关闭)。

用户离开包间前，关闭换气扇：

第二种场景：组合控制当保洁打扫完毕或用户下单时，需要将所有设备复位（照明关、换气关、空调关）。这里推荐使用 批量控制（Batch） 指令，一次性发送所有指令，减少网络开销：

(此指令将同时关闭第1、2、4路，实现一键清空)。

第三种场景：互锁/延时控制为了排出包间异味，设定换气扇在关灯后继续运行5分钟再关闭。代码逻辑上需要做如下处理：

用户点击“离店/关灯”按钮。
前端调用：{"power1": 0} （关灯）
前端调用：{"reset": {"relay": [2], "interval": 300000}} （第2路先断后通，延迟5分钟=300000毫秒后关闭换气扇）。

为了让开发者快速集成，在后端服务中封装一个通用的设备控制函数：

获取凭证：系统启动时读取配置的AppID和AppSecret。
生成签名
- str1 = MD5(AppSecret)
- str2 = str1 + str(当前时间戳)
- sign = MD5(str2)
发起请求：使用HTTP Client构造POST请求。
错误处理
- 若返回{“code”:401}，通常为签名错误或时间戳失效，检查服务器时间是否同步NTP。
- 若返回{“code”:500}，需检查Device ID是否正确或设备是否离线。

伪代码示例（Python思路）

WiFi信号强度：控制器安装在吊顶或弱电箱内，需确保现场2.4GHz WiFi信号覆盖良好（信号强度不低于-70dBm），否则可能导致响应延迟或离线。
TTS语音播报：如果采购了TTS版本（语音播报版），还可以利用接口实现订单播报。例如用户下单成功后，下发{“play:gbk:16”:“欢迎光临，请进入3号包间”}，提升用户体验。
私有化部署：如果数据安全要求比较高，该设备也支持局域网原生API，可将API地址从api.thingboot.com切换为设备的局域网IP进行通信。