如何二次开发60A智能限流断路器来实现远程定时通断控制_解决方案

CATALOG

芯步60A智能限流断路器的开放接口基于HTTP协议，签名验证机制清晰，配合设备内置的定时参数（如reset指令），可低成本实现远程定时控制。以下是具体的技术实现方案。

芯步60A智能限流断路器二次开发方案：远程定时通断控制

1. 背景与目标

60A智能限流断路器 不仅具备传统过载、短路保护功能，还集成了 Wi-Fi 通信模块 与 电能计量 功能。芯步为该类产品（型号如 UNI-DLQ-M-60A-P）提供了开放的 HTTP API 接口。

本方案的目标是指导开发者如何利用这些接口，在不依赖厂家自带 App 的情况下，搭建属于自己的后端服务或物联网平台，实现对 60A 断路器的远程定时通断控制（如定时开关路灯、工厂排班用电、充电桩定时启停）。

2. 核心技术原理

该方案的实现基于以下两个核心机制：

直接控制机制：芯步的设备无需网关，直连 Wi-Fi。开发者向云端 API 发起 HTTPS 请求 $\rightarrow$ 平台下发指令至特定设备 $\rightarrow$ 设备执行闭合/分断。从请求发出到执行，延迟通常在 80-120ms 之间。
本地定时机制：为了避免后端服务器维护复杂的 Cron 任务（定时任务），该设备指令支持倒计时或定时戳参数。下发一次指令即可让设备在指定时间后自动翻转状态，即使断网也能执行。

3. 开发准备

在开始编码前，需要准备以下三个关键凭证：

账户与设备：注册芯步平台，在控制台添加 “60A智能大功率断路器”，确保设备联网状态为“在线”。
获取 AppID / AppSecret：在平台“开发设置”中获取应用的唯一标识（AppID）和密钥（AppSecret）。
获取设备 ID：在设备列表页获取目标 60A 断路器的 Device ID（例如：820720）。

4. 接口签名算法详解

为了防止接口被恶意篡改，芯步采用了 双层 MD5 签名机制。所有控制请求必须携带动态生成的 sign 参数。

签名生成公式如下

Sign = MD5( MD5( AppSecret ) + ts )

字段说明

AppSecret：你的开发者密钥。
ts：Unix 时间戳（秒级），用于防止请求重放攻击。
+：字符串拼接。

代码示例逻辑

5. 实现远程定时通断的三种方案

针对不同的应用场景，我们可通过以下三种方式实现定时功能。

方案一：设备端倒计时（最稳定）

适用场景：简单的定时关闭，如充电桩限时充电 2 小时后断电。这种方式不需要开发者维护服务器定时任务。只需在请求的 order 参数中加入 reset 字段。

控制目标：立即闭合断路器，并在 1 小时后自动断开。
请求参数示例

效果：断路器瞬间响应闭合命令，1小时后自动跳闸断开。

方案二：云端轮询调度（最灵活）

适用场景：复杂的周期性调度（如每天 8:00 开，18:00 关）。需要在你的服务器上编写定时任务脚本，在特定时间点触发 HTTP 请求。

步骤 1：在你的服务器（Python/Node/Java）中设定 Cron 表达式。
步骤 2：到了指定时间，执行如下请求。
请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求 Body

方案三：批量控制与脉冲控制

适用场景：需要短暂触发（如按一下门禁开关，或控制电机点动）。60A 断路器同样支持“先通后断”或“先断后通”的脉冲指令。

脉冲控制示例：让断路器立即断开，并在 500 毫秒后自动重新闭合（相当于一次重启操作）。
指令

6. 实战：Python 全自动化脚本示例

以下是一个完整的 Python 脚本，展示了如何结合 schedule 库实现每日定时控制。

import requests
import hashlib
import time
import schedule

# 配置信息
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "820720"  # 替换为你的60A断路器ID

def control_breaker(power_status):
    """发送控制指令"""
    ts = str(int(time.time()))
    # 1. 计算签名 (Sign)
    md5_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign_str = md5_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 2. 构造 URL 和 Header
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    headers = {'Content-Type': 'application/json'}
    
    # 3. 构造 Body
    payload = {
        "device": DEVICE_ID,
        "order": {"power": power_status}
    }
    
    # 4. 发送请求
    response = requests.post(url, headers=headers, json=payload)
    print(f"[{time.ctime()}] 发送指令: {power_status}, 响应: {response.text}")

# 定时任务配置
if __name__ == "__main__":
    schedule.every().day.at("08:00").do(control_breaker, 1)  # 早上8点开启
    schedule.every().day.at("18:00").do(control_breaker, 0)  # 晚上6点关闭
    
    while True:
        schedule.run_pending()
        time.sleep(1)

7. 集成到现有系统的架构

针对企业级应用，采用以下架构以发挥 60A 断路器的最大效能：

私有化部署：该设备支持纯局域网通信，如果对数据安全要求比较高，可将服务部署在内网，请求地址改为局域网内映射的 API 地址。
数据可视化：由于该断路器具备计量版功能，调用 device/status 接口获取电压、电流、功率数据，结合 Grafana 或 ECharts 制作能耗看板。
联动逻辑：利用 Webhook 或 消息队列，当服务器检测到断路器过载跳闸事件时，自动发送邮件或企业微信机器人通知运维人员。

8. 常见问题与排障

签名错误 (401 Unauthorized)
- 检查时间戳 ts 是否为秒级（10位数字），而非毫秒级。
- 确认 MD5 结果为 32位小写 十六进制字符串。
设备离线
- 60A 断路器仅支持 2.4G Wi-Fi，请确认现场 Wi-Fi 频段及信号强度。
指令执行延迟高
- 若使用公网 API，延迟通常在 100ms 左右。若需要更快的响应（如极速联动），开启“局域网直连”模式，直接向设备局域网 IP 发送 HTTP 指令。

9. 总结

通过芯步提供的 HTTP 开放接口，开发者仅需掌握基础的 POST 请求与 MD5 加密，即可在数小时内完成 60A 智能限流断路器的二次开发。结合其内置的 reset 倒计时参数和云端调度框架，可以轻松、稳定地实现各种复杂的远程定时通断策略。