芯步的智能通断器AC4-20A是一款支持HTTP接口控制的WiFi继电器模块,无需网关、可直接接入220V电路控制最高4400W的负载。下面从硬件准备到接口调用,说清楚怎么把它对接到你自己的项目中。
一、先认识一下这个硬件
AC4-20A本质上是一个支持远程控制的继电器,你可以把它理解成一个可以用HTTP请求拨动的电闸。
几个关键参数:
工作电压:AC 85-265V(直接接市电,火零线都要接)
额定电流:MAX 20A
负载功率:阻性负载(比如白炽灯、电热器)最大4400W,感性负载(电机、LED灯)控制在700W以内
联网方式:2.4G WiFi直连,不需要网关或主机
控制接口:HTTP API,任何能发HTTP请求的环境都能用
外观上有四个接线孔:火线进、火线出、零线进、零线出。安装时请一定要断电操作,火线要串联到电路里。
二、整体对接思路
对接分三步走:
配网:让设备连上WiFi
获取凭证:拿到AppID、AppSecret、设备ID
调接口:用HTTP请求控制通断
芯步的接口设计得比较直白——签名计算 + POST请求,不需要复杂的SDK,也不用处理WebSocket长连接。
三、详细对接步骤
3.1 给设备配网
AC4-20A没有屏幕,配网用的是热点模式
设备上电后,如果没连过网,指示灯会慢闪
用手机连设备发出的热点(名称一般是
Yoyo_xxxx)打开芯步的配网页面或App,输入家里的WiFi密码
设备收到信息后自动切换连接目标WiFi,指示灯常亮表示成功
配网成功后,去芯步控制台注册账号,把设备绑定到你的账号下(扫码或输入设备ID)。
3.2 拿到三个关键信息
控制台里找到这三样东西:
| 参数 | 说明 | 在哪拿 |
|---|---|---|
| AppID | 你的应用标识 | 控制台 → 开发设置 |
| AppSecret | 你的应用密钥 | 同上,注意保密 |
| 设备ID | 具体哪个通断器 | 控制台 → 设备列表 |
这三样是后续所有接口调用的“身份证”。
3.3 签名计算(最容易踩坑的地方)
芯步的接口用双重MD5签名防篡改,算法是:
Sign = MD5( MD5(AppSecret) + ts )
其中ts是当前Unix时间戳(秒级)。
举个例子,假设:
AppSecret =
abc123ts =
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,最好在你自己后端封装一个服务层。这样做的好处是:
签名计算统一管理
可以加日志、记录操作历史
调用方(前端、小程序)不用关心签名逻辑
伪代码示意:
四、安防场景的应用思路
既然你是做安防设备交流电路控制,几个典型的玩法:
烟感联动断电:烟雾传感器触发 → 后端调AC4-20A接口 → 切断非消防电源
门禁联动:布防状态下门被打开 → 接通报警灯(接在通断器上)
定时巡检:每天凌晨自动通断一次,检测设备是否正常
远程复位:安防设备死机了?远程断电再通电,相当于物理重启
AC4-20A支持传多个设备ID(用逗号分隔),一条请求可以同时控制多个通断器,这对安防场景挺实用的——比如一键全楼断电。
五、几个要注意的点
签名用的ts有时间窗口,一般几分钟内有效,所以每次请求都要重新算
设备需要保持在线,断网时HTTP接口调了也没用,可以考虑搭配本地定时任务兜底
感性负载要降额,接电机、LED灯时功率别超过700W,不然容易烧触点
私有化部署:如果你不想走云端,芯步也支持局域网直接控制,需要的话可以研究一下自建消息服务器
接口返回记得处理异常,比如设备离线、签名错误等,加重试机制
六、总结
对接流程就四步:配网 → 拿凭证 → 算签名 → 发请求。最费劲的是签名那块,其他都很直白。
如果你只是简单做个开关控制,半天内应该能跑通。要是想做安防联动逻辑,再加一层业务判断就行。有具体问题可以继续问。