芯步的50A智能断路器通过开放HTTP API接口,支持单台控制、批量下发和定时任务,适合园区、工厂等需要集中管控大功率设备的场景。以下方案涵盖接口协议、签名算法和多设备批量控制的实现方式。
解决方案:基于芯步开放接口的50A智能断路器远程批量控制系统
1. 概述
芯步的50A智能断路器(型号:UNI-DLQ-M-50A 及计量数显版)核心优势在于去网关化(直连WiFi)和全开放的HTTP API接口。该系统允许开发者通过任何支持HTTP请求的编程语言(Python, Java, Go, PHP, Node.js等)直接向设备下发指令,无需中间件。
本方案的目标是指导开发者如何从零开始,实现对一台或多台50A智能断路器的远程状态控制(开/关),并重点解决批量控制(同时控制几十甚至上百台设备)的技术实现问题。
2. 核心准备:接口鉴权与地址
在调用接口前,需准备以下三要素,所有API请求均依赖它们进行身份验证。
AppID: 在芯步控制台创建应用后生成的唯一标识。
AppSecret: 应用的密钥,用于生成签名。
设备ID (Device ID): 设备的唯一标识,可在控制台查看。
API端点
[HTTP Method] POST
[URL] http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
[Header] Content-Type: application/json注:支持HTTPS,生产环境使用HTTPS。
3. 技术:签名生成与单设备控制
为防止接口被恶意篡改,每次请求需携带动态签名。
签名算法步骤
将
AppSecret进行一次MD5加密,得到encrypt_secret。将
encrypt_secret与当前Unix时间戳(秒,ts)拼接。将拼接后的字符串再次进行MD5加密,得到最终的
sign。
公式sign = md5( md5(AppSecret) + ts )
单设备控制示例(以curl命令为例)假设我们要关闭ID为 301788 的断路器。
关键参数说明
order字段为JSON字符串:{"power":1}: 开启断路器。{"power":0}: 关闭断路器。若是计量版,还可加入
{"metering":"1"}读取实时电量数据。
4. 进阶应用:批量控制
对于“远程批量控制”,芯步的接口支持在单次HTTP请求中传入多个设备ID,极大提高控制效率。
实现方案在 device 字段中使用英文逗号 , 分隔多个设备ID。
批量关闭示例假设我们需要同时关闭 301788, 301789, 301790 三台设备。
请求体(Request Body)
代码逻辑(Python示例)
5. 高级控制策略:定时与延时
在实际的能源管理场景中,有时需要“临时接通”或“定时断开”。50A断路器接口支持内置定时参数,无需在服务器端维护复杂的定时任务队列。
临时接通(短暂供电后自动断电) :在某些测试场景,需要接通1分钟后自动跳闸。指令:
{"reset": 60000}(单位:毫秒。执行闭合动作,60秒后断开)。延时断开指令:
{"point": 60000}(先断开,60秒后自动闭合,常用于重启路由器等设备)。批量设置同样支持批量传入:
6. 私有化部署与局域网控制(高安全场景)
对于金融、政府或高保密企业,如果数据不能上公网,芯步支持私有化部署和局域网通信。
原理: 设备虽然连接WiFi,但可以指向客户自建的服务器IP,而非芯步官方云。
切换: 在设备配网阶段,通过协议指定私有云IP。此时,API调用地址需改为
http://{Your_Private_IP}:{Port}/...。优势: 即使外网断开,局域网内的控制指令依然畅通,延迟可降至10ms以内。
7. 实施落地流程
注册与配网: 在芯步官网注册账号,创建工作台。通过“物联网控制台”模块对50A断路器进行WiFi配网(仅支持2.4G),并记录下生成的设备ID。
接口调试: 使用Postman或命令行测试单设备控制,确保签名计算正确。
业务系统集成: 将上述代码片段集成到您的现有MES、ERP或楼宇自控系统中。
压力测试: 使用批量接口同时操作50台或100台设备,观察API响应时间(通常在800ms-1500ms内)。
8. 总结
芯步50A智能断路器的批量控制核心在于利用其 “单次请求多Device ID” 的特性。开发者只需关注业务逻辑(何时开、何时关),将设备ID列表动态拼接到 device 参数中,即可轻松实现整栋楼或整个园区的电力负载远程集中管理。