CATALOG

共享棋牌室现在很火,但要实现真正的无人值守,电控是关键。你提到的“60A带计量智能断路器”正好适合这种高功率场景(一台空调或麻将桌怎么都够了),而且还能看电量,防止跑电。

下面这份方案会讲得稍微口语化一点,一步步教你如何通过芯步的开放接口,把这台“硬核”硬件无缝接到你的小程序或管理后台里。

一、 为什么选这个“大家伙”?

在开始写代码之前,我们先确认一下场景。共享棋牌室最大的痛点是啥?大功率电器多(空调、麻将机、饮水机),而且怕偷电

普通的智能插座扛不住 60A 的三相电,所以我们必须用这种“智能断路器”。我们需要它做三件事:

  1. 远程通断:用户下单后自动合闸通电,时间到了自动拉闸断电。

  2. 电能计量:看看这个包厢今天到底用了多少度电,是赚是赔。

  3. 功率保护:如果有人在里面用超大功率的违规电器(比如带了个工业暖风机),自动跳闸保护。

芯步这款设备的接口是完全开放的,对接思路跟控制一个灯泡差不多,只是指令里的参数变成了“合闸”和“读取电量”。

二、 准备工作:让设备“上网”

在写代码之前,我们得先让断路器连上云平台。这一步通常不用写代码,在芯步的后台配置就行。

  1. 注册与创建:在芯步官网注册开发者账号,创建一个“工作台”(可以理解成你的项目空间)。

  2. 配网:这个设备一般是支持 Wi-Fi4G 的。

    • 如果是 Wi-Fi 版:用“芯步”小程序,输入棋牌室现场的 Wi-Fi 密码(注意必须是 2.4G 频段),让设备听到网络信号。

    • 如果是 4G 版:插卡即用,信号更稳,但稍微贵一点。我推荐共享棋牌室用 4G 版,省得客户路由器死机连不上。

  3. 获取关键凭证

    • 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”了。

四、 实战场景:共享棋牌室全流程

我们捋一下整个业务流程,看看这套接口是怎么跑起来的:

  1. 用户下单

    • 用户小程序付款 -> 你的后端收到支付回调 -> 你调用控制接口,发送 {"power":1} 给断路器 -> 包厢通电。

  2. 使用中

    • 断路器定时上报电压电流 -> 你的后端监测功率。

    • 逻辑判断:如果电流超过设定阈值(比如60A满负荷跑了5分钟),你可以主动发送 {"power":0} 断电,并推送消息“老板,有人闹事/违规用电”。

  3. 订单结束

    • 时间到 -> 后端自动调用{"power":0} -> 包厢断电。

    • 顺便调用一下查询接口,拉取本次时长内的用电量,算一下电费成本。

五、 稍微进阶一点的玩法(避坑指南)

1. 关于“急停按钮”的物理逻辑

共享棋牌室虽然无人,但必须有物理急停按钮。这个按钮不是直接切断 60A 高压电(那太危险了),而是连接一个弱电信号给服务器。

  • 逻辑:按按钮 -> 服务器收到消息 -> 服务器调用接口断开断路器。

  • 好处:如果有人走了但忘了关空调,你可以在后台一键全部门店断电。

2. 局域网控制(可选)

如果你的棋牌室生意好到爆,担心断网(没外网),芯步的设备支持 局域网 API

  • 买个工控机或者树莓派放在店里。

  • 调用内网 IP 地址的接口。

  • 优点:0延迟,不受外网波动影响。

3. 计量清零

注意:60A 断路器一般都是总闸,计量的是总度数。当新客人进场时,你可能需要记录当前的“码表底数”,而不是清零电表。通过 end_energy - start_energy 算出本次消耗。

六、 总结

把芯步的 60A 带计量断路器接入软件项目,其实就是在做 “发指令”“收数据” 这两件事。

一句话总结给老板听

这玩意儿就像你手机里的遥控器 APP,只不过我们通过写几行代码,让服务器在你客人付款成功后,自动按一下那个“通电”按钮,还能自动抄一下电表告诉你用了多少电。

芯步的 HTTP 接口文档写得很清晰,只要后端工程师看一眼那个 device/control 接口,十分钟就能把电通起来。剩下的时间,可以让他们专心优化一下小程序界面和订单系统了。