芯步的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路控制器,如果逐条发送 power1 到 power8 会占用较多网络开销。根据芯步的协议文档,使用 batch 批量命令。
批量控制示例:假设你想开启1、3、5路,关闭其他路。
1(第1路 开)0(第2路 关)1(第3路 开)0(第4路 关)1(第5路 开)0(第6路 关)0(第7路 关)0(第8路 关)这种方式效率更高,非常适合预设情景模式(如“营业模式”、“消杀模式”、“待客模式”)。
6. 注意事项(避坑指南)
关于30A空调负载:虽然控制器支持30A,但在软件逻辑上增加延时启动。特别是在夏季,断电后立刻重启空调压缩机会导致无法制冷甚至损坏空调。清场后如果要再次开台,中间预留3-5分钟缓冲,或者不要切断空调的电源(即不控制第8路,仅控制灯光)。
局域网控制:如果门店网络不稳定或对响应速度要求比较高,可以开启控制器的局域网API模式。芯步设备支持局域网发现和控制,可以不经过云端直接在本地服务器发送指令。
混合负载:10A和16A版本在硬件接口(插座形态)上可能不同。16A的插座孔位间距更大,如果接普通10A插头需要转接头或直接剪线接线,提前规划好布线。
通过以上方案,你可以快速将芯步的硬件集成到业务系统中,实现真正的无人值守或少人值守的智能化包间管理。