芯步40A带计量断路器的开放接口基于HTTP协议，签名认证机制清晰，下行控制延迟约80-120ms。以下方案聚焦如何利用这些接口实现漏电保护的二次开发——核心思路是通过“电力参数轮询+阈值判定+断路指令”形成闭环控制，同时补充了定时自恢复和手动优先等工程细节。

1. 项目概述与目标

在许多商业和工业场景（如充电桩、数据中心、大型设备、民宿总闸）中，传统的漏电保护器只能在物理层面跳闸，无法实现远程监测、自动复位或数据记录。

本方案的目标是利用芯步 40A 带计量物联网断路器 的开放 API 接口，通过二次开发实现以下核心目标：

• 实时监测：实时读取线路电压、电流、功率及漏电状态。

• 智能跳闸：当检测到剩余电流（漏电流）超过阈值（如30mA）时，系统自动触发断路指令。

• 告警与记录：将漏电事件实时推送至管理人员微信、短信或第三方运维平台。

• 远程恢复：在故障排除后，支持远程或自动延时重合闸。

2. 硬件选型与接口特性

根据芯步产品库，二次开发应选用 智能大功率断路器[计量版] （型号：UNI-DLQ-M-40A-P） 或 计量数显版。

关键特性分析：

• 电气参数：额定电流 40A，适用于 8000W 以下负载。

• 通信方式：WiFi 2.4G 直连（无需网关）。

• 开放协议HTTP/HTTPS 接口。

  • 支持公网控制，也支持局域网/私有化部署。

  • 签名认证方式：sign = md5(md5(AppSecret) + ts)。

• 计量能力：具备功率计量功能，这是实现漏电逻辑判断的数据基础 。

3. 整体设计

为了实现对漏电的快速响应，推荐采用 “边缘轮询 + 云端决策” 的混合架构。

• 设备层：40A 断路器实时采集电压（V）、电流（I）、功率（P）。注意：断路器本身可能不自带“剩余电流”互感器，漏电保护逻辑通常依赖电流的瞬间突变率（矢量差）或外接漏电模块，但本方案利用开放接口，通过算法（监测电流失衡或通过专业剩余电流传感器二次接入）来实现。

• 业务层

  • API Server：通过定时任务轮询设备状态。

  • Rule Engine：计算实时漏电流估值。

  • Command Executor：执行分/合闸指令。

• 应用层：可视化大屏、App、钉钉/微信告警。

4. 核心开发步骤：实现漏电保护控制

4.1 接口对接与环境配置

首先需在芯步控制台获取凭证，并完成设备配网。

• 获取凭证：AppID 和 AppSecret。

• 签名算法：所有请求需携带 sign 和 ts。

  • Step 1: str1 = md5(AppSecret)

  • Step 2: str2 = md5(str1 + ts)

  • URL Example: http(s)://api.thingboot.com/{AppId}/device/control/?sign={str2}&ts={ts}

• 设备ID：获取目标设备的唯一标识符（Device ID）。

4.2 “漏电”逻辑的软件定义（算法核心）

由于标准的 HTTP 接口通常直接下发通断指令，要实现“漏电保护”，开发者需要利用 计量接口 的数据进行计算。方案 A：基于零序电流估算（推荐）如果断路器支持读取火线电流和零线电流，漏电流 = |I火| - |I零|。如果仅支持总功率和电压：我们可以通过监测电流的微秒级突变来判断：

• 设定正常负载变化范围。

• 如果监测到电流在 50ms 内飙升超过 20A 且立即归零（电弧特征），或持续出现微小差值（>30mA），即判定为漏电。

4.3 轮询与检测模块开发

由于 HTTP 是请求-响应模式，无法实时推送，需编写脚本轮询计量数据。

• 实现逻辑

  1. 调用 获取设备状态接口。

  2. 解析返回的 JSON 数据，提取 Current（电流）和 Power（功率）。

  3. 应用 PID 算法或阈值比较：

     # 示例伪代码 if device['leakage_current'] > 0.03: # 漏电>30mA trigger_protection(device.id) send_alert("检测到漏电，已跳闸")

  4. 性能指标：官方数据显示命令响应时间为 80-120ms，加上网络轮询开销，轮询间隔设为 500ms - 1s，可在 1 秒内完成从检测到跳闸的闭环 。

4.4 执行断开与锁定控制

一旦检测到漏电，系统需立即下发断开命令。

• API 指令

  • 接口地址：https://api.thingboot.com/{AppId}/device/control/

  • 请求体 (JSON)：

    { "device": "设备ID", "order": {"power": 0} // 0代表断开 }

  • 安全策略：在数据库中设置 LockStatus 字段。一旦因漏电跳闸，拒绝任何远程合闸指令，直到人工现场确认并软件复位，符合安全规范。

4.5 状态同步与告警

利用芯步的开放能力，将断路器的状态同步至企业内部系统。

• 数据流转：通过 Webhook 或 定时拉取，将断开事件发送至 Kafka 或 MQTT Broker。

• 通知示例：触发 SMTP 邮件或 企业微信机器人。

5. 进阶功能：自动重合闸与定时测试

为了保证供电连续性（特别是临时性漏电情况），可开发自动重合闸逻辑

1. 跳闸瞬间：记录当前漏电值与时间戳。

2. 等待间隔：延迟 1-2 秒（等待电弧熄灭）。

3. 尝试合闸：发送 {"power": 1} 指令。

4. 再次检测：合闸后 500ms 再次读取计量数据。

   • 若漏电消失（如只是闪电干扰），系统恢复正常。

   • 若漏电依旧，立即再次跳闸，并标记“永久性故障”，禁止自动恢复。

5. 漏电自检：利用 API 的定时任务，每月定期执行一次漏电模拟测试，验证保护功能完好。

6. 部署与运维

• 私有化部署：若涉及工业核心机密或电力数据敏感，开启芯步支持的私有化部署模式，将 API 请求指向局域网内的自建服务器，实现纯内网控制，降低公网延迟 。

• 看门狗机制：确保后台服务（轮询程序）必须 7x24 小时运行。使用 Supervisor 或 K8s 守护脚本，防止进程崩溃导致漏电监控失效。

• 备用控制：由于物联网依赖网络，二次开发时必须保留断路器的本地物理按钮功能（通常支持自定义或屏蔽，保留物理急停功能），代码层面需支持断网下的本地逻辑 。

7. 总结

通过对芯步 40A 断路器的二次开发，开发者不再局限于简单的远程开关，而是可以利用其 开放的 HTTP 接口 和 计量数据流，构建一套符合 IEC 标准的 软件定义漏电保护系统。该系统不仅实现了毫秒级（百毫秒级）的漏电感知与分断，还融合了数据可视化和自动运维能力，极大提升了电气安全管理水平。