CATALOG

芯步的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. 技术:签名生成与单设备控制

为防止接口被恶意篡改,每次请求需携带动态签名。

签名算法步骤

  1. AppSecret 进行一次MD5加密,得到 encrypt_secret

  2. encrypt_secret 与当前Unix时间戳(秒,ts)拼接。

  3. 将拼接后的字符串再次进行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. 实施落地流程

  1. 注册与配网: 在芯步官网注册账号,创建工作台。通过“物联网控制台”模块对50A断路器进行WiFi配网(仅支持2.4G),并记录下生成的设备ID

  2. 接口调试: 使用Postman或命令行测试单设备控制,确保签名计算正确。

  3. 业务系统集成: 将上述代码片段集成到您的现有MES、ERP或楼宇自控系统中。

  4. 压力测试: 使用批量接口同时操作50台或100台设备,观察API响应时间(通常在800ms-1500ms内)。

8. 总结

芯步50A智能断路器的批量控制核心在于利用其 “单次请求多Device ID” 的特性。开发者只需关注业务逻辑(何时开、何时关),将设备ID列表动态拼接到 device 参数中,即可轻松实现整栋楼或整个园区的电力负载远程集中管理。