CATALOG

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 )步骤说明:

    1. AppSecret 进行第一次MD5加密,得到字符串 S1

    2. 获取当前Unix时间戳(秒级) ts

    3. 拼接字符串 S1 + ts

    4. 对拼接后的字符串进行第二次MD5加密,得到最终的 Sign

  • 请求地址POST https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}

3. 业务逻辑对接实现

为了实现对第1路(照明)和第2路(换气扇)的控制,开发者需要编写HTTP请求。

JSON请求体示例:

核心命令对照表(针对4路Mini控制器):

功能描述命令字段 (Order)参数值业务场景
开启照明power11客人进入包间,自动亮灯
关闭照明power10客人离开/退单,自动关灯
开启换气扇power21检测到烟雾或定时通风
关闭换气扇power20离开房间或关闭通风
全开/总清power10一键启用/禁用包间所有设备
暂停/复位pointreset详见下文用于设备临时断电重启

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. 实施注意事项

  1. 感性负载限制:换气扇属于电机类设备(感性负载)。虽然第2路支持最高500W感性负载,但在连接多台风扇时计算总功率,避免瞬间电流击穿继电器

  2. WiFi稳定性:由于Mini版仅支持2.4G,若现场环境2.4G干扰严重(如商场内),将设备“第1路照明”和“第2路换气扇”设置为静态DHCP分配,确保IP不漂移,降低控制延迟。

  3. 调试模式:在开发测试阶段,可以在控制台开启“调试模式”,此时系统会暂时忽略Sign签名校验,方便开发者优先验证业务逻辑流程

通过以上步骤,可以基于芯步标准HTTP接口配合Mini控制器的4路端口,实现照明与换气扇的接入。

控制器产品方案:
怎么在快递柜设备控制中集成智能硬件来实现远程控制16路线路
查看 >>
怎样在店铺照明设备控制中集成智能设备以实现4路独立线路控制
查看 >>
怎样对接智能直流控制器4路以实现联动场景逻辑控制
查看 >>
怎么接入智能 24 路远程开关控制模块以实现自定义场景联动控制
查看 >>
高端会所包间设备管理:怎样把8 路包间场景联动控制器接入到项目中
查看 >>
照明场景方案:
展厅展品重点照明:如何将家居氛围灯光驱动模块接入到软件项目中
查看 >>
便利店照明管理:怎么把3路智能墙壁触摸远程控制开关集成到自己的项目中
查看 >>
小型商铺照明管理:怎么将智能墙壁开关1路集成到自己的项目中
查看 >>
共享茶室照明插座控制:如何把6600W 线路控制器对接到软件项目中
查看 >>
怎么对接WiFi触摸墙壁开关以实现单路照明或门禁控制
查看 >>
换气扇用途方案:
如何接入4路包间智能开关控制器MINI来实现照明换气扇电源控制
查看 >>
怎样二次开发麻将机/空调/门禁一体控制器来实现照明换气扇电源控制
查看 >>
怎么二次开发8 路包间设备控制模块来实现照明换气扇电源控制
查看 >>
怎样对接智能包间电源控制迷你版以实现照明换气扇电源控制
查看 >>
怎么对接8路10A/16A/30A多规格输出控制器来实现照明换气扇电源控制
查看 >>