CATALOG

带计量功能的智能断路器(尤其是40A这种大功率型号)非常适合机房、充电桩、大型设备等场景。芯步的产品开放了HTTP接口,这意味着你可以用自己的服务器或云平台直接跟它“对话”。

下面我会结合接口文档的常规逻辑(签名校验、指令下发)来写,尽量少讲理论,多给实操层面的参考。

一、 准备工作:硬件与配置

在写代码之前,硬件得先就位。按照芯步的产品手册,主要分三步:

  1. 接线安装:这个40A的断路器一般是导轨式安装。注意,40A通常对应8000W左右的功率,线径一定要够粗(6平方或以上铜线),接口要拧紧,避免发热

  2. 设备配网:这款断路器是通过2.4G WiFi联网的,不需要额外买网关

    • 下载“芯步”小程序或者登录官网控制台。

    • 打开手机蓝牙/定位(为了发现设备),长按断路器上的按钮直到指示灯快闪。

    • 在小程序里输入家里的WiFi密码(注意:只支持2.4G频段,双频路由器的5G频段搜不到)

  3. 获取凭证

    • 登录芯步控制台,找到“开发设置”。

    • 记下两个关键字符串:AppID(开发者ID)和 AppSecret(开发者密码)。这两个东西就像用户名和密码,调接口的时候要用

二、 接口对接逻辑:怎么“遥控”它?

芯步的接口本质上是 HTTP POST 请求。你不需要懂复杂的协议,只要会发POST请求就行。控制流程分为两步:获取实时数据 和 下发指令。

1. 获取实时数据(“感知”电流)

断路器会上报当前的电压、电流、功率、开关状态等到云端。你需要调用API来拉取这些数据。关键参数device_id(你那个断路器的唯一ID)。

  • 响应数据示例(参考常规物联网API格式):返回的JSON里通常会包含 current(电流值,单位A)、power(功率)、status(开关状态)等字段。

2. 下发控制指令(“执行”断电)

当检测到电流超过40A(或者你设定的阈值,比如32A)时,你就要发指令让它跳闸。

  • 接口地址https://api.yoyoiot.com/ordercontrol

  • 核心参数device_idcmd

    • cmd 的值通常是 ”turn_off””0”,具体参数一定要去看产品的“产品手册”里的【支持命令】章节

3. 关于签名(Sign)

这是新手比较容易踩坑的地方。为了防止接口被别人乱刷,芯步要求你把参数拼接起来,结合 AppSecret 做个MD5加密(即Sign算法)。有一个偷懒的技巧:在开发测试阶段,去控制台把“调试模式”打开,这时候系统暂时不校验签名,你可以专心写业务逻辑,等上线再把签名算法加上去

三、 核心实现:过流自动断电的逻辑(代码思路)

我们要做的核心逻辑就是:轮询 -> 判断 -> 执行

我们可以写一个Python脚本(用Java、Go或Node.js都可以,原理一样),放在服务器上跑。

第一步:封装一个调用函数

写一个函数,负责给断路器发命令。

第二步:获取实时电流并判断

写一个定时任务,比如每5秒检查一次电流值。

四、 避坑指南与调优

  1. 阈值不要设满(留余量)既然是40A的断路器,千万不要真的等到40A才跳。断路器在40A满负载长时间运行容易发热。物理安全阈值设在 32A - 35A 左右。在软件逻辑里,如果连续2-3次检测到超过35A,再执行断电,防止电流瞬间波动的误判。

  2. “自动重合闸”逻辑断电之后,如果故障排除了,怎么恢复?

    • 手动恢复:让工作人员去现场按断路器上的物理按钮,或者在小程序里点“通电”。

    • 自动恢复(慎用):如果是临时过载(比如大功率设备启动了2秒),可以设定一个延时,比如断电后等待30秒,自动尝试合闸一次。如果合闸后还是过流,那就彻底锁死不要再尝试了,否则电路有故障一直重合闸会出事故。

  3. 断网/本地执行能力这套方案依赖云端,如果WiFi断了,云指令可能下不去。这款断路器虽然支持远程HTTP控制,但对于过流这种安全保护,配置一下断路器的“本地保护参数”。也就是说,通过接口把“超过40A就跳闸”这个阈值写入设备固件里。这样即使断网,断路器自己检测到40A电流也会物理跳闸,这是双重保险

  4. 数据存储在数据库里记录每一次过流跳闸事件。比如:“2025年X月X日,XX车间回路电流达到42A,触发保护。” 这对于排查工厂设备故障非常有用。

五、 总结

接入芯步的40A智能断路器,核心就是抓牢 “查询接口”“控制接口” 这两个点。开发顺序:

  1. 先用 Postman 把接口调通,试着把灯关了、打开。

  2. 再用 Python/Java 把签名算法写好,封装成函数。

  3. 最后加上 if current > 35: turn_off() 的逻辑。

整个过程还是比较顺滑的,只要搞定签名(Sign),其他都简单。