CATALOG

一、这个东西到底能干啥?

先说说这个开关是啥。芯步的86型单路智能开关,说白了就是一个能联网的墙壁开关。它长着标准86型的样子(就是咱们家里墙上那种正方形开关的尺寸),可以直接替换你现有的墙壁开关,不用重新开槽布线。

它能干什么?

  • 控制一路灯或者别的电器(比如门禁电磁锁、排风扇)

  • 通过HTTP接口远程控制,你在办公室也能关家里的灯

  • 支持定时任务、联动操作

  • 有一个很实用的功能叫“状态保持”——用户按了开关后几秒钟自动恢复原状

这个“状态保持”对于门禁场景特别有用:比如你刷门禁卡开门,电磁锁通电开锁,几秒后自动断电锁门,不用再手动关。

二、准备工作:你得有这几样东西

在动手之前,先把东西备齐:

  1. 硬件部分

    • 芯步UNI-KG-1智能墙壁开关(1路的那款)

    • 你家有2.4GHz的WiFi(注意5G频段不行)

    • 螺丝刀、电工胶布这些基本工具

  2. 软件部分

    • 在芯步官网注册一个开发者账号

    • 登录控制台,创建一个“工作台”

    • 在开发设置里拿到你的AppID和AppSecret(这两个相当于你的身份凭证,别乱给别人)

    • 把开关通上电,通过网络配置把它连上你家WiFi(配网流程官网上有详细说明,可以用电脑配也可以用小程序配)

  3. 一点基础知识

    • 会发HTTP请求就行,不管你是用Python、Java、JavaScript还是C#,甚至用Postman测试都行

三、核心接口:怎么远程控制它?

这开关的核心接口就是一个HTTP POST请求,地址是:

注意: 这个接口需要携带签名,说白了就是防别人乱调你家设备的机制。

签名的计算方法(稍微有点绕,但照着做就行)

签名算法是这样的:

其中ts是当前时间戳(秒)。

用伪代码写就是:

下发控制命令

拿到签名后,就可以发POST请求了。请求体是一个JSON:

  • power1: 1 表示打开第一路线路

  • power1: 0 表示关闭

如果你想控制门禁场景的那个“开锁几秒后自动关”,可以用reset1命令:

这个意思就是:先断电(或通电),5000毫秒后恢复原状态。

四、实战:分步骤对接你的项目

下面用一个简单的Python例子演示整个流程,你可以照猫画虎移植到其他语言。

第一步:封装一个控制函数

第二步:对接门禁场景

假设你要做一个办公室门禁系统:员工刷工牌,门锁打开,5秒后自动锁上。

第三步:对接你的业务系统

如果你用的是Web系统,前端调后端接口,后端再调这个开关接口:

五、几个踩坑提醒

  1. WiFi只支持2.4GHz:别连5G WiFi,设备搜不到。很多路由器双频合一,分开或者临时关闭5G频段配网。

  2. 负载功率别超了:这个开关最大10A电流,LED灯的话不要超过300W。如果控制大功率设备(比如中央空调),加中间继电器。

  3. 返回200不代表设备真的执行了:200只代表平台收到了你的指令。如果设备离线(比如断网了),指令是下不去的。关键场景要用异步消息推送确认执行结果。

  4. 时间戳有有效期:签名里的时间戳一般几分钟内有效,过时得重新生成。

  5. 设备ID在哪里找:登录芯步控制台,在设备列表里能看到一串数字,那就是设备ID。

六、还能玩出什么花样?

除了远程开关,还可以做这些事情:

  • 批量控制:device参数可以传多个设备ID,用逗号隔开,一次控制好几个房间的灯

  • 分组控制:先在控制台把设备分个组,然后直接控制整个组

  • 定时任务:通过API创建定时任务,比如每天早上8点开灯,晚上6点关灯

  • 状态同步:订阅设备的状态变化推送,实时掌握开关是开还是关

七、总结

把86型智能开关对接进自己的项目,核心就是三件事:

  1. 配网让设备上网

  2. 拿凭证AppID、AppSecret、设备ID

  3. 发HTTP请求带上签名,告诉设备干啥

芯步的接口设计得比较简洁,标准的HTTP + MD5签名,没有乱七八糟的私有协议,基本上任何能发HTTP请求的环境都能接。从开箱到跑通第一个指令,快的话十几分钟就够了。

如果对接过程中遇到问题,他们家提供免费的技术指导,直接找工程师问就行。硬件选型、对接、安装调试都会有人帮你看。