4路包间设备集中控制器MINI是一款专为棋牌室、茶室等场景设计的智能硬件,4路输出可分别控制照明、换气扇等设备。以下方案涵盖硬件接线、接口签名算法及单路/批量控制的代码示例,帮助快速完成对接。
解决方案:基于芯步4路集中控制器MINI的照明与换气扇控制接入方案
1. 硬件选型与准备
在开始对接前,需要明确硬件规格。芯步的 智能包间控制器Mini (UNI-KZQ-BJ-MINI) 专为服务型门店包间设计,具备4路独立控制能力。
核心设备:4路集中控制器MINI。
线路规划
第1路:接照明灯(16A开关,适合LED灯或日光灯)。
第2路:接换气扇/排风扇(16A开关,适合感性负载,注意功率限制)。
第3路:备用(10A,通常用于门锁或小功率设备)。
第4路:备用(30A,通常用于空调,若无需空调可扩展其它设备)。
网络环境:设备仅支持 2.4G WiFi,无需额外网关。需确保包间内WiFi信号覆盖良好。
供电:DC 5V1A 供电(Micro USB接口),保持长期在线。
2. 接口鉴权与通信机制
芯步的开放接口基于 HTTP协议,采用 MD5双重签名 机制保障安全性。所有对接动作需通过调用 api.thingboot.com 完成。
开发者凭证在芯步控制台的“开发设置”中获取
AppID(开发者ID)和AppSecret(开发者密码)。签名算法 (Sign)
Sign = MD5( MD5(AppSecret) + ts )步骤说明:将
AppSecret进行第一次MD5加密,得到字符串S1。获取当前Unix时间戳(秒级)
ts。拼接字符串
S1 + ts。对拼接后的字符串进行第二次MD5加密,得到最终的
Sign。
请求地址
POST https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}
3. 业务逻辑对接实现
为了实现对第1路(照明)和第2路(换气扇)的控制,开发者需要编写HTTP请求。
JSON请求体示例:
核心命令对照表(针对4路Mini控制器):
| 功能描述 | 命令字段 (Order) | 参数值 | 业务场景 |
|---|---|---|---|
| 开启照明 | power1 | 1 | 客人进入包间,自动亮灯 |
| 关闭照明 | power1 | 0 | 客人离开/退单,自动关灯 |
| 开启换气扇 | power2 | 1 | 检测到烟雾或定时通风 |
| 关闭换气扇 | power2 | 0 | 离开房间或关闭通风 |
| 全开/总清 | power | 1 或 0 | 一键启用/禁用包间所有设备 |
| 暂停/复位 | point 或 reset | 详见下文 | 用于设备临时断电重启 |
4. 高级场景与代码实战
第一种场景:远程开关照明与换气扇(PHP代码示例)这是一个典型的PHP后端实现,用于接收小程序或Web端指令并下发控制。
第二种场景:一键全开/全关用于商家清场或客人入场准备。
全开:
{“power”: 1}(所有4路同时通电,包括照明和风扇)全关:
{“power”: 0}(切断包间所有电源,安全节能)
第三种场景:设备“复位”功能(解决风扇卡死或灯保护)某些情况下,换气扇需要断电重启才能恢复最大风力,或者照明设备需要复位。可以利用 “先断后通” (reset) 命令。
命令示例
{“reset”: {“relay”: [2], “interval”: 3000}}逻辑:第2路(换气扇)立即断电,等待3秒后自动重新接通。这在远程维护时非常实用,无需派人去包间插拔电源。
5. 私有化部署与内网环境(可选)
如果您的场景对公网依赖较低,或者要求极低延迟、数据不出厂(如公司内部健身房或高档私人会所),可以利用设备的 软网关模式。
机制:设备上电后自动寻找局域网内的“芯步软网关”。
接口变化:原本调用公网API的地址,变为调用局域网内服务器的地址(如
http://192.168.1.100:8080/control)。优势:即使外网断开,只要局域网通,照明和风扇依然可以通过局域网指令控制。
6. 实施注意事项
感性负载限制:换气扇属于电机类设备(感性负载)。虽然第2路支持最高500W感性负载,但在连接多台风扇时计算总功率,避免瞬间电流击穿继电器。
WiFi稳定性:由于Mini版仅支持2.4G,若现场环境2.4G干扰严重(如商场内),将设备“第1路照明”和“第2路换气扇”设置为静态DHCP分配,确保IP不漂移,降低控制延迟。
调试模式:在开发测试阶段,可以在控制台开启“调试模式”,此时系统会暂时忽略Sign签名校验,方便开发者优先验证业务逻辑流程。
通过以上步骤,可以基于芯步标准HTTP接口配合Mini控制器的4路端口,实现照明与换气扇的接入。