针对芯步的4路电源控制器MINI,接入方式其实非常简单——它走的是标准HTTP接口,说白了就是给你的服务器发一个网络请求的事儿。无论你的后端是用Java、Python、PHP还是Go写的,甚至前端想直接调(不推荐,容易暴露密钥),都能轻松搞定。
下面我把整个接入过程拆解成“三步走”,并专门针对共享台球室的使用场景(用户下单通电、计时结束断电、老板远程控制)来说明。
第一步:搞清楚你的硬件“长什么样”(物理接线)
在写代码之前,咱们得先把包间里的线路理清楚。这款MINI控制器虽然体积小,但功能很强,有4路继电器
第1路(16A):接照明或换气扇。客人进来灯要亮,走了灯要灭。
第2路(16A):接麻将机或饮水机。台球室里主要供电给打球设备或休息区插座。
第3路(10A):专门用来接门禁电磁锁。这一路有个很实用的功能,配合门磁感应,可以实现“通电开锁/断电闭锁”或者反过来,看你的锁是断电开还是断电关。
第4路(30A):这一路电流最大,专门留给2匹左右的空调。
一点小:在布线的时候,尽量把总闸和这个控制器放在包间角落的弱电箱里。这样看起来整洁,也不怕客人误触。
第二步:理解“对话”的方式(API接口逻辑)
设备通上电、连上WiFi之后,你的软件要怎么告诉它“把灯打开”呢?芯步的开放接口用的是标准的HTTP协议,说白了就是调用一个网址。无论你是做微信小程序、iOS APP还是网页管理后台,调用的方式都一样。
基本请求格式如下(虽然是口语化解释,但结构是确定的):
地址
http(s)://你的域名或IP/api/device/control/参数
AppID:你的应用ID,就像用户名。
sign:签名,为了防止别人乱刷你的接口,把参数按规则加密一下。
ts:时间戳,防止网络攻击的。
Device:这个控制器的唯一ID(贴在盒子上的那个字符串)。
Order:具体指令,比如让第2路通电。
举个例子,我想把台球室的灯(第1路)打开:你的代码其实就是发了个POST请求,body里面塞了类似这样的数据:
如果你是开发者,也可以跟芯步要一份完整的API文档,里面会用表格列清楚各种指令:
{"power1":"1"}:单独打开第1路。{"power2":"0"}:单独关闭第2路。{"power4":"1"}:打开空调(空调需要先通电,遥控器是另外调温度)。{"reset":{"relay":[1,2,3,4],"interval":1000}}:这是一个高级功能,让所有回路先断后通,间隔1秒。这在台球室有啥用?比如电锁,有时候开门需要先断电再通电来复位。
网络模式选择芯步的设备支持局域网和互联网两种模式。我个人如果你门店有固定的公网IP或者用了内网穿透,优先用局域网。这样哪怕外网断了,你店里的局域网还是能控制包间断电,避免客人走了关不了灯的尴尬。
第三步:融入台球室业务流程(实战代码思路)
光会调用接口没用,你得把它写到你的系统里。
假设你的共享台球室系统是基于微信小程序的,业务流程一般是这样的:
1. 用户下单成功 -> 自动通电
当用户在小程序里支付了“19:00 - 20:00”时段的包间费,服务器后端收到支付回调,这时候做两件事:
把包间状态改为“已使用”。
调用硬件接口:服务器向该包间的控制器发送指令:
order: {"power1":"1", "power2":"1", "power4":"1"}(开灯、开台球设备、开空调)。如果是电子锁,可以顺便发一个指令把门打开(让客人进去)。
2. 使用过程中 -> 小度/语音/手动
客人进去后,如果觉得冷,想调低空调温度(空调温度调不了,只能断电),或者想关灯睡觉(开玩笑),他可以在小程序里点一下“关灯”。
小程序前端:带上设备ID和指令,调一下接口就行。
老板远程:如果老板在吧台,发现某个包间超时了,直接在后台管理系统点“断电”,也是调同一个接口,只是指令变成了
{"power1":"0"}。
3. 订单结束前提醒 -> 语音播报(TTS版本特有)
如果你买的是TTS版本(带语音播报),这玩意儿简直是为共享台球室量身定做的。当订单还剩5分钟时,你的服务器可以调用TTS播报接口,让那个白色的盒子发出发出声音:“您本次的消费时间即将结束,如需续费请扫码”。
4. 订单超时未续费 -> 强制断电
这是一个关键逻辑。你的系统需要跑一个定时任务(比如每隔1分钟扫描一次)。伪代码逻辑:
避坑指南和需要注意的点
在落地这个方案时,有几个坑你必须提前知道:
空调控制的问题MINI控制器只能控制空调的通断电,不能控制模式(制冷制热)和温度。你需要把空调的物理开关打开,通电即运行。这种适合定频空调。如果是那种断电后需要手动按一下开关的空调,客人进去发现没冷气,体验会很差。
门锁的接法(第3路)
如果是电插锁(断电开/通电关),你的控制器逻辑要写反。比如客人下单,给第3路通电(关门);订单结束,给第3路断电(开门)。一定要现场测试清楚。
安全第一:系统里必须设计一个紧急开门按钮,别依赖API。
接口签名(sign)千万不要在前端(小程序、H5)硬编码你的AppID和签名密钥!一定要走后端。让前端调用你自己的服务器接口,你的服务器再去调芯步的接口。否则别人扒了你的小程序代码,拿到密钥,就可以随意控制你的全部包间。
设备配网首次使用需要让设备连上WiFi。芯步一般支持“一键配网”或“AP配网”。在包间装修的时候,保证WiFi信号覆盖好(2.4G频段),这个设备不支持5G WiFi,这点要切记。
总结一下这个方案的优势
用芯步这款MINI控制器接入共享台球室,最爽的一点就是零开发成本打通硬件。它不限制你用什么语言,只要你会发HTTP请求就行。这样一来,你只需要专注于开发你的台球室营销功能(比如团购券核销、会员储值),剩下的硬件控制逻辑,几个API就能搞定。