40A带计量数显导轨式智能断路器(型号UNI-DLQ-M-40A-PD)的核心优势在于开放HTTP API接口,支持开发者通过任意编程语言(Node.js、Java、Python等)调用,实现设备控制、数据采集和跨设备联动。以下方案以该断路器为中心,结合芯步其他智能硬件(如4路/8路控制器、墙壁开关等),设计一套完整的二次开发架构。
1. 项目概述与设计
1.1 背景
在许多工业自动化、智能建筑、基站配电或智慧农业场景中,单一的断路器只能实现线路的通断保护,无法满足负载联动、时序控制和远程运维的需求。本方案的目标是利用芯步40A带计量数显导轨式智能断路器作为核心执行与计量节点,结合其HTTP开放接口,构建多设备联动控制系统。
1.2 核心架构
系统采用云-端-移动端三层架构:
感知/执行层:以40A智能断路器(主控大功率设备)为核心,辅以4路/8路智能控制器(控制照明、风扇等辅助设备)及墙壁开关(信号输入)。
网络层:所有设备通过WiFi 2.4G直连云端,支持局域网和公网两种通信模式,无需额外网关。
平台层
公有云/私有化API:芯步提供的标准HTTP接口。
业务服务器:用户自行开发的联动规则引擎(如Node-RED或Spring Boot应用)。
客户端:Web端后台或微信小程序。
2. 设备接入与接口解析
2.1 40A计量断路器核心参数
该设备不仅是电源开关,更是数据采集源
电气参数:额定电流40A,总额定功率8000W,适用于大功率空调、充电桩、总闸等。
计量功能:实时上报电压、电流、功率、电量等数据(数显版直接读取)。
控制方式:支持本地物理按钮和远程HTTP接口控制。
2.2 API调用鉴权机制
所有二次开发均需基于芯步的统一鉴权协议。每次HTTP请求需携带以下参数进行身份验证
AppID:应用唯一标识。
ts:当前Unix时间戳(秒),防止重放攻击。
Sign:签名。
算法
Sign = md5( md5(AppSecret) + ts )逻辑:先将AppSecret进行MD5,拼接ts,再进行整体MD5。
2.3 断路器控制指令集
接口地址POST https://api.thingboot.com/{AppID}/device/control/
请求示例
特色命令(适用于拒绝频繁断电的场景):
先通后断
{"point":{"relay":[1],"interval":1000}}(先提供1秒测试电,常用于门禁或设备复位)。延时联动:支持在
order中配置延时参数,较少依赖云端二次下发。
3. 多设备联动场景逻辑设计
为了展示“多设备联动”,设计一个“充电桩/机房配电智能联动”场景:
关联设备:40A计量断路器(总进线)、4路智能控制器(控制排风扇和照明)、物联网墙壁开关(门磁/按钮)。
联动目标:当总功率超限时,自动切断非关键负载(如照明、风扇),只保留核心供电;或者根据温度/门禁状态联动。
3.1 数据采集触发
业务服务器需定时或通过消息队列获取断路器状态。
3.2 第一种场景:过载分级卸载联动
逻辑:40A断路器实时监测功率。若系统检测到当前功率 > 7000W(额定8000W的87.5%),为防止跳闸,自动关闭辅助设备。
3.3 第二种场景:基于计量的定时与无人化管理
利用断路器自带的计量功能,判断“待机功耗”。若某生产线断路器检测到电流低于阈值(A),判定设备待机,联动4路控制器切断该工位的插座电源,实现节能。
4. 后端业务系统开发实现
以下核心代码示例,展示如何编写联动规则引擎。
4.1 基础通信类
编写一个通用的ThingBootService类封装签发生成和请求发送。所有代码逻辑均需包含:AppID、AppSecret、设备ID(通过物联网控制台获取)以及请求签名计算。
4.2 联动规则引擎伪代码实现
在实际开发中,使用Node.js(异步非阻塞,适合IO密集型)或Java(适合企业级稳定系统)编写轮询与事件处理服务。程序将:1) 读取断路器当前功率;2) 判断是否超过阈值;3) 若超限则发送指令切断辅助设备;4) 记录日志。
4.3 高级联动:断路器与4路控制器的时序配合
有时候需要更复杂的时序控制,例如恢复供电时序:当来电时,不要立即接通所有大功率设备,以免造成瞬时冲击。通过后端脚本控制,先接通40A总闸,延时3秒后,通过接口控制4路控制器逐一接通分路。
5. 前端与移动端集成(微信小程序/Web)
二次开发不仅仅是后端逻辑,还需要交互界面。芯步接口支持跨域和移动端调用。
5.1 微信小程序集成
在小程序页面中,为了提供良好的用户体验,通常需要封装wx.request方法。用户可以实时看到40A设备上报的功率数显数值(通过设备状态查询接口获取),并点击按钮切换状态。
5.2 Web端实时看板
利用断路器上报的计量数据,开发者可以搭建比原厂更复杂的BI看板,例如:当日用电量环比分析、功率曲线预测、报警事件热力图等。
6. 高可用与私有化部署方案
对于不允许数据出厂的工厂或政府单位,芯步支持局域网私有化部署和自建MQTT/HTTP消息服务器接收设备主动上报的数据。
6.1 纯局域网控制
前提:确保40A断路器和您的业务服务器在同一网段(或可路由)。
配置:在设备配网时,将平台地址指向本地的私有化网关地址而非
api.thingboot.com。优势:控制延时低至毫秒级,彻底断网仍可运行。
6.2 设备主动上报配置
为了减少服务器轮询压力,配置设备主动推送。将服务器公网IP/域名配置到物联网控制台的回调地址中。当40A断路器检测到功率突变、过温或开关动作时,会自动POST数据到指定URL,实现“实时联动”效果。
7. 调试与发布 Checklist
在实施二次开发时,请请一定要遵循以下步骤:
环境准备
注册芯步账号,创建工作台,获取
AppID和AppSecret。给40A断路器配置2.4G WiFi网络。注意:不支持5G WiFi频段。
接口调试
使用Postman测试签名算法是否正确。
调用
device/control/接口发送{"power1":"0"},观察断路器是否断开。
数据验证
确认接口返回的功率值单位是W还是kW(通常精确到0.1kW或1W)。
部署运行
若部署在云服务器,确保服务器IP已加入芯步API白名单(如有必要)。
8. 总结
通过对芯步40A智能断路器的二次开发,开发者不再受限于原厂App的功能边界。结合其开放的计量数据接口和标准HTTP控制指令,我们可以编写复杂的业务逻辑(如电量计费、过载保护、定时任务等),并联动该平台下的4路控制器、墙壁开关等硬件,构建真正软硬一体的智能配电解决方案。这种基于API的松耦合架构极大地降低了智能硬件开发的门槛。