芯步的智能墙壁开关2路支持完整的HTTP API接口,你可以通过调用接口实现各种自定义联动——比如门锁开了自动亮灯、传感器触发后延时关灯等。下面我整理了对接方案和常见的联动场景代码。
1. 找齐你的“三把钥匙”
在开始写代码之前,你需要先登录芯步官网,拿到以下三个关键信息:
AppID(应用ID):标识你是哪个开发者。
AppSecret(开发者密码):用来加密签名,防止接口被别人乱刷。
Device ID(设备ID):就是你手里那个开关的身份证,在控制台可以看到。
拿到这三样东西,我们就可以开始“对话”了。
2. 搞懂接口:怎么下发命令
芯步的接口非常标准,采用的是 HTTP POST 请求。你只要向这个地址发数据就行:
这里稍微注意一下安全校验(签名):别看这个 sign 参数有点复杂,其实原理很简单,就是为了防止别人伪造请求来控制你的设备。
公式
sign = md5( md5(AppSecret) + ts )通俗解释:先把你的
AppSecret转成密文,再把这个密文和当前时间戳(比如1715234567)拼在一起,再转一次密文。放心:几乎所有编程语言都有现成的
md5库,直接调用就行。
3. 核心玩法:两路开关的“命令词典”
这个开关有 2 路,你可以把它想象成两个独立的插座,分别控制两个灯或电器。通过 order 字段里的不同参数,可以玩出很多花样。
基础操作:开/关
这是最常用的,直接给线路 1 或线路 2 发送 1(开)或 0(关)。
关掉第1路
{"power1":"0"}打开第2路
{"power2":"1"}
进阶操作:点动模式
有些场景下,按下按钮只是为了触发某个动作(比如按一下给电脑开机,过几秒自己断电),而不是一直亮着。
先通后断(脉冲开):瞬间接通然后断开。
{"point1":"2000"}(第1路接通2秒后自动关闭,常见于控制门禁或触发警铃)
先断后通(脉冲关):瞬间断开然后恢复。
{"reset1":"3000"}(第1路断开3秒后自动恢复,常见于重启路由器)。
防误触操作:状态保持
家里有老人习惯机械按键?或者怕小孩乱关重要设备(比如冰箱、鱼缸)?这时候可以用“状态保持”功能
锁定开启:无论物理按键怎么按,关了立马自动开。
{"power1":{"keep":"1","revert":"3"}}
锁定关闭:怎么按都打不开。
{"power1":{"keep":"0","revert":"3"}}
4. 实战:几个自定义联动的例子
下面用 JavaScript 写几个脚本示例,方便你直接集成到自己的系统里。
第一种场景:人体传感器 + 灯光(人来灯亮)
假设你通过其他程序检测到有人体传感器触发(PIR),现在要调用接口开灯。
代码参考来源:芯步官方接口文档及JS示例
第二种场景:离家模式(一键全关)
当你按下“离家”按钮,把房子里所有灯都关了。
第三种场景:电视机散热风扇(智能温控)
假设你在机柜里装了温控模块,温度超过 40 度,自动开启排风扇(接在开关的第2路)。
5. 几个小贴士(避坑指南)
关于网络:这个开关只支持 2.4G WiFi ,配网的时候记得手机不要连 5G WiFi 。
关于反馈:调用接口返回 200 只代表“指令发出去了”,不代表“设备执行了”。如果需要确认灯是否真的亮了,配合芯步的 消息推送 功能来监听设备状态变化。
关于本地化:如果你家里或者公司的网络要求高,不想走外网云端,这款开关也支持 局域网 和 私有化部署,可以直接在内网控制,响应速度更快更稳定。
通过这一套组合拳,不管是简单的远程开关,还是复杂的场景联动,都能轻松搞定。