CATALOG

芯步的智能通断器AC4-20A是一款支持HTTP接口控制的WiFi继电器模块,无需网关、可直接接入220V电路控制最高4400W的负载。下面从硬件准备到接口调用,说清楚怎么把它对接到你自己的项目中。

一、先认识一下这个硬件

AC4-20A本质上是一个支持远程控制的继电器,你可以把它理解成一个可以用HTTP请求拨动的电闸。

几个关键参数:

  • 工作电压:AC 85-265V(直接接市电,火零线都要接)

  • 额定电流:MAX 20A

  • 负载功率:阻性负载(比如白炽灯、电热器)最大4400W,感性负载(电机、LED灯)控制在700W以内

  • 联网方式:2.4G WiFi直连,不需要网关或主机

  • 控制接口:HTTP API,任何能发HTTP请求的环境都能用

外观上有四个接线孔:火线进、火线出、零线进、零线出。安装时请一定要断电操作,火线要串联到电路里。

二、整体对接思路

对接分三步走:

  1. 配网:让设备连上WiFi

  2. 获取凭证:拿到AppID、AppSecret、设备ID

  3. 调接口:用HTTP请求控制通断

芯步的接口设计得比较直白——签名计算 + POST请求,不需要复杂的SDK,也不用处理WebSocket长连接。

三、详细对接步骤

3.1 给设备配网

AC4-20A没有屏幕,配网用的是热点模式

  1. 设备上电后,如果没连过网,指示灯会慢闪

  2. 用手机连设备发出的热点(名称一般是Yoyo_xxxx

  3. 打开芯步的配网页面或App,输入家里的WiFi密码

  4. 设备收到信息后自动切换连接目标WiFi,指示灯常亮表示成功

配网成功后,去芯步控制台注册账号,把设备绑定到你的账号下(扫码或输入设备ID)。

3.2 拿到三个关键信息

控制台里找到这三样东西:

参数说明在哪拿
AppID你的应用标识控制台 → 开发设置
AppSecret你的应用密钥同上,注意保密
设备ID具体哪个通断器控制台 → 设备列表

这三样是后续所有接口调用的“身份证”。

3.3 签名计算(最容易踩坑的地方)

芯步的接口用双重MD5签名防篡改,算法是:

Sign = MD5( MD5(AppSecret) + ts )

其中ts是当前Unix时间戳(秒级)。

举个例子,假设:

  • AppSecret = abc123

  • ts = 1704067200

第一步:md5_secret = MD5("abc123")e99a18c428cb38d5f260853678922e03第二步:拼接 → e99a18c428cb38d5f260853678922e03 + 1704067200 = e99a18c428cb38d5f260853678922e031704067200第三步:再MD5一次得到最终Sign

实际开发时不用手算,写个函数就行。下面给个Python版和JavaScript版的示例:

Python版:

JavaScript版(Node.js):

3.4 调用控制接口

接口地址:

POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求头:

Content-Type: application/json

请求体:

order里的命令格式:

  • {"power": 1} — 接通(开)

  • {"power": 0} — 断开(关)

  • {"point": 3000} — 先通后断,3秒后自动断开(单位毫秒)

  • {"reset": 5000} — 先断后通,5秒后自动接通

一个完整的curl示例:

3.5 在自己的系统里封装一层

不每次控制都裸调API,最好在你自己后端封装一个服务层。这样做的好处是:

  • 签名计算统一管理

  • 可以加日志、记录操作历史

  • 调用方(前端、小程序)不用关心签名逻辑

伪代码示意:

四、安防场景的应用思路

既然你是做安防设备交流电路控制,几个典型的玩法:

  1. 烟感联动断电:烟雾传感器触发 → 后端调AC4-20A接口 → 切断非消防电源

  2. 门禁联动:布防状态下门被打开 → 接通报警灯(接在通断器上)

  3. 定时巡检:每天凌晨自动通断一次,检测设备是否正常

  4. 远程复位:安防设备死机了?远程断电再通电,相当于物理重启

AC4-20A支持传多个设备ID(用逗号分隔),一条请求可以同时控制多个通断器,这对安防场景挺实用的——比如一键全楼断电。

五、几个要注意的点

  1. 签名用的ts有时间窗口,一般几分钟内有效,所以每次请求都要重新算

  2. 设备需要保持在线,断网时HTTP接口调了也没用,可以考虑搭配本地定时任务兜底

  3. 感性负载要降额,接电机、LED灯时功率别超过700W,不然容易烧触点

  4. 私有化部署:如果你不想走云端,芯步也支持局域网直接控制,需要的话可以研究一下自建消息服务器

  5. 接口返回记得处理异常,比如设备离线、签名错误等,加重试机制

六、总结

对接流程就四步:配网 → 拿凭证 → 算签名 → 发请求。最费劲的是签名那块,其他都很直白。

如果你只是简单做个开关控制,半天内应该能跑通。要是想做安防联动逻辑,再加一层业务判断就行。有具体问题可以继续问。