CATALOG

芯步的2路智能墙壁开关开放了标准的HTTP接口,对接起来其实挺顺滑的。下面我会从接线开始,一步步带你走通整个流程,重点讲怎么用它的API创建定时任务,实现照明设备的自动开关。

一、 咱们先把它“装好”并连上网(准备工作)

在写代码之前,得先让这个开关“活”起来,连上家里的WiFi。

  1. 硬件接线(安全第一!)

    • 记得把家里的总电闸关了再操作(别嫌麻烦,安全第一)。

    • 零火线:虽然开关背后只有L(火线进)、L1(灯线1出)、L2(灯线2出),但现在的智能开关必须要有零线才能供电工作。如果墙里没有零线,得找电工确认一下。

    • 接灯:把你要控制的两盏灯的线分别接在L1和L2上

  2. 配网(让开关认识路由器)

    • 去应用商店下载“芯步”App(或者用微信小程序也行)。

    • 长按开关面板,直到指示灯急速闪烁(像呼吸灯一样),这就进入配网模式了。

    • 重点提醒:WiFi一定要用2.4G频段,5G频段它识别不了。在App里输入你家的WiFi密码,等它“叮”一声,指示灯常亮,就说明连上了

  3. 拿到设备的“身份证”

    • 登录芯步的官网后台,在“物联网控制台”里找到你刚添加的这个设备。

    • 记下那一串设备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命令大概长这样:

只要返回的code200,你家的灯应该就亮了

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或小程序里,点进设备详情页,直接找“定时”功能设置就行了,完全不用写代码。

四、 帮你避坑: