芯步的2路智能墙壁开关开放了标准的HTTP接口,对接起来其实挺顺滑的。下面我会从接线开始,一步步带你走通整个流程,重点讲怎么用它的API创建定时任务,实现照明设备的自动开关。
一、 咱们先把它“装好”并连上网(准备工作)
在写代码之前,得先让这个开关“活”起来,连上家里的WiFi。
硬件接线(安全第一!)
记得把家里的总电闸关了再操作(别嫌麻烦,安全第一)。
零火线:虽然开关背后只有L(火线进)、L1(灯线1出)、L2(灯线2出),但现在的智能开关必须要有零线才能供电工作。如果墙里没有零线,得找电工确认一下。
接灯:把你要控制的两盏灯的线分别接在L1和L2上。
配网(让开关认识路由器)
去应用商店下载“芯步”App(或者用微信小程序也行)。
长按开关面板,直到指示灯急速闪烁(像呼吸灯一样),这就进入配网模式了。
重点提醒:WiFi一定要用2.4G频段,5G频段它识别不了。在App里输入你家的WiFi密码,等它“叮”一声,指示灯常亮,就说明连上了。
拿到设备的“身份证”
登录芯步的官网后台,在“物联网控制台”里找到你刚添加的这个设备。
记下那一串设备ID(比如
12345678),这就是你以后发指令要找的对象。
二、 核心玩法:怎么发指令给它
芯步的接口很开放,用的是标准的HTTP协议,不管你用什么编程语言(Python、Java、PHP)都能调。
1. 先搞懂“签名”
它的接口地址大概是这样的:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}
这里的sign(签名)是为了安全,防止别人乱发指令捣乱。虽然是加密,但其实公式很简单:sign = md5( md5(你的AppSecret) + ts )
AppSecret: 相当于你账户的私钥,在后台“开发设置”里能看到。ts: 当前的Unix时间戳(比如 1715328000)。md5: 是一种加密算法。白话解释:就是把你的密钥先加密一次,再拼接上当前时间,整体再加密一次。这样每次请求的密码都不一样,防止被坏人利用。
2. 动手试试“开关灯”
用你电脑上的命令行工具 curl 就可以测试(或者用Postman)。我们试着控制第一路灯:
操作:打开开关的第一路。
命令:
{"power1":"1"}(1是开,0是关)
假设参数:
AppID =
123设备ID =
456你要开的灯 = 线路1
完整的CURL命令大概长这样:
只要返回的code是200,你家的灯应该就亮了。
2路开关的常用“命令参数”参考:
| 你想做的事 | 对应的命令内容 (order里的值) | 说明 |
|---|---|---|
| 开 第一路 | {"power1":"1"} | 立刻打开 |
| 关 第一路 | {"power1":"0"} | 立刻关闭 |
| 开 第二路 | {"power2":"1"} | 立刻打开 |
| 关 第二路 | {"power2":"0"} | 立刻关闭 |
| 临时开/关 | {"point1":"2000"} | 第一路接通2秒后自动断开 |
| 状态恢复 | {"reset1":"3000"} | 第一路断开3秒后自动恢复(复位) |
三、 实现“定时开关”(重点来了)
如果你只是想写几行代码在某个时间点关灯,方法其实很简单:在你的服务器上写个脚本,用 cron 或计划任务,在指定时间去调用上面的 device/control 接口就行了。
不过,芯步提供了一个更稳当的办法——云平台定时任务。这样做的好处是:即使你的手机关机了,或者家里的网断了(指令是存在云端的),设备只要通电,到点就会执行。
我们要用的接口是: /task/create/
场景设定: 想让走廊灯(第二路)每天晚上 18:00 准时亮,第二天早上 7:00 准时灭。
第一步:创建“18:00开灯”的任务
你需要向服务器发送一个 task/create 的请求。
任务类型:
day(每天执行)执行时间:
18:00:00执行内容:
{"power2":"1"}(打开第二路)
第二步:创建“07:00关灯”的任务
任务类型:
day(每天执行)执行时间:
07:00:00执行内容:
{"power2":"0"}(关闭第二路)
如果你不想这么麻烦,想偷个懒:其实最简单的方法是在“芯步”的官方App或小程序里,点进设备详情页,直接找“定时”功能设置就行了,完全不用写代码。