CATALOG

芯步的40A智能空开开放了HTTP接口,这意味着你可以用任何编程语言直接调用,把它集成到自己的管理系统里。下面我会从接口对接、过载保护逻辑、异常处理几个方面,把这个方案说清楚。

一、 我们面对的是什么设备?

首先,我们手里拿到的这款 芯步 UNI-DLQ-M-40A ,其实就是一个“聪明”的空气开关。它和我们家里那种扳一下才会跳的普通空开最大的不同是:它身上带了 WiFi 模块 和 计量芯片

所以,它不仅仅是 40A 电流到了就“咔嚓”一声机械跳闸,它能做到:

  • 感知:实时告诉你现在电流多大,功率多高。

  • 通讯:连着 WiFi,等着你的指令。

  • 执行:你通过网络发个请求,它能远程断开或闭合。

我们要做的,就是把它这个 开放 HTTP 接口 用起来

二、 对接思路:服务器怎么认识空开?

官方手册提到,设备支持 HTTP 接口,任何能发请求的编程语言(Python、Java、PHP、Go 等)都能对接 。流程其实很直接:

  1. 设备联网:空开通电后,会用 WiFi 2.4G 连接网络,注册到芯步的云端(或者如果你做私有化部署,就连到你自己的服务器)。

  2. 获取“把手”:你要控制某个空开,得先拿到它的 设备IDAPI Key(密钥) 。这相当于这把锁的地址和钥匙。

  3. 发起指令:你的业务系统向云端发起 HTTP 请求,带上签名和参数。

  4. 执行与反馈:云端把指令推给空开,空开执行,然后返回“已断开”或“已闭合”的结果给你。

三、 实战:怎么实现“过流过载保护”?

我们要实现的功能不是简单的“超过 40A 就跳”,而是 精细化、可编程的保护策略。比如:比如“电流超过 30A 持续 5 秒,先报警不断开;超过 40A 立即断开”。

这里需要分两步走:读取数据(判断过载) + 下发命令(执行保护)。

第一步:实时监测电流(感知危险)

你需要通过 API 获取空开的实时状态。轮询接口或者设置 Webhook(消息推送)都可以。

  • 接口作用:获取设备的当前状态,包括电流、电压、功率、开关状态等。

  • 核心参数

    • current(当前电流):如果这个值一直在涨,比如从 10A 涨到了 35A,说明快要过载了。

    • power(当前功率):配合电流做辅助判断。

  • 逻辑判断(在你自己的服务器代码里写)

第二步:执行断开控制(实施保护)

一旦你的代码判定“这是危险过载”,就要调用控制接口

根据芯步的通用规范,控制一个设备通断通常像这样发一个 HTTP 请求 :

  • URLhttps://api.yoyoiot.com/ordercontrol

  • Method:POST

  • HeadersContent-Type: application/json, Authorization: Bearer {你的access_token}

  • Body 参数

    • device_id: xxxxxxx (设备的唯一ID)

    • cmd: 0 (假设 0 代表断开/分闸)

    • reason: Circuit overload (记录一下原因)

下发命令如果你的服务器判定电流超标,代码就会组装上面这个请求发送出去。云端收到指令后,会下发给家里的空开。空开里的电动操动机构会动作,在几十毫秒内把开关拨到“Off”状态 。

这时候,你的设备就断电了,保护完成。

四、 进阶一点:怎么做得比传统空开更“聪明”?

如果只是超过 40A 就跳闸,那和传统机械空开没啥区别,体现不出智能的价值。智能体现在它能识别“浪涌”“精细管理”

1. 避开“开机浪涌”误判

很多大功率设备(比如空调、冰箱压缩机、电机)启动的那一瞬间,电流会瞬间飙高,可能达到 60A-80A,但持续时间只有零点几秒 。

如果这时候直接跳闸,那就是“误报”,用户体验会很差。

  • 解决方案:在你的代码里加入 延时去抖 逻辑。

2. 自定义“软阈值”保护

传统空开是