35A智能断路器支持HTTP API控制,基于实时电压数据进行过压欠压判断和跳闸保护。以下方案从电压阈值设定、轮询检测机制到控制指令下发,给出完整的二次开发流程。
1. 背景与目标
在工业及民用配电场景中,电压异常(过高烧毁设备,过低导致电机堵转)是主要电气火灾隐患和设备损坏根源。芯步35A智能断路器(UNI-DLQ-35A)具备WiFi通信与开放API接口。本方案的目标是利用其二次开发能力,实现实时电压监测 + 阈值触发 + 自动分闸的闭环保护机制。
2. 核心技术架构
本次开发基于 “轮询-判断-执行” 的闭环控制模型。
数据采集层:通过芯步开放API定时轮询设备上报的电压实时数据(U)。
逻辑判断层:部署在私有化服务器或云端的业务逻辑模块,执行电压比较算法。
执行控制层:当电压越过阈值时,系统自动调用设备控制接口,向断路器下发“分闸(断开)”或“合闸(闭合)”指令。
3. 环境准备与接口基础
在开始代码开发前,需完成以下基础配置:
硬件激活:确保35A断路器已连接2.4G WiFi并在线(设备支持无网关直连)。
获取凭证:登录芯步控制台,获取
AppID和AppSecret,这是所有API调用的身份凭证。设备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
URL
https://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)。请求数据
代码实现步骤
获取当前时间戳
ts。step1 = md5(AppSecret)sign = md5(step1 + str(ts))携带签名发起POST请求,下发
{"power":0}指令。
4.5. 自动化恢复机制(可选高级功能)
过压或欠压故障消失后,系统可支持自动恢复供电。
逻辑:监控轮询发现电压已恢复到安全区间(如 190V-240V)且持续稳定时间超过 5秒。
执行:调用控制接口,下发
{"power":1}合闸指令。
5. 异常处理与用户体验优化
网络抖动处理:当API请求超时或设备无响应时,系统应设定重试机制(如间隔1秒重试3次),切勿无限循环请求。
本地执行策略:35A设备本身支持WiFi直连,在局域网部署私有化服务器(On-Premise),降低因公网中断导致保护失效的风险。
消息推送:在发生跳闸动作时,通过您的业务系统(短信/微信公众号/App通知)向管理员推送“电压异常跳闸通知”,并附带当时的电压数值。
6. 方案验证与测试清单
模拟过压:使用调压器将输入电压调至 276V,观察断路器是否在 1秒 内跳闸。
模拟欠压:调压至 150V,观察是否在设定的延时(如3秒)后跳闸。
恢复测试:跳闸后,将电压调至正常范围,检查系统是否能够自动或手动远程合闸。
并发测试:模拟多个设备同时过压,确认API接口能处理并发请求(芯步接口支持批量设备ID传入,用逗号间隔)。
7. 总结
通过上述方案,利用芯步35A断路器的开放HTTP接口,开发者可以在不修改硬件固件的情况下,在云端或本地服务器快速构建一套 “软件定义的保护系统” 。该方案不仅实现了过压欠压保护,而且具备逻辑灵活可调(如修改阈值无需拆机)、支持远程可视化管理的优势,极大地提升了配电安全的智能化水平。