CATALOG

芯步的25A智能断路器通过开放的HTTP接口,可以灵活集成到各类软件系统中。要实现定时通断控制,核心思路是在服务端维护定时任务,到时间点调用设备的通断电指令即可。以下方案涵盖接口对接、定时任务设计和服务端实现三个关键环节。

1. 解决概述

1.1 方案目标

通过调用芯步开放接口,实现对 25A智能断路器(型号:UNI-DLQ-25A) 的定时控制(如:定时开关、循环通断),用于路灯控制、农业灌溉、园区设备定时巡检等场景。

1.2 技术原理

芯步的智能断路器通过 WiFi(2.4GHz) 直连路由器联网,无需网关。设备开放标准的 HTTP/HTTPS API定时控制流程:您的业务服务器通过 定时任务(如 Cron Job),在指定时间向设备下发通断指令。

1.3 适用场景

  • 园区路灯按需照明(如:18:00 开,06:00 关)。

  • 农业自动灌溉(如:每日 08:00 开阀,08:30 关阀)。

  • 广告牌/灯箱定时亮灭。

2. 准备工作

在开始开发前,请确认具备以下条件:

  1. 硬件设备:已购买并安装 UNI-DLQ-25A 智能断路器,并确保其所处位置有稳定的 2.4G WiFi 信号。设备需通过官方 App(如“芯步”)或配网流程完成网络配置。

  2. 开发者账号:注册芯步开发者账号,获取 Access Key / Secret Key 用于接口鉴权。

  3. 设备 ID:在管理后台或通过接口查询获取目标断路器的唯一标识符(Device ID)。

  4. 开发环境:任意支持 HTTP 请求的编程语言(如 Python, Java, Node.js, Go, PHP, C# 等)

3. 核心 API 接口详解

以下是实现控制所需的核心接口逻辑,签名算法和具体 URL 请参考官方最新文档。

3.1 认证方式

所有接口请求需携带签名(Signature)。一般计算规则如下(伪代码):

3.2 核心控制接口

  • 功能:下发合闸(开)/ 分闸(关)。

  • 请求方式:POST / GET

  • 关键参数

    • device_id: 设备ID。

    • switch: on (开启) / off (关闭)。

    • signature: 认证签名。

  • 功能:查询设备当前状态。

  • 用途:在执行定时任务前,可先查询状态,避免重复下发。

4. 详细实施方案:定时控制

为了实现精准的定时控制,我们需要通过 “第三方服务端逻辑” 来驱动接口调用。

4.1 设计

推荐使用 “中心化调度” 模式:

  • 优点:日志全、易维护、不受设备掉线影响(任务由服务器执行,服务器会在设备重连后立即指令)。

  • 缺点:依赖外部网络。

4.2 数据库设计(定时任务表)

在您的业务数据库中建立 device_timing_tasks 表,用于存储规则:

4.3 服务端调度实现步骤

步骤 1:环境配置在服务器配置文件中写入固定参数:

步骤 2:封装控制函数编写一个通用的函数,用于向设备发送指令:

步骤 3:定时任务执行逻辑编写一个调度核心,每分钟扫描一次数据库,检查哪些任务需要执行。

4.4 进阶应用:循环通断(如:工作 5 分钟,休息 10 分钟)

由于断路器标准 API 是一次性指令,实现循环需要在应用层进行计算

  1. 设定一个 “运行模式” 标志。

  2. 示例:如果需要设备“开 10 秒,关 20 秒”循环 3 次。

  3. 在服务器层使用 TimerDelay Queue

    • T+0s:调用 control_breaker(device, "on")

    • T+10s:调用 control_breaker(device, "off")

    • T+30s:再次重复上述逻辑。

5. 错误处理与最佳实践

5.1 重试机制

断路器可能因 WiFi 信号问题瞬时掉线。当调用接口返回 TimeoutDevice Offline 时,请勿只执行一次。

  • 策略:若失败,间隔 5 秒、10 秒、30 秒进行重试,最多重试 3 次。

5.2 时钟同步

定时任务强烈依赖时间准确性。

  • 方案:确保运行定时调度代码的服务器(或云函数)已开启 NTP 自动对时,保持与标准时间一致。

5.3 日志审计

记录每一次控制请求的完整日志(请求参数、返回结果、IP),便于排查“为什么灯没关”的问题。

6. 总结

  1. 无需网关:25A 断路器直接走 WiFi,降低硬件成本和故障点

  2. 接口友好:标准 HTTP 协议,支持 PHP、Java、Python、Go 等各种后端语言

  3. 灵活扩展:您可以任意组合定时规则,实现传统物理定时开关无法做到的“节假日跳过”、“随机定时(防贼)”等高级逻辑。

  4. 高负载能力:单台云服务器即可通过并发请求管理成千上万台设备。

通过以上方案,您可以快速将芯步的智能断路器集成到您的业务系统中,实现高精度的定时通断管理。