如何二次开发智能大功率断路器[计量版]|40A来实现过流自动断电控制_解决方案

CATALOG

芯步的智能大功率断路器开放标准HTTP接口，这意味着你可以用任何编程语言直接调用设备API，将“云端决策+设备执行”的闭环打通。以下方案以40A计量版为例，实现过流自动断电的二次开发。

解决方案：基于芯步开放接口的智能大功率断路器过流保护二次开发

1. 背景与目标

智能大功率断路器[计量版]（型号：UNI-DLQ-M-40A-P）不仅支持传统的远程通断控制，还具备电能计量功能，能够实时上报电流、电压、功率等数据。

本方案核心目标：利用设备实时上报的电流数据，在用户自己的云端服务器或本地服务器中设定逻辑规则，当检测到电流超过额定阈值（如40A）或用户自定义阈值时，自动调用API接口切断电路，防止因过载引发火灾或设备损坏。

2. 技术架构与原理

本方案采用经典的“设备端 + 云平台/用户服务器”架构，包含三种实现路径：

路径A（推荐-本地化/私有化部署）：设备通过WiFi直连用户局域网，用户服务器监听设备上报的MQTT/HTTP消息。此方式延迟最低，不经过芯步公有云，数据安全且响应快，适合工厂或机房环境。
路径B（公有云模式）：设备数据上报至芯步云，用户服务器通过芯步提供的API接口主动拉取数据或设置Webhook推送。
路径C（边缘计算模式）：利用Node-RED或HomeAssistant等开源平台，在局域网内快速搭建自动化规则。

核心原理

采样：设备内部计量芯片实时采集电流数据。
决策：外部服务器接收数据，执行 IF Current > Threshold THEN Action 逻辑。
执行：服务器发送HTTP GET/POST请求到设备API，执行断开指令。

3. 二次开发关键步骤

3.1 环境准备与接口鉴权

在开始编码前，首先需要在芯步开发者平台获取凭证：

注册并登录芯步控制台。
获取 AppID 和 AppKey，用于生成签名。
绑定设备，获取唯一的 Device ID。

接口鉴权机制：每次HTTP请求需携带以下参数以验证身份

appid: 您的应用ID
deviceid: 目标设备ID
ts: 时间戳（Unix时间戳，秒级）
sign: MD5签名，计算方式通常为 md5(appid + deviceid + ts + appkey)

3.2 获取实时电流数据（数据采集）

要实现过流判断，必须获取电流值。根据不同的部署模式，获取数据方式不同：

方式一：主动拉取（查询模式）调用 获取设备状态 接口，获取设备的实时计量数据。
- 请求示例： GET https://api.yoyoiot.com/orderstatus?deviceid=xxx&sign=xxx&ts=xxx
- 返回解析：关注返回JSON中的 electricity.current 字段（单位：安培A）或 electricity.power。
方式二：被动接收（推送模式 - 推荐）搭建一个公网可访问或局域网可访问的 Webhook Server。在芯步控制台配置消息推送URL，设备每次数据变化（如每秒或每变化一定阈值）时，平台会将数据POST到您的服务器。这种方式实时性最高，无需频繁轮询。

3.3 过流逻辑判断（核心算法）

在您的后端服务中，编写定时任务或接收数据的处理函数。为了设备安全，设计防抖和连续判断逻辑，避免因瞬间浪涌电流导致断路器频繁跳闸。

伪代码示例（Python Flask 接收Webhook模式）：

from flask import Flask, request
import requests
import hashlib
import time

app = Flask(__name__)

# 配置参数
DEVICE_ID = "YOUR_DEVICE_ID"
APP_ID = "YOUR_APP_ID"
APP_KEY = "YOUR_APP_KEY"
# 阈值设定:40A设备设定为32A（额定80%）或自定义
CURRENT_THRESHOLD = 32.0 
# 持续时间阈值:连续超过阈值3秒才动作，防止电机启动瞬间误判
OVERLOAD_DURATION = 3

# 简单的状态存储（生产环境用Redis）
state_store = {"overload_start_time": None}

