CATALOG

共享台球室的痛点是电路安全与运营效率——跳闸后若不能及时恢复,顾客流失、订单纠纷接踵而至。25A智能空开通过芯步的开放接口,能将传统空开升级为“可远程复位、可实时监控”的智能节点。以下是完整的接入方案:

1. 背景与需求分析

1.1 共享台球室的电路痛点在无人值守的共享台球室场景中,电路安全和用电管理是运营的基石。传统的空气开关虽然具备过载和短路保护功能,但在共享模式下存在明显短板:当某台球桌发生跳闸时,运营方必须派人到现场手动合闸,这不仅影响用户体验(用户可能正在打球),还增加了运维成本。

1.2 25A智能空开的选型理由选择25A规格是基于台球室的典型负载:一台台球桌的照明灯光约40-100W,加上休息区的空调(约2000-3500W)和饮水机,单路负载通常不会超过20A。25A智能空开留有余量,既能保障安全又可防止频繁跳闸。

1.3 集成目标

  • 实现远程分合闸控制,用户遇到跳闸可自助恢复(或系统自动恢复)

  • 实时监测电流、电压、功率等电参数,预判过载风险

  • 将智能空开嵌入现有的共享台球室小程序/管理后台

  • 建立用电安全告警机制,及时推送异常通知

2. 芯步开放接口概述

芯步为智能空开/断路器提供了标准的HTTP API接口,支持云端API和本地局域网两种调用方式。对于共享台球室场景,采用云端API模式,便于集中管理分布在不同地点的多家门店。

2.1 核心接口能力

  • 设备控制:单路/多路通断控制、先通后断(脉冲)、先断后通(复位)

  • 状态查询:实时获取设备开关状态、电流、电压、功率、电能计量数据

  • 批量控制:一次性对多个设备下发命令

  • 定时任务:通过平台设置定时开关策略(如营业时间自动通电)

2.2 接口调用基础信息

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • 请求方式:POST

  • 数据格式:JSON

  • 认证机制:签名认证(AppID + 动态Sign)

3. 接入准备工作

3.1 硬件准备

  • 芯步25A智能空开(需确认支持HTTP API控制)

  • 2.4GHz Wi-Fi网络环境(设备配网必需)

  • 标准35mm DIN导轨安装件

3.2 平台账号与凭证

  1. 注册芯步账号:访问 account.thingboot.com

  2. 创建工作台(Workbench):在 my.thingboot.com 创建

  3. 进入物联网控制台模块

  4. 在“开发设置”中获取:

    • AppID:开发者标识

    • AppSecret:开发者密钥(需妥善保管)

    • 在调试阶段开启“调试模式”(临时跳过签名校验)

3.3 设备配网

  1. 将智能空开接入电源,长按配网按键直至指示灯快闪

  2. 在物联网控制台的“网络配置”中登记现场WiFi(SSID和密码)

  3. 通过手机热点方式将设备配网(或使用“芯步”小程序)

  4. 配网成功后,在控制台的“设备列表”中获取设备ID(Device ID)

4. 接口对接技术实现

4.1 签名算法(Sign)

这是对接中最关键的部分。芯步采用双重MD5加密+时间戳的方式防重放攻击

签名计算步骤:

  1. 将AppSecret进行MD5加密:secret_md5 = md5(AppSecret)

  2. 拼接时间戳(秒级):sign_str = secret_md5 + ts

  3. 再次MD5得到最终签名:sign = md5(sign_str)

代码示例

4.2 远程控制空开(分合闸)

第一种场景:单路控制(合闸/通电)当用户扫码开台时,系统自动合闸通电。

第二种场景:批量控制(结束清场)用户超时结束订单后,关闭对应台球桌的所有设备。

4.3 高级控制指令(适用于特殊场景)

脉冲控制(先通后断)适用于临时通电测试或门禁控制场景。

先断后通(复位)适用于设备死机后强制断电重启。

状态保持(防误触)用于重要设备,防止用户通过物理按键误操作。

上述命令格式详见芯步产品手册

4.4 状态查询与数据采集

共享台球室需要实时监控电流、功率以判断设备是否正常运行(如灯光损坏、空调异常)。

查询设备状态芯步提供设备状态查询接口,可获取:

数据项说明用途
开关状态当前分合闸状态确认设备是否通电
电流实时电流(A)判断是否过载
电压实时电压(V)电压异常告警
功率实时功率(W)能耗统计
电能累计用电量(kWh)计费参考(如按电量分摊电费)

该接口调用方式与下发命令类似,实际使用时可参考设备对应的产品手册

5. 共享台球室业务场景集成

将上述接口能力与业务逻辑结合,可构建完整的智能用电管理体系。

5.1 订单联动机制

  • 用户下单/开台:调用控制接口合闸,台球桌照明和插座通电

  • 临场提醒(剩余15分钟):闪烁灯光提示(可发送脉冲控制指令触发空开快速通断一次)

  • 超时断电:订单结束后自动分闸,切断电源防止能耗浪费

  • 异常断电恢复:检测到非正常断电时,系统提示用户确认后远程合闸,避免现场处理

5.2 安全保护策略

  • 过载预保护:设定功率阈值,当实时功率超过2500W时推送告警,30秒后仍超限则自动分闸

  • 漏电自检:利用智能空开的漏电自检功能,每月自动执行一次并上报结果

  • 定时开关:设置营业时间策略(如凌晨2点强制关闭全场电源)

5.3 管理后台功能开发开发以下模块:

  • 设备地图:展示各门店设备在线状态

  • 用电报表:按日/月统计能耗,分析单桌成本

  • 告警记录:历史故障与保护动作日志

  • 远程调试:支持维护人员远程分合闸测试

6. 部署注意事项

6.1 网络稳定性智能空开依赖Wi-Fi,需确保台球室内2.4G信号覆盖良好,每200㎡部署一个AP。若Wi-Fi中断,设备仍保持本地保护功能(过载跳闸),但远程控制暂时失效

6.2 安全机制

  • 所有API调用必须走HTTPS,AppSecret严禁硬编码在前端

  • 生产环境请一定要关闭“调试模式”,开启签名校验和IP白名单

  • 物理应急机制:在配电箱保留总闸,供紧急情况手动切断

6.3 控制优先级与防误操作可通过设置控制等级(本地+远程可控 / 仅远程可控)避免用户随意触碰物理按键导致断电纠纷。设置为“仅远程可控”,物理按键仅用于应急。

7. 总结

将芯步25A智能空开接入共享台球室项目,主要涉及三个层次的工作:

  1. 设备层:完成配网,获取设备ID

  2. 接口层:实现签名算法,封装控制与查询函数

  3. 业务层:将控制指令与订单状态机绑定,构建安全监控体系

通过上述方案,共享台球室不仅能实现基本的远程分合闸,还能建立智能化的用电安全管理能力——在提升用户体验(自助恢复供电)的同时降低运营成本(减少现场处理),是无人化场景必需的基础设施改造。