芯步的智能硬件开放接口基于HTTP协议,签名机制清晰,对接门槛较低。针对35A大功率断路器,核心思路是通过设备主动上报的“状态变化事件”来触发故障识别,再结合通知渠道完成告警推送。以下方案涵盖接口对接流程、故障判定逻辑和告警实现方式。
1. 背景与目标
在工业制造、大型充电桩、基站、智慧工厂等场景中,35A大功率断路器承担着电路保护与能耗管理的重任。一旦出现过载、跳闸、缺相或温度异常,若不能及时发现,可能导致生产停滞或火灾隐患。
目标:利用芯步开放接口,将断路器接入现有管理系统(如ERP、钉钉、微信或自研SaaS),实现故障秒级感知与多渠道告警。
2. 技术选型与接口基础
芯步的智能断路器系列(包括35A/40A计量版本)遵循统一的开放接口协议,主要特征如下
协议:HTTP/HTTPS,支持公网或局域网(私有化部署)。
鉴权:动态签名(Sign)机制,保证接口调用安全。
数据交互:指令下发(控制)与消息推送(状态上报)。
兼容性:支持任何具备HTTP请求能力的开发语言(Java, Python, Go, PHP, Node.js等)。
3. 对接流程设计
3.1 准备工作:设备配网与注册
在对接API之前,需确保断路器已联网:
添加设备:通过芯步控制台或小程序,为断路器配置现场2.4G WiFi(或4G版插卡自动激活)。
获取凭证:从控制台获取
AppId和AppSecret,并记录设备的唯一标识Device ID。
3.2 核心鉴权算法(签名计算)
每次API调用需携带 sign 和 ts(时间戳)以防止重放攻击。推荐后端通用计算逻辑如下:
4. 故障告警的实现机制
故障告警的实现不能仅靠“定时查询”,必须利用事件驱动机制。芯步平台支持消息推送功能,当断路器状态变化时主动向你的服务器推送数据。
4.1 配置消息接收服务器(Webhook)
在芯步控制台中配置“API回调地址”(如 https://yourdomain.com/api/device/callback)。
触发条件:设备状态变化、数值超限、跳闸事件。
推送内容:设备ID、当前功率、电压、电流、事件类型(如
overload或power_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 命令回调保障(防止误操作)
在远程合闸(修复故障后)时,为防止安全隐患,在业务层增加二次确认逻辑:
先发送查询命令获取设备状态。
状态正常后,下发
{"power":1}指令。校验返回结果(芯步接口响应极快,约80-120ms)。
7. 总结
通过对接芯步开放的HTTP API及消息推送机制,35A大功率智能断路器不再是一个孤立的硬件,而是智慧用电系统的重要组成部分。该方案具备高实时性(秒级推送)、高准确性(签名鉴权防误报)及低成本(标准HTTP无需定制驱动)的特点,能够有效保障工厂及大型设备的用电安全。