芯步的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)
为了安全,调用接口需要加签名。说实话一开始我看文档也头大,其实规则很简单:
把给你的
AppSecret(开发者密码)做一次MD5加密。把加密结果加上当前的时间戳
ts。把拼接后的字符串再做一次MD5。公式:
sign = md5( md5(AppSecret) + ts )
直接用Curl命令测试:假设你的AppSecret是abc123,AppId是testApp。
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命令。
如果你是做微信小程序,直接把device和order拼进请求体就行。
五、如果调试不成功,可能是什么原因?
签名错误:这是99%的人遇到的第一坑。检查一下时间戳
ts是不是秒级(10位数)而不是毫秒级(13位数)。WiFi没连上:设备如果是红灯快闪,说明没联网,接口调用成功它也执行不了。
指令格式不对:注意
order是一个字符串化的JSON。如果你在Postman里测试,Body选raw->JSON,然后写成这样:不要直接写
"order": { "power": 1 },虽然看着舒服,但芯步的网关解析方式特殊,会报错。
总结一下
把30A断路器集成到自己项目里,真的不用想得太复杂。总结起来三步:
物理接线 + 2.4G配网。
复制设备ID和AppID。
写一句
curl或者几行http.post代码,把{"power":1}发出去。
如果遇到具体报错码(比如返回50x),直接去芯步开放文档查,或者把报错贴出来,很容易解决的。