芯步这款60A带计量功能的断路器,其实是标准的“WiFi+HTTP API”架构,对接思路非常清晰:先让设备连上网,然后按规则调用接口获取数据就行。
下面我按实际开发顺序,一步步说明怎么把电流、电压、功率这些数据接到你自己的系统里。
一、明确你的目标与设备身份
首先,你要对接的设备型号是 UNI-DLQ-M-60A-P(计量版)。
特殊之处:它相比普通版(UNI-DLQ-M-60A),内部集成了计量芯片,不仅能听你话通断电,还能主动告诉你它现在的“身体状况”——也就是电压、电流、功率等数据。
通信方式:它通过 WiFi 2.4G 联网,不需要额外买网关,直接连路由器就行。
你要做的,就是让你的服务器通过芯步的开放接口,和这个设备“说话”。
二、前期准备
在写代码之前,需要先在芯步的平台上做一些准备工作,这大概需要花5分钟:
注册与创建:去芯步官网注册账号,创建一个“工作台”,然后进入“物联网控制台”。
设备配网
确保你的手机连着2.4G Wi-Fi。
在控制台里找到“网络配置”,把你的Wi-Fi名和密码填进去。
给断路器通电,长按按键让它进入配网模式(通常是指示灯快闪),然后在控制台里点击“为设备配置此网络”。等指示灯常亮,就说明它连上网了。
获取关键凭证
在“开发设置”里,拿到你的 AppID 和 AppSecret(开发者密码)。
在设备列表里,复制你这个断路器显示的 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。
六、完整对接流程示意图(逻辑抽象)
这里帮你梳理一下整个数据流向,方便你写代码时参考:
硬件层:60A断路器通过WiFi连接云端。
云端接口层
控制:你的服务器调用
device/control接口(携带AppID,Device ID,Sign)。查询:你的服务器调用
device/status接口,获取实时计量数据。
应用层:你的业务系统接收数据并展示。
七、几个小
关于计量数据的频率:既然是WiFi设备,不太频繁地去查询(比如每秒查一次),那样可能会把设备搞死机或者WiFi模块过热。5到10秒查一次,如果只是做能耗统计,几分钟查一次甚至一小时查一次都行。
关于本地化部署:如果你数据安全性要求比较高(比如军工或机密项目),芯步这套设备其实支持纯局域网控制。不过那需要你开启私有化模式,设备直接发数据到你指定的服务器IP,不走云平台,具体配置可以问他们的技术支持。
免费技术支持:他们的文档里特别提到“免费提供全程技术指导”。如果你们团队配置网络或者算签名的时候遇到奇怪的问题,直接找他们的工程师远程支持一下,比自己瞎琢磨快得多。
总的来说,你就把这款60A断路器想象成一个自带REST API的智能电表。不需要关心底层复杂的Modbus或485协议,只需要通过HTTP请求和它对话就行了。