CATALOG

35A智能断路器支持HTTP API控制,基于实时电压数据进行过压欠压判断和跳闸保护。以下方案从电压阈值设定、轮询检测机制到控制指令下发,给出完整的二次开发流程。

1. 背景与目标

在工业及民用配电场景中,电压异常(过高烧毁设备,过低导致电机堵转)是主要电气火灾隐患和设备损坏根源。芯步35A智能断路器(UNI-DLQ-35A)具备WiFi通信与开放API接口。本方案的目标是利用其二次开发能力,实现实时电压监测 + 阈值触发 + 自动分闸的闭环保护机制。

2. 核心技术架构

本次开发基于 “轮询-判断-执行” 的闭环控制模型。

  • 数据采集层:通过芯步开放API定时轮询设备上报的电压实时数据(U)。

  • 逻辑判断层:部署在私有化服务器或云端的业务逻辑模块,执行电压比较算法。

  • 执行控制层:当电压越过阈值时,系统自动调用设备控制接口,向断路器下发“分闸(断开)”或“合闸(闭合)”指令。

3. 环境准备与接口基础

在开始代码开发前,需完成以下基础配置:

  1. 硬件激活:确保35A断路器已连接2.4G WiFi并在线(设备支持无网关直连)

  2. 获取凭证:登录芯步控制台,获取 AppIDAppSecret,这是所有API调用的身份凭证

  3. 设备ID:记录目标设备的唯一标识符(Device ID),例如示例中的 1878

4. 具体开发步骤详解

4.1. 电压阈值设定(业务逻辑定义)

根据国家标准(GB/T 12325-2008)及通用电气安全规范,设定默认保护门限(支持通过后台动态修改):

  • 过压保护(Over Voltage):电压 > 275V(峰值)。动作:立即跳闸。

  • 欠压保护(Under Voltage):电压 < 160V(峰值)。动作:延时3秒跳闸(防止电机启动瞬间压降导致的误跳)。

  • 恢复回差:电压回落至 240V 或回升至 190V 并稳定3秒后,允许自动或手动合闸。

4.2. 核心功能A:获取实时电压数据(状态轮询)

为了判定电压是否异常,需要获取设备的当前电压数据。

  • 实现原理:由于设备会自动上报状态,我们可以通过调用设备状态查询接口,或者在自建服务器接收设备上报的HTTP Push消息。

  • 开发动作:在您的服务器代码中,创建一个定时任务(Cron Job/ Timer),如每 500ms(可根据电网质量调整)读取一次电压值。

  • 关键命令示例:查询设备状态(假设API约定)。

    • 请求方式:POST/GET

    • URLhttps://api.thingboot.com/{AppId}/device/status/

    • 参数device = 1878

    • 返回值解析:重点关注返回JSON中的 voltage 字段(单位:V)。

4.3. 核心功能B:电压异常判断算法

在服务器端接收到 Current_Voltage 后,执行以下伪代码逻辑:

4.4. 核心功能C:下发分闸/合闸指令(设备控制)

这是执行动作的关键。当判断逻辑认定电压异常时,需要调用此接口断开电路。

  • 请求地址https://api.thingboot.com/{AppId}/device/control/

  • 签名生成:需动态计算 sign 参数。公式为 sign = md5(md5(AppSecret) + ts)

  • 请求数据

  • 代码实现步骤

    1. 获取当前时间戳 ts

    2. step1 = md5(AppSecret)

    3. sign = md5(step1 + str(ts))

    4. 携带签名发起POST请求,下发 {"power":0} 指令。

4.5. 自动化恢复机制(可选高级功能)

过压或欠压故障消失后,系统可支持自动恢复供电。

  • 逻辑:监控轮询发现电压已恢复到安全区间(如 190V-240V)且持续稳定时间超过 5秒

  • 执行:调用控制接口,下发 {"power":1} 合闸指令。

5. 异常处理与用户体验优化

  1. 网络抖动处理:当API请求超时或设备无响应时,系统应设定重试机制(如间隔1秒重试3次),切勿无限循环请求。

  2. 本地执行策略:35A设备本身支持WiFi直连,在局域网部署私有化服务器(On-Premise),降低因公网中断导致保护失效的风险

  3. 消息推送:在发生跳闸动作时,通过您的业务系统(短信/微信公众号/App通知)向管理员推送“电压异常跳闸通知”,并附带当时的电压数值。

6. 方案验证与测试清单

  • 模拟过压:使用调压器将输入电压调至 276V,观察断路器是否在 1秒 内跳闸。

  • 模拟欠压:调压至 150V,观察是否在设定的延时(如3秒)后跳闸。

  • 恢复测试:跳闸后,将电压调至正常范围,检查系统是否能够自动或手动远程合闸。

  • 并发测试:模拟多个设备同时过压,确认API接口能处理并发请求(芯步接口支持批量设备ID传入,用逗号间隔)

7. 总结

通过上述方案,利用芯步35A断路器的开放HTTP接口,开发者可以在不修改硬件固件的情况下,在云端或本地服务器快速构建一套 “软件定义的保护系统” 。该方案不仅实现了过压欠压保护,而且具备逻辑灵活可调(如修改阈值无需拆机)、支持远程可视化管理的优势,极大地提升了配电安全的智能化水平。