CATALOG

芯步这款60A带计量功能的断路器,其实是标准的“WiFi+HTTP API”架构,对接思路非常清晰:先让设备连上网,然后按规则调用接口获取数据就行。

下面我按实际开发顺序,一步步说明怎么把电流、电压、功率这些数据接到你自己的系统里。

一、明确你的目标与设备身份

首先,你要对接的设备型号是 UNI-DLQ-M-60A-P(计量版)。

  • 特殊之处:它相比普通版(UNI-DLQ-M-60A),内部集成了计量芯片,不仅能听你话通断电,还能主动告诉你它现在的“身体状况”——也就是电压、电流、功率等数据

  • 通信方式:它通过 WiFi 2.4G 联网,不需要额外买网关,直接连路由器就行

你要做的,就是让你的服务器通过芯步的开放接口,和这个设备“说话”。

二、前期准备

在写代码之前,需要先在芯步的平台上做一些准备工作,这大概需要花5分钟:

  1. 注册与创建:去芯步官网注册账号,创建一个“工作台”,然后进入“物联网控制台”

  2. 设备配网

    • 确保你的手机连着2.4G Wi-Fi。

    • 在控制台里找到“网络配置”,把你的Wi-Fi名和密码填进去

    • 给断路器通电,长按按键让它进入配网模式(通常是指示灯快闪),然后在控制台里点击“为设备配置此网络”。等指示灯常亮,就说明它连上网了。

  3. 获取关键凭证

    • 在“开发设置”里,拿到你的 AppIDAppSecret(开发者密码)

    • 在设备列表里,复制你这个断路器显示的 Device ID(设备ID)。

三、搞定“签名”:这是接口调用的关键

芯步的接口为了提高安全性,需要带一个动态签名。这个机制听着唬人,但其实逻辑很简单,就是为了防止有人伪造请求。

签名的生成规则是:md5( md5(AppSecret) + ts )

用人话解释一下:

  • AppSecret:你的私有密码,别泄露。

  • ts:当前的时间戳(比如:1715678900)。

  • 步骤:先把 AppSecret 进行MD5加密得到一串字符,然后把这串字符后面直接拼接上时间戳 ts,再把拼接后的这一长串进行一次MD5加密,最后得到的32位字符串就是 sign

通俗理解:这就好比你的门禁卡,每次进门前,系统都会根据当前时间算一个临时密码,这样即使密码被截获,过一会儿也就失效了。

四、如何“读取”计量数据(核心需求)

这是你要的核心功能。既然是要监测电流电压,你的系统就得主动去“问”断路器现在的数据是多少。这通常有两种方式,我推荐第一种:

方式一:主动查询(HTTP请求)这是最直接的方式。比如你需要做一个前端大屏,每5秒刷新一次数据,就可以调用获取设备状态的接口。

芯步有专门的接口来查询设备最新上报的数据。你只需要向 https://api.thingboot.com/{AppID}/device/status/ 类似的地址(具体看文档)发请求,带上签名和设备ID,它就会返回一个JSON包,里面通常会包含:

拿到这些数据,你就可以存数据库、做图表展示,或者判断是否过载了

方式二:异步推送(消息队列)如果你的系统要求数据实时性特别高,可以用MQTT。设备一有数据变化,平台就会主动推给你。但这需要你那边搭一个MQTT客户端,配置稍微复杂一点

五、如何“控制”通断

虽然你的重点是监测,但控制往往也是联动的必选项。

命令接口地址是:POST https://api.thingboot.com/{AppID}/device/control/?sign={签名}&ts={时间戳}

请求体 (Body) 要带两个参数:

  • device:你的设备ID。

  • order:控制指令。

举个栗子:想关掉断路器(假设电压过高触发保护),你要发的JSON就是:

如果想再打开,就把 0 改成 1

六、完整对接流程示意图(逻辑抽象)

这里帮你梳理一下整个数据流向,方便你写代码时参考:

  1. 硬件层:60A断路器通过WiFi连接云端。

  2. 云端接口层

    • 控制:你的服务器调用 device/control 接口(携带 AppID, Device ID, Sign)。

    • 查询:你的服务器调用 device/status 接口,获取实时计量数据。

  3. 应用层:你的业务系统接收数据并展示。

七、几个小

  1. 关于计量数据的频率:既然是WiFi设备,不太频繁地去查询(比如每秒查一次),那样可能会把设备搞死机或者WiFi模块过热。5到10秒查一次,如果只是做能耗统计,几分钟查一次甚至一小时查一次都行

  2. 关于本地化部署:如果你数据安全性要求比较高(比如军工或机密项目),芯步这套设备其实支持纯局域网控制。不过那需要你开启私有化模式,设备直接发数据到你指定的服务器IP,不走云平台,具体配置可以问他们的技术支持

  3. 免费技术支持:他们的文档里特别提到“免费提供全程技术指导。如果你们团队配置网络或者算签名的时候遇到奇怪的问题,直接找他们的工程师远程支持一下,比自己瞎琢磨快得多。

总的来说,你就把这款60A断路器想象成一个自带REST API的智能电表。不需要关心底层复杂的Modbus或485协议,只需要通过HTTP请求和它对话就行了。