CATALOG

共享台球室的痛点是“无人化运营”——用户下单后需自动通电、计时结束后自动断电,同时要防止非授权时段偷电。芯步的5位智能PDU(UNI-PDU-ZK-5)正好解决这个问题:它提供HTTP开放接口,可通过服务器远程控制每个插座位的通断。以下方案涵盖硬件选型、接口对接逻辑、计费联动及异常处理机制。

1. 背景与需求分析

在共享台球室的无人值守运营场景中,设备机柜内通常放置着台球桌的照明系统、计时计费显示屏、网关路由器等关键设备。运营商面临的核心挑战是:如何确保用户仅在使用时段内获得电源,并在结束后自动切断,以防止资源浪费和偷电行为?

本项目采用的硬件核心是 芯步 5位智能PDU(产品型号:UNI-PDU-ZK-5) 。该设备具备5个独立控制的插座孔位,支持通过WiFi联网,并开放标准的HTTP API接口,允许服务器直接下发指令控制每个孔位的通断

2. 硬件选型与拓扑架构

2.1 核心设备参数

  • 控制路数:5位独立控制(支持单控或全控)。

  • 负载能力:单孔位额定功率1500W,总额定功率3000W,完全满足台球厅照明和电视/显示器的功耗需求。

  • 通信方式:WiFi 2.4GHz(无需额外网关,直接连接门店路由器)。

  • 开放特性:支持私有化部署和公网SaaS模式,API响应极快(约80-120ms)

2.2 网络拓扑

系统采用 “云端/本地服务器 — 路由器 — 智能PDU” 的三层架构:

  1. 终端层:智能PDU的插孔1-5分别接入不同的台球桌照明灯或机柜散热设备。

  2. 传输层:利用门店现有的商用宽带/WiFi,PDU通过WiFi直连路由器。

  3. 控制层:部署在云端的业务服务器(或门店本地服务器)通过芯步的开放接口与PDU进行数据交互。

3. 开放接口接入详解

芯步的开放平台基于HTTP协议,这意味着无论你的后端是用Java、Python还是PHP开发,都可以轻松集成

3.1 接口鉴权机制

为了安全性,所有API请求均需携带签名(Sign)。签名生成逻辑如下(参考官方手册):

  1. 准备 AppSecret(从芯步控制台获取)。

  2. 获取当前Unix时间戳(秒级) ts

  3. 计算 sign = md5( md5(AppSecret) + ts )

  4. 请求URL格式:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3.2 核心控制指令

针对 UNI-PDU-ZK-5 型号,主要的JSON指令如下:

功能描述JSON命令格式 (order字段)适用场景
开启插孔1{"power1": 1}用户下单成功,对应台球桌亮灯
关闭插孔1{"power1": 0}订单结束/超时,自动断电
开启全部{"power": 1}营业开始批量上电或紧急维护
重启插孔3{"reset3": 1}设备死锁远程重启(先断后通)
单孔功率查询(通过设备详情接口获取)监测设备是否异常高功耗

4. 业务逻辑接入方案(重点)

为了将PDU无缝融入“共享台球室”的SaaS系统中,采用以下三种策略模式:

4.1 标准计费联动模式

这是最常规的流程,适用于大多数计时收费场景。

  1. 用户下单:用户在微信小程序支付定金或生成订单。

  2. 服务器触发:业务系统记录订单开始,根据订单中的“桌号”映射到对应的“设备ID”和“插孔号”。

  3. 执行开电

  4. 状态监控:服务器需维护一个状态表,防止重复下发指令。

  5. 订单结束:用户点击“结束”或计时达到预设时长 -> 下发 {"power3": 0} -> 断电。

4.2 人感联动与节能策略

结合芯步生态中的智能人体存在雷达传感器,可以进一步节约能耗。

  • 场景:用户中途去洗手间,长时间没人打球,灯光一直亮着浪费电。

  • 逻辑

    1. 服务器开启某插孔后,开始监听该房间的人体传感器数据。

    2. 若传感器上报 {"radar_enable": 0} (无人状态)超过15分钟。

    3. 服务器发送消息提醒给用户:“检测到长时间无人,即将断电,请点击续费...”。

    4. 若5分钟内无响应,执行 {"power3": 0}

4.3 异常断电与自动恢复

共享场景中,若用户未下单但PDU被异常拔出或网络波动后重连,设备行为需定义清楚。

  • 掉电记忆:芯步设备通常支持设置断电恢复后的状态。在控制台配置为:“恢复断电前状态”

  • 逻辑:如果是合法跳闸,恢复后仍是断电状态,安全;如果是网吧整体跳闸恢复,设备会自动恢复供电,无需人工干预

5. 核心代码实现逻辑(伪代码示意)

在后端服务中,你需要封装一个控制核心类。以下为逻辑示意(非完整代码,仅描述逻辑结构):

6. 实施注意事项

  1. 网络信号强度:PDU使用2.4G WiFi,台球室金属机柜可能屏蔽信号。安装时确认信号强度,或在机柜外置天线。

  2. 额定功率限制:单孔位限制1500W。台球厅的LED无影灯功率通常在200-300W,完全没问题。但如果机柜内要接大功率空调或暖气,需分配至不同孔位,且总额定不超过3000W

  3. 手动应急开关:虽然通过API控制,但对接入的业务系统,遇到网络故障时,现场工作人员可通过微信小程序或后台管理端手动触发“强制断电”指令。

  4. 私有化部署:如果对公网依赖性要求极低,或担心断网影响,可利用芯步支持的局域网私有化特性。服务器和PDU在同一局域网下,断外网依然可通过内网API控制

7. 方案总结

将芯步5位智能PDU接入共享台球室项目,本质上是一个 “状态机 + HTTP请求” 的集成过程。该PDU提供的标准化开放接口(Open API)能够快速嵌入现有的小程序与后台管理系统,实现订单系统与物理硬件的实时联动。

通过该方案,不仅可以实现无人值守、自动通断的基础功能,还能结合传感器实现二次节能,有效降低运营电费成本,提升场地管理的智能化水平。