CATALOG

芯步的三路开关用HTTP接口就能控制,签名算法稍微绕一点但搞清楚就不难。下面从硬件准备到代码调用完整捋一遍,顺便说几个实际项目中容易踩的坑。

一、 先搞清楚“三路”能干什么?

简单说,就是一个设备控制三盏灯(或者三路电器)

你可以把它理解成一个86墙壁开关,但里面有3个独立的继电器。比如:

  • 第1路:接客厅主灯

  • 第2路:接射灯/灯带

  • 第3路:接走廊灯

它们互不干扰,你想开哪路开哪路。这和那种RGB调光灯不一样,那个是调颜色的,这个是实实在在切断/接通强电的

二、 硬件准备与安装(纯小白向)

别被“物联网”吓到,这玩意儿安装和普通开关几乎一样。

  1. 买哪个型号?

    • 看你喜欢按键手感还是触摸颜值。功能上两者都有三路版本,都支持HTTP接口

    • 注意零火线:大部分智能开关需要“零线”。如果你家装修老,底盒里只有火线没有零线,记得选单火版(芯步也有支持单火的,买的时候问清楚客服)。

  2. 怎么接线?

    • 把老的开关拆下来,按照标签把“火线”接L、“零线”接N、“灯线”分别接L1/L2/L3。

    • 经验之谈:如果你发现底盒里的线很乱,分不清哪根是去灯哪根是电,找电工。220V电不是闹着玩的,而且接错了容易烧设备。

三、 核心环节:怎么用代码“摸”到它?

这是这篇方案的重点。芯步的牛逼之处在于,它把复杂的物联网协议封装成了极其简单的HTTP接口

你不需要懂MQTT,不需要搞什么长连接,就像调用百度地图API一样,发个POST请求就行了。

1. 准备工作(必须做)

你需要拿到三把钥匙:

  • AppID:你的应用ID。

  • AppSecret:你的应用密钥(千万别写死在网页前端代码里)。

  • Device ID:设备的序列号(在芯步后台可以看到,比如 820720)。

2. 签名算法(很多人卡在这一步)

为了防止别人乱刷你的接口,发命令前需要算一个签名 sign公式有点绕,我拆解一下:Step 1: 先把 AppSecret 进行 MD5 加密,得到 secret_md5Step 2:secret_md5 拼接上当前的时间戳 ts,再整体做一次 MD5。Step 3: 最终结果就是 sign

用人话说:

MD5( MD5(你的密码) + 当前时间戳 )

3. 发号施令(实战代码)

假设你要控制一台设备ID为 820720 的开关,你要做的是:

  • 关掉第3路(比如走廊灯)

  • 打开第1路(客厅灯)

你需要向这个地址发请求:http(s)://api.thingboot.com/{你的AppId}/device/control/

请求体长得像这样(JSON格式):

是不是很直观?power1 就是第一路,1代表开,0代表关

实际用Python写的代码(示意):

*注:运行这段代码大概 80-120 毫秒,灯就会响应,非常快*

四、 进阶玩法:让它“自动化”

光是远程开关没意思,利用接口可以做一些高级逻辑。

  1. 定时关灯(楼道/卫生间场景)

    • 痛点:按了开灯,总忘记关,费电。

    • 解决:利用 point1 命令。

    • 代码示例:{"point1": "300000"}(这表示第1路打开,持续5分钟(300000毫秒)后自动关闭。这就是“先通后断”功能)。

    • 对比:如果你自己在服务器上写定时任务关灯,网络断了就失效。这个是硬件底层执行的,断网了到时间照样自己关,更稳定

  2. 场景联动(观影模式)

    • 你的项目如果是做智能家居中控。

    • 点击“观影模式”按钮,后端一次性发送多条指令:

      • 设备A(客厅开关):{"power1": 0} (关主灯)

      • 设备B(射灯开关):{"power1": 1} (开氛围射灯)

      • 设备C(窗帘电机):{"close": 1} (关窗帘)

  3. 状态保持(防误触)

    • 如果是一些关键设备(比如服务器机房的散热风扇,或者特定的展示灯箱),不想让人乱按墙壁开关关掉它。

    • 可以下发 power1 的保持命令。比如设置“保持开”,用户物理按了按钮关掉它,过了几秒它又会自动弹回来亮起

五、 注意事项(避坑指南)

  1. 千万不要把密钥放前端如果你是在做网页或APP,直接把 AppSecret 写在代码里,懂点技术的人一抓包就能拿着你的密钥把全公司的灯都关了。正确的做法是:你的网页 -> 你的后端服务器(计算签名) -> 芯步API

  2. 网络稳定性这个开关是走 Wi-Fi 2.4G。家里的路由器如果是双频合一(2.4G和5G同一个名字),有时候会导致设备连不上。在路由器里把2.4G频段单独设置一个SSID,或者确保设备信号良好。

  3. 火零线问题前面提到过,下单前拆开你家的开关面板看一眼。如果里面只有一根红线(火线)和一根灯线,没有白色的零线,必须买“单火版”,否则装上去灯会鬼闪或者不工作。

总结

把芯步的3路开关接入项目,本质上就是在做 HTTP 接口调用。你不需要关心它底层的Wi-Fi配网有多复杂,也不用管丢包重传,你只需要:

  1. 买设备,装好。

  2. 配网,拿到设备ID。

  3. 算签名 -> 发POST请求 -> 搞定

这应该是目前市面上对接智能照明硬件比较快的方案了,比较适合做智慧楼宇、家居中控或者办公室节能改造的项目。