一、这个东西到底能干啥?
先说说这个开关是啥。芯步的86型单路智能开关,说白了就是一个能联网的墙壁开关。它长着标准86型的样子(就是咱们家里墙上那种正方形开关的尺寸),可以直接替换你现有的墙壁开关,不用重新开槽布线。
它能干什么?
控制一路灯或者别的电器(比如门禁电磁锁、排风扇)
通过HTTP接口远程控制,你在办公室也能关家里的灯
支持定时任务、联动操作
有一个很实用的功能叫“状态保持”——用户按了开关后几秒钟自动恢复原状
这个“状态保持”对于门禁场景特别有用:比如你刷门禁卡开门,电磁锁通电开锁,几秒后自动断电锁门,不用再手动关。
二、准备工作:你得有这几样东西
在动手之前,先把东西备齐:
硬件部分
芯步UNI-KG-1智能墙壁开关(1路的那款)
你家有2.4GHz的WiFi(注意5G频段不行)
螺丝刀、电工胶布这些基本工具
软件部分
在芯步官网注册一个开发者账号
登录控制台,创建一个“工作台”
在开发设置里拿到你的AppID和AppSecret(这两个相当于你的身份凭证,别乱给别人)
把开关通上电,通过网络配置把它连上你家WiFi(配网流程官网上有详细说明,可以用电脑配也可以用小程序配)
一点基础知识
会发HTTP请求就行,不管你是用Python、Java、JavaScript还是C#,甚至用Postman测试都行
三、核心接口:怎么远程控制它?
这开关的核心接口就是一个HTTP POST请求,地址是:
注意: 这个接口需要携带签名,说白了就是防别人乱调你家设备的机制。
签名的计算方法(稍微有点绕,但照着做就行)
签名算法是这样的:
其中ts是当前时间戳(秒)。
用伪代码写就是:
下发控制命令
拿到签名后,就可以发POST请求了。请求体是一个JSON:
power1: 1表示打开第一路线路power1: 0表示关闭
如果你想控制门禁场景的那个“开锁几秒后自动关”,可以用reset1命令:
这个意思就是:先断电(或通电),5000毫秒后恢复原状态。
四、实战:分步骤对接你的项目
下面用一个简单的Python例子演示整个流程,你可以照猫画虎移植到其他语言。
第一步:封装一个控制函数
第二步:对接门禁场景
假设你要做一个办公室门禁系统:员工刷工牌,门锁打开,5秒后自动锁上。
第三步:对接你的业务系统
如果你用的是Web系统,前端调后端接口,后端再调这个开关接口:
五、几个踩坑提醒
WiFi只支持2.4GHz:别连5G WiFi,设备搜不到。很多路由器双频合一,分开或者临时关闭5G频段配网。
负载功率别超了:这个开关最大10A电流,LED灯的话不要超过300W。如果控制大功率设备(比如中央空调),加中间继电器。
返回200不代表设备真的执行了:200只代表平台收到了你的指令。如果设备离线(比如断网了),指令是下不去的。关键场景要用异步消息推送确认执行结果。
时间戳有有效期:签名里的时间戳一般几分钟内有效,过时得重新生成。
设备ID在哪里找:登录芯步控制台,在设备列表里能看到一串数字,那就是设备ID。
六、还能玩出什么花样?
除了远程开关,还可以做这些事情:
批量控制:device参数可以传多个设备ID,用逗号隔开,一次控制好几个房间的灯
分组控制:先在控制台把设备分个组,然后直接控制整个组
定时任务:通过API创建定时任务,比如每天早上8点开灯,晚上6点关灯
状态同步:订阅设备的状态变化推送,实时掌握开关是开还是关
七、总结
把86型智能开关对接进自己的项目,核心就是三件事:
配网让设备上网
拿凭证AppID、AppSecret、设备ID
发HTTP请求带上签名,告诉设备干啥
芯步的接口设计得比较简洁,标准的HTTP + MD5签名,没有乱七八糟的私有协议,基本上任何能发HTTP请求的环境都能接。从开箱到跑通第一个指令,快的话十几分钟就够了。
如果对接过程中遇到问题,他们家提供免费的技术指导,直接找工程师问就行。硬件选型、对接、安装调试都会有人帮你看。