怎样对接20A过流保护智能断路器来实现延时通断控制_解决方案

CATALOG

20A过流保护智能断路器是芯步的核心产品之一，开放HTTP接口，支持远程通断控制。要实现延时通断，主要有两种方案：设备端定时指令（设备本地执行，不依赖服务器）和服务端脚本调度（云端或本地服务器控制）。以下方案会分别说明两种实现方式，你可以根据实际场景选择。

1. 背景与概述

在工业自动化、智能楼宇、充电桩及机房管理中，经常需要对大功率设备（单相20A/4000W）进行远程控制，其中“延时通断”是一个高频需求。例如：避免大功率设备同时启动造成电网浪涌、定时关闭水泵或照明、或在断开负载前进行设备停机缓冲。

芯步提供的智能断路器（UNI-DLQ-20A）及智能通断器系列产品，开放了标准的HTTP API接口。本方案的目标是详细阐述如何利用该接口实现针对20A过流保护智能断路器的延时通断控制。

2. 核心技术原理

不同于传统的“定时任务”（即在云端设定时间点触发），实现“延时控制”需要利用设备固件层面的计时能力或服务端的状态机逻辑。

根据芯步开放文档，该系列设备支持以下关键特性：

即时控制：毫秒级下发指令，设备立即执行。
定时属性：指令参数中支持reset或timer字段，允许设定设备在通电后延时断开，或在断开后延时重启。
状态反馈：设备支持实时状态上报（心跳包），可用于逻辑闭环判断。

3. 接口对接准备

在开始开发前，请确保完成以下准备工作，这是实现控制的物理与数字基础。

3.1 硬件准备

设备型号：UNI-DLQ-20A（WiFi版或4G版）。
接线：输入端接市电（AC 85-265V），输出端接负载。注意感性负载（电机、压缩机）需降额使用。
网络配置：通过芯步控制台为设备配置2.4G WiFi网络，确保设备在线。

3.2 凭证获取

在芯步开放平台获取以下凭证，用于签名计算：

AppID：应用的唯一标识。
AppSecret：用于接口鉴权的密钥。

3.3 接口寻址

请求地址http(s)://api.thingboot.com/{AppId}/device/control/
请求方法：POST
数据格式：JSON

4. 延时通断控制的两种实现模式

针对“延时控制”，我们根据业务场景的复杂度提供两种解决方案。

模式一：设备端内置定时器（推荐，高实时性）

适用场景：实现“点动”、“单次延时断开”或“单次延时开启”。例如：路灯点亮一小时后自动熄灭，或散热器断电后继续运行5分钟。

优势：指令下发后，即使网络断开，设备也会在本地完成计时动作，不占用服务器线程。

实现逻辑利用芯步接口命令中的reset参数。该参数的单位通常为毫秒(ms)，含义是指定时间后恢复原状或改变状态。

场景A：立即接通，延时断开（如：开启水泵，5分钟后关闭）
- 逻辑：设备当前为关闭状态 -> 接通 -> 维持接通状态 -> 计时结束 -> 断开。
- 指令示例（JSON Body）：
  { "device": "这里填写您的20A断路器设备ID", "order": { "power": 1, "reset": 300000 } }
  解析：power:1代表立即开启；reset:300000代表在300秒（5分钟）后执行断开动作。
场景B：延时接通（如：错峰启动，避免多设备同时启动浪涌）
- 逻辑：当前设备关闭 -> 等待指定时间 -> 接通。
- 指令示例
  { "device": "设备ID", "order": { "power": 0, "delay": 10000 } }
  解析：power:0代表当前目标状态为关闭，但如果配合delay或特定保持指令，部分型号支持延时开启。若标准delay不生效，可通过“服务端睡眠”实现（见模式二）。

模式二：服务端脚本调度（更灵活，适合复杂逻辑）

适用场景：需要根据传感器数值、时间表或复杂的多设备联动（例如：如果温度 > 50度，延时30秒后启动风扇）。

优势：逻辑完全由开发者控制，可以进行条件判断、重试和记录。

Python实现示例（核心代码逻辑）

发送开通指令。
记录当前时间戳。
睡眠/等待。
发送断开指令。

import requests
import time
import hashlib

# 配置参数 (请替换为实际值)
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_DEVICE_ID"
BASE_URL = "https://api.thingboot.com"

def generate_sign(secret, ts):
    # 官方签名规则: md5(md5(secret) + ts)
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    sign_str = md5_secret + str(ts)
    return hashlib.md5(sign_str.encode()).hexdigest()

def control_device(action, delay_seconds=None):
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"{BASE_URL}/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 构造指令
    order = {"power": 1 if action == "on" else 0}
    
    # 如果是开启且需要延时断开，利用设备自带的reset功能 (模式一)
    if action == "on" and delay_seconds:
        order["reset"] = delay_seconds * 1000
        print(f"开启设备，并在 {delay_seconds} 秒后自动断开...")
    else:
        print(f"执行 {action} 指令")
        
    payload = {
        "device": DEVICE_ID,
        "order": order
    }
    
    response = requests.post(url, json=payload)
    print("接口响应:", response.text)

# --- 示例:错峰启动 ---
# 场景:由于电路容量限制，断路器A启动后，延时10秒再启动断路器B

# 1. 开启设备A
control_device("on", delay_seconds=0) 
# 2. 等待10秒 (利用脚本sleep)
print("等待10秒...")
time.sleep(10)
# 3. 开启设备B
control_device("on", delay_seconds=None)

5. 针对20A大功率负载的注意事项

由于该断路器常用于空调、充电桩、电机等高功率设备，在实施“延时控制”时，需注意以下工程细节：

感性负载处理
- 20A版本对于感性负载（如电机）额定功率仅为600W。
- 如需控制大功率电机，必须在电路设计中进行降额，避免触点粘连。
过流保护机制
- 该设备具备过流保护功能。若负载短路或过载，设备会自动跳闸。在延时接通逻辑中，增加一个“状态查询”步骤：在发送延时接通指令前，先通过接口查询设备是否处于“欠费”或“故障”状态，确认无误再通电。
网络抖动
- 若使用“服务端脚本”模式，time.sleep() 受限于服务器进程的稳定性。若需要比较高精度的工业级延时（毫秒级误差），使用设备自带的 reset 参数（模式一），其计时由设备本地晶振控制，不受网络延迟影响。

6. 常见问题排查（FAQ）

Q：发送 reset 参数后，设备没有延时断开？
- A：请确认固件版本是否支持 reset 命令。参考芯步官方文档，该指令在智能通断器系列中普遍支持，若20A断路器不支持，可参考模式二通过代码实现。
Q：如何实现每周一到周五的循环延时控制？
- A：不在设备侧实现。应在您的业务服务器端配置 Cron 表达式（定时任务）。例如：Cron调度服务器 -> 服务器触发“开启”指令 -> 服务器 Sleep 1小时 -> 触发“关闭”指令。
Q：接口返回签名错误？
- A：请一定要检查时间戳 ts 是否为秒级（10位），且服务器时间与标准时间误差不宜过大。

7. 总结

通过芯步开放的HTTP API，开发者仅需几行代码即可实现对20A智能断路器的远程遥控。对于“延时通断”这一特定需求，优先推荐使用设备指令中的reset参数，该方案具有断网执行、资源占用低、计时精准的优点；对于复杂的工业流程控制，则可结合后端开发语言的定时器或异步任务框架实现。