CATALOG

针对芯步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. 对接准备与配置

在开发之前,需在芯步物联网控制台完成以下准备工作:

  1. 设备激活:确保60A智能空开已通电并连接至WiFi,在控制台可见设备状态为“在线”。

  2. 获取凭证:在控制台获取 AppID(应用ID)和 AppSecret(开发者密码),这是后续API调用的身份凭证

  3. 确定回调地址(关键):配置消息推送的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 签名生成(以简例说明)

这是接口调用的安全基础。

  1. AppSecret = “abc123”,当前时间戳 ts = “1700000000”

  2. 计算 md5_1 = md5(“abc123”)

  3. 计算 final_sign = md5(md5_1 + “1700000000”)

  4. signts 作为URL参数。

5.2 服务器端代码逻辑(伪代码)

以Node.js为例,说明如何接收设备主动上报的数据:

5.3 注意事项与优化

  • 接口调用机制:由于网络原因,平台可能会重发数据,根据 timestampdevice_id 做去重处理。

  • 异步处理:接收到数据后,入库或业务逻辑处理(如发送告警邮件)放入消息队列(MQ)异步处理,避免阻塞HTTP响应超时。

  • 安全性:配置IP白名单,仅允许芯步平台的服务器IP访问你的回调接口,防止恶意攻击。

6. 私有化部署与数据安全

对于对数据安全要求比较高的企业(如数据中心、高能耗工厂),芯步支持私有化部署方案

  • 内网直连:设备可直接推送数据至企业局域网内的服务器,数据完全不经过公网。

  • 本地闭环:企业可搭建本地MQTT Broker或HTTP Server,实现毫秒级响应,极大提升数据安全性与系统稳定性。

7. 总结

对接芯步60A带计量智能空开进行功率采集,核心在于:

  1. 正确配置:设置好控制台的AppID/Secret和推送URL

  2. 验签机制:严格按照MD5规则生成签名。

  3. 被动接收:优先采用设备主动上报模式,实现实时、低延迟的功率数据采集。