CATALOG

芯步的智能断路器采用标准HTTP接口通信,无需网关即可直连Wi-Fi 2.4G网络。以下方案涵盖从硬件接线、设备配网到接口集成的完整流程,代码部分可直接复用于Web、小程序或App项目。

1. 项目概述与目标

在家庭配电箱改造场景中,引入 芯步 智能大功率断路器[计量数显版]|60A,不仅是为了实现用电安全的远程监控,更是为了通过软件定义的方式实现能源的精细化管理。本方案的目标是解决如何将这款硬件设备以标准化的方式,快速、稳定地接入现有的或全新的软件项目中。

通过本方案,开发者将实现以下目标:

  • 远程控制:无论身处何地,通过软件界面即可对60A大功率线路进行分合闸操作。

  • 数据可视化:实时读取电流、电压、功率等计量数据,并在管理后台或大屏展示。

  • 智能告警:设定阈值(过载、过压),实现秒级预警,保障家庭用电安全。

  • 系统集成:将设备能力封装为服务,供上层业务逻辑调用。

2. 设备选型与参数解析

针对家庭入户或大功率电器(如中央空调、充电桩)回路,必须选用符合负载特性的硬件。

2.1 核心产品特性

本方案选用的 智能大功率断路器[计量数显版]|60A 具备以下关键特性

  • 额定电流:60A,适用于家庭总进线开关或大功率设备支路。

  • 计量功能:内置高精度计量芯片,支持电压、电流、功率、电量实时读取。

  • 数显:设备本体自带显示屏,现场运维人员可不依赖手机直接查看数据。

  • 通信方式:支持 Wi-Fi 2.4G 频段,直连路由器,无需额外网关,降低改造成本和故障点。

  • 接口协议:开放的 HTTP API,兼容私有化部署和局域网通信。

2.2 接口开放能力

该设备所在的 “芯步” 生态提供了标准的物联网接口

接口类别功能描述核心价值
设备控制下发分合闸指令实现远程开关、定时任务
状态同步获取设备当前通断状态保证软件开关状态与物理状态一致
数据查询读取计量数据获取实时电流/电压用于分析
设备管理获取设备列表与详情用于软件中的设备绑定与展示

3. 硬件安装与网络配置

在编写代码之前,必须确保设备处于在线状态。

3.1 配电箱接线指南

安全警告:涉及强电操作,请一定要由持证电工在断电下进行。

  1. 选位:将断路器卡装在标准的 DIN 导轨(35mm)上。

  2. 进线(上口):接入家庭总进线的火线(L)与零线(N)。

    • 注意:60A 规格需匹配至少 10mm² 的铜芯电缆,并确保接线端子拧紧,防止发热。

  3. 出线(下口):连接至后端负载(如全屋总线路或大功率设备)。

  4. 天线:确保 Wi-Fi 天线引出且未被金属配电箱完全屏蔽(金属箱体对 Wi-Fi 信号衰减严重,若信号不佳改用 4G 版本或引天线至箱外)。

3.2 设备配网激活

设备支持 2.4G Wi-Fi 连接,可采用“热点配网”模式

  1. 设备进入配网模式:长按断路器上的物理按键(或通过设备屏幕菜单操作),直到指示灯进入快闪状态(通常为闪烁频率较高)。

  2. 手机/电脑连接:搜索并连接设备发出的以 “TB-AP-xxxx” 开头的热点。

  3. 推送Wi-Fi信息:通过芯步的控制台或配网工具,将家庭路由器的 SSID(名称)密码 发送给设备。

  4. 验证在线:设备指示灯变为 常亮慢闪,此时在软件项目的后台应能看见设备状态为“在线”。

4. 软件集成方案(API对接)

芯步采用标准的 HTTP 请求进行通信,签名机制保证了接口安全,适合用 Python、Java、PHP、Node.js 或小程序开发。

4.1 签名机制(鉴权)

所有 API 请求都需要携带签名,以防止伪造请求。签名算法如下

  • 参数ts (时间戳, 10位), sign (签名)。

  • 公式

    sign = md5( md5(开发者密码) + ts )
  • 步骤

    1. 后台获取应用的 AppIDDeveloper Password

    2. 将密码进行第一次 MD5 加密,得到字符串 A

    3. A 与当前时间戳 ts 拼接,进行第二次 MD5 加密。

    4. 最终得到 32 位小写 sign

4.2 核心接口实战

假设你的AppIDYOUR_APP_ID,设备ID为 DEVICE_60A_001

4.2.1 控制设备(合闸/分闸)

向设备下发指令,包含“通”和“断”两种状态。

  • 请求URLPOST https://api.thingboot.com/YOUR_APP_ID/device/control

  • Query参数?sign=xxxxx&ts=1734567890

  • HeaderContent-Type: application/json

  • Body (JSON)

    注:对于单路控制的60A大功率断路器,通常使用 power 字段,具体请参考产品手册确认命令格式

4.2.2 获取设备状态与计量数据

读取该断路器的当前电压、电流及开关状态。

  • 请求URLGET https://api.thingboot.com/YOUR_APP_ID/device/info

  • Query参数?sign=xxxxx&ts=1734567890&device=DEVICE_60A_001

  • 返回示例

4.3 代码实现示例(JavaScript - 用于Web/小程序)

以下是一段通用的异步函数,用于控制设备:

5. 业务场景进阶应用

5.1 过载联动保护

60A 断路器虽然带载能力强,但业务软件层可设置更精细的策略。例如,在充电桩场景中,当检测到电流超过 50A 且持续 10 分钟,软件自动发送短信告警,并可选择主动跳闸,避免线路老化起火。

5.2 能耗统计与费效分析

利用定时器(如 setInterval 或 Cron 任务)每分钟调用一次获取状态接口,将 powerenergy 数据存入数据库(如 MySQL 或 InfluxDB)。

  • 前端展示:使用 ECharts 绘制功率曲线,直观显示空调或总电路的用电高峰时段。

  • 逻辑今日用电量 = 最新总电能 - 凌晨0点电能基数

5.3 局域网私有化部署(高安全场景)

芯步设备支持私有化部署。如果你的软件项目运行在家庭本地服务器(如树莓派、NAS、HomeAssistant),可以将 API 请求地址从 api.thingboot.com 改为设备本地 IP。此时,即使外网断开,依然能够控制断路器,这对家庭自动化至关重要。

6. 常见问题排查 (FAQ)

  • 设备离线怎么办?

    1. 检查家庭 2.4G Wi-Fi 信号强度,5G Wi-Fi 无法连接。

    2. 检查配电箱是否屏蔽信号(将设备天线引出至塑料面板外)。

    3. 代码中 ts 时间戳与服务器时间误差不可超过规定阈值(通常为5分钟)。

  • 如何区分“计量版”与“普通版”?在调用设备详情接口时,计量版的返回数据中会包含 voltage/current 等字段,而普通版仅返回 switch 状态。在 UI 设计上,可以为计量版渲染更丰富的仪表盘界面

  • 60A 设备在总闸处如何取电?该设备本身需要工作电源,通常接线方式为上进线下出线。设备内部电源模块会自行从火零线取电,无需额外适配器。

7. 总结

通过将 芯步 智能大功率断路器[计量数显版]|60A 接入软件项目,家庭配电箱不再是盲区。利用其 开放的HTTP接口精准的计量能力,开发者仅需几百行代码即可构建一套完整的家庭智慧能源管理系统。这一改造不仅提升了用电安全性,更为家庭节能提供了数据支撑。