4路包间电器覆盖控制器MINI的核心优势在于:一路解决空调(30A)、一路解决门锁(10A)、两路解决照明/麻将机等常规电器——基本一个盒子管满一个包间。以下是完整接入方案。
1. 产品概述与核心参数
4路包间电器覆盖控制器MINI 是专为服务型门店(共享棋牌室、茶室、自习室、琴房等)设计的核心IoT设备。它最大的特点是“麻雀虽小,五脏俱全”,在一个仅90*72*62.8mm的Mini身材内,集成了对包间内所有强电设备的独立控制能力。
1.1 硬件接口定义
在接入前,需明确其4路输出的物理承载:
第1路:16A继电器(开关类),适用于照明、换气扇、吸烟灯等阻性负载。
第2路:16A继电器(插座类),适用于饮水机、麻将机、按摩仪等设备。
第3路:10A继电器(门禁专用),适用于电磁锁、电插锁(直流)。
第4路:30A大功率继电器,专门用于2匹以内空调的直接控制。
1.2 技术特性
网络连接:仅支持2.4GHz WiFi,直连路由器,无需网关。
开放性:提供完整的HTTP API接口,支持云端调用和局域网自建服务器调用。
语音扩展:TTS版本支持远程文字转语音播报(如:提醒顾客时间到了)。
2. 接入准备与网络配置
在编程开发之前,需要完成物理设备的初始化。
2.1 设备配网
设备通电后,会发出热点信号。需通过芯步官方App或小程序,为其配置目标WiFi的SSID和密码。
注意:该设备仅支持 IEEE 802.11 b/g/n 2.4GHz 频段,无法连接5G WiFi。
2.2 获取开发者凭证
登录芯步控制台:
AppID:应用唯一标识。
AppSecret:开发者密钥(用于生成签名)。
Device ID:设备的唯一ID,可从控制台设备列表获取。
2.3 通信模式选择
芯步开放接口支持两种模式,可根据项目需求选择:
公有云模式(默认):调用
api.thingboot.com域名,设备无需固定IP,适合SaaS多租户系统。私有化/局域网模式:如果要求断外网可控或低延迟,可将设备与服务器配置在同一局域网,直接通过设备本地IP调用API(需设备固件支持)。
3. API 接口集成方案
控制器提供了一系列标准的HTTP POST接口来控制物理世界。
3.1 请求地址与签名构造
请求URL
POST https://api.thingboot.com/{AppID}/device/control/鉴权参数
ts:当前Unix时间戳(秒),用于防重放攻击。sign:签名,计算公式为md5(md5(AppSecret) + ts)。
3.2 单路独立控制
针对包间内的不同设备(如只关灯,不开门),通过修改 order 参数中的具体继电器状态。
请求示例(关闭第2路,即关闭麻将机)
参数说明
power1~power4分别对应硬件的1-4路。值
"1"代表通电/开启;"0"代表断电/关闭。
3.3 一键全控与批量操作
在用户离店(一键全关)或上钟(一键全开)场景非常实用。
请求示例(全开/全关)
仅控制奇数路(如只关照明,保留空调和门禁):
3.4 先断后通(Reset)—— 门禁与空调保护
这是集成中最核心的逻辑,用于门禁复位和空调压缩机保护。
场景:顾客按门铃或请求远程开门。
逻辑:先给电磁锁断电(断开),等待一定时间(如5秒)后再自动恢复供电(闭合),实现“瞬断开门”。
特殊场景:控制空调时,若立即断电又马上通电会损坏压缩机,利用此接口可实现断电后不再自动通电,或延迟重启。
请求示例(第3路门禁复位,先断5秒后自动通)
interval单位为毫秒,5000即5秒。
3.5 先通后断(Point)—— 临时照明或提醒
适用于“寻车模式”或“延时关灯”。开启照明电路,保持一定时间(如2分钟)后自动熄灭。
请求示例(第1路照明,立即开启,2分钟后自动关闭)
4. 代码集成示例(核心逻辑封装)
由于不同语言调用方式类似,关键在于对 order 字符串的动态拼接。以下是基于通用语言的逻辑示例(参考 bash 与 PHP 逻辑):
业务逻辑
状态同步:虽然API下发是异步的,但在重要操作(如退单关电)后,调用设备状态查询接口二次确认。
本地缓存:将
Device ID与包间房号绑定存入数据库,用户下单时触发放电指令。TTS应用:如果是Mini TTS版本,可通过特定API接口下发文字,例如“欢迎光临3号包间”或“余额不足,请续费”。
5. 接入注意事项
感性负载限制
第1、2路接电机/麻将机(感性负载)最大 500W。
第3路接门锁(感性负载)最大 350W。
第4路接空调(感性负载)最大 1100W(约2匹)。
超出此功率可能导致继电器粘连。
门禁接线:第3路输出的是 10A干接点信号,用于控制门禁电源的磁锁,并非直接输出12V/24V电压,接线时需分清是“开关”还是“供电”。
网络稳定性:该设备依赖WiFi,在项目中增加设备心跳检测机制。若设备离线,API调用会立即返回失败,业务系统需做好异常处理。
通过以上步骤,开发者可以在10分钟内完成从配网到第一条指令的下发,将4路控制器无缝集成到自己的无人值守、智能家居或SaaS管理系统中。