CATALOG

芯步的3路智能墙壁开关通过HTTP接口开放了全部控制能力,你可以用任何编程语言调用。下面我把整个接入流程串一遍,从拿到设备到写代码调用,一步步说清楚。

一、 准备工作:先把“硬骨头”搞定

在写代码之前,你需要搞定两件小事,也就是拿到“钥匙”和“门牌号”:

  1. 拿到钥匙 (AppID 和 AppSecret)先去芯步的控制台注册个账号。然后在“开发设置”里,你就能看到系统分配给你的 AppID(相当于用户名)和 AppSecret(相当于密码)。注意AppSecret 一会儿要用来做签名,别泄露了。

  2. 拿到门牌号 (Device ID)把你买回来的“3路智能墙壁开关”接好线、通上电,并给它连上家里的2.4G Wi-Fi。连上网之后,在控制台的设备列表里,你就能看到一个数字ID,这就是这台设备的唯一标识 Device ID

二、 核心环节:怎么发命令(签名与请求)

芯步的接口逻辑很直接:往指定的URL发一个POST请求就行了。唯一稍微需要动点脑子的是签名,这是为了安全,防止别人乱动你的开关。不过别担心,逻辑很简单,就是把刚才拿到的 AppSecret “加密”一下

签名的生成规则(傻瓜式步骤):假设你的 AppSecretabc123,当前时间是 1712457600

  1. 先把 AppSecret 做一次MD5加密,比如结果是 xxxxxxxxx

  2. 把加密后的结果后面拼上时间戳,变成 xxxxxxxxx1712457600

  3. 把这个拼接后的字符串再做一次MD5加密,得到的最终字符串就是 sign(签名)。

请求的“靶心”地址:

三、 实战演练:控制3路照明

现在我们开始写具体的命令。假设你的设备ID是 10086,你想把客厅灯(第1路)打开,把餐厅灯(第2路)关掉,把走廊灯(第3路)打开。

那么,你要发送的 POST 请求内容(Body)应该长这样

是不是很直观? power1power2power3 分别对应开关背后的三根控制线。

四、 进阶玩法:不仅是开和关

如果你觉得这只是个“遥控器”,那就小看它了。这玩意儿还支持一些高级功能,在设置自动化场景时特别有用

1. “点动”模式(相当于按门铃或者给电控锁通电):如果你需要开关打开几秒钟后自动关闭,不需要自己写代码去算时间再发关的命令,可以直接发:

2. “互锁”模式:不过这里文档里没提,通常用于电机正反转,但基础的控制已经很灵活了。

五、 用 Shell 脚本直接测(最简单的Demo)

为了验证接口通不通,你甚至不用写复杂的程序。如果你手边有Linux终端或者装了Git Bash的电脑,直接复制下面这段命令改改就能跑

运行这行代码,如果不出意外,你的灯就应该亮/灭了。

六、 扩展思路:可以做成什么样?

既然是开放接口,能玩的花样就多了:

  • 接入语音助手:虽然官方可能没直接做小爱同学或天猫精灵的对接,但你可以写个简单的脚本,让服务器收到语音助手的指令后,转化成这个HTTP请求发出去。

  • 集成到自有系统:如果你自己有做APP或者网页后台,直接把这一套接口封装进去,就能在自己的系统里控制灯光了。

  • 定时任务:不用去买复杂的定时器,在你的服务器上写个 crontab 脚本,到点执行这个curl命令,定时开关灯就做好了。

总结一下:整个接入过程就是 拿参数 -> 算签名 -> POST JSON 这三步。对于3路开关,核心就是记住 power1power2power3 这三个控制参数