芯步AC1智能通断器远程参数配置对接方案
一、写在前面
大家好,咱们今天来聊聊怎么对接芯步的AC1智能通断器。
其实AC1这东西说白了就是一个可以用网络控制的开关,额定功率2200W,家里的大多数电器都能带得动。最方便的是它开放了HTTP接口,不管你是用Java、Python、PHP还是Node.js,只要能发HTTP请求就能控制它。
下面我就一步步跟大家说清楚怎么对接。
二、对接前的准备工作
动手之前,先得把"钥匙"拿到手:
注册芯步账号,登录控制台
获取AppID和AppSecret:在控制台的"开发设置"页面能看到
拿到设备ID:设备外壳上印的有,或者控制台的设备列表里也能看到
确保AC1已经配网成功:用官方的小程序把设备连上Wi-Fi
小提示:芯步的开放平台是免费的,不管是私有化部署还是直接调他们的接口,都不收费。
三、核心:签名怎么算
这是最容易踩坑的地方,我单独拎出来说。
每次调用接口都要带两个参数:sign(签名)和ts(时间戳)。签名的算法是:
用人话解释一下:
先把你的AppSecret做一次MD5加密
把上面得到的结果跟当前时间戳(10位数字,秒级)拼在一起
再把拼好的字符串做一次MD5
代码示例(Bash):
注意:时间戳必须是中国时间,误差太大会报
bad ts错误。
四、远程控制接口(基础操作)
控制设备的核心接口地址:
请求体(JSON格式):
参数说明:
| 参数 | 说明 |
|---|---|
| device | 设备唯一ID,多个设备用逗号隔开 |
| order | 命令内容,{"power1":1}表示开,{"power1":0}表示关 |
AC1是单路通断器,所以用power1。如果你接的是多路控制器,就用power2、power3这样。
五、进阶:远程参数配置(这才是重点)
"远程参数配置管理"听着高大上,其实就是通过API给设备下发一些带有延时、定时逻辑的命令。下面几个场景很实用:
第一种场景:定时断开(比如让灯亮1小时后自动关)
这个命令会让设备先接通,然后在3600000毫秒(也就是1小时)后自动断开。单位是毫秒,别搞错了。
第二种场景:先通后断(点动模式)
设备会先通电,500毫秒后自动断电。这个场景特别适合控制电动门锁、闸机之类的——给一个脉冲信号就行。
第三种场景:先断后通
先断电,1秒后再通电。有点像"重启"操作。
场景四:批量控制多个线路
如果你用的是多路控制器:
同时把第1路和第3路都关掉。