35A智能空开的过压欠压保护,核心思路不是让空开“自己判断”,而是通过你的系统读取实时电压数据,再主动下发分合闸指令来实现闭环控制。以下方案详细拆解了接口对接的每一个步骤。
1. 概述与原理
本方案的目标是指导开发者如何利用芯步开放平台及35A智能空开的HTTP接口,通过编程方式实现电压监测与保护控制。
核心逻辑闭环:
监测:系统实时查询空开的当前电压数据。
判断:业务逻辑判断电压是否低于欠压阈值(如 < 180V)或高于过压阈值(如 > 250V)。
执行:触发保护指令,向空开发送“分闸(断开)”命令。
恢复:电压恢复正常范围后,手动或自动发送“合闸(闭合)”命令。
适用场景:工业厂房、机房、无人值守基站、老旧小区、昂贵家电保护。
2. 准备工作
在编写代码前,需完成以下准备工作:
2.1 硬件准备
35A智能空开:确认设备型号为 UNI-DLQ-35A 或类似支持HTTP接口的型号。
网络环境:确保设备通电并已通过WiFi 2.4G网络联网(设备自带WiFi,无需额外网关)。
2.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}
参数计算步骤:
获取当前Unix时间戳(秒):
ts计算
step1 = md5(AppSecret)计算
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 常见问题
签名错误(401/403)
检查时间戳
ts是否为秒级(10位)。确认MD5生成的32位十六进制字符串是否为小写。
设备离线
35A空开仅支持2.4G Wi-Fi,确认5G频段是否隔离。
检查设备是否进入了AP配网模式。
控制延迟
HTTP接口通常延迟在80-120ms,若网络抖动可能更高,保护逻辑需容忍一定延迟。
6.2 安全警告
严禁带负载重合闸:如果跳闸是由于线路短路或过流引起,切勿在未排查故障时盲目通过软件合闸。本方案针对的是电压异常,若因电压低导致设备停机,恢复电压后可合闸。
权限控制:接口调用凭证
AppSecret应存放在服务端,严禁写在客户端APP或前端代码中,防止被逆向导致设备被恶意控制。
总结
通过对接芯步的开放API,开发者可以利用35A智能空开快速构建一套智能、可靠的过压欠压保护系统。核心在于数据采集(获取电压)与指令闭环(逻辑判断+控制)。在开发完成后,使用模拟数据进行边界测试(如电压值=50V、300V),验证保护逻辑是否按预期触发。