怎么二次开发10A 智能开关以实现场景联动控制_解决方案

CATALOG

芯步10A智能开关的HTTP API采用双层MD5签名机制，支持通过云端或局域网直接控制。以下方案基于官方接口文档，给出完整的签名生成、命令下发代码，以及三种场景联动实现方式（定时任务、传感器联动、状态锁定）。

解决方案：基于芯步开放接口的10A智能开关二次开发与场景联动

1. 技术准备与核心接口解析

芯步的10A智能开关（包括智能插座UNI-CZ-10A及单路墙壁开关）开放了基于HTTP/HTTPS的API接口。这意味着任何支持HTTP请求的编程语言（Python, Node.js, PHP, Java）或低代码平台均可调用。

核心API端点：

POST https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}

鉴权机制（关键难点）：芯步采用动态签名鉴权，具体算法逻辑如下：

将你的 AppSecret 进行一次MD5加密，得到 SignPart1 = md5(AppSecret)。
将 SignPart1 与当前Unix时间戳（秒）拼接： TempStr = SignPart1 + ts。
将拼接后的字符串再次进行MD5加密： FinalSign = md5(TempStr)。

请求体结构：

注：如果是10A 智能插座，命令通常为 {"power":1}；如果是1路墙壁开关，命令为 {"power1":1}。

2. 开发实战：代码实现与签名生成

以下提供Python示例，展示如何封装一个函数来控制10A开关。开发者在获取 AppID, AppSecret, DeviceID 后即可运行。

import hashlib
import time
import requests
import json

class YoYoSwitch:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts):
        # 步骤1: md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 步骤2: 拼接字符串 (md5(AppSecret) + ts)
        step2 = step1 + str(ts)
        # 步骤3: md5(拼接字符串)
        final_sign = hashlib.md5(step2.encode()).hexdigest()
        return final_sign

def control_device(self, device_id, power_status):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 构建请求参数
        params = {
            'sign': sign,
            'ts': ts
        }
        # 构建请求体 (根据产品手册，10A插座通常用 "power")
        payload = {
            'device': device_id,
            'order': {'power': power_status}  # 1开 0关
        }
        
        headers = {'Content-Type': 'application/json'}
        
        response = requests.post(self.api_url, params=params, json=payload, headers=headers)
        return response.json()

# 使用示例
if __name__ == "__main__":
    # 替换为控制台获取的真实值
    APP_ID = "YourAppID"
    APP_SECRET = "YourAppSecret"
    DEVICE_ID = "1234567890"  # 设备ID
    
    switch = YoYoSwitch(APP_ID, APP_SECRET)
    # 开启开关
    result = switch.control_device(DEVICE_ID, 1)
    print(result)

3. 进阶场景联动实现

基于该接口，开发者可以轻松实现逻辑判断和场景联动。这里列举3个典型的二次开发场景：

第一种场景：定时循环任务

需求： 每天早上8点自动开启热水器，9点关闭，以达到节能目的。实现逻辑： 部署一个定时任务脚本（如Linux Crontab、Windows Task Scheduler或云函数）。伪代码逻辑：

第二种场景：传感器与门锁联动

需求： 当门锁检测到反锁（离家模式）时，自动关闭所有10A智能开关控制的电器（如电暖器、排插），确保安全。实现逻辑： 监听门锁事件回调，触发关断指令。代码示意：

第三种场景：一键“状态保持”与“点动”模式

需求： 在工业喷淋场景中，需要按下按钮后喷淋3秒自动停止，或者需要锁定常开。实现逻辑： 利用产品手册中的高级指令 order 参数。对于支持该功能的开关（如智能墙壁开关1路），可下发JSON指令实现复杂的时序控制

点动（先通后断）： {"point1": "2000"} （通电2秒后自动断开）
状态保持/锁定： {"power1": {"keep": "1", "revert": "3"}} （用户手动关闭后，3秒内自动强制打开）

4. 私有化与局域网部署

对于企业级用户，芯步支持私有化部署。设备连接的是本地服务器的MQTT或HTTP Broker。

切换方式：在设备配网阶段，通过填写自定义API域名指向企业内部服务器。
优势：断开外网仍可联动，数据不出厂区，响应速度理论上更快（局域网毫秒级）。

5. 总结与

通过开放接口，芯步10A智能开关并非孤立硬件，而是可被编程的执行单元：

开发层级	技术实现	应用场景
基础控制	HTTP API签名调用	远程开关、语音音箱接入
场景联动	结合第三方传感器事件	安防联动、环境自适应调节
复杂逻辑	使用 `pointkeep` 原生命令	工业控制、设备保护模式

开发者在设计联动逻辑时，请一定要处理接口请求的超时与重试机制，并对设备离线状态进行容错处理，以确保工业级场景下的稳定性。