怎样二次开发86型3路WiFi开关来实现场景联动照明控制_解决方案

CATALOG

这是一份关于基于芯步86型3路WiFi开关的二次开发解决方案。我尽量写得偏实战和口语化一些，方便你理解思路。

一、我们想要解决什么问题？

想象一下这些场景：

人来灯亮：推开储物间的门，灯自动亮起，离开后自动熄灭。
一键影院模式：点击手机上的“观影”按钮，客厅主灯关闭，电视背景墙的射灯打开，窗帘缓缓合上。
离家模式：出门按一下门锁，家里所有的灯光全部关闭。

要实现这些“场景联动”，核心在于：传感器感知状态 → 服务器/大脑做判断 → WiFi开关执行动作。

本文将手把手教你如何利用芯步86型3路WiFi开关的开放HTTP接口，把普通的灯变成智能联动的灯。

二、准备工作：认识你的“装备”

1. 硬件：86型3路WiFi开关

这就是你墙上的开关，但它连了网。

3路：意味着它能独立控制3组不同的灯（比如：路1=客厅主灯，路2=射灯，路3=走廊灯）。
安装：直接替换家里的标准86盒，零火线供电（注意家里是否有零线）。
特色功能：它有一个“状态保持”功能很有用，后面会用到。

2. 开放武器库：HTTP接口

芯步最大的好处是接口开放，你不用受限于它的官方App。只要支持HTTP请求（比如Python、Java、JS或任何后端语言），就能指挥它。

控制接口POST https://api.thingboot.com/{AppId}/device/control/
核心参数device（设备ID）、order（你要它干嘛的命令）。

3. 联动的大脑：你的私有服务器

我们不需要改造硬件。只需要在你的云端服务器（或者家里24小时开机的树莓派/NAS）上写一段脚本，接收传感器的信号，然后给开关发指令。

三、核心接口解析：学会发号施令

在动手写代码前，我们先搞懂怎么“指挥”这个开关。

1. 鉴权与签名

为了安全，直接调用接口是不行的，需要加个“密码”。芯步用的是动态签名。公式sign = md5( md5(AppSecret) + ts )

AppSecret：你的开发者密钥。
ts：当前时间戳。
做法：先对你的密钥做一次MD5，拼上时间戳，再做一次MD5。这样每次请求的签名都是变化的，防止别人盗用。

2. 基础指令：开关灯

如果你想让第1路的灯打开，order参数如下

开{"power1": 1}
关{"power1": 0}

同理，控制第2路就是power2，第3路是power3。这三路是完全独立的，你可以把它们当作三个独立的开关去控制。

3. 高级指令：场景联动的点睛之笔

普通开关只能保持“开”或“关”，但这款开关有几个高级玩法：

A. 点动模式（用于门磁/人来灯亮）

场景：储物间开门，灯亮；人走后（或关门），灯灭。你需要让开关开启 “先通后断” 。

命令{"point1": 5000}含义：让第1路接通，保持5秒（5000毫秒）后自动关闭。这非常适合配合“人体传感器”——检测到人，触发这个命令，灯亮5分钟（如300000毫秒）后自动关，省去再发一次关灯指令的麻烦。

B. 互锁模式（用于风扇/取暖器）

场景：一个设备只有高低档，不能同时开两个档位（比如浴霸的暖风1和暖风2）。

命令：开2路时自动关1路 {"power2": 1, "power1": 0}接口支持批量下发命令，你可以通过代码逻辑保证不会同时开启两个开关。

四、实战场景搭建：手把手写代码

假设我们有一个人体传感器（比如小米的，或者芯步的红外传感器）检测到有人经过，我们就打开走廊的灯（例如接在第3路），30秒后自动关闭。

第一步：获取必要的ID

在芯步后台：

找到你的 AppId 和 AppSecret。
找到你绑定好的86开关的 Device ID（例如：820720）。

第二步：写代码（以Node.js/Python为例）

我们需要写一个API路由，用来接收传感器的触发；以及一个函数，用来控制开关。

伪代码逻辑：

传感器检测到人 -> 向你的服务器发请求。
你的服务器接收请求 -> 调用芯步API -> 向开关发送 point3=30000 指令。

代码片段示例（核心指令部分）：

import requests
import hashlib
import time

# 配置信息
app_id = "你的AppId"
app_secret = "你的AppSecret"
device_id = "820720"  # 这是你的86开关ID

# 1. 生成签名
def generate_sign(secret, ts):
    # md5(md5(secret) + ts)
    step1 = hashlib.md5(secret.encode()).hexdigest()
    step2 = step1 + str(ts)
    sign = hashlib.md5(step2.encode()).hexdigest()
    return sign

# 2. 控制开关的函数
def control_light(order_json):
    ts = int(time.time())
    sign = generate_sign(app_secret, ts)
    
    url = f"https://api.thingboot.com/{app_id}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    data = {
        "device": device_id,
        "order": order_json
    }
    
    # 发送POST请求
    response = requests.post(url, params=params, json=data)
    print(f"指令 {order_json} 发送结果: {response.text}")

# 3. 场景联动逻辑:假如传感器被触发了...
def on_sensor_triggered():
    # 需求:走廊灯（第3路）亮30秒后自动熄灭
    # 指令:{"point3": 30000}
    control_light({"point3": 30000})
    print("走廊灯已打开，30秒后自动熄灭")

# 模拟场景
if __name__ == "__main__":
    # 假设收到了传感器的触发信号
    on_sensor_triggered()

第三步：更复杂的“多路联动”

如果你想实现“离家模式”，需要关闭所有灯。虽然可以分别调用三次关闭接口，但为了效率，可以直接循环或者在逻辑里一次性构建：

如果想实现“睡眠模式”（关主灯，开床头灯）：

五、进阶技巧：状态同步与硬件锁定

1. 实时状态反馈

在二次开发中，有时候你需要知道灯当前是开还是关。芯步支持消息推送。你需要设置一个接收URL（同样在你的服务器上）。当开关状态改变时（无论是手机控还是物理按键按的），平台会把新状态POST到你设定的地址。这样，你手机App上的图标就能实时同步了，不会出现“实际关着，App显示开着”的尴尬。

2. 物理按键锁定

这是一个很人性化的功能。比如你在做“投影仪联动”场景时，为了防止熊孩子乱按墙壁开关把投影仪关了，你可以利用开关的 “状态保持” 功能。

指令{"power1": {"keep": "1", "revert": "3"}}效果：用户手动关掉开关后，开关会在3秒后自动又打开。相当于物理按键失效，保证了场景的稳定性。

六、总结

通过对芯步86型3路WiFi开关的二次开发，我们只需要掌握 “签名计算” 和 “order命令构造” ，就能把它从单一的墙壁开关，升级为：

一个独立的三路智能执行器；
配合人体感应的自动照明系统；
家居全屋智能场景的重要组成部分。

整个过程不需要改动任何硬件电路，完全依靠云端API驱动。只要你有简单的编程基础（能发HTTP请求），就能轻松实现“人来灯亮、人去灯熄、一键全关”等复杂的场景联动照明控制。