如何对接50A计量数显智能断路器来实现过压欠压保护控制_解决方案

CATALOG

芯步的开放接口以HTTP API为主，本身不直接处理过压/欠压判断——这部分逻辑需要在你自己的业务服务器上实现：通过API轮询获取电压数据，与阈值比较后下发分合闸指令。以下方案涵盖了从数据获取到保护执行、再到延时自恢复的完整闭环。

1. 概述

本方案的目标是指导开发者如何利用芯步提供的开放API接口，对接其50A计量数显智能断路器（如智能通断器或4路控制器），实现完整的过压、欠压保护控制功能。

核心逻辑是通过您的业务服务器实时（或准实时）获取设备的电压数据，在检测到电压异常时，通过API下发指令远程分闸（切断电路），从而保护后端负载设备。当电压恢复正常范围并稳定一段时间后，可由系统自动或人工确认后合闸（恢复供电）。

适用范围：50A及以下容量的智能断路器/智能通断器，工作电压AC 85-265V。

2. 核心技术架构

基于芯步的设备特性，推荐采用 “轮询监测 + 即时控制” 的架构，无需依赖硬件层面的实时中断（因普通WiFi模块难以实现毫秒级瞬时保护，需依赖设备固件的本地保护作为第一道防线，云平台作为第二道防线）。

[设备层]：50A智能断路器（负责采集电压、电流，执行分合闸）。
[接口层]：芯步开放API（HTTP协议）。
[业务层]：您的应用服务器（负责定时获取数据、逻辑判断、下发命令）。
[控制层]：通过API下发 power 或 power1 等指令。

3. 对接准备

3.1 硬件确认

请确保所选用的芯步50A级别设备支持以下功能：

计量功能：必须支持读取电压数据（V）。
控制功能：必须支持远程断路（power 或 power1 等指令）。
电气参数
- 额定电流：50A（或通过互感器支持50A）。
- 额定电压：230V/400V AC。
注：参考市面上B104等类似型号，过压保护阈值通常可设为 100V~480V，欠压阈值 30V~320V 。

3.2 平台凭证

在芯步控制台中获取以下信息

AppId：应用唯一标识。
AppSecret：密钥（用于签名计算）。
Device ID：目标断路器的设备编号。

4. 关键接口调用详解

芯步的接口采用 HTTP POST 请求，签名机制为双重MD5加密。

4.1 签名算法

为了保证接口调用的安全性，每次请求需携带签名 sign 和时间戳 ts。生成规则sign = md5( md5(AppSecret) + ts )其中 + 为字符串拼接。

4.2 获取设备最新电压数据

场景：您需要知道当前的实时电压值，以判断是否过压或欠压。

由于芯步公开文档中主要展示了“控制类”接口，获取计量数据通常有两种方式（视具体设备固件而定），推荐方案如下：

设备状态查询接口（请查阅具体的设备手册）：向 api.thingboot.com 发送查询请求，获取设备上报的当前电量参数。返回的JSON中通常包含 voltage 字段。
消息推送（Webhook）：如果您拥有公网服务器，可在芯步控制台配置消息推送URL，设备每次上报数据时会主动推送到您的服务器（实时性更高）。

4.3 下发分/合闸指令

请求地址POST http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}HeaderContent-Type: application/jsonBody (JSON)

对于多路控制器，请使用 power1、power2 等字段。

5. “过压/欠压保护”业务逻辑实现

此处以Python伪代码为例，展示如何在您的服务器上实现核心守护逻辑。

5.1 阈值设定

根据常规电气规范设定安全范围（具体数值可配置）：

过压阈值 (OverVoltage)> 275V（动作值） / < 265V（恢复值）
欠压阈值 (UnderVoltage)< 160V（动作值） / > 195V（恢复值）
延时：为了躲避电网瞬时波动，电压异常持续 2-5秒 后再执行断电。

5.2 核心代码逻辑

import time
import hashlib
import requests

# 配置参数
APP_ID = "YourAppId"
APP_SECRET = "YourAppSecret"
DEVICE_ID = "Device_50A_Breaker"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

# 电压阈值配置
VOLT_LIMITS = {
    "over_max": 275.0,   # 过压保护阈值 (Volts)
    "over_min": 265.0,   # 过压恢复阈值
    "under_max": 195.0,  # 欠压恢复阈值
    "under_min": 160.0   # 欠压保护阈值
}

def generate_sign(secret, ts):
    """生成芯步标准签名"""
    first_md5 = hashlib.md5(secret.encode()).hexdigest()
    sign_str = first_md5 + str(ts)
    return hashlib.md5(sign_str.encode()).hexdigest()

