CATALOG

芯步的30A断路器支持HTTP接口控制,核心就是调用API发指令。下面我从选型、接线到接口调用一步步说清楚,你可以直接照着操作。

一、先搞清楚你要用哪款硬件

芯步带“远程控制”功能的30A设备其实有好几款,为了不买错,你可以这样区分:

  • 智能通断器 AC4-30A:这是4路的,每一路最大支持30A,总功率能到6600W。适合需要分别控制多个大功率设备(比如中央空调、多个热水器)的场景

  • 智能断路器30A(单路):只控制一路电,额定电流30A,阻性负载最大6000W。适合监控整个房间或一台大型机器的总电源

  • 通用智能通断器:一般也是单路,支持30A电流,常用在工装改造里

怎么选? 如果你只是想远程开关某个总闸,选“单路断路器”或者“单路通断器”。如果你需要在一个电箱里独立控制好几个设备,直接买那个4路的AC4-30A会更省空间。

二、拿到硬件后,怎么接进项目里?

1. 接线与安装

这东西是导轨安装的,直接卡在电箱里的DIN导轨上就行。

  • 进线端:接火线输入。

  • 出线端:接负载的火线。

  • 零线:设备一般需要单独供零线给模块供电,或者零线共用(具体看接线图,记得断电操作!)。

2. 让设备连上网

这是最关键的一步。芯步的设备只支持2.4G WiFi,不支持5G。

  • 配网:下载“芯步”小程序,或者登录他们的物联网控制台。

  • 步骤:先添加现场WiFi的账号密码(必须是2.4G的) -> 用手机热点或蓝牙方式进行设备配网 -> 把WiFi凭证发给设备,直到设备指示灯从快闪变为常亮或慢闪

连上网后,在控制台里找到你的设备,记下那串Device ID(设备ID),后面调用接口全靠它。

三、核心实操:怎么用接口控制它?

芯步的接口非常友好,没有复杂的MQTT协议,就是最普通的HTTP POST请求

1. 准备签名(Sign)

为了安全,调用接口需要加签名。说实话一开始我看文档也头大,其实规则很简单:

  1. 把给你的AppSecret(开发者密码)做一次MD5加密。

  2. 把加密结果加上当前的时间戳ts

  3. 把拼接后的字符串再做一次MD5。公式:sign = md5( md5(AppSecret) + ts )

直接用Curl命令测试:假设你的AppSecretabc123AppIdtestApp

2. 常用命令实战(Order参数)

这里的order其实就是你要下发的指令,我用大白话给你列几个最常用的:

  • 只想开/关单路(单路设备或4路设备的第一路)开:{"power":1} 关:{"power":0}

  • 4路设备分别控制关第二路:{"power2":0} 开第三路:{"power3":1}

  • “点动”控制(比如按一下,接通1秒后自动断开)这个功能非常实用,比如控制电控锁或短暂提醒。{"point":{"relay":[1],"interval":1000}}(含义:让第1路接通,1000毫秒(1秒)后自动断开)

  • 批量操作(同时关掉第1路和第3路){"batch":{"relay":[1,3],"power":"0"}}

四、结合项目实际场景的代码示例

不管你是写Java后端、Node.js还是Python,逻辑都是一样的。这里给一个Java的例子(用Unirest库会比较方便):

稍微口语化一点的说明:代码里order外面套了引号,是因为HTTP Body要求传字符串,但实际上设备收到后,会解析里面的JSON命令

如果你是做微信小程序,直接把deviceorder拼进请求体就行

五、如果调试不成功,可能是什么原因?

  1. 签名错误:这是99%的人遇到的第一坑。检查一下时间戳ts是不是秒级(10位数)而不是毫秒级(13位数)。

  2. WiFi没连上:设备如果是红灯快闪,说明没联网,接口调用成功它也执行不了。

  3. 指令格式不对:注意order是一个字符串化的JSON。如果你在Postman里测试,Body选raw -> JSON,然后写成这样:

    不要直接写"order": { "power": 1 },虽然看着舒服,但芯步的网关解析方式特殊,会报错

总结一下

把30A断路器集成到自己项目里,真的不用想得太复杂。总结起来三步:

  1. 物理接线 + 2.4G配网。

  2. 复制设备ID和AppID。

  3. 写一句curl 或者几行 http.post 代码,把 {"power":1} 发出去。

如果遇到具体报错码(比如返回50x),直接去芯步开放文档查,或者把报错贴出来,很容易解决的。