25A 断路器的“自定义联动”本质是：用传感器数据作为“因”，通过您的业务服务器判断，最终向断路器下发“通/断”指令作为“果”。以下方案基于芯步开放接口，详细拆解这一闭环的实现路径。

1. 解决概述

1.1 背景

在许多工业及商业场景中（如养殖场温控、机房热管理、工厂设备联锁），单纯的远程通断已无法满足需求。用户需要设备根据环境参数（温度、湿度、电流）或时间策略自动执行通断逻辑。

1.2 方案架构

本方案采用 “传感层 + 执行层 + 大脑层” 的架构：

• 传感层（触发器）：芯步系列传感器（温湿度、人体雷达、烟感）或 25A 断路器自身的电流/功率检测。

• 执行层：25A 智能断路器（型号：UNI-DLQ-25A）。

• 大脑层（自定义逻辑）：用户自建服务器 / 私有化部署。负责接收设备上报的实时数据，执行 if-then 逻辑判断，并调用 OpenAPI 下发指令。

1.3 涉及的核心能力

• 消息推送：设备状态实时上报至用户服务器。

• HTTP 接口：用户服务器向设备下发控制指令（通断、点动、锁死）。

2. 环境准备与接口基础

2.1 设备物模型定义

在进行开发前，需明确 25A 断路器的核心属性。依据官方手册，该设备物模型如下：

2.2 API 调用规范

芯步开放平台提供标准的 HTTP API 。

• 请求地址： http(s)://api.thingboot.com/{AppID}/device/control/

• 鉴权方式： sign (签名) + ts (时间戳)

• 请求示例（JSON POST） ：

  POST /your_app_id/device/control/?sign=xxx&ts=1702000000 HTTP/1.1 Content-Type: application/json { "device": "860304123456789", "order": { "power": 1, "extra": "CMD_001" } }

  注：extra 字段可用于携带业务订单号，便于异步回调匹配 。

3. 实现自定义联动逻辑

联动控制的核心在于 “消息的捕获”与 “指令的计算”。

3.1 数据获取方式

为了实现自定义逻辑，首先需要让服务器知道“当前发生了什么”。有两种主流方式：

方案 A：自建消息服务器（私有化/局域网）

• 配置：在芯步控制台配置第三方 MQTT 或 HTTP 回调地址。

• 流程：断路器状态变化（本地按键/过热跳闸/远程控制） $\rightarrow$ 平台推送消息 $\rightarrow$ 您的服务器接收。

• 场景：高实时性核心工业控制、数据不出厂的内部网络。

方案 B：主动轮询

• 配置：服务器定时调用查询接口获取设备状态。

• 流程：服务器定时任务（如每5秒） $\rightarrow$ 调用设备状态查询接口。

• 场景：对实时性要求不高的简单节能控制。

3.2 核心联动场景实现案例

第一种场景：过载预保护联动（基于功率逻辑）

业务需求：当检测到回路电流超过 20A（非短路，软过载）持续 10 秒，自动断开，并在 30 秒后尝试自动重合闸。

实现逻辑步骤

1. 数据获取：服务器接收设备推送的实时功率/电流数据（如果设备支持计量）。

2. 逻辑判断

   # 伪代码示例 if device.current > 20.0 and duration >= 10: call_api(action="power_off", device_id="DLQ_01") if device.power == "off" and off_time == 30: call_api(action="power_on", device_id="DLQ_01")

3. 指令下发：调用 {"power": 0} 执行断电。

第二种场景：环境温湿度联动（设备联锁）

业务需求：配电柜内温度 > 70℃ 时，强制断开负载并锁定，禁止远程合闸（直到温度恢复）。

前置条件：部署 芯步温湿度传感器。

实现逻辑

1. 触发：温湿度传感器上报 {"temperature": 72} 至服务器。

2. 策略执行

   • 向断路器下发 {"power": 0}。

   • 记录数据库状态 override_lock = True。

3. 联动恢复

   • 服务器收到温度传感器报文 {"temperature": 50}。

   • 解除锁定标志。

   • 自动合闸或等待人工确认。

第三种场景：定时 + 防呆机制

业务需求：每天晚上 22:00 自动断开路灯，但如果检测到设备电流依然 > 0.5A（接触器粘连），发出告警，并尝试 3 次强制断开（先通后断冲击）。

实现逻辑

1. 定时触发：服务器 Cron 任务触发联动逻辑。

2. 执行：下发 {"power": 0}。

3. 校验

   • 查询设备状态 power 是否变为 0。

   • 若有源设备电流反馈依然高，判定为故障。

4. 高级指令：下发 {"point": "1000"}（先通后断，间隔1000毫秒），尝试利用电流冲击震开粘连的接触器。

4. 关键高级配置与优化

4.1 利用设备本身的“自定义联动”

说明：对于简单的“传感器 $\rightarrow$ 断路器”逻辑，如果设备支持云端联动规则，可直接在控制台配置，无需编写代码 。

• 优点：零延迟，不依赖服务器。

• 局限性：仅支持简单的“如果 A 高于阈值，则 B 动作”，复杂的时序逻辑仍需 API。

4.2 私有化部署（MQTT 直连）

对于高安全场景，25A 断路器支持跳过芯步公有云，直连您的私有 MQTT Broker 。

• 配置：通过配网模式，将设备服务器地址指向您的内部 MQTT 服务器地址。

• 优势：全部数据留存在内网，指令响应控制在毫秒级。

4.3 指令重试与事务机制

由于网络波动可能导致指令丢失，需在代码中建立重试机制：

• 策略：下发 control 指令后，调用状态查询接口确认。

• 超时处理：若 5 秒内未执行，利用 extra 字段做调用机制处理（防止重复执行），再次下发。

5. 实施流程

1. 设备入网：参照手册，通过 SmartConfig 或 AP 配网，将 25A 断路器连接至互联网/WiFi。

2. 平台注册：在芯步开放平台注册开发者账号，获取 AppID 与 AppSecret，添加设备实例。

3. 环境配置

   • 公有云方案：准备一台公网服务器部署您的逻辑代码。

   • 私有化方案：搭建 MQTT Broker 服务。

4. 逻辑编码

   • 实现签名算法（MD5 或指定加密方式）。

   • 编写 if-else 逻辑处理函数。

   • 对接设备上下线 Webhook，保证设备离线时不积压无效指令。

5. 测试验证

   • 使用 Postman 模拟传感器数据回调。

   • 观察断路器是否按预期通断。

6. 投产：部署服务，监控日志。

6. 总结

通过 “设备上报 $\rightarrow$ 业务逻辑判断 $\rightarrow$ API 指令控制” 的闭环，芯步 25A 断路器可以无缝融入任何现有的监控或自动化系统。

开发者无需掌握嵌入式硬件知识，仅利用 HTTP/MQTT 协议，即可实现对大功率负载（5000W）的逻辑化、智能化控制。无论是构建边缘计算网关还是大型 SaaS 能源管理平台，其开放的接口体系均能提供稳定支撑。