def control_breaker(action):
    """
    控制断路器状态
    :param action: 0 表示断开(保护动作), 1 表示闭合(恢复供电)
    """
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"{API_URL}?sign={sign}&ts={ts}"
    payload = {
        "device": DEVICE_ID,
        "order": {"power": action}  # 标准通断命令
    }
    
    response = requests.post(url, json=payload)
    print(f"Send command {action} -> Response: {response.text}")

def get_current_voltage():
    """
    模拟获取当前电压值。
    实际开发中需调用 设备状态查询API 或 解析推送的数据。
    这里假设从数据库或缓存中读取最近一次设备上报的电压。
    """
    # 替换为实际API调用: 
    # res = requests.get(f"https://api.thingboot.com/.../status?device={DEVICE_ID}")
    # return res.json().get('voltage', 0)
    
    # 这里是模拟数据，用于测试逻辑
    return 280.0

# --- 主逻辑:电压监控守护进程 ---
def voltage_protection_loop():
    """
    过压欠压保护主循环
    """
    print("Starting Voltage Protection Service for 50A Breaker...")
    # 状态机变量 (0=正常, 1=过压故障, 2=欠压故障)
    fault_status = 0 
    
    while True:
        # 1. 获取电压 (这里需要配合数据更新频率，例如每2秒执行一次)
        current_v = get_current_voltage()
        print(f"Monitoring Voltage: {current_v} V")
        
        # 2. 逻辑判断
        # 过压判断
        if current_v >= VOLT_LIMITS["over_max"] and fault_status != 1:
            print(f"OverVoltage detected! ({current_v}V > {VOLT_LIMITS['over_max']}V). Tripping breaker...")
            control_breaker(0)  # 断开断路器
            fault_status = 1    # 标记为过压故障态
            
        # 欠压判断
        elif current_v <= VOLT_LIMITS["under_min"] and fault_status != 2:
            print(f"UnderVoltage detected! ({current_v}V < {VOLT_LIMITS['under_min']}V). Tripping breaker...")
            control_breaker(0)
            fault_status = 2    # 标记为欠压故障态
            
        # 恢复判断 (已处于故障状态，且电压回到安全区间)
        elif fault_status != 0 and VOLT_LIMITS["under_max"] <= current_v <= VOLT_LIMITS["over_min"]:
            print(f"Voltage recovered to {current_v}V. Auto-reclosing in 5 seconds...")
            # 实际应用中通常延时5-30秒恢复，防止电压震荡
            time.sleep(5) 
            control_breaker(1)  # 重合闸
            fault_status = 0    # 恢复常态
            
        # 无动作时休眠，避免CPU过高。1-2秒检查一次。
        time.sleep(2)

if __name__ == "__main__":
    # 启动服务
    voltage_protection_loop()

6. 关键逻辑说明与优化

6.1 实时性与可靠性的权衡

由于HTTP API交互存在网络延迟（通常80-120ms内），且受限于轮询频率（Polling），本方案更适合防止长时间异常电压烧毁设备的场景（如夜间电压骤升），而作为追加保护。：对于需要极其灵敏的保护（如打火、浪涌），应优先依赖设备自身的硬件/固件保护机制。您可以通过API将设备固件中的“过压保护阈值”配置参数写入设备，这样即使网络中断，设备本地也能自动跳闸。

6.2 延时自恢复

在上述代码逻辑中，我们加入了恢复判断。这一功能对于基站、机房或无人值守站点极其重要。必须确保电压在安全区间内且稳定维持了一段时间（例如5-30秒）才能进行合闸操作，防止因电网频繁波动导致设备继电器频繁动作而损坏。

6.3 多设备批量控制

如果需要对多个断路器进行统一保护（例如三相电缺相导致的大面积欠压），可以利用芯步接口支持的批量控制功能。order字段可以这样构造：{"batch":{"relay":[1,2,3,4],"power":0}}，一条命令即可同时关断所有线路。

6.4 数据可视化与告警

结合芯步的接口能力，您还可以：

Web界面：实时绘制电压曲线图，标记过压/欠压发生的时间点。
告警推送：当发生跳闸保护时，自动触发短信、邮件或应用内通知，告知运维人员。

7. 总结

通过对接芯步50A计量数显智能断路器的开放HTTP接口，您可以在不涉及底层嵌入式开发的情况下，快速构建一套过压、欠压保护系统。

该方案的核心在于服务器侧的轮询逻辑与设备本身的执行能力相结合。对于要求苛刻的工业场景，优先配置设备本地的电子保护阈值（如过压275V自动脱扣），再将云平台API作为“远程监控、数据记录和自动重合闸”的管理手段。