def control_device(action):
    """发送控制指令:action = 1 (闭合/通电), action = 0 (断开/断电)"""
    ts = int(time.time())
    # 签名字符串需按字典序排序或文档要求拼接
    raw_str = f"{APP_ID}{DEVICE_ID}{ts}{APP_KEY}"
    sign = hashlib.md5(raw_str.encode()).hexdigest()
    
    url = f"http://api.thingboot.com/ordercontrol"
    params = {
        "appid": APP_ID,
        "deviceid": DEVICE_ID,
        "ts": ts,
        "sign": sign,
        "action": action  # 0为断开
    }
    try:
        r = requests.get(url, params=params, timeout=5)
        print(f"控制指令发送结果: {r.text}")
    except Exception as e:
        print(f"控制失败: {e}")

@app.route('/webhook/callback', methods=['POST'])
def device_callback():
    """处理设备上报的数据"""
    data = request.json
    current = data.get('current')  # 假设字段名为current，单位A
    
    if current is None:
        return "ok"
    
    print(f"收到实时电流: {current}A")
    
    # 判断是否过流
    if current > CURRENT_THRESHOLD:
        # 如果这是第一次超过阈值，记录开始时间
        if state_store["overload_start_time"] is None:
            state_store["overload_start_time"] = time.time()
        else:
            # 检查持续时间
            duration = time.time() - state_store["overload_start_time"]
            if duration >= OVERLOAD_DURATION:
                print(f"电流持续过载{duration}秒，执行断电保护！")
                control_device(0)  # 发送断开指令
                # 可选:发送警报通知
                # 复位记录，防止重复发送断开指令
                state_store["overload_start_time"] = None
                # 注意:这里如果不复位且设备未断电，会每3秒发一次指令，最好加入"已断电"标志
    else:
        # 电流恢复正常，重置计时器
        if state_store["overload_start_time"] is not None:
            print("电流已恢复正常，重置计时")
            state_store["overload_start_time"] = None
            
    return "ok"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

上述代码演示了如何在接收到设备数据后，判断电流超过32A是否持续超过3秒，若是则调用控制接口断电。

3.4 断电执行与恢复策略

执行断电后，断路器处于“断开”状态。设计恢复策略时需格外注意安全：

手动恢复：过流断电往往意味着电路存在隐患。最安全的策略是不断电，系统发送告警（短信/微信/邮件）通知运维人员现场排查后，通过物理按键或App手动合闸。
自动重试：如果场景允许自动恢复（如空调机组、间歇性负载），可在断电后等待设定时间（如5分钟，期间不再检测到异常电流），再发送 action=1 指令尝试恢复供电。
锁定机制：如果短时间内（如10分钟内）连续触发过流保护3次，程序应自动进入“锁定”状态，停止自动合闸，强制要求人工介入。

3.5 高级优化参数与界面

除了简单的通断控制，利用计量版的数据可以实现更精细的控制：

动态阈值：根据时间（如夜间用电低谷）调整阈值。例如，夜晚22:00后，将阈值从32A下调至20A，进一步提升安全性。
功率累计保护：监测实时功率，当检测到功率长时间超过额定功率（如8000W）时动作。
可视化看板：由于HTTP接口开放，可以将电流数据接入Grafana、腾讯云图或自建管理后台，绘制实时电流曲线。一旦曲线突破警戒线，系统自动标红并跳闸。

4. 总结

无需网关：设备直连WiFi，降低了网络层级的复杂性，减少了故障点。
高实时性：结合局域网推送模式，从电流异常到执行断电，总耗时通常可在1秒内完成。
逻辑可编程：相比传统断路器的固定热磁脱扣曲线，开发者可以根据具体负载特性随意定制脱扣曲线（如反时限、定时限等）。
全平台兼容：无论是Windows服务、Linux守护进程、云函数（Serverless），只要能发HTTP请求，均可集成。

5. 注意事项

安全冗余：软件开发层面虽然实现了过流保护，但绝不能完全替代物理线路中的空开或保险丝。本方案适用于智能控制和预警，物理保护仍需符合电气规范。
网络稳定性：执行断电依赖WiFi信号。如果WiFi断开，本方案失效。开启设备的“掉电/离线记忆”功能，并确保设备所在位置WiFi信号良好。
接口限频：注意芯步开放接口的调用频率限制（如果有），不要在高频循环中无意义地刷新状态接口。

通过上述方案，您可以充分利用芯步智能断路器的开放特性，灵活构建适应各种复杂用电场景的过流保护系统。