芯步60A智能断路器的核心优势在于计量功能和开放API——你可以直接通过HTTP接口获取电压、电流、功率数据,同时下发分合闸指令。以下方案涵盖设备选型、接口对接、签名生成及典型场景代码实现。
一、 解决概述
本方案基于芯步 60A带计量物联网断路器(如UNI-DLQ-M-60A-P) 的开放API特性。该设备内置Wi-Fi模块(2.4GHz),无需额外网关即可联网。开发者仅需通过HTTP请求向云端或本地服务器发送指令,即可实现状态监控、电量数据读取与远程通断控制。
适用场景:智慧充电桩运营、基站远程重启、大型机房分路监控、出租房电费预付费管理等。
二、 技术对接准备
在开始编码前,需要准备以下三个关键要素:
设备激活与配网:确保60A断路器已安装并通电。通过芯步提供的配网工具或App将设备连接至Wi-Fi。
获取凭证
AppId:应用唯一标识。
AppSecret:开发者密码,用于生成签名。
Device ID:设备的唯一ID(通常在控制台或配网成功后获得)。
网络环境:系统需能访问公网(如果使用云模式)或局域网(如果启用私有化部署)。
三、 API接口对接核心逻辑
芯步的接口设计遵循“简单签名+JSON数据”的轻量化原则。
1. 签名生成规则
为了安全性,所有请求都需要携带签名。算法标准流程如下(以Python伪代码为例):
将
AppSecret进行MD5加密,得到encoded_secret。将
encoded_secret拼接上当前时间戳ts(秒级)。将拼接后的字符串再次进行
MD5加密,得到最终的sign。即:sign = MD5( MD5(AppSecret) + ts )
2. 接口地址结构
请求URL:
http(s)://api.thingboot.com/{AppId}/device/control/Query参数
?sign={计算出的签名}&ts={当前时间戳}请求头
Content-Type: application/json
3. 核心下发指令示例
目标:关闭断路器(分闸)
请求方法:POST
Body负载
注:如果需要读取计量数据,通常设备会自动上报数据到平台,开发者可通过“设备状态查询接口”或平台消息推送获取电压、电流、功率因数及累计电能。
四、 实战代码演示
以下演示如何通过代码控制该60A断路器。
第一种场景:使用Python后端进行控制
这是最常见的服务器集成方式。
第二种场景:集成高级定时命令
该设备支持硬件级定时,无需在服务器维护定时任务队列,即使断网任务也会执行。例如,“在1小时后断开电路”:
逻辑:立即接通电源,并在1小时后自动断开。
五、 电路逻辑与多路控制(扩展)
虽然60A断路器多为单路,但如果是多路控制器场景,芯步的接口规范如下,可供参考
控制第一路:
{"power1": 1}控制第二路:
{"power2": 0}批量控制:
{"batch":{"relay":[1,3],"power":0}}(关闭第1和第3路)
六、 系统架构
数据监控链路断路器计量芯片 -> WiFi模块 -> 芯步云 -> 你的业务服务器(通过API拉取或设置为回调转发) -> 前端展示。
私有化部署如果项目对数据安全或响应速度有比较高要求(如工业产线),可利用芯步的私有化部署方案。设备直接配置服务器内网IP,数据完全不经过外网,延迟可降低至毫秒级。
七、 常见问题排查
签名错误:检查时间戳是否为秒级(不是毫秒),以及MD5值是否为32位小写。
设备不在线:60A断路器仅支持2.4G WiFi。请检查配电箱内的Wi-Fi信号强度(可配置5组备选WiFi)。
功率超限:此设备额定60A,通常用于总进线或大功率空调、充电桩。请确保实际电流不超过额定值,以免设备过热保护。
总结
将芯步60A断路器对接到自有项目,只需掌握MD5双重签名机制和Power控制指令。无论是构建一套完整的预付费电表系统,还是简单的远程机房重启工具,这套基于HTTP的解决方案都能在极短时间内完成集成。