CATALOG

35A智能空开的过压欠压保护,核心思路不是让空开“自己判断”,而是通过你的系统读取实时电压数据,再主动下发分合闸指令来实现闭环控制。以下方案详细拆解了接口对接的每一个步骤。

1. 概述与原理

本方案的目标是指导开发者如何利用芯步开放平台及35A智能空开的HTTP接口,通过编程方式实现电压监测与保护控制。

核心逻辑闭环:

  1. 监测:系统实时查询空开的当前电压数据。

  2. 判断:业务逻辑判断电压是否低于欠压阈值(如 < 180V)或高于过压阈值(如 > 250V)。

  3. 执行:触发保护指令,向空开发送“分闸(断开)”命令。

  4. 恢复:电压恢复正常范围后,手动或自动发送“合闸(闭合)”命令。

适用场景:工业厂房、机房、无人值守基站、老旧小区、昂贵家电保护。

2. 准备工作

在编写代码前,需完成以下准备工作:

2.1 硬件准备

  • 35A智能空开:确认设备型号为 UNI-DLQ-35A 或类似支持HTTP接口的型号

  • 网络环境:确保设备通电并已通过WiFi 2.4G网络联网(设备自带WiFi,无需额外网关)

2.2 平台账号与密钥

  1. 注册芯步开发者账号

  2. 登录工作台,创建“应用”,获取唯一标识:

    • AppID:应用ID。

    • AppSecret:应用秘钥(用于计算签名)

2.3 设备ID获取

在控制台的设备管理界面,查看已联网的35A智能空开对应的Device ID(设备编号)

3. 接口鉴权与基础通信

芯步采用动态签名验证(MD5双层加密),所有API请求均需携带签名。

3.1 签名生成规则

请求URL格式:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数计算步骤:

  1. 获取当前Unix时间戳(秒):ts

  2. 计算 step1 = md5(AppSecret)

  3. 计算 sign = md5(step1 + ts) (字符串拼接后再次MD5)

注:由于空开涉及安全操作,服务端对ts(时间戳)做有效期校验(如5分钟内有效),防止请求重放攻击。

3.2 基础请求示例 (Python)

4. 过压欠压保护逻辑实现

要实现保护功能,系统需要先读取电压,再判断并执行

4.1 第一步:获取实时电压数据

芯步平台通常支持通过HTTP接口获取设备最新状态(需查阅具体API文档获取实时数据接口,或通过平台消息推送)。

假设逻辑:如果平台只提供控制接口,状态数据通常通过回调/Webhook推送给你的服务器。你需要配置一个接收URL,当空开状态变化或数据上报时,平台会POST如下格式的数据:

4.2 第二步:核心保护算法

在你的服务端编写逻辑函数:

4.3 第三步:指令下发格式

针对35A空开,其控制JSON格式通常遵循标准断路器协议

动作Order JSON 格式说明
分闸(断开){"power": 0}{"power1": 0}切断线路,实现保护
合闸(闭合){"power": 1}{"power1": 1}恢复供电(重合闸)
查询状态调用设备状态API或等待回调获取实时电压电流

5. 高级防护策略与优化

为了提升系统健壮性和用户体验,实施以下高级策略:

5.1 防抖动与滤波

电网瞬间的浪涌或雷击可能导致电压瞬时波动。在代码中应加入去抖动逻辑

  • 连续采样3次,若均超过阈值,才执行跳闸。

  • 或判断电压异常持续时间是否超过3秒(可配置)。

5.2 定时自检与重合闸

针对无人值守场景:

  • 跳闸后,每隔 5 分钟检测一次电压。

  • 若电压连续稳定在正常区间超过 1 分钟,自动执行重合闸命令 {"power":1},尝试恢复供电。

5.3 带参数保护指令(进阶)

部分固件支持直接设置阈值并让设备本地执行保护,以减少云端延迟

  • 通过特定接口配置设备参数,例如设置 max_vol=250, min_vol=180。

  • 优势:即使服务器或网络中断,空开依然能本地自主跳闸保护。

6. 故障排查和需要注意的点

6.1 常见问题

  1. 签名错误(401/403)

    • 检查时间戳ts是否为秒级(10位)。

    • 确认MD5生成的32位十六进制字符串是否为小写。

  2. 设备离线

    • 35A空开仅支持2.4G Wi-Fi,确认5G频段是否隔离。

    • 检查设备是否进入了AP配网模式。

  3. 控制延迟

    • HTTP接口通常延迟在80-120ms,若网络抖动可能更高,保护逻辑需容忍一定延迟

6.2 安全警告

  1. 严禁带负载重合闸:如果跳闸是由于线路短路或过流引起,切勿在未排查故障时盲目通过软件合闸。本方案针对的是电压异常,若因电压低导致设备停机,恢复电压后可合闸。

  2. 权限控制:接口调用凭证AppSecret应存放在服务端,严禁写在客户端APP或前端代码中,防止被逆向导致设备被恶意控制。

总结

通过对接芯步的开放API,开发者可以利用35A智能空开快速构建一套智能、可靠的过压欠压保护系统。核心在于数据采集(获取电压)与指令闭环(逻辑判断+控制)。在开发完成后,使用模拟数据进行边界测试(如电压值=50V、300V),验证保护逻辑是否按预期触发。