怎样二次开发25A 智能断路器以实现导轨式安装通断控制_解决方案

CATALOG

针对芯步25A智能断路器的二次开发，其核心在于利用设备开放的HTTP API接口，通过编程方式实现远程通断控制。以下方案涵盖设计、接口适配及具体代码实现。

一、技术可行性分析

芯步的 UNI-DLQ-25A 系列智能断路器（含4G版和WiFi版）专门为系统集成和二次开发设计了开放HTTP接口。这意味着它不依赖特定的APP或封闭生态，你可以直接通过任何后端语言（Python, Java, Go, PHP）或前端脚本（Ajax）下发指令。

关键特性如下：

接口协议：标准 HTTP POST 请求。
控制模式：支持单路控制（线路1为总线路）、批量控制、定时任务。
安装方式：标准 35mm 导轨式安装，直接替换传统空开，无需改动原有配电箱布局。
负载能力：额定 25A / 最高 5000W（阻性），满足工业设备、大功率空调、商用电器等场景。

二、整体设计

为了实现“导轨式安装通断控制”，通常采用 云-端协同 的架构，但芯步的设备也支持局域网直连或私有化部署，具体取决于你的网络环境。

设备层（智能硬件）
- 设备型号：UNI-DLQ-25A 系列。
- 安装位置：强电配电箱（DIN导轨）。
- 联网方式：WiFi（2.4GHz）或 4G（根据现场网络覆盖选择）。
网络层（接口调用）
- 公网模式：设备连接芯步云，你的业务服务器通过调用云API下发指令（适合分布式部署）。
- 局域网/私有化模式：设备直接连接你的本地服务器（如HomeAssistant或自研控制台），数据不经过外网。
应用层（业务系统）
- 你的上位机软件、MES系统、能源管理系统或智慧楼宇平台。

三、核心开发步骤与接口示例

二次开发的核心是调用下面的接口。在芯步平台，每个开发者账号拥有 AppID 和 AppSecret，所有请求必须携带动态 sign（签名）以保证安全性。

1. 鉴权与签名计算

在发送指令前，必须计算 Sign。算法逻辑如下

准备 AppSecret（从控制台获取）。
获取当前 Unix 时间戳 ts（秒级）。
Sign = md5( md5(AppSecret) + ts )

2. 控制断路器通断 (Python 示例)

以下是控制25A断路器闭合（通电） 和断开（断电） 的核心代码逻辑。

import hashlib
import time
import requests
import json

# 配置参数 (从你的芯步控制台获取)
APP_ID = "YOUR_APP_ID"          # 你的应用ID
APP_SECRET = "YOUR_SECRET"      # 你的开发者密码
DEVICE_ID = "YOUR_DEVICE_SN"    # 断路器的设备ID，通常贴在设备侧面或控制台查看

def generate_sign(secret):
    # 1. 对 Secret 进行一次 MD5
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 2. 拼接时间戳
    ts = str(int(time.time()))
    sign_str = md5_secret + ts
    # 3. 再进行一次 MD5 得到最终签名
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

def control_breaker(order_code):
    """
    控制断路器
    :param order_code: 命令字符串 (如 "1" 代表通，"0" 代表断)
    """
    sign, ts = generate_sign(APP_SECRET)
    
    # 构建 URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 构建 Body
    # 对于 25A 断路器，通常使用 "power" 字段控制总线路
    # 如果设备是多路的，使用 power1, power2 等[citation:3]
    payload = {
        "device": DEVICE_ID,
        "order": {"power": order_code}  # {"power":"1"} 开启, {"power":"0"} 关闭
    }
    
    headers = {
        "Content-Type": "application/json"
    }
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    print(f"控制结果: {response.text}")
    return response

if __name__ == "__main__":
    # 示例:闭合断路器（通电）
    # control_breaker("1")
    
    # 示例:断开断路器（断电）
    # control_breaker("0")
    pass

3. 高级控制指令

除了简单的开关，针对工业场景下的电机、照明或特殊负载，你可能需要用到以下指令

点动/脉冲控制（先通后断）：适用于控制卷帘门、电机启动。
- order = {"point":{"relay":[1],"interval":500}} (接通线路1，500ms后自动断开)
先断后通（复位）：适用于服务器重启或设备复位。
- order = {"reset":{"relay":[1],"interval":1000}}(断开线路1，1秒后重新接通)

四、安装与接线实操（导轨式安装）

既然主题强调“导轨式安装”，在物理部署时需注意以下细节：

物理安装
- 产品尺寸为 36mm (宽) × 66mm (长) × 81mm (高)，占 2P (2个模数) 宽度。
- 将设备卡入配电箱的 DIN 导轨（35mm），确保卡扣“咔哒”锁死。
- 接线：上进下出。上方端子接输入火线 (L)，下方端子接输出负载火线。零线 (N) 需直接并接或单独接零线排（因为断路器通常只控制火线）。
供电与网络
- 供电：直接接入 AC 85-265V 市电即可工作。
- 配网：如果使用 WiFi 版本，首次使用需通过芯步提供的简易配网流程将其连接至你的 2.4GHz 热点；4G版本则即插即用。

五、注意事项与最佳实践

负载限制
- 虽然额定是25A，但请注意区分负载类型。如果是感性负载（如电机、压缩机），功率应控制在 800W 以内，否则可能因浪涌电流导致触点粘连。
- 如果是LED灯或节能灯（容性负载），同样需降额使用，总功率控制在 1000W 以内以避免冲击电流损坏继电器。
局域网直连（私有化部署）
- 如果你不希望经过外网云平台，且控制端和设备处于同一局域网，可直接根据设备的 IP 地址（通过 DHCP 获取）调用本地 API。这能极大降低延迟，并提高数据安全性。
状态同步（回调）
- 如果只是下发命令，却不获取设备当前状态是不安全的。在你的服务器上设置一个接收回调（Callback/Webhook）的接口。将设备的 AppID 配置中开启“设备状态推送”，当断路器因过载跳闸或本地人为按下时，平台会主动推送状态变化到你的服务器，从而保持系统同步。

通过上述方案，你可以快速将25A智能断路器集成到现有的任何软件系统中，实现基于HTTP协议的精准电源控制。