CATALOG

芯步的60A带计量智能空开(UNI-DLQ-M-60A-P)通过HTTP接口开放控制能力,对接的核心是:实时获取电流数据 → 与阈值比较 → 触发分闸指令。以下是完整技术方案。

一、 核心思路与原理

要实现“过流自动断电”,需要建立一个闭环控制系统。芯步的这款智能断路器具备实时电量计量(电流、电压、功率)和远程通断控制两大核心能力

  • 自动断电逻辑:您的服务器不断通过API轮询设备上报的电流值(或通过设备主动推送),一旦电流超过设定的阈值(例如60A的额定值或您设定的更低阈值如50A),服务器立即向设备下发“断开”指令。

  • 保护机制:为了避免由于电流瞬间波动(如电机启动)导致的频繁误动作,方案中必须加入去抖逻辑延时确认机制。

二、 准备工作

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

  1. 硬件设备:已配置并联网的 “智能大功率断路器[计量版]” (型号 UNI-DLQ-M-60A-P)。

  2. 平台账号:已注册芯步开发者账号,并在控制台获取了 AppIDAppSecret

  3. 设备ID:在控制台获取目标断路器的 Device ID(例如文档示例中的 820720

  4. 网络环境:服务器能公网访问 api.thingboot.com,或处于同一局域网(若使用私有化部署)。

三、 详细对接步骤

步骤 1:获取实时电流数据

要实现精准控制,首先要知道当前的负载情况。芯步的设备支持设备状态查询接口。您可以通过调用 设备状态拉取接口 获取实时电流。

对接任务设定一个定时任务(Cron Job),频率为 1-5秒/次,调用API获取设备的最新上报数据。解析返回的JSON包,提取其中的 current(电流)字段,单位通常是 A(安培)。

步骤 2:设定过流保护策略(算法逻辑)

单纯的阈值判断很容易误判。在您的业务逻辑层实现以下算法:

  • 阈值设置

    • 保护阈值:例如 60A(额定最大值)或 50A(用户自定义预警值)。

    • 恢复阈值:例如 55A(只有电流降到安全值以下,才允许远程合闸)。

  • 延时判定

    • 当检测到电流 ≥ 60A时,不立即跳闸,而是进入 “预警窗口”

    • 在随后的 3-5秒 内连续采样。

    • 如果每次采样电流都超标,则触发断电;如果只是瞬时尖峰(如电机启动),则自动复位计数器,不动作。

步骤 3:执行断电操作(下发控制指令)

一旦逻辑判定需要断电,立即调用设备控制接口

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方法:POST

  • 请求体 (JSON)

  • 签名计算:需严格按照文档规则计算 sign(MD5(MD5(AppSecret) + ts)),这是接口调用的安全凭证

步骤 4:告警与恢复机制

  • 告警推送:执行断电后,系统应通过短信、邮件或应用内通知告知运维人员:“设备ID [xxx] 因过流(实际值 XX A)已自动断电”。

  • 自动/手动复位

    • 自动重合闸:过流断电通常意味着电路故障,在故障未排除时自动重合闸(除非特定场景如大功率设备启停)。

    • 远程恢复:故障排除后,管理员可通过发送 {"power":1} 指令恢复供电。

四、 接口对接技术细节

以下是一个伪代码逻辑示例,展示如何集成上述逻辑:

五、 注意事项与优化

  1. 响应速度芯步的接口响应通常在 80-120ms 左右,加上网络延迟,从检测到过流到实际断电总耗时可能在 200-500ms。对于普通配电过载保护,这完全足够;如果是短路保护,请依赖设备本身的物理脱扣机构

  2. 设备保持连接这款断路器使用 Wi-Fi 2.4G 连接。请一定要确保现场WiFi信号强度良好,否则网络延迟或断连可能导致“发指令切不断”的情况

  3. 双向心跳机制不要完全依赖轮询。如果设备支持消息上报回调(Webhook),配置消息推送。设备每计量一次数据就推送到您的服务器,这比轮询更实时,也能减轻服务器压力。

  4. 多方控制协调您的系统在执行自动断电时,应同步更新本地数据库状态,避免用户在App端看到“在线”却无法开启(因处于保护锁定状态)。增加一个“保护锁定标志”,需人工介入解锁才能再次合闸。

六、 总结

通过对接芯步60A智能断路器的 HTTP API,您可以利用计量接口获取实时电流,配合延时算法逻辑,通过控制接口下发指令,快速实现过流自动断电功能。该系统架构简单,无需网关直连WiFi,非常适合快速集成到现有的智慧用电、机房监控或充电桩管理系统中