家庭配电箱电路改造：如何将35A 智能断路器接入到软件项目中_解决方案

CATALOG

芯步智能断路器采用HTTP API接口，签名验证简单（MD5嵌套），支持公网与局域网两种模式。以下方案从硬件选型、接口对接、签名算法到前后端代码实现，给出完整的接入路径。

一、解决概述

在家庭配电箱改造场景中，引入 35A 智能断路器主要目的是实现远程控制（如离家时一键断电）和安全保护（如过载预警、用电统计）。芯步的产品优势在于其开放且标准的 HTTP API 接口，这意味着无论您的软件项目是基于 Vue/React 的 Web 应用，还是基于 Java/Python/Go 的后端服务，甚至是微信小程序，都可以通过调用 HTTP 请求轻松完成对接。

核心流程：

硬件安装：将 35A 智能断路器替换入家庭配电箱。
设备配网：通过“芯步”官方小程序配置 WiFi（2.4G）。
接口对接：获取 AppID 和 AppSecret，通过签名算法调用 API。
业务集成：在您的软件中实现开关控制、状态同步和安全告警。

二、硬件选型与安装准备

在 35A 规格下，通常对应的是 智能断路器 35A型号（如 UNI-DLQ-35A）或具备 35A 通断能力的 智能通断器 AC4-35A。

额定功率：35A 适用于家庭总闸或大功率空调/中央空调回路，额定功率通常在 8000W 左右。
接线规格：搭配 6-10mm² 的铜芯电缆，确保接线端子螺丝拧紧，避免大电流发热。
网络环境：确保配电箱位置有 2.4G WiFi 信号覆盖（金属配电箱对信号有一定屏蔽，信号强度在 -70dBm 以上）。

三、软件集成开发指南

1. 接口基础信息

芯步的接口采用标准的 HTTP POST 请求，请求地址为：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

AppId：应用唯一标识（在芯步控制台创建）。
ts：Unix 时间戳。
sign：签名，用于身份验证。

2. 重点：签名算法

为了接口安全，芯步采用了 MD5 嵌套加密。所有第三方软件集成都需要先通过这个逻辑生成签名，否则无法控制设备。

签名公式：sign = md5( md5(AppSecret) + ts )

实现步骤：

将您的开发者密码 AppSecret 进行 MD5 加密，得到字符串 S1。
将 S1 与当前的时间戳 ts （字符串形式）直接拼接，得到新字符串 S2。
将 S2 再次进行 MD5 加密，得到最终的 sign。

示例代码 (Python)：

3. 核心 API 调用实战

第一种场景：远程控制断路器通断

需求： 用户在手机 App 点击“关闭总闸”，软件需向该设备下发“断开”指令。

请求地址：如上 API Url
请求方式：POST
HeaderContent-Type: application/json
Body (JSON)

注：如果是多路控制（如 4路控制器），则使用 {"power1":0} 或 {"power2":1} 分别控制。

第二种场景：获取实时状态与消息推送

需求： 当有人手动按下断路器上的物理按钮，或者电路发生跳闸时，软件需要实时更新显示状态。

方案 A（推荐）：配置消息服务器芯步支持消息推送。您需要搭建一个公网可访问的 HTTP 服务器地址，在控制台配置回调 URL。

触发机制：当断路器状态变化（如从闭合变为断开），平台会主动向您的服务器发送 JSON 数据包。
数据解析：您的后端接收后，解析出 device 和 power 状态，实时推送给前端 Web/App 用户。

方案 B：定时轮询如果您的项目处于局域网或对实时性要求不高，可以通过接口主动查询设备状态（具体方法参考其 SDK 文档）。

第三种场景：高级联动与场景自动化

结合芯步生态内的其他传感器（如烟雾传感器、水浸传感器），您可以构建配电箱的自动保护逻辑。

联动逻辑示例：如果“烟雾传感器”探测到火灾 -> “软件系统”接收到报警 -> 自动调用断路器 API ({"power":0}) -> 切断总闸，防止二次触电。
实现的方式是：此逻辑通常运行在您的业务服务器上。服务器监听传感器事件，并执行控制代码。

四、针对“家庭配电箱”的软件功能设计

作为完整的解决方案，您的软件项目包含以下模块：

可视化界面
- 在软件中绘制家庭电路图，标注“总闸35A”、“空调”、“照明”等对应设备。
- 使用醒目颜色区分“合闸”（绿色）与“分闸”（灰色）。
定时任务
- 利用服务器的定时器，调用 API 实现“离家模式”（晚上 10 点自动关闭插座回路）或“定时热水器”。
- 注：硬件也支持 RTC 定时，但软件端管理更灵活。
安全日志
- 记录每一次开关动作的来源（是 App 远程操作，还是本地物理操作）。
- 记录电压、电流异常波动（如果设备支持电量统计功能，可通过 API 拉取数据）。
局域网直连（可选高阶）
- 芯步支持私有化部署。如果您的家庭网络不允许外网访问（或追求极低延迟），您的软件可以在局域网内直接扫描并控制设备，不经过云端服务器。

五、总结

利用芯步智能断路器改造家庭配电箱，核心在于理解其 简单的 HTTP 签名机制 和 标准化的 JSON 指令集。

开发量：极低。只需要后端工程师封装一个签名函数和几个 HTTP 请求函数即可完成基础控制。
稳定性：支持 WiFi 直连，无需额外网关，配合私有化部署选项，可保障居家网络断网时依然能局域网控制。
落地路径：注册账号 -> 通电配网 -> 获取设备ID -> 复制代码示例 -> 集成到您的现有项目。