CATALOG

芯步60A断路器提供标准HTTP API接口,支持公网与局域网两种接入模式,通常可在10-15分钟内完成基础对接。以下方案涵盖设计、接口调用流程及典型代码示例。

解决方案:基于芯步60A断路器的门店电路远程集控系统

1. 背景与选型

在门店管理中,空调、照明、厨房设备、招牌灯箱等大功率线路(通常电流需求在60A以内)的能源浪费和安全隐患是痛点。传统断路器无法远程复位或定时控制。

设备选型: 采用芯步 智能大功率断路器[计量版] (型号:UNI-DLQ-M-60A-P)。

  • 核心优势:支持60A大电流,直接替代传统总闸;无需网关,直连Wi-Fi 2.4G;提供开放HTTP接口,支持私有化部署

2. 设计

我们将采用云云对接局域网直连两种模式。鉴于门店网络环境复杂,推荐混合架构:

  • 设备层:60A断路器替换原有总闸或分路开关,采集电压、电流、功率及开关状态。

  • 网络层:设备连接门店2.4G Wi-Fi(支持设置5组备用Wi-Fi,断网重连能力强)

  • 业务集成层

    • 公网模式:你的业务服务器通过调用芯步云端API,经云服务器下发指令至设备(适用于连锁门店集中管理)。

    • 局域网模式:业务服务器在门店本地直接调用断路器的本地IP进行控制(延迟更低,断外网仍可控制,需设备支持局域网SDK)。

特性公网控制模式局域网控制
路由路径App/Server → 芯步云 → 门店Wi-Fi → 设备App/Server → 本地服务器 → 门店Wi-Fi → 设备
延迟约80-120ms<10ms(内网传输)
依赖需门店外网通畅需内网网络通畅,可断开外网
适用场景连锁总部集中管理、移动办公店内本地自动化联动(如传感器触发断电)

3. 对接关键流程

芯步的接口采用 HTTP POST 请求,数据格式为JSON,签名算法为双重MD5。

第一步:获取凭证在芯步控制台获取 AppIDAppSecret,并将断路器绑定至账号下,获取唯一的 device ID(例如:820720)。

第二步:签名计算(核心安全机制)所有API请求需携带 signts(时间戳)。

  • 算法sign = md5( md5(AppSecret) + ts )

  • 示例

    • 假设 AppSecret = “abc123”

    • md5(AppSecret) = “e99a18c428cb38d5f22e03”

    • 拼接时间戳 ts = “” -> “e99a18c428cb38d5f22e03”

    • 再次MD5得到最终 sign

第三步:下发控制指令

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求体 (JSON)

  • 定时任务:若需“1小时后断开”,可在 order 中加入 "reset": 3600000(单位毫秒)

第四步:状态同步与回调

  • 主动查询:调用设备状态查询接口获取实时电参量(电压、功率)。

  • 被动接收:配置消息推送。当设备状态变化(如跳闸、电压异常)时,芯步云会主动推送数据到你的服务器地址。

4. 代码实现示例

以下是一个简单的 Python 脚本,演示如何封装API以控制断路器通断。

5. 高级功能集成:计量与告警

此断路器不仅是一个开关,还是一个智能电表。你可以利用其计量版的特性,开发以下增值功能:

  • 能耗看板:定期读取设备接口返回的 kwh(累计电量)和 power(实时功率),在门店管理后台生成实时用电报表。

  • 过载预保护:在软件层设定阈值。例如若检测到 power > 6000W 持续10秒,自动触发 {"power": 0} 指令断电,并推送“门店大功率设备未关”告警给店长。

  • 联动控制:通过 webhook 连接门禁系统。下班打卡后,自动触发关断所有“非24小时设备”的断路器,并在早上上班前10分钟自动合闸通电。

6. 部署和需要注意的点

  1. Wi-Fi信号覆盖:60A断路器通常安装在配电箱内,金属箱体会屏蔽信号。在安装时测试信号强度(RSSI),若信号弱需加装信号放大器

  2. 私有化部署:若数据安全要求比较高(如金融门店),可向芯步申请私有化部署方案,将API服务部署在你的内网服务器中,所有数据不经过外网

  3. 电工资质:安装涉及强电接线(输入/输出端),必须由持证电工操作,确保接线牢固以防因接触不良导致高温。

总结

通过上述方案,你可以在 15分钟内 跑通第一个控制指令。利用芯步开放的双重MD5签名接口和灵活的 HTTP 指令,开发者无需关心底层无线通讯协议,只需关注业务逻辑(定时、能耗分析、连锁调度),即可快速将门店的传统电气设备升级为智慧物联系统。