CATALOG

智能3路开关的远程控制其实很简单——芯步的开放接口基于标准HTTP协议,签名算法规整,基本上拿到文档后十几分钟就能跑通第一组命令。下面我从硬件准备到接口调用、再到场景应用,一步步说清楚。

一、我们面对的是什么设备?

智能3路墙壁场景联动开关(具体型号通常为 UNI-KG-3 或类似),简单来说,就是一个能放进标准86底盒(家里的墙壁开关大小)的硬件。

它有三个核心特点:

  1. 三路独立控制:一个开关面板可以分别控制三盏灯或三个设备。比如第一路接客厅吊灯,第二路接射灯,第三路接风扇。

  2. 直接替换:如果你家里现在是普通开关,拆下来,按照零火线/单火线接好,把它装上去就行,不用改线路

  3. 带“大脑”:它内置了WiFi模块(注意只支持2.4G WiFi),连上网就能接收互联网指令

二、接入原理(一句话版本)

芯步把这个复杂的物联网通信简化成了我们程序员最熟悉的 HTTP 请求

你把你的服务器当成“总司令”,把智能开关当成“小兵”。你要做的,就是给你的服务器写一段代码,让它向芯步的云端服务器发一条 POST 请求,云平台就会把这条指令转发给你的“小兵”(智能开关),让它执行

延迟大概在 80-120 毫秒,基本上你点一下APP里的按钮,灯就亮了,几乎没有延迟感

三、实战:手把手教你接代码

第一步:准备工作(拿钥匙)

在动手写代码前,你需要去芯步的控制台拿到三样东西,这三样是通行证:

  1. AppID:你的应用ID,识别你是谁。

  2. AppSecret:你的应用密钥,别泄露给别人。

  3. Device ID:设备的ID,就是你买的那台开关的身份证。

拿到这些后,你需要知道如何计算签名(Sign),这是为了防止接口被别人乱刷。算法很简单(虽然有点绕):

Sign = md5( md5(AppSecret) + ts )简单说就是:先把你的 AppSecret 加密一次,再拼接上当前时间戳,再把整个字符串加密一次。

第二步:组装命令(让灯“听”话)

我们要控制的是3路开关,所以命令格式是一个 JSON 串。

假设你的场景:晚上回家,只想打开第1路(走廊灯)和第3路(客厅灯),第2路(阳台灯)保持关闭。你的 JSON 命令就是:

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

第三步:发送请求(秀操作)

我们用一个非常简单的 curl 命令来演示发送过程(你也可以用 Python、PHP、Go 等任何语言)。

注:上面的 820720 是示例设备ID,请换成你自己的。

如果一切顺利,你会收到一个成功的返回,然后... 灯就亮了!

四、进阶玩法:让开关更“聪明”

光用手机远程开关还不够,这个开关支持一些高级参数,让联动场景更有趣。芯步的接口支持 “定时恢复”“点动模式”

第一种场景:楼道感应灯(保持关)

需求:楼道灯通过面板打开后,没人关灯会亮一宿,费电。方案:下发一个“保持关”命令,告诉开关:就算用户手贱按开了,10秒后也必须给我关掉。

第二种场景:排气扇/智能家居联动(点动模式)

需求:按一下开关,电机转一下停止(比如给门禁一个脉冲信号)。方案:使用先通后断(Point)功能。

这对于控制老式卷帘门电机或者给某些设备一个触发信号非常实用

五、如果不想走云端?

有些项目要求纯内网(局域网)控制,安全第一