CATALOG

芯步的智能硬件开放接口基于HTTP协议,签名机制清晰,对接门槛较低。针对35A大功率断路器,核心思路是通过设备主动上报的“状态变化事件”来触发故障识别,再结合通知渠道完成告警推送。以下方案涵盖接口对接流程、故障判定逻辑和告警实现方式。

1. 背景与目标

在工业制造、大型充电桩、基站、智慧工厂等场景中,35A大功率断路器承担着电路保护与能耗管理的重任。一旦出现过载、跳闸、缺相或温度异常,若不能及时发现,可能导致生产停滞或火灾隐患。

目标:利用芯步开放接口,将断路器接入现有管理系统(如ERP、钉钉、微信或自研SaaS),实现故障秒级感知与多渠道告警。

2. 技术选型与接口基础

芯步的智能断路器系列(包括35A/40A计量版本)遵循统一的开放接口协议,主要特征如下

  • 协议:HTTP/HTTPS,支持公网或局域网(私有化部署)。

  • 鉴权:动态签名(Sign)机制,保证接口调用安全。

  • 数据交互:指令下发(控制)与消息推送(状态上报)。

  • 兼容性:支持任何具备HTTP请求能力的开发语言(Java, Python, Go, PHP, Node.js等)。

3. 对接流程设计

3.1 准备工作:设备配网与注册

在对接API之前,需确保断路器已联网:

  1. 添加设备:通过芯步控制台或小程序,为断路器配置现场2.4G WiFi(或4G版插卡自动激活)

  2. 获取凭证:从控制台获取 AppIdAppSecret,并记录设备的唯一标识 Device ID

3.2 核心鉴权算法(签名计算)

每次API调用需携带 signts(时间戳)以防止重放攻击。推荐后端通用计算逻辑如下:

4. 故障告警的实现机制

故障告警的实现不能仅靠“定时查询”,必须利用事件驱动机制。芯步平台支持消息推送功能,当断路器状态变化时主动向你的服务器推送数据。

4.1 配置消息接收服务器(Webhook)

在芯步控制台中配置“API回调地址”(如 https://yourdomain.com/api/device/callback)。

  • 触发条件:设备状态变化、数值超限、跳闸事件。

  • 推送内容:设备ID、当前功率、电压、电流、事件类型(如 overloadpower_off)。

4.2 故障判定逻辑(关键点)

35A大功率断路器的故障通常分为以下几类:

故障类型物模型/事件标识触发逻辑
过载预警power (功率值)实时功率 > 额定功率 * 1.1 (如 > 7.7kW)
跳闸/断电power 状态变为 0开关状态由“合”变“分”
温度异常temperature (若支持)内部温度 > 设定阈值 (如 80°C)
缺相/欠压voltage三相电压缺失或不平衡
主动断开operation人为点击“断开”按钮触发通知

实际场景举例

  • 第一种场景:充电桩电流过大,35A断路器跳闸。设备通过HTTP推送 {"device":"xxx","status":"trip", "reason":"over_current"} 至你的服务器。

  • 第二种场景:设备超负荷运行但未跳闸(存在火灾风险)。服务器接收到实时 power 值(如8500W),对比阈值后判定为“预警”。

4.3 实时状态获取(主动拉取)

如果是低频轮询场景(如每5分钟检查一次),可调用查询接口获取设备实时状态:

  • 接口地址https://api.thingboot.com/{AppId}/device/status/ (具体根据文档)

  • 请求示例:携带签名及设备ID。

  • 返回字段:包含 power(开关状态)、electricity(电量)、voltage(电压)等

5. 告警通知的落地实现

当后端接收到故障事件后,需根据严重等级触达不同人员。以Java/Spring Boot为例的处理逻辑:

6. 安全与优化

6.1 私有化部署(局域网)

对于数据安全的工厂或机房,可利用芯步支持的私有化特性

  • 设备直接推送数据到局域网内的服务器 IP,不经过外网。

  • 有效降低延迟(<100ms),提高内网穿透安全性

6.2 命令回调保障(防止误操作)

在远程合闸(修复故障后)时,为防止安全隐患,在业务层增加二次确认逻辑:

  1. 先发送查询命令获取设备状态。

  2. 状态正常后,下发 {"power":1} 指令。

  3. 校验返回结果(芯步接口响应极快,约80-120ms)

7. 总结

通过对接芯步开放的HTTP API及消息推送机制,35A大功率智能断路器不再是一个孤立的硬件,而是智慧用电系统的重要组成部分。该方案具备高实时性(秒级推送)、高准确性(签名鉴权防误报)及低成本(标准HTTP无需定制驱动)的特点,能够有效保障工厂及大型设备的用电安全。