CATALOG

芯步的8路控制器提供了开放HTTP接口,可以通过API灵活控制各路输出。针对包间场景,关键是选对设备规格——10A/16A接灯光、排风扇、麻将机,30A那路专门用于空调。以下方案从硬件选型、接口调用到“一键场景”的实现逻辑,给出完整的对接思路。

1. 解决概述

在包间(如棋牌室、茶室、KTV、自习室)场景中,往往存在多种功率的电器:LED灯带(小功率)、排气扇、麻将机(中功率)、2匹及以上空调(大功率)。传统的人工逐一手动开启不仅效率低,还容易因忘记关空调造成巨大的能源浪费。

利用芯步多规格输出控制器,结合其开放的HTTP API,可以将所有设备集成到同一个管理后台或小程序中。核心思路是:将大功率空调接在30A专用端口,灯光等小功率接在10A/16A端口,通过后台接口聚合调用,实现 “一键场景” (如一键开台、一键清空)。

2. 硬件选型与线路规划

根据搜索结果,针对混合负载场景,推荐使用 “智能包间控制器|Max” 。这款设备专为服务型门店包间设计,针对不同功率需求提供了差异化的接口

推荐硬件:智能包间控制器|Max

  • 供电方式:DC 5V2A(直流低压,安全稳定)。

  • 网络连接:WiFi 2.4GHz(直连路由器,无需网关)。

  • 核心优势:无需网关,只要有WiFi即可远程控制,支持局域网和公网两种模式。

具体接线方案(以一个标准包间为例):

控制器端口规格类型对接设备说明
第1-3路10A (阻性2200W/感性350W)射灯、灯带、排气扇、吸烟灯适用于阻性照明设备或小型感性电机,适合频繁开关的灯光设备。
第4-6路16A (阻性3500W/感性500W)麻将机、饮水机、茶艺炉、普通插座16A接口兼容常规10A插头,承载能力更强,适合加热类或电机类设备。
第8路30A (MAX 6600W)挂机/柜机空调市面上唯一的30A大功率继电器,可直接控制2匹甚至3匹空调,无需额外加装交流接触器。
第7路10A (门禁专用)电磁锁/电插锁配合门磁实现包间门禁控制,实现“通电开锁/断电闭锁”的逻辑。

3. 对接开发核心流程

芯步的开放接口基于HTTP协议,支持JSON格式,可以很方便地集成到现有的SaaS系统或小程序中

3.1 接口鉴权(签名计算)

所有API请求都需要携带签名以保证安全性。签名算法如下(通用伪代码):

3.2 核心控制命令

该控制器通过标准的HTTP POST请求下发指令,主要通过 order 参数中的 powerX 字段来控制对应路的通断。

  • 控制单路:仅开启第1路灯光。

  • 控制多路:同时操作多个继电器,实现一键场景。

4. 实现“一键开启包间”逻辑

这通常是用户扫码下单或前台点击“开台”时触发的动作。在此场景下,我们需要同时打开灯光、插座和空调,并将空调设置为预设模式(若需设置温度,通常需配合红外遥控或用空调伴侣,该控制器主要负责供电)。

步骤一:设备上电与联网

将控制器安装进弱电箱或挂墙,通电后,通过芯步后台或配网工具将设备连接到店铺的2.4G WiFi网络

步骤二:接口调用示例(一键全部开启)

当用户进入包间或前台点击“启用包间”时,后台向API发送以下请求:

  • 接口地址https://api.thingboot.com/{AppId}/device/control/

  • 请求方法:POST

  • 请求体 (JSON)我们需要一次性让所有设备恢复供电(1-6路插座照明全开,8路空调全开)。因为第8路是30A大功率,请一定要确保空调处于可待机状态。

    *注:上述命令假设您使用的是MAX 8路版本,若使用10A/16A通用版本,命令格式相同(power1-power8*

步骤三:接口调用示例(一键结束/清场)

当订单结束或顾客离开,操作员点击“清场”时,调用同样的接口,将所有数值改为 0,即可切断所有电源,防止浪费。

5. 高级技巧:使用批量控制命令

对于8路控制器,如果逐条发送 power1power8 会占用较多网络开销。根据芯步的协议文档,使用 batch 批量命令

批量控制示例:假设你想开启1、3、5路,关闭其他路。

  • 1(第1路 开)

  • 0(第2路 关)

  • 1(第3路 开)

  • 0(第4路 关)

  • 1(第5路 开)

  • 0(第6路 关)

  • 0(第7路 关)

  • 0(第8路 关)这种方式效率更高,非常适合预设情景模式(如“营业模式”、“消杀模式”、“待客模式”)。

6. 注意事项(避坑指南)

  1. 关于30A空调负载:虽然控制器支持30A,但在软件逻辑上增加延时启动。特别是在夏季,断电后立刻重启空调压缩机会导致无法制冷甚至损坏空调。清场后如果要再次开台,中间预留3-5分钟缓冲,或者不要切断空调的电源(即不控制第8路,仅控制灯光)。

  2. 局域网控制:如果门店网络不稳定或对响应速度要求比较高,可以开启控制器的局域网API模式。芯步设备支持局域网发现和控制,可以不经过云端直接在本地服务器发送指令

  3. 混合负载:10A和16A版本在硬件接口(插座形态)上可能不同。16A的插座孔位间距更大,如果接普通10A插头需要转接头或直接剪线接线,提前规划好布线

通过以上方案,你可以快速将芯步的硬件集成到业务系统中,实现真正的无人值守或少人值守的智能化包间管理。

控制器产品方案:
怎样接入4路智能直流开关以实现多设备联动控制
查看 >>
怎么在轰趴馆多功能包间控制中对接智能硬件来实现空调电源控制
查看 >>
怎样接入8路防水防尘控制箱来实现远程控制8路线路
查看 >>
线下服务门店包间管理:如何将8路包间综合管理控制器接入到项目中
查看 >>
怎样在店铺照明设备控制中集成智能设备以实现4路独立线路控制
查看 >>
灯光场景方案:
派对聚会灯光秀控制:怎么把网红奶茶店灯光装饰中对接到自己的项目中
查看 >>
共享台球室三路灯光空调控制:如何将86型3路翘板开关接入到软件项目中
查看 >>
如何在共享棋牌室灯光设备控制中对接智能硬件以实现电流超限保护控制
查看 >>
共享健身房灯光控制:如何将3路2灯1控复合开关对接到项目中
查看 >>
怎么在LED 灯光系统直流控制中接入智能硬件以实现远程批量控制
查看 >>
开启用途方案:
怎样在共享办公独立包间场景中接入智能设备来实现包间灯光空调一键开启
查看 >>
如何对接智能8路包间控制器Max以实现包间灯光空调一键开启
查看 >>
怎么二次开发4路包间智能远程控制器MINI来实现包间灯光设备一键开启
查看 >>
怎样在私人 K 歌房包间控制中集成智能设备来实现包间灯光空调一键开启
查看 >>
如何接入4路包间设备控制器MINI以实现包间灯光设备一键开启
查看 >>