如何二次开发60A带计量数显智能空开以实现场景联动控制_解决方案

CATALOG

60A带计量数显智能空开的二次开发，核心在于利用芯步开放的HTTP API，将设备的数据采集、通断控制与业务场景进行逻辑串联。以下方案涵盖接口对接、签名认证、场景联动代码实现及典型应用案例。

一、解决背景与目标

芯步的 60A带计量数显智能空开 是一款支持大功率（60A）控制的工业级断路器，具备电压、电流、功率等电能计量功能，并标配数显屏幕。其核心优势在于开放了全平台的HTTP API，支持公有云及私有化部署。

本方案的目标是指导开发者如何通过调用芯步开放平台的HTTP接口，对此款空开进行二次开发，实现以下场景联动目标：

远程控制：通过网络下达分合闸指令。
数据采集：实时读取电压、电流及功率数据。
场景联动：基于电气数据（如过载、欠压、功率阈值）触发逻辑规则（如自动断电、告警或联动其他设备）。

二、硬软件准备与接口特性

硬件：芯步智能大功率断路器[计量版] (型号：UNI-DLQ-M-60A-P)。
通信协议：Wi-Fi 2.4GHz（直连，无需网关）。
核心接口：HTTP API / MQTT。
认证机制：双重MD5加密签名（Sign）。

三、二次开发核心技术：接口对接与签名认证

要进行二次开发，首先需要过“安全认证关”。芯步的API通过 AppID、AppSecret 和时间戳 ts 来保证安全。

1. 签名生成规则

根据官方文档，签名算法如下

2. 核心API端点

设备控制（单设备） ：POST /{AppId}/device/control/
设备控制（标签化/批量控制） ：POST /{AppId}/tag/control/

四、实战：场景联动逻辑开发

针对60A空开的特点，以下是三个典型场景的二次开发实现方案。

第一种场景：基于功率阈值的动态过载保护

需求：当实时功率超过设定阈值（如20,000W）且持续超过3秒，自动断开电路，并在恢复后尝试自动重连。逻辑：通过轮询或API获取实时数据 -> 逻辑判断 -> 调用控制接口。

实现代码逻辑（伪代码/概念）：

import time
import requests
import json

# 1. 定义获取设备状态的函数（假设设备上报数据已推送到您的服务器，或您主动查询）
def get_device_metrics(device_id):
    # 实际开发中，可配置"消息推送"接收实时数据，或调用设备状态查询API
    # 返回示例: {"voltage": 220, "current": 90.9, "power": 20000}
    response = requests.get(f"https://api.thingboot.com/.../status/{device_id}")
    return response.json()

# 2. 定义控制设备的函数
def control_breaker(device_id, action):
    # action: "power":1 代表合闸， "power":0 代表分闸
    url = "https://api.thingboot.com/AppId/device/control/"
    payload = {
        "device": device_id,
        "order": {"power": action}  # 针对单路空开
    }
    # 这里需补充完整的Sign和Headers
    requests.post(url, data=json.dumps(payload))

# 3. 场景联动核心逻辑
def smart_protection_loop(device_id, power_threshold=20000, hold_time=3):
    overload_start_time = None
    
    while True:
        data = get_device_metrics(device_id)
        current_power = data.get('power', 0)
        
        if current_power > power_threshold:
            if overload_start_time is None:
                overload_start_time = time.time() # 开始计时
            elif time.time() - overload_start_time >= hold_time:
                print(f"功率 {current_power}W 超过阈值，触发断电保护")
                control_breaker(device_id, 0) # 分闸
                # 可选:发送告警通知
                break
        else:
            overload_start_time = None # 重置计时
        time.sleep(1) # 检测间隔

第二种场景：与第三方传感器联动

需求：将60A空开与温湿度传感器联动。当机房温度过高时，不仅空调启动，如果空调失效，空开直接切断主电源防止火灾。方案：物联网平台接收到温度传感器的告警 -> 触发规则引擎 -> 调用芯步API。

HTTP请求示例（用于切断电源）

第三种场景：标签化批量控制

需求：在一个工厂车间，需要一键关闭所有机器（按区域）。方案：在芯步控制后台将多个空开绑定到一个“标签”（Tag）下。二次开发时，只需调用标签控制接口，无需遍历设备ID。

请求数据格式

五、数据采集与可视化二次开发

计量功能是该产品的亮点。除了控制，您通常需要将电流、电压数据集成到自己的BI系统或APP中。

由于官方API支持私有化部署和自建消息服务器，采用以下架构：

设备 -> 云/本地：配置设备的HTTP推送地址为您自己的服务器地址 http://your-server.com/api/receive。
数据解析：在您的服务器端接收JSON数据包。
业务应用
- 大屏展示：实时显示三相电压、电流。
- 计费系统：累加功率与时间，计算电能消耗，生成电费账单。
- 预警系统：如电流曲线突增，通过企业微信/钉钉机器人发送告警。

六、总结

通过对芯步60A智能空开的二次开发，开发者可以构建出远超传统断路器的智能化系统：

低成本迁移：利用WiFi直连和简单的HTTP API，可在现有软件系统中快速集成。
安全可控：通过私有化部署选项，核心用电数据可以保留在局域网或企业自有服务器中，避免了数据泄露风险。
核心价值延伸：利用计量数据作为“触发器”，让空开从一个被动的执行设备（只是开关），升级为一个主动保护的边缘计算节点。