智能家居电路保护：怎么把35A智能空开开关集成到软件项目中_解决方案

CATALOG

芯步的35A智能空开通过HTTP接口开放控制能力，可以快速集成到各类软件项目中。以下方案从接口对接、签名认证到部署架构，梳理了完整的集成路径。

解决方案：芯步35A智能空开开关在软件项目中的集成与应用

1. 概述与准备工作

芯步的智能断路器35A（UNI-DLQ-35A）是一款支持WiFi直连的智能硬件，无需网关即可接入网络。该产品最显著的特点是提供了全开放的HTTP API接口，这意味着无论你的软件项目是基于Web、移动端（APP/小程序）还是桌面应用，都可以通过标准的HTTP协议与其进行通信，实现对电路通断的控制和监控。

核心准备工作：

获取凭证：在芯步官方平台注册开发者账号，在控制台获取 AppID 和 AppSecret。
设备配网：确保35A智能空开已通电并连接至2.4G WiFi网络。
获取设备ID：在平台控制台查看设备列表，获取目标设备的唯一标识 device ID。

2. 接口集成方案

芯步的接口设计遵循简单的请求-响应模式，核心在于通过HTTP POST请求发送控制指令。

2.1 核心接口地址

2.2 签名机制（鉴权）为了确保安全性，每次请求都需要携带签名sign和时间戳ts。签名生成算法如下：

将 AppSecret 进行 MD5 加密，得到 secret_md5。
将 secret_md5 与当前时间戳 ts 进行拼接。
对拼接后的字符串再次进行 MD5 加密，得到最终的 sign。

算法公式：sign = MD5( MD5(AppSecret) + ts )

2.3 控制指令格式

针对35A智能空开（通常对应单路或多路控制），请求的Content-Type应为application/json。请求体需包含device和order两个字段。

单路控制（打开/关闭）假设需要控制设备的第1路输出，命令如下：
{ "device": "设备的唯一ID", "order": {"power1": 1} // 1为接通（开），0为断开（关） }
注意：如果是单路版本的空开，命令通常为{"power":1}；多路版本则使用power1、power2等。
定时/延时控制芯步的接口支持内置延时功能，无需在软件端维护定时任务。例如，“在1小时后断开电路”：
{ "device": "设备ID", "order": {"reset": 3600000} // 单位是毫秒，3600000ms = 1小时 }
该命令会让开关立即接通，并在1小时后自动断开。
批量控制如果需要同时控制多个空开，可以在device参数中用逗号分隔ID，或者在order中使用batch指令。
{ "device": "ID1,ID2,ID3", "order": {"power": 0} // 批量关闭所有列出的设备 }

3. 代码实现案例

以下是一个基于Python的实现案例，展示了如何将上述逻辑封装成一个简单的电路控制模块：

import hashlib
import time
import requests

class SmartBreaker:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _gen_sign(self, ts):
        # 1. MD5(AppSecret)
        secret_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. MD5(secret_md5 + ts)
        raw_sign = secret_md5 + str(ts)
        sign = hashlib.md5(raw_sign.encode()).hexdigest()
        return sign

def control(self, device_id, power_status):
        ts = int(time.time())
        sign = self._gen_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        # 构造控制指令
        payload = {
            "device": device_id,
            "order": {"power": 1 if power_status else 0}
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 使用示例
breaker = SmartBreaker("你的AppID", "你的AppSecret")
result = breaker.control("设备ID", True) # 合闸通电
print(result)

响应时间：根据官方数据，从命令下发到设备执行的响应时间约为80-120ms，适合构建实时响应的交互体验。

4. 设计：公有云 vs. 局域网

根据你项目对安全性、稳定性和响应速度的要求，芯步的接口支持两种部署模式：

特性	公有云模式	私有化部署/局域网模式
调用地址	`api.thingboot.com`	自建服务器IP或设备局域网IP
网络要求	设备与软件端均有外网	设备与服务器在同一局域网，可断网运行
适用场景	手机APP远程控制、连锁店铺管理	工厂车间、别墅豪宅、高保密性场所
优势	无需维护服务器，即插即用	极低延迟，数据不外流，断网可用

集成：若你的软件项目运行在企业内网，且对电路保护的安全性要求比较高（如数据中心机房），采用私有化部署方案。这种情况下，可以直接调用设备在局域网内的本地IP地址进行控制，完全脱离外网。

5. 高级功能集成（可选）

除了基础的通断控制，你还可以利用接口实现更智能的“主动保护”逻辑：

功率过载保护：通过接口查询设备的实时功率（需设备支持计量功能），若软件监测到功率超过阈值（如35A对应的约8000W），可自动触发{"power":0}命令进行软件层面的断电保护。
定时策略同步：如果软件项目中有复杂的业务规则（如夜间模式、节假日模式），在服务器端用cron任务或定时器触发API调用，而不是完全依赖设备内置的定时器，以便于统一管理和日志记录。

6. 总结

将芯步35A智能空开集成到软件项目中是一项标准化的工作。关键步骤

认证：通过MD5(MD5(Secret)+TS)计算签名。
指令：使用标准JSON格式下发power命令。
架构：根据场景选择公有云或局域网私有化部署。

通过这套方案，开发者可以在10分钟内完成核心对接，使软件获得对强电电路的直接操控能力，从而构建完整的能源管理与安全防护系统。