芯步的40A智能断路器支持HTTP接口直接调用,签名认证、设备控制、状态回调都可以通过标准API完成。以下是完整的对接方案,涵盖硬件准备、接口认证、核心代码实现及配电箱改造要点。
解决方案:家庭配电箱电路改造 —— 智能断路器(40A)对接软件项目
1. 背景与选型
在家庭配电箱改造中,40A智能断路器通常用于控制大功率主线、中央空调、即热式热水器或全屋总闸。本次方案基于 芯步 的“智能大功率断路器[计量数显版]”或“智能大功率断路器[计量版]”(型号如 UNI-DLQ-M-40A-P)。
该系列产品的核心优势在于提供完全开放的HTTP API接口,无需中间网关(直连Wi-Fi 2.4G),支持远程通断控制、电量计量读取及私有化部署。
2. 对接前的准备与配网
在编写代码之前,需完成硬件的物理安装与网络初始化:
硬件安装:采用标准35mm导轨安装。关键注意:40A断路器接线端子较大,输入(进线)端需根据实际功率匹配10平方毫米或以上的铜线,并请一定要拧紧扭矩以防止电弧发热。
网络配置
注册芯步开发者账号,获取 AppID 和 AppSecret(密钥)。
使用“芯步小程序”或PC控制台,将设备配置到现场2.4G WiFi网络。该设备支持设定5组备用Wi-Fi,信号可自动切换。
配网成功后,在控制台获取 Device ID(设备唯一ID),这是后续软件控制的唯一标识。
3. 软件对接核心流程
芯步的接口设计遵循 HTTP 标准,签名算法简单且平台永久免费。
3.1 签名算法
所有API请求均需携带 sign 和 ts(时间戳)进行身份验证。算法规则:sign = md5( md5(AppSecret) + ts )。
3.2 API 接口调试示例
以下是基于 Python 的后端控制代码示例(实现“闭合/断开”总闸):
命令解析
{"power": 1}:执行“合闸”,接通电路。{"power": 0}:执行“分闸”,切断电路。响应
code: 200仅代表指令下发成功,设备实际执行结果需通过消息推送确认。
3.3 获取实时电量数据
若使用“计量版”断路器,设备会主动上报电压、电流、功率及今日用电量。软件项目可通过两种方式获取:
主动查询:调用设备状态查询接口(GET请求)获取实时快照。
被动接收(推荐) :配置消息推送回调地址。当功率变化超过阈值或设备定时上报时,平台会 HTTP POST 数据到你的服务器,实现实时监控。
3.4 高级特性与联动
定时任务:无需在服务器侧维护定时器,可直接下发指令如
{"reset": 3600000},设备将在接通1小时后自动断开,即使断网也会执行。本地局域网控制:支持私有化部署,软件项目在检测到与设备处于同一局域网时,可直接通过局域网 IP 调用 API,响应速度可低至80ms且不依赖外网。
多设备批量控制:请求时
device字段可用英文逗号拼接多个ID,如"820720,820721",实现全屋断电一键操作。
4. 家庭配电箱改造实施要点
将软件逻辑落地到物理电路改造时,需注意以下几点以确保合规与安全:
零火线识别:智能断路器需接入零线(N)供电才能保持联网模块工作。传统总闸可能只断火线,改造时需引入零线排。
负载匹配:明确 40A 对应的额定功率为 8000W(阻性) 至 1400W(感性)。在软件逻辑中应增加“软限制”,例如设置软件层面的超载预警(如检测到功率>7500W发送报警通知,而不是直接依赖机械跳闸)。
状态同步机制:物理按键或手动拨杆操作后,设备状态会通过消息推送到软件系统。设计软件 UI 时,必须以设备上报的状态为准,不能仅依赖上次发送的命令,避免软件显示“关闭”但物理被人为“开启”的不一致情况。
天线空间:断路器的 WiFi 模块内置在外壳内部,金属配电箱对信号屏蔽较强。改造时,在配电箱门板或侧边预留非金属开口,或确保家庭路由器距离配电箱较近,以保证信号强度。
5. 总结
通过芯步的开放接口,将40A智能断路器集成到软件项目中是一项标准、低成本的任务。开发者仅需关注 AppID/Secret 的管理和 Device ID 的映射关系,即可在3-5天内完成从配网到指令集成的全流程开发,实现家庭用电的远程化、自动化管理。