芯步的智能通断器系列开放HTTP API接口，支持二次开发接入电量监测与保护逻辑。以下方案以60A带计量设备为例，说明如何通过接口轮询电压数据并实现过压欠压的自动保护控制。

1. 背景与需求分析

在工业自动化、基站动环监控、智慧用电等场景中，大功率设备（60A）对供电电压的稳定性要求比较高。

• 过压风险：电压过高会直接烧毁开关电源、电机绕组，甚至引发火灾。

• 欠压风险：电压过低导致电流增大，电机或压缩机发热损毁，甚至无法启动。

• 核心需求：利用芯步带电量计量功能的60A智能硬件，实时监测电压数据，当电压越限时自动执行断开保护，恢复后自动重合闸。

2. 硬件选型

针对60A大电流的应用场景（如空调、充电桩、大型设备），选用芯步 “60A智能通断器/计量器” 系列。

该系列硬件具备以下关键特性：

• 大功率承载：支持60A额定电流，阻性负载可直接控制。

• 精准计量：集成计量芯片，可实时高精度采集电压、电流、功率、电能数据。

• 本地主动保护（关键）：部分设备支持固件级保护阈值设置，这是实现毫秒级保护的基础；若设备不支持，则需依赖云端逻辑（秒级响应）。

• 开放接口：全面开放HTTP API，支持第三方服务器查询状态与控制通断。

3. 技术设计

为确保保护的实时性与可靠性，采用 “边缘主动防御 + 云端策略辅助” 的双重架构，而非完全依赖云端轮询。

3.1 系统拓扑

1. 感知层：60A智能断路器/通断器，安装在设备前端。

2. 传输层：通过WiFi/4G将数据上报至芯步云，或通过局域网API直连本地服务器。

3. 处理层

   • 本地服务器/网关：高频轮询设备电压值，或接收设备主动推送的实时数据。

   • 物联网后台：配置自动化联动规则（如：电压>275V -> 执行断开）。

4. 执行层：调用API下发断电指令，或通过设备内部逻辑自主跳闸。

3.2 数据流向

60A计量设备 -> 采集电压(如240V) -> 上报芯步云/直达本地服务器 -> 逻辑判断(是否超限) -> 触发API命令 -> 设备执行断开 -> 告警推送

4. 开发接入步骤

4.1 基础对接准备

在芯步开发者平台完成以下操作：

1. 获取凭证：获取 AppID 和 AppSecret，用于API鉴权。

2. 设备上线：对60A设备进行配网，确保其在控制台显示为“在线”状态，并记录唯一的 Device ID。

3. 接口测试：调用 device/control/ 接口，测试能否正常控制 {"power":0} 和 {"power":1}。

4.2 数据采集接口（获取电压）

系统需要获取当前的实时电压值。根据芯步的接口规范，需要通过查询设备状态接口获取。

• 请求地址https://api.thingboot.com/{AppId}/device/query/

• 核心参数：传入 Device ID。

• 返回解析：在返回的 data 字段中，寻找电压参数，通常标准字段为 voltage 或 v（单位：V，保留1位小数）。

• 轮询策略：设置 500ms - 1000ms 的轮询间隔。间隔太短会触发API限流，太长则保护不及时。

4.3 保护执行接口（控制通断）

一旦监测到电压越限，需立即执行保护动作。

• 请求地址https://api.thingboot.com/{AppId}/device/control/

• 签名算法：采用 md5(md5(AppSecret) + ts) 方式加密，确保接口安全。

• 执行命令

  • 分闸（保护）{"power":0} （关闭输出）

  • 合闸（复位）{"power":1} （开启输出）

5. 过压欠压保护逻辑实现（代码逻辑设计）

在实际开发中，在您的服务器或本地网关中运行如下监控逻辑：

5.1 判定阈值设定（以220V标准为例）

• 过压保护（OVP）：电压 $≥ 265V$（可调），持续 $2$ 秒。

• 欠压保护（UVP）：电压 $≤ 160V$（可调），持续 $2$ 秒。

• 恢复回差：电压回落至 $235V$ 以下且稳定 $5$ 秒，或回升至 $190V$ 以上，才允许合闸。

5.2 状态机控制逻辑

1. 初始化：标记 Protection_Flag = False。

2. 数据清洗：读取电压值，过滤掉突变的毛刺数据（如瞬时跌落到0的无效数据）。

3. 越限判断

   • 触发：如果 voltage >= OVP_Threshold 或 voltage <= UVP_Threshold，且标志位为 False，计数器 +1。

   • 确认：当连续检测到越限次数达到设定值（如连续3次/3秒），则判定为真实故障。

   • 动作：调用 control API 下发 {"power":0} 断开电路。

   • 告警：记录跳闸原因（过压/欠压），并通过短信、webhook或应用推送通知运维人员。

4. 闭锁与恢复

   • 切断后停止执行合闸指令。

   • 持续监测电压，若电压持续在安全区间 $X$ 分钟，自动尝试调用 {"power":1} 恢复供电。

5.3 示例伪代码

6. 技术细节与优化

6.1 签名生成（以Python为例）

每次调用API都需要动态生成签名，这是接入的关键步骤

6.2 局域网直连（低延迟方案）

如果您的服务器与设备在同一局域网（如工厂车间），优先使用局域网API。

• 优势：延迟从公网的 80-120ms 降低至 10ms 以内，摆脱公网波动。

• 方法：获取设备本地IP，直接 POST http://[device_ip]/control/，同样支持JSON命令格式。

6.3 定时自复位与通讯失败处理

• 自动重合闸：欠压通常是电网波动，电压恢复后应自动合闸。可编写脚本，在保护动作后每隔5分钟查询一次电压，正常则发命令合闸。

• 断网防御：若因网络故障导致无法下发API指令，60A设备自身的过欠压脱扣器（物理特性）将作为最后一道防线，在电压异常比较高时物理熔断或跳闸。

7. 总结

通过接入芯步60A带计量设备的开放接口，开发者可以快速构建一套高精度的电压保护系统。

该方案的核心在于：

1. 数据采集：利用计量接口高频获取电压数据。

2. 逻辑闭环：通过对电压数据的阈值判断，结合 device/control 接口，形成“监测-判断-执行”的自动化闭环。

3. 安全冗余：结合软件逻辑保护与硬件物理保护，确保60A大电流负载在过压、欠压工况下的绝对安全。

该方案不仅适用于单一的60A设备保护，亦可横向扩展至整个配电箱的智能化管理。