针对芯步60A带计量智能空开(型号UNI-DLQ-M-60A-P)的功率数据采集需求,以下方案基于其开放API架构,采用HTTP协议和签名认证机制,帮助企业快速完成系统对接。
1. 产品核心能力概述
芯步智能大功率断路器[计量版](型号:UNI-DLQ-M-60A-P)是一款支持60A大电流的智能空开设备。它是实现用电量监测和远程控制的关键节点。
硬件特性:支持WiFi 2.4G直连,无需网关,可设定5组WiFi网络并自动选择信号最强的连接 。
数据采集核心:具备电能计量功能,能够实时监测并上报电压、电流、功率、功率因数等关键参数。
开放接口:提供标准的HTTP API接口,支持任何支持HTTP请求的编程语言(如Java、Python、Node.js、PHP等)及软件项目(Web、App、SaaS)进行对接 。
2. 整体对接架构方案
整个对接架构采用“设备主动推送 + 平台指令控制”的双向通信模式。
上行(数据采集):设备通电联网后,按照设定的周期(或状态变化时)主动向企业服务器推送实时功率及电能数据。
下行(控制与配置):企业业务系统通过调用芯步开放API,向设备下发断开/闭合命令或读取实时数据。
3. 对接准备与配置
在开发之前,需在芯步物联网控制台完成以下准备工作:
设备激活:确保60A智能空开已通电并连接至WiFi,在控制台可见设备状态为“在线”。
获取凭证:在控制台获取
AppID(应用ID)和AppSecret(开发者密码),这是后续API调用的身份凭证 。确定回调地址(关键):配置消息推送的URL(企业公网服务器地址)。设备数据将POST至此地址。
4. 核心实现:功率数据采集方案
功率数据的采集分为两种业务场景:被动接收实时数据(推荐)与主动查询实时数据。
4.1 方案一:被动接收实时上报数据(推荐)
这是最高效、实时的采集方式。当空开的功率发生变化或达到心跳时间时,设备会主动将消息推送到配置好的服务器地址。
数据格式:JSON。
接收示例你的服务器需开发一个接口(例如
/api/device/data)来接收POST请求。数据载荷通常包含以下字段:回调响应:服务器收到数据后,需返回字符串
ok表示接收成功,否则平台会触发重推机制。
4.2 方案二:主动查询实时数据(指令下发)
企业系统需要即时获取当前功率值时,可调用平台的“设备控制”接口下发查询命令。
接口地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。请求方法:POST
签名算法
sign = md5(md5(AppSecret) + ts)(即:将AppSecret进行MD5加密,结果拼接上时间戳ts,再进行一次MD5) 。请求Body示例
芯步一般采用通用命令规范,具体需查阅官方文档确认获取功率的特定
order字段名 。
5. 数据对接技术实现步骤
5.1 签名生成(以简例说明)
这是接口调用的安全基础。
设
AppSecret = “abc123”,当前时间戳ts = “1700000000”。计算
md5_1 = md5(“abc123”)。计算
final_sign = md5(md5_1 + “1700000000”)。将
sign和ts作为URL参数。
5.2 服务器端代码逻辑(伪代码)
以Node.js为例,说明如何接收设备主动上报的数据:
5.3 注意事项与优化
接口调用机制:由于网络原因,平台可能会重发数据,根据
timestamp和device_id做去重处理。异步处理:接收到数据后,入库或业务逻辑处理(如发送告警邮件)放入消息队列(MQ)异步处理,避免阻塞HTTP响应超时。
安全性:配置IP白名单,仅允许芯步平台的服务器IP访问你的回调接口,防止恶意攻击。
6. 私有化部署与数据安全
对于对数据安全要求比较高的企业(如数据中心、高能耗工厂),芯步支持私有化部署方案
内网直连:设备可直接推送数据至企业局域网内的服务器,数据完全不经过公网。
本地闭环:企业可搭建本地MQTT Broker或HTTP Server,实现毫秒级响应,极大提升数据安全性与系统稳定性。
7. 总结
对接芯步60A带计量智能空开进行功率采集,核心在于:
正确配置:设置好控制台的
AppID/Secret和推送URL。验签机制:严格按照MD5规则生成签名。
被动接收:优先采用设备主动上报模式,实现实时、低延迟的功率数据采集。