怎样接入3路墙壁智能开关以实现定时开关照明设备_解决方案

CATALOG

芯步的3路智能开关开放了完整的HTTP API接口，可以通过简单的签名认证直接控制每一路照明。下面这份方案会带你走通从硬件准备到代码实现的全过程，重点是怎么用接口做定时控制。

1. 我们都需要准备啥？

在动手之前，咱们得先把“家伙什儿”备齐了。其实很简单，主要就这么三样：

一台芯步的“3路智能墙壁开关”：记得买的时候看准型号，要那种写着“3路”的。根据官方参数，它长这样：86型标准大小，能直接替换家里的老开关，每路最大能带300-1200W的灯或电器，客厅的大吊灯或者走廊的筒灯都够用了。
一个芯步开发者账号：得先去官网注册一个账号，然后进到“工作台”里的“物联网控制台”。在这里你要找到两个关键字符串：
- AppID：像是你的“用户名”。
- AppSecret：像是你的“密码”，这个千万别泄露给别人。这两个是后面调用接口的“钥匙”。
一个能跑代码的电脑或服务器：定时任务总得有地方跑吧？你可以用家里的树莓派、一直开着的电脑，或者随便一个云服务器都行。哪怕用Windows自带的“任务计划程序”都行。

2. 硬件安装与接线（简单带过）

这玩意儿接线其实不复杂，但再次强调：涉及强电，一定要找专业电工师傅操作！

标准86盒：只要你家墙上那个开关底盒是86型的（大部分都是），就能直接换上去，不用凿墙。
接线注意：开关背后一般会有标识。你需要把进线（火线）接好，然后“L1”、“L2”、“L3”分别接三路灯的线。要是家里是老房子没零线，芯步的开关也有单火版本，不用担心装不了。

3. 核心逻辑：怎么通过API控制开关？

硬件连上网（通常是2.4G Wi-Fi）后，在控制台能看到设备ID。接下来就是用代码发指令了。

芯步的接口挺友好的，就一个地址，用POST方法发个JSON数据过去就行。关键是签名（Sign） 要算对，这是为了防止别人乱发指令。

第一步：搞懂“签名”（Sign）怎么算

别被“加密”吓到，这就是一层薄薄的“窗户纸”，捅破了贼简单。官方给的算法是：md5(md5(你的AppSecret) + ts)。

翻译成人话就是：

先把你的AppSecret做一次MD5加密，得到一个32位的字符串（叫它str1吧）。
把你当前的时间戳（ts） 拼在str1的后面，变成一串新字符。
再把这一长串做一次MD5加密，最后得到的32位字符串就是Sign。

第二步：下命令——“把第一路打开！”

比如你要控制家里的客厅灯（设备ID假设是 100001） 打开第一路，你得给服务器发个请求。

请求地址https://api.thingboot.com/你的AppID/device/control/
参数（Body）

一个小提示：3路开关的命令分别是 power1、power2、power3。如果你想关掉第二路的灯，就把命令写成 {“power2”： 0}。

4. 实战环节：如何实现“定时开关”？

懂了怎么单次控制，定时就好办了。无非就是“到了指定时间，系统自动去调用上面那个开/关的接口”。

为了让大家看得明白，我直接给出一段 Python代码。假设我们要实现：每天晚上18：00 打开客厅灯（第1路），晚上23：00 关闭客厅灯（第1路）。

Python 代码示例（保姆级注释）

import requests
import time
import hashlib
import schedule  # 这是一个专门做定时的库，需要安装:pip install schedule

# --- 配置区:请把这里改成你自己的信息 ---
APP_ID = "请替换成你的AppID"
APP_SECRET = "请替换成你的AppSecret" 
DEVICE_ID = "请替换成你的3路开关设备ID" 
# ------------------------------------

def calculate_sign(ts):
    """计算芯步需要的签名 Sign"""
    # 1. 把 AppSecret 加密一次
    md5_secret = hashlib.md5(APP_SECRET.encode(‘utf-8’)).hexdigest()
    # 2. 拼接 ts (注意 ts 必须是字符串)
    str_to_sign = md5_secret + str(ts)
    # 3. 再次加密，得到最终的 sign
    sign = hashlib.md5(str_to_sign.encode(‘utf-8’)).hexdigest()
    return sign

def control_light(switch_num, action):
    """控制开关
    :param switch_num: 数字 1、2 或 3，代表第几路
    :param action: 字符串 ‘on’ 或 ‘off’，代表开或关
    """
    # 获取当前时间戳（10位秒级）
    ts = int(time.time())
    # 生成签名
    sign = calculate_sign(ts)
    
    # 构造 URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/？sign={sign}&ts={ts}"
    
    # 构造命令
    # 如果开关是第1路，命令就是 {"power1": 1}
    power_key = f"power{switch_num}"
    power_value = 1 if action == "on" else 0
    order_json = {power_key: power_value}
    
    # 构造请求体
    payload = {
        "device": DEVICE_ID，
        "order": order_json
    }
    
    # 发送 POST 请求
    headers = {"Content-Type": "application/json"}
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=10)
        print(f"[{time.strftime(‘%Y-%m-%d %H:%M:%S’)}] 指令已发送:第{switch_num}路 -> {action}")
        print("服务器返回:"， response.text)
    except Exception as e:
        print(f"发送失败: {e}")

# --- 定义定时任务 ---
# 每天晚上 18:00 打开第1路
schedule.every().day.at("18:00").do(control_light， switch_num=1， action="on")
# 每天晚上 23:00 关闭第1路
schedule.every().day.at("23:00").do(control_light， switch_num=1， action="off")

if __name__ == "__main__":
    print("定时控制系统已启动，正在监控中...")
    while True:
        schedule.run_pending()  # 检查是否有需要执行的任务
        time.sleep(1)           # 每秒检查一次（别太频繁，1秒够了）

代码运行效果当你把代码在电脑上跑起来，命令行会提示“正在监控中”。只要电脑时间准，一到18：00，你就会看到打印“指令已发送”，你家的灯就自动亮起来了。这个方案对于走廊、阳台或者出门忘关灯的场景特别实用。

5. 一点小与避坑指南

关于网络：芯步支持局域网通信。如果你追求极致的稳定和速度（或者家里断网了也想让定时生效），可以在路由器里绑定开关的IP地址，然后在代码里把api.thingboot.com换成你开关的局域网IP。不过最简单的还是用云端，零维护成本。
安全提醒：上面代码里的 AppSecret 千万别写在网页前端的JS里，不然容易被别人看到。最好放在后端服务器调用。
负载功率：千万注意你接的灯的总功率。虽然开关标称10A，但如果是LED灯，别看它亮起来瓦数小，启动瞬间电流大。官方LED灯每路不要超过300W。

希望这个方案能帮到你，快去动手试试吧，看着自己写的代码控制家里的灯，还是挺有成就感的。