智能3路开关的远程控制其实很简单——芯步的开放接口基于标准HTTP协议,签名算法规整,基本上拿到文档后十几分钟就能跑通第一组命令。下面我从硬件准备到接口调用、再到场景应用,一步步说清楚。
一、我们面对的是什么设备?
智能3路墙壁场景联动开关(具体型号通常为 UNI-KG-3 或类似),简单来说,就是一个能放进标准86底盒(家里的墙壁开关大小)的硬件。
它有三个核心特点:
三路独立控制:一个开关面板可以分别控制三盏灯或三个设备。比如第一路接客厅吊灯,第二路接射灯,第三路接风扇。
直接替换:如果你家里现在是普通开关,拆下来,按照零火线/单火线接好,把它装上去就行,不用改线路 。
带“大脑”:它内置了WiFi模块(注意只支持2.4G WiFi),连上网就能接收互联网指令 。
二、接入原理(一句话版本)
芯步把这个复杂的物联网通信简化成了我们程序员最熟悉的 HTTP 请求。
你把你的服务器当成“总司令”,把智能开关当成“小兵”。你要做的,就是给你的服务器写一段代码,让它向芯步的云端服务器发一条 POST 请求,云平台就会把这条指令转发给你的“小兵”(智能开关),让它执行 。
延迟大概在 80-120 毫秒,基本上你点一下APP里的按钮,灯就亮了,几乎没有延迟感 。
三、实战:手把手教你接代码
第一步:准备工作(拿钥匙)
在动手写代码前,你需要去芯步的控制台拿到三样东西,这三样是通行证:
AppID:你的应用ID,识别你是谁。
AppSecret:你的应用密钥,别泄露给别人。
Device ID:设备的ID,就是你买的那台开关的身份证。
拿到这些后,你需要知道如何计算签名(Sign),这是为了防止接口被别人乱刷。算法很简单(虽然有点绕):
Sign = md5( md5(AppSecret) + ts )简单说就是:先把你的 AppSecret 加密一次,再拼接上当前时间戳,再把整个字符串加密一次。
第二步:组装命令(让灯“听”话)
我们要控制的是3路开关,所以命令格式是一个 JSON 串。
假设你的场景:晚上回家,只想打开第1路(走廊灯)和第3路(客厅灯),第2路(阳台灯)保持关闭。你的 JSON 命令就是:
是不是很直观?power1、power2、power3 分别对应开关背后的三根控制线 。
第三步:发送请求(秀操作)
我们用一个非常简单的 curl 命令来演示发送过程(你也可以用 Python、PHP、Go 等任何语言)。
注:上面的 820720 是示例设备ID,请换成你自己的。
如果一切顺利,你会收到一个成功的返回,然后... 灯就亮了!
四、进阶玩法:让开关更“聪明”
光用手机远程开关还不够,这个开关支持一些高级参数,让联动场景更有趣。芯步的接口支持 “定时恢复” 和 “点动模式”。
第一种场景:楼道感应灯(保持关)
需求:楼道灯通过面板打开后,没人关灯会亮一宿,费电。方案:下发一个“保持关”命令,告诉开关:就算用户手贱按开了,10秒后也必须给我关掉。
第二种场景:排气扇/智能家居联动(点动模式)
需求:按一下开关,电机转一下停止(比如给门禁一个脉冲信号)。方案:使用先通后断(Point)功能。
这对于控制老式卷帘门电机或者给某些设备一个触发信号非常实用 。
五、如果不想走云端?
有些项目要求纯内网(局域网)控制,安全第一