如何二次开发60A远程控制断路器以实现导轨式安装通断控制_解决方案

CATALOG

芯步60A智能断路器采用WiFi直连方案，开放标准HTTP接口，支持二次开发接入。下面从硬件安装、接口协议、代码实现到高级配置，系统说明如何完成二次开发。

一、硬件选型与安装准备

在进行任何代码开发之前，首先要确保硬件环境的正确部署。芯步的60A断路器（如型号 UNI-DLQ-M-60A）设计遵循工业标准，具备以下显著特点：

导轨式安装：该设备外壳采用标准化的卡扣设计，支持 DIN 标准导轨 安装。在配电箱中，你只需将其卡入导轨并锁紧，即可完成物理固定，无需复杂的螺丝打孔。
大功率承载：额定电流 60A，适用于大功率设备（如空调机组、大功率照明回路、充电桩）的通断控制。
无线联网：设备内置 WiFi 2.4G 无线模块，支持 5 组 WiFi 网络配置（自动漫游切换），只需将设备置于有 WiFi 信号覆盖的配电箱内，无需额外购买网关，通电后即可自动寻找预先配置的网络进行连接。
接线示意
- 输入端：接入 220V 交流火线进线。
- 输出端：接至负载设备。
- 零线：设备工作需零线（N）接入以供内部电路工作。

二、核心开放接口技术解析

芯步的核心优势在于其极简的 HTTP 协议 开放能力。这意味着你可以使用 Python、Java、Go、PHP 甚至小程序的 JS 语言，只要能够发起 HTTPS 请求，就能控制断路器，无需关心底层复杂的 TCP 长连接或 MQTT 协议栈。

1. 接口地址与鉴权机制

所有控制请求均指向同一个 API 端点，通过 动态签名 保障安全性。

请求方式：POST
URL 结构https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}

鉴权算法（三步签名法）为了防止请求被伪造或重放攻击，系统采用双重 MD5 加密 + 时间戳策略。

准备两个关键参数：
- AppSecret：从工作台“开发设置”中获取的密钥。
- Timestamp (ts)：当前的 Unix 时间戳（秒级）。
计算签名
- Step A：先计算 SecretKey_MD5 = md5(AppSecret)
- Step B：拼接字符串 temp = SecretKey_MD5 + ts
- Step C：最终签名 sign = md5(temp)
携带设备与命令
- device：目标设备的唯一 ID（可从控制台复制）。
- order：具体的控制指令（JSON 字符串）。

2. 设备“物模型”与指令集

针对 60A 断路器，其逻辑模型定义了以下核心操作

功能分类	命令示例 (order 参数)	功能说明	应用场景
基础通断	`{"power1": 1}`	闭合断路器（通电）	正常启动负载
`{"power1": 0}`	断开断路器（断电）	正常关闭负载
先断后通	`{"reset": 3000}`	立即断开，延时 3 秒后自动闭合	重启路由器、服务器，解决死机问题
先通后断	`{"point": 2000}`	立即闭合，延时 2 秒后自动断开	触发门禁、脉冲式控制
设备重启	`{"system": "restart"}`	软重启设备主控芯片	设备离线时远程维护

三、二次开发代码实战

以下是针对 60A 断路器 的二次开发示例，展示如何通过代码实现“远程重启”功能（该功能常用于解决工业网关死机）。

场景模拟

某充电桩的工控机死机，需要断电 3 秒后重新通电。通过调用 reset 命令实现。

Python 实现示例

import hashlib
import time
import requests
import json

# 配置信息 (从芯步控制台获取)
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "设备的ID"  # 如 1878

def generate_sign(secret, timestamp):
    # Step 1: md5(AppSecret)
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # Step 2: md5(md5_secret + ts)
    sign_str = md5_secret + str(timestamp)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign

def control_breaker(action_command):
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    # 构造 URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 构造 Body
    # action_command 可以是 {"power1":0} 或 {"reset":3000}
    payload = {
        "device": DEVICE_ID,
        "order": json.dumps(action_command) # 注意:order的值必须是字符串形式的JSON
    }
    
    headers = {'Content-Type': 'application/json'}
    
    response = requests.post(url, json=payload, headers=headers)
    return response.json()

# 执行任务:断开3秒后自动重启
if __name__ == "__main__":
    # 发送先断后通指令，间隔3000毫秒
    result = control_breaker({"reset": 3000}) 
    print(result)

关键代码解析

自动重连机制：命令下发后，设备内部 MCU 会独立执行计时器任务。即使执行 reset 导致网络模块短暂断电，恢复供电后设备也会自动重连 WiFi，无需人工干预。
批量控制：如果现场有多个断路器需要同步动作，device 字段支持逗号分隔，如 device = "id1,id2,id3"，系统会并发执行指令。

四、高级配置与场景优化

除了实时调用 API 控制外，在进行二次开发整合系统时，关注以下配置项以提升系统健壮性：

1. 配置“断电记忆”功能

在工业环境中，若现场意外跳闸后恢复供电，你可能不希望负载自动运行（存在安全隐患）。可以通过修改设备的 配置项 中的 relay1（开机状态）来实现。

设置为 0：恢复供电后，断路器保持断开状态（推荐用于生产设备）。
设置为 1：恢复供电后，断路器自动闭合。
修改方式：通过芯步控制台 -> 设备管理 -> 配置项修改，或通过 API 下发配置指令。

2. 消息推送与状态同步

单纯的“控制”是单向的，为了实现闭环管理（确认开关确实动作了），你可以利用 自建消息服务器 功能。

在开发者中心配置你的服务器 URL。
当断路器状态发生变化（手动按下物理按钮、设备重启、执行动作完成）时，平台会主动向你的服务器推送设备当前的状态数据（如 {"power1":1}），这对于构建同步状态的 Web 后台或 App 至关重要。

五、总结

通过芯步的开放接口对 60A 断路器进行二次开发，整体路径非常清晰：硬件安装（导轨固定 + WiFi 配网） → 获取凭证（AppID/Secret） → 调用 API（签名计算 + 指令下发） → 状态闭环（消息推送）。

这套方案不仅省去了复杂的协议解析工作，而且基于 HTTP 的特性使其能无缝集成到现有的 MES 系统、ERP 系统或自研的 IoT 中台系统中，真正实现大功率电气负载的远程智能化管理。