CATALOG

芯步AC1智能通断器远程参数配置对接方案

一、写在前面

大家好,咱们今天来聊聊怎么对接芯步的AC1智能通断器。

其实AC1这东西说白了就是一个可以用网络控制的开关,额定功率2200W,家里的大多数电器都能带得动。最方便的是它开放了HTTP接口,不管你是用Java、Python、PHP还是Node.js,只要能发HTTP请求就能控制它。

下面我就一步步跟大家说清楚怎么对接。

二、对接前的准备工作

动手之前,先得把"钥匙"拿到手:

  1. 注册芯步账号,登录控制台

  2. 获取AppID和AppSecret:在控制台的"开发设置"页面能看到

  3. 拿到设备ID:设备外壳上印的有,或者控制台的设备列表里也能看到

  4. 确保AC1已经配网成功:用官方的小程序把设备连上Wi-Fi

小提示:芯步的开放平台是免费的,不管是私有化部署还是直接调他们的接口,都不收费

三、核心:签名怎么算

这是最容易踩坑的地方,我单独拎出来说。

每次调用接口都要带两个参数:sign(签名)和ts(时间戳)。签名的算法是:

用人话解释一下:

  1. 先把你的AppSecret做一次MD5加密

  2. 把上面得到的结果跟当前时间戳(10位数字,秒级)拼在一起

  3. 再把拼好的字符串做一次MD5

代码示例(Bash):

注意:时间戳必须是中国时间,误差太大会报bad ts错误

四、远程控制接口(基础操作)

控制设备的核心接口地址:

请求体(JSON格式):

参数说明:

参数说明
device设备唯一ID,多个设备用逗号隔开
order命令内容,{"power1":1}表示开,{"power1":0}表示关

AC1是单路通断器,所以用power1。如果你接的是多路控制器,就用power2power3这样

五、进阶:远程参数配置(这才是重点)

"远程参数配置管理"听着高大上,其实就是通过API给设备下发一些带有延时、定时逻辑的命令。下面几个场景很实用:

第一种场景:定时断开(比如让灯亮1小时后自动关)

这个命令会让设备先接通,然后在3600000毫秒(也就是1小时)后自动断开。单位是毫秒,别搞错了

第二种场景:先通后断(点动模式)

设备会先通电,500毫秒后自动断电。这个场景特别适合控制电动门锁、闸机之类的——给一个脉冲信号就行。

第三种场景:先断后通

先断电,1秒后再通电。有点像"重启"操作。

场景四:批量控制多个线路

如果你用的是多路控制器:

同时把第1路和第3路都关掉