共享棋牌室现在很火,但要实现真正的无人值守,电控是关键。你提到的“60A带计量智能断路器”正好适合这种高功率场景(一台空调或麻将桌怎么都够了),而且还能看电量,防止跑电。
下面这份方案会讲得稍微口语化一点,一步步教你如何通过芯步的开放接口,把这台“硬核”硬件无缝接到你的小程序或管理后台里。
一、 为什么选这个“大家伙”?
在开始写代码之前,我们先确认一下场景。共享棋牌室最大的痛点是啥?大功率电器多(空调、麻将机、饮水机),而且怕偷电。
普通的智能插座扛不住 60A 的三相电,所以我们必须用这种“智能断路器”。我们需要它做三件事:
远程通断:用户下单后自动合闸通电,时间到了自动拉闸断电。
电能计量:看看这个包厢今天到底用了多少度电,是赚是赔。
功率保护:如果有人在里面用超大功率的违规电器(比如带了个工业暖风机),自动跳闸保护。
芯步这款设备的接口是完全开放的,对接思路跟控制一个灯泡差不多,只是指令里的参数变成了“合闸”和“读取电量”。
二、 准备工作:让设备“上网”
在写代码之前,我们得先让断路器连上云平台。这一步通常不用写代码,在芯步的后台配置就行。
注册与创建:在芯步官网注册开发者账号,创建一个“工作台”(可以理解成你的项目空间)。
配网:这个设备一般是支持 Wi-Fi 或 4G 的。
如果是 Wi-Fi 版:用“芯步”小程序,输入棋牌室现场的 Wi-Fi 密码(注意必须是 2.4G 频段),让设备听到网络信号。
如果是 4G 版:插卡即用,信号更稳,但稍微贵一点。我推荐共享棋牌室用 4G 版,省得客户路由器死机连不上。
获取关键凭证
AppID:你的应用唯一标识。
AppSecret:你的接口密钥(打死不能放前端,必须放后端服务器)。
Device ID:这台断路器的身份证号(一般在设备外壳上写着)。
三、 核心对接逻辑:服务器怎么“拧”开关?
这是最关键的一步。我们要把“用户点击开始计时”这个动作,翻译成“断路器合闸”的指令。
1. 签名计算(Sign)
芯步的接口为了安全,要求签名认证。公式大概是:sign = md5( md5(AppSecret) + ts )。简单来说:就是把你的密钥加密一下,再拼接上当前时间戳,再加密一次。后端写个函数搞定就行。
2. 下发合闸命令(给电)
场景:用户小程序支付成功,系统需要给房间通电。接口地址http(s)://api.thingboot.com/{AppId}/device/control/请求方式:POST数据包内容
返回结果:如果返回 {"code":200},代表指令下发成功,你的继电器会“哒”的一声吸合,包厢来电!
3. 读取实时电量(计量)
场景:管理员后台想看实时功率,或者担心设备忘关。思路:芯步除了主动控制,还支持设备状态推送。你可以配置一个回调地址(Webhook)。数据样子(大概举例):当断路器状态变化或定时上报时,芯步云会主动给你的服务器发一个POST请求,里面带着:
你收到这个数据存到数据库里,用户就能在小程序上看到“实时功率 2800W”了。
四、 实战场景:共享棋牌室全流程
我们捋一下整个业务流程,看看这套接口是怎么跑起来的:
用户下单
用户小程序付款 -> 你的后端收到支付回调 -> 你调用控制接口,发送
{"power":1}给断路器 -> 包厢通电。
使用中
断路器定时上报电压电流 -> 你的后端监测功率。
逻辑判断:如果电流超过设定阈值(比如60A满负荷跑了5分钟),你可以主动发送
{"power":0}断电,并推送消息“老板,有人闹事/违规用电”。
订单结束
时间到 -> 后端自动调用
{"power":0}-> 包厢断电。顺便调用一下查询接口,拉取本次时长内的用电量,算一下电费成本。
五、 稍微进阶一点的玩法(避坑指南)
1. 关于“急停按钮”的物理逻辑
共享棋牌室虽然无人,但必须有物理急停按钮。这个按钮不是直接切断 60A 高压电(那太危险了),而是连接一个弱电信号给服务器。
逻辑:按按钮 -> 服务器收到消息 -> 服务器调用接口断开断路器。
好处:如果有人走了但忘了关空调,你可以在后台一键全部门店断电。
2. 局域网控制(可选)
如果你的棋牌室生意好到爆,担心断网(没外网),芯步的设备支持 局域网 API。
买个工控机或者树莓派放在店里。
调用内网 IP 地址的接口。
优点:0延迟,不受外网波动影响。
3. 计量清零
注意:60A 断路器一般都是总闸,计量的是总度数。当新客人进场时,你可能需要记录当前的“码表底数”,而不是清零电表。通过 end_energy - start_energy 算出本次消耗。
六、 总结
把芯步的 60A 带计量断路器接入软件项目,其实就是在做 “发指令”和 “收数据” 这两件事。
一句话总结给老板听
这玩意儿就像你手机里的遥控器 APP,只不过我们通过写几行代码,让服务器在你客人付款成功后,自动按一下那个“通电”按钮,还能自动抄一下电表告诉你用了多少电。
芯步的 HTTP 接口文档写得很清晰,只要后端工程师看一眼那个 device/control 接口,十分钟就能把电通起来。剩下的时间,可以让他们专心优化一下小程序界面和订单系统了。