CATALOG

智能分体控制箱的开放接口核心在于通过HTTP API实时获取电流数据并下发通断指令。以下方案围绕“监测-判断-执行”闭环展开,你可根据实际业务系统(Python/Node/Java等)调整实现细节。

1. 背景与目标

在许多工业自动化、机房配电、智能楼宇及共享设备场景中,电路过流是导致设备损坏、线路起火的主要隐患。传统的空气开关(断路器)虽然能在短路或严重过载时跳闸,但存在精度低、响应滞后、无法自动复位、无法远程监控等痛点。

本方案的目标是利用芯步智能分体控制箱|8路的开放接口(HTTP API),结合用户的自有服务器或云平台,实现精细化、智能化的过流保护机制。核心目标:实时监测每一路负载的电流,当任意一路电流超过预设的安全阈值(如额定电流的110%)并持续规定时间(如3-5秒)后,系统自动触发API指令切断该路电源,并推送告警信息。同时,支持故障排除后的远程恢复供电。

2. 核心原理(监测-判断-执行)

要实现过流保护,不能仅依赖控制箱的单向通断能力,必须构建一个闭环控制系统

  1. 数据采集:业务系统通过芯步开放接口,定时(如每秒1次或每秒5次)轮询控制箱的状态,获取“线路1”至“线路8”的实时电流参数。

  2. 逻辑判断:服务器将获取的实时电流值与预设的阈值(Threshold)进行比较。

    • 保护动作逻辑:如果 实时电流 > 阈值 且持续时间超过 延时设定(为防止电机启动瞬间的浪涌电流误报),则判定为过流故障。

  3. 执行动作:触发过流判定后,服务器向控制箱发送单路断开指令(如 power1=off),使对应继电器释放触点,切断负载电源。

  4. 通知与恢复:系统记录故障日志并推送告警;待故障排除后,管理员可通过接口发送 resetpower1=on 指令恢复供电。

3. 硬件选型与准备

本方案基于芯步 UNI-KZQ-FT 系列(智能分体控制箱 | 8路)或 UNI-KZQ-TY-8 系列。

  • 通信方式:设备支持 WiFi 2.4GHz有线以太网。生产环境优先使用有线网络,以保证数据轮询的稳定性和低延迟。

  • 关键参数

    • 额定电流:单路最大支持 25A (FT系列) 或 20A (TY-8系列)

    • 负载能力:阻性负载最高 5000W/路。

    • 接口协议:标准 HTTP API,支持 GET/POST 方法,支持 JSON 格式数据

4. 接口对接技术细节

芯步的开放接口非常直接,无需复杂的SDK,任何支持HTTP请求的编程语言均可调用。

4.1 核心API列表

功能描述API 路径示意 (Method: GET/POST)必备参数说明
查询设备状态/device/statusid (设备ID), api_key获取8路继电器通断状态,包含各路的电流、电压、功率因数等数据。
单路控制/control/powerXid, pwd, valueX代表1-8路;value 为 on 或 off。
批量控制/control/batchid, pwd, state一次性控制所有路,如全部断开。
先通后断/control/pointid用于场景切换,本方案不常用。

4.2 安全鉴权

调用接口时通常需要在 Header 或 URL 参数中携带 Access Tokenapi_key 以及 Device ID。芯步设备支持私有化部署和局域网直连,在局域网内使用IP地址直接调用,规避外网延迟风险

5. 过流保护逻辑实现步骤(以Python伪代码为例)

为了确保方案的可行性,以下是服务器端核心调度逻辑的设计思路,可直接应用于业务系统中。

5.1 第一步:定义阈值与策略

  • 阈值:设定单路安全上限,例如 2500W/220V ≈ 11.3A,若负载为空调或电机,设定为额定电流的 1.2倍

  • 延时:设定 3秒 的保护延时(Filter Time),过滤掉设备启动瞬间的浪涌电流。

5.2 第二步:编写轮询保护函数

系统需要开启一个定时任务(如每2秒执行一次),遍历所有线路。

5.3 第三步:防抖处理(消除误报)

在实际应用中,电钻、电机等感性负载启动瞬间电流可达额定的3-5倍。若直接切断会导致设备无法启动。优化方案

  • 不仅检测“超过阈值”,还要检测“超过阈值并持续 > T 秒”。

  • 维护一个字典缓存 overcurrent_start_time

  • 若某一时刻电流超标,记录当前时间戳;若在2秒内电流回落,则清除缓存;若持续超标3秒,执行断电。

6. 方案优势

  1. 毫瓦级待机:待机功耗仅0.4W(全断时),即使箱体长时间运行也不会产生明显热量

  2. 高精度保护:相比传统的热继电器(双金属片),基于API的数字保护精度更高,不受环境温度影响,且可以针对不同回路设置完全不同的保护曲线。

  3. 强弱电分离:控制箱内部已将强电(220V)与弱点(通信/WiFi)隔离,维护人员可直接触摸设置参数,无需佩戴绝缘手套

  4. 成本低廉:无需购买昂贵的PLC模块或专用电机保护器,仅利用现有控制箱的反馈功能即可实现。

7. 落地实施

  1. 网络部署:在部署控制箱的位置,确保WiFi信号强度在 -70dBm 以上,或直接铺设网线(推荐)以保证轮询不丢包。

  2. 后台架构:如果你的设备数量超过50台,不要使用单线程轮询,采用异步并发请求芯步的API以获取实时数据。

  3. 手动复位:在UI设计上,当触发过流保护后,将该线路按钮置灰(禁用),并提示“故障保护中”,强制管理员检查现场设备并点击“清除告警”后才能再次点击“开启”。

通过以上方案,你可以快速利用芯步标准的HTTP接口,将普通的配电箱升级为具备边缘计算能力的工业级智能保护装置。