CATALOG

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 获取开发者凭证

登录芯步控制台:

  1. AppID:应用唯一标识。

  2. AppSecret:开发者密钥(用于生成签名)。

  3. Device ID:设备的唯一ID,可从控制台设备列表获取

2.3 通信模式选择

芯步开放接口支持两种模式,可根据项目需求选择:

  • 公有云模式(默认):调用 api.thingboot.com 域名,设备无需固定IP,适合SaaS多租户系统。

  • 私有化/局域网模式:如果要求断外网可控或低延迟,可将设备与服务器配置在同一局域网,直接通过设备本地IP调用API(需设备固件支持)。

3. API 接口集成方案

控制器提供了一系列标准的HTTP POST接口来控制物理世界。

3.1 请求地址与签名构造

  • 请求URLPOST 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 字符串的动态拼接。以下是基于通用语言的逻辑示例(参考 bashPHP 逻辑):

业务逻辑

  1. 状态同步:虽然API下发是异步的,但在重要操作(如退单关电)后,调用设备状态查询接口二次确认。

  2. 本地缓存:将 Device ID 与包间房号绑定存入数据库,用户下单时触发放电指令。

  3. TTS应用:如果是Mini TTS版本,可通过特定API接口下发文字,例如“欢迎光临3号包间”或“余额不足,请续费”

5. 接入注意事项

  1. 感性负载限制

    • 第1、2路接电机/麻将机(感性负载)最大 500W

    • 第3路接门锁(感性负载)最大 350W

    • 第4路接空调(感性负载)最大 1100W(约2匹)

    • 超出此功率可能导致继电器粘连。

  2. 门禁接线:第3路输出的是 10A干接点信号,用于控制门禁电源的磁锁,并非直接输出12V/24V电压,接线时需分清是“开关”还是“供电”

  3. 网络稳定性:该设备依赖WiFi,在项目中增加设备心跳检测机制。若设备离线,API调用会立即返回失败,业务系统需做好异常处理。

通过以上步骤,开发者可以在10分钟内完成从配网到第一条指令的下发,将4路控制器无缝集成到自己的无人值守、智能家居或SaaS管理系统中

控制器产品方案:
怎么接入智能 24 路远程开关控制模块以实现自定义场景联动控制
查看 >>
怎么在轰趴馆多功能包间控制中对接智能硬件来实现空调电源控制
查看 >>
照明控制:如何将8路防水防尘控制箱对接到项目中
查看 >>
怎么接入智能 24 路远程通用控制器来实现设备故障告警通知
查看 >>
怎样接入8路防水防尘控制箱来实现远程控制8路线路
查看 >>
覆盖场景方案:
4路包间电器覆盖控制器MINI:怎样将4路包间设备控制器MINI接入到项目中
查看 >>
怎么在4路包间电器覆盖控制器MINI中集成智能硬件以实现包间设备能耗数据分析
查看 >>
4路包间电器覆盖控制器MINI:如何将4路包间设备集中控制器MINI接入到自己的项目中
查看 >>
怎么在4路包间电器覆盖控制器MINI中对接智能设备来实现远程重置包间设备状态
查看 >>
4路包间电器覆盖控制器MINI:如何把4路包间设备控制模块MINI对接到软件项目中
查看 >>
包间用途方案:
4路远程包间电源管理模块MINI:怎样把4路10A/16A/30A多规格输出控制器MINI对接到项目中
查看 >>
怎么在舞蹈练习室设备管理中集成智能设备来实现包间清洁模式一键切换
查看 >>
共享办公独立包间场景:如何将8路大功率包间电源控制板对接到软件项目中
查看 >>
高端会所包间设备管理:怎样把8 路包间场景联动控制器接入到项目中
查看 >>
怎样对接8路包间设备控制器以实现包间设备能耗数据分析
查看 >>