芯步的智能插座产品(如16A计量版)本身就带过流过载保护功能,只是需要通过API参数配置阈值。以下方案说明如何通过开放接口对接1位5孔定时开关插座,把“被动跳闸”升级成“主动保护+联动控制”。
1. 背景与目标
在智能楼宇、机房运维及工业末端配电场景中,用电安全是核心诉求。传统断路器在过载跳闸后无法自恢复,且往往没有前置预警。本方案基于芯步智能插座(计量版) 的开放接口(HTTP API),旨在实现以下目标:
实时监测:获取电流、电压、功率因数及实时负载功率。
阈值控制:通过API动态下发过载阈值,当功率/电流超过设定值时自动断电。
策略自愈:结合定时任务或云端逻辑,实现“过载保护-断电-延时-重试”的闭环控制。
2. 对接设计
由于芯步设备支持标准的HTTP API且支持私有化部署,采用设备直连云平台/本地服务器的架构。无需网关,设备通过WiFi 2.4G直接与业务系统交互。
设备层:芯步1位5孔计量插座(如UNI-CZ-16A-P)。
传输层:HTTP/HTTPS协议,设备主动上报状态,服务器下发控制指令。
业务逻辑层:负责轮询数据、判断是否过载、执行断电或重连指令。
执行层:通过API调用控制继电器的通断。
3. 核心对接步骤
3.1 设备初始化与网络配置
配网:设备上电后,通过芯步提供的配网工具(或SmartConfig/AP模式)将插座接入本地2.4G Wi-Fi网络。
获取唯一标识:记录设备的
Device ID(MAC地址或设备序列号),后续API调用均需携带此ID。
3.2 接口调用基础准备
芯步采用RESTful风格的HTTP API,数据格式为JSON。调用时需要关注以下要点:
鉴权:在HTTP Header中携带API Key或动态Token(具体依据企业管理后台配置)。
签名:部分敏感操作需按照文档规则进行MD5签名以防止篡改。
协议
http://或通过云平台接口/api/... https://api.yoyoiot.com/v1/...。
3.3 获取实时电量数据(过载判断依据)
为了实现过载保护,首先必须实时读取负载数据。接口请求示例逻辑如下:
Endpoint:
GET /device/status参数:
device_id={设备ID}返回的关键字段
power:当前实时功率(单位:W)。current:当前实时电流(单位:A)。voltage:当前电压(单位:V)。relay_state:当前继电器的通断状态(1=闭合/通电,0=断开/断电)。
3.4 下发控制指令(执行保护动作)
当监测到数值超限时,需调用断电接口。
Endpoint:
POST /device/controlBody:
4. 过流过载保护控制逻辑实现
本方案不依赖插座内置的硬件保护(虽然硬件有,但为了软件联动),构建一个软件层面的智能保护服务。
4.1 阈值设定策略
根据插座的额定功率(通常为2500W/10A或4000W/16A),设定三级阈值:
预警阈值(80%):触发告警通知,但不断电。
延时阈值(100%-120%):持续5秒仍超限,执行断电。
瞬时阈值(>150%):立即断电(模拟短路保护)。
4.2 轮询与判定流程
在业务服务器(或云函数)中配置定时任务(Cron Job),间隔为 1-3秒。
4.3 定时控制与过载锁
利用设备的“定时开关”接口结合过载逻辑,可以实现“测试自动复位”:
过载发生后,插座断电。
系统设定5分钟后执行“开启”指令。
安全逻辑:开启后立即检测功率。如果依然过载,立即再次断电并锁定,需人工介入,防止无限次重试烧毁线路。
5. 关键接口参数详解(参考)
虽然不同型号略有差异,但芯步标准计量插座的接口字段通常包含以下内容,对接时请对照您的设备文档:
| 功能分类 | 接口/参数名称 | 说明 | 处理方式 |
|---|---|---|---|
| 数据采集 | get_metrics | 一次性获取功率、电流、电压 | 重点解析power字段,保留小数点后一位 |
| 阈值设定 | set_overtemp / set_overload | 部分型号支持云端直接写入硬件保护阈值 | 可写入5500W配合16A的断路器使用 |
| 继电器控制 | relay/0?turn=off | 控制插孔通断 | 切换延时通常在200ms-500ms之间 |
| 定时任务 | schedule/timer | 设定倒计时开关 | 可用于过载后的尝试性恢复供电 |
6. 高级应用场景
6.1 动态过载保护
在电动车充电场景中,充电功率是变化的。对接后可通过算法实现:
静态保护失效:如果设定死值2200W,车辆刚启动时瞬间超限会误判。
动态方案:采集前10秒的平均功率作为基准,允许基准值+20%的波动。如果突然超出基准值200%,视为故障切断。
6.2 本地局域网极速控制
为了追求更高的响应速度(切断时间小于100ms),采用本地局域网API模式,而不是经过云端。
实施:业务服务器与插座在同一网段,直接通过HTTP调用插座的本地IP地址。
优势:不依赖外网带宽,专线内网控制,延迟更低,更安全。
7. 异常处理与容错机制
网络抖动:当API请求超时或失败时,不能盲目重试。采用随机间隔(或逐次增大间隔)算法(1s, 2s, 4s),防止因大量重试导致设备死机。
断网续传:芯步设备若支持本地存储,在网络恢复时应补传过载期间的数据,方便审计。
硬件自恢复:在软件保护失效的极端情况下(如死机),依赖设备底层硬件的温控保险或物理过流保护作为最后一道防线。
8. 总结
通过对接芯步的开放接口,开发者可以构建起一套软硬结合的精细化配电系统。这不仅仅是简单的“超限-断电”,而是可以结合定时策略实现“过载锁定-自动巡检-智能复位”的完整运维闭环。实施时重点关注数据轮询的频率控制以及本地局域网API的调用效率,即可实现工业级的安全保护控制。