芯步60A计量断路器支持HTTP API直接控制,无需网关即可接入。以下方案涵盖单台控制、批量指令下发、状态监控及企业级对接架构,你可根据实际并发量和安全要求选择对应模式。
1. 背景与概述
随着智慧用电和能源管理需求的提升,对大功率配电回路的远程精细化控制成为刚需。芯步推出的智能大功率断路器(计量版,60A,型号 UNI-DLQ-M-60A-P)不仅具备传统的过载短路保护功能,还集成了电能计量、分合闸控制和开放的 API 接口 。
本方案的目标是指导开发者或系统集成商如何利用芯步提供的 HTTP 开放接口,实现对 60A 智能断路器的远程批量控制。核心目标是解决在宿舍、基站、充电桩或工厂产线等场景下,如何通过编程方式高效、稳定地对单台或多台设备执行通断电操作,并获取实时状态反馈。
2. 核心设备与接口特性
在开始对接前,需明确目标硬件的技术特性,这对设计至关重要。
2.1 60A 智能断路器(计量版)特点
大功率承载:额定电流 60A,适用于空调、大型电机、主进线回路等场景 。
计量功能:除了开关控制,还支持电压、电流、功率、电能等电参量实时读取 。
通信方式:支持 WiFi 2.4G 直连,无需额外网关,降低部署成本;同时支持局域网 HTTP 控制及私有化部署 。
控制逻辑:本质上是继电器输出控制,指令通常对应
power1(针对主回路)或通过power字段控制 。
2.2 开放接口能力
芯步提供的 HTTP API 具有以下特征:
协议标准:基于 HTTP POST 请求,数据格式为 JSON。
鉴权方式:采用
AppID+ 动态签名(Sign)机制,保障接口调用的账户安全 。批量支持:接口参数中的
device字段支持传递多个设备 ID(用英文逗号分隔),是实现批量控制的关键 。
3. 接口对接准备
在编写代码前,需完成以下准备工作:
注册与创建:在芯步官网注册开发者账号,并创建工作台,进入物联网控制台模块 。
获取密钥:在控制台的“开发设置”中获取 AppID 和 AppSecret。这是后续计算签名的凭证,需妥善保管 。
设备配网与ID获取
将 60A 断路器上电,通过“芯步”APP 或小程序为其配置 WiFi 网络 。
配网成功后,在控制台设备列表中查看该设备的唯一标识符(Device ID),此 ID 即 API 操控的目标对象。
4. 签名生成机制
为了保证请求的安全性,每一次 API 调用都需要携带动态签名。签名算法规则如下
计算公式Sign = MD5( MD5(AppSecret) + ts )
参数说明
AppSecret:开发者密钥。ts:当前 Unix 时间戳(秒),防止请求重放攻击。+:表示字符串拼接。
示例流程(伪代码)
在构造请求时,需将 sign 和 ts 作为 Query 参数拼接在 URL 中。
5. 远程批量控制实现方案
针对“远程批量控制”需求,本方案提供两种实现逻辑,适应不同规模的管控需求。
5.1 单请求多设备控制(简单批量)
这是最高效的批量处理方式,适用于同一指令下发给多个设备(例如:晚上 10 点关闭所有宿舍灯光或回路)。
请求URL
https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={ts}请求方法:POST
请求体(Body)关键参数
device:传入需要控制的所有设备 ID,使用逗号间隔。order:传入 JSON 指令。
示例:同时关闭 3 台断路器
注:{"power1": 0} 代表断开主回路(分闸);{"power1": 1} 代表闭合(合闸)。
5.2 精细化批量控制(带顺序与间隔)
在工业场景中,突然同时断开/闭合多台大功率 60A 设备可能对电网造成冲击(涌流)。芯步的接口支持更精细的控制指令,如 先通后断、先断后通 以及 继电器顺序动作。
场景:需要逐台启动大型电机,避免瞬间电流过大。
指令格式:利用
point(点动/先通后断)或利用batch指令,通过编程循环调用并附带延时。
代码层实现逻辑(推荐策略)当需要对 100 台设备进行分批启动时,在业务服务器端进行排队处理:
获取待控制的设备列表。
将设备分为 N 组(如每组 5 台)。
轮询发送请求,每组请求间隔 500ms。
调用接口时,body 中携带本组设备 ID。
5.3 状态查询与反馈
批量控制后的状态确认至关重要。可以通过以下两种方式获取断路器状态:
主动查询:调用设备状态查询接口,获取断路器的当前分合闸状态以及实时电压电流值,用于 UI 界面展示 。
消息推送(推荐):配置消息推送 URL。当断路器状态变化或计量数据更新时,平台会主动向指定的服务器地址推送数据,实现数据的实时同步。
6. 系统架构与集成
为了实现稳定的企业级应用,架构如下:
基础设施层:部署 60A 智能断路器,确保 WiFi 信号覆盖强度(设备支持配置 5 组 WiFi,自动切入信号最佳的网络)。
业务层
Token 与签名管理:编写统一的 Sign 生成工具类。
执行记录:建立数据库表(如
control_logs),记录每次下发的指令、目标设备 ID、操作结果(成功/失败)及时间戳。对于批量操作,记录批次号(BatchId)。
接口调用优化
超时设置:批量调用时,HTTP 请求超时时间设置为 30 秒以上,防止因网络抖动导致大批量指令发送中断。
异常重试:对于返回 504 或 Timeout 的请求,需建立随机间隔(或逐次增大间隔)重试机制。
7. 典型应用场景案例
场景:校园宿舍用电管理
需求:每晚 23:00 自动切断宿舍 60A 总闸,次日 06:00 恢复供电;管理员可在控制室一键关闭违规电器所在楼层的总闸。
实施
将每间宿舍的 60A 断路器 ID 与宿舍房间号在业务系统中绑定。
部署定时任务脚本,22:55 通过 API 下发
{"power1":0}到所有宿舍设备 ID 列表。管理员在 Web 端点击“区域断电”,服务器拼接该区域下所有 ID,构造
{"device":"id1,id2,id3", "order":{"power1":0}}进行提交。
8. 总结
对接芯步 60A 智能断路器实现远程批量控制的技术门槛较低,核心在于掌握 MD5 签名算法 和利用 device 字段支持多ID 的特性。在实际开发中,开发者应重点关注:
安全鉴权:确保 AppSecret 不泄露,签名时间戳有效。
业务逻辑:区分“批量同时动作”与“排队动作”,保护电网安全。
容错机制:处理接口调用的超时与重试,确保控制指令必达。
通过上述方案,企业可以快速构建属于自己的智慧用电管理系统,实现用电的可视、可控、可管。