CATALOG

带计量功能的40A智能断路器,适用于宿舍、商铺、充电桩等大功率场景。芯步的设备通过简洁的HTTP接口即可完成对接,本文将围绕“批量控制”这一核心需求,从接口协议、签名算法到代码实现进行完整拆解。

解决方案:基于芯步开放接口实现带计量智能断路器(40A)的远程批量控制

1. 概述

本方案的目标是指导开发者或系统集成商,利用芯步提供的标准HTTP API接口,实现对 40A 带计量智能断路器 的远程批量控制。

适用场景:智慧园区、基站远程重启、宿舍电力控制、充电桩运营、工业设备联动。核心目标:通过编程方式,对单台或多台40A断路器执行开/关闸指令,并实时读取电压、电流、功率等计量数据。

2. 硬件与接口准备

在开始开发前,请确认已准备以下资源:

2.1 硬件设备

  • 产品型号:智能大功率断路器[计量版] 40A 或 智能大功率断路器[计量数显版] 40A

  • 关键参数:额定功率8000W,支持2.4G WiFi直连,无需网关

2.2 软件凭证

  • AppID:应用唯一标识(登录芯步控制台获取)。

  • AppSecret:开发者密码(用于接口签名加密,请勿泄露)

  • 设备ID:即 device 参数(设备联网后可在控制台查看或通过接口拉取)。

3. 接口鉴权机制

所有HTTP接口请求均需携带签名以验证身份。签名算法如下(以PHP语法为例,其他语言逻辑相同):

最终请求地址结构为:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

4. 核心功能实现:API调用详解

4.1 单台设备控制(基础)通过HTTP POST请求控制指定ID的断路器。

  • 请求方式:POST

  • HeaderContent-Type: application/json

  • Body 示例

注:对于40A大功率断路器,通断命令通常使用 power 字段

4.2 批量控制(核心)针对“远程批量控制”的需求,芯步接口支持在同一请求中传入多个设备ID,实现毫秒级同步控制。

  • 实现的方式是device 参数支持逗号分隔多个ID。

  • 请求Body示例(批量关闭)

4.3 实时计量数据读取带计量功能的核心优势在于数据监控。设备会上报电压、电流、功率等数据。

  • 方案A(推荐:接收推送):设备数据变化时会主动上报至您预设的URL(需在控制台设置消息推送地址)。

    • 上报数据示例{"device":"118554288","voltage":220.5,"current":12.3,"power":2706}

  • 方案B(主动查询):调用设备状态查询接口获取实时快照。

5. 完整对接流程(时序图逻辑)

  1. 设备配网:使用“芯步”小程序为断路器配置现场2.4G WiFi,获取设备ID

  2. 服务端开发

    • 根据上述签名规则构建API请求函数。

    • 编写业务逻辑(如:定时任务、能耗超限自动跳闸、远程批量升级固件)。

  3. 指令下发

    • 服务端向 api.thingboot.com 发起请求。

    • 平台下发指令至云端。

    • 断路器通过长连接接收指令,执行动作(约80-200ms响应)

  4. 状态同步:设备执行后返回结果,平台推送最新状态至服务端。

6. 高级扩展策略

  • 场景联动:结合芯步的传感器(如温湿度、烟感),设定联动规则。例如:检测到“烟雾报警”时,API自动调用断路器接口切断总闸

  • 私有化部署:若对数据安全要求比较高,芯步产品支持局域网或私有云部署,API可切换至本地服务器地址避免公网传输

7. 常见问题

  • 断路器已断电,如何远程恢复?如果断路器直接断电导致设备离线,无法通过网络唤醒。解决方案是配合“自复式”功能或通过上级总闸供电。

  • 如何确认控制成功?接口返回HTTP Status Code 200 仅代表指令接收成功,通过计量数据回传(如功率>0即代表已合闸)双重确认

注:芯步提供全程免费技术指导,在选型与对接调试过程中可随时联系其工程师支持