智能分体控制箱的开放接口核心在于通过HTTP API实时获取电流数据并下发通断指令。以下方案围绕“监测-判断-执行”闭环展开,你可根据实际业务系统(Python/Node/Java等)调整实现细节。
1. 背景与目标
在许多工业自动化、机房配电、智能楼宇及共享设备场景中,电路过流是导致设备损坏、线路起火的主要隐患。传统的空气开关(断路器)虽然能在短路或严重过载时跳闸,但存在精度低、响应滞后、无法自动复位、无法远程监控等痛点。
本方案的目标是利用芯步智能分体控制箱|8路的开放接口(HTTP API),结合用户的自有服务器或云平台,实现精细化、智能化的过流保护机制。核心目标:实时监测每一路负载的电流,当任意一路电流超过预设的安全阈值(如额定电流的110%)并持续规定时间(如3-5秒)后,系统自动触发API指令切断该路电源,并推送告警信息。同时,支持故障排除后的远程恢复供电。
2. 核心原理(监测-判断-执行)
要实现过流保护,不能仅依赖控制箱的单向通断能力,必须构建一个闭环控制系统。
数据采集:业务系统通过芯步开放接口,定时(如每秒1次或每秒5次)轮询控制箱的状态,获取“线路1”至“线路8”的实时电流参数。
逻辑判断:服务器将获取的实时电流值与预设的阈值(Threshold)进行比较。
保护动作逻辑:如果
实时电流 > 阈值且持续时间超过延时设定(为防止电机启动瞬间的浪涌电流误报),则判定为过流故障。
执行动作:触发过流判定后,服务器向控制箱发送单路断开指令(如
power1=off),使对应继电器释放触点,切断负载电源。通知与恢复:系统记录故障日志并推送告警;待故障排除后,管理员可通过接口发送
reset或power1=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/status | id (设备ID), api_key | 获取8路继电器通断状态,包含各路的电流、电压、功率因数等数据。 |
| 单路控制 | /control/powerX | id, pwd, value | X代表1-8路;value 为 on 或 off。 |
| 批量控制 | /control/batch | id, pwd, state | 一次性控制所有路,如全部断开。 |
| 先通后断 | /control/point | id | 用于场景切换,本方案不常用。 |
4.2 安全鉴权
调用接口时通常需要在 Header 或 URL 参数中携带 Access Token 或 api_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. 方案优势
毫瓦级待机:待机功耗仅0.4W(全断时),即使箱体长时间运行也不会产生明显热量。
高精度保护:相比传统的热继电器(双金属片),基于API的数字保护精度更高,不受环境温度影响,且可以针对不同回路设置完全不同的保护曲线。
强弱电分离:控制箱内部已将强电(220V)与弱点(通信/WiFi)隔离,维护人员可直接触摸设置参数,无需佩戴绝缘手套。
成本低廉:无需购买昂贵的PLC模块或专用电机保护器,仅利用现有控制箱的反馈功能即可实现。
7. 落地实施
网络部署:在部署控制箱的位置,确保WiFi信号强度在 -70dBm 以上,或直接铺设网线(推荐)以保证轮询不丢包。
后台架构:如果你的设备数量超过50台,不要使用单线程轮询,采用异步并发请求芯步的API以获取实时数据。
手动复位:在UI设计上,当触发过流保护后,将该线路按钮置灰(禁用),并提示“故障保护中”,强制管理员检查现场设备并点击“清除告警”后才能再次点击“开启”。
通过以上方案,你可以快速利用芯步标准的HTTP接口,将普通的配电箱升级为具备边缘计算能力的工业级智能保护装置。