CATALOG

从产品参数来看,智能大功率断路器[计量数显版]|50A 采用标准导轨式安装(36mm宽度,占2P位置),支持WiFi 2.4G直连,无需网关即可上云。其核心价值在于:一是50A大电流承载能力(适用于10000W阻性负载),二是“计量数显”功能——可实时读取电压、电流、功率、电量等参数,三是通过开放HTTP接口实现远程通断控制。

以下是基于芯步开放 API 的对接方案。

1. 概述

本方案的目标是指导开发者如何利用芯步提供的标准 HTTP 开放接口 ,对接 智能大功率断路器[计量数显版]|50A 产品。通过该方案,用户或系统集成商可以在任何支持HTTP协议的环境(如Web应用、手机APP、微信小程序、Windows桌面软件或SaaS平台)中,实现对工业/商业配电箱内导轨安装的断路器进行远程通断控制电力数据监测

适用场景:智能充电桩控制、远程路灯控制、基站智能配电、工厂设备远程重启、共享设备租赁控制等。

2. 硬件准备与安装

在开始对接API之前,需确保硬件已正确物理安装并接入网络。

  • 产品型号:UNI-DLQ-M-50A (计量数显版)

  • 安装方式

    1. 导轨安装:将设备卡入标准的DIN导轨(35mm)上。该设备宽度为36mm(2P标准宽度),安装时需注意上下卡扣的紧固

    2. 接线

      • 输入端:接入火线(L)和零线(N),电压范围AC 85-265V。

      • 输出端:接至负载端。由于是50A大功率设备,使用匹配的铜线或铜排,并确保螺丝拧紧以防发热。

    3. 上电:合闸后,设备数码显示屏应亮起,显示实时电压或电流数据。

  • 网络配置该设备通过WiFi 2.4G联网。需通过“芯步”小程序或管理后台,将现场的WiFi SSID和密码推送给设备进行配网注意:设备可预设5组WiFi,会自动选择信号最强的连接,增强了网络稳定性

3. API 对接核心流程

芯步的API采用标准的签名认证机制,所有控制指令均通过HTTPS POST请求发送。

3.1 获取关键凭证

对接前,需要在芯步控制台获取以下信息:

  • AppID:应用的唯一标识。

  • AppSecret:开发者密码,用于计算签名。

  • Device ID:设备的唯一ID(通常贴在设备标签上或在配网后显示在设备列表中)。

3.2 签名机制

为了防止接口被恶意篡改,每次请求都需要携带动态生成的签名(Sign)。芯步采用的签名算法逻辑如下,这也是实现对接的关键步骤:

签名公式YourSign = MD5( MD5(AppSecret) + ts )

参数说明

  • AppSecret:开发者密码。

  • ts:当前Unix时间戳(秒级)。

  • MD5():标准的32位小写MD5加密函数。

3.3 接口交互流程

步骤一:生成签名假设 AppSecret = "abc123",当前时间戳 ts = 1714352400

  1. 计算 MD5(AppSecret) -> e99a18c428cb38d5f260853678922e03

  2. 拼接字符串:e99a18c428cb38d5f260853678922e03 + 1714352400 = e99a18c428cb38d5f260853678922e031714352400

  3. 再次计算MD5得到最终签名。

步骤二:发起控制请求

  • 请求URLhttps://api.thingboot.com/{AppID}/device/control/

  • Method:POST

  • HeadersContent-Type: application/json

  • Query参数?sign={YourSign}&ts={ts}

步骤三:请求Body

注意:根据产品手册,对于单路大功率断路器,控制通断的字段为 power

步骤四:Python代码示例

3.4 数据读取

除了通断控制,“计量数显版”的核心优势在于数据可视化。开发者可以通过以下两种方式获取电流、电压、功率等数据:

  1. API拉取:调用设备状态查询接口,返回的JSON数据包中将包含电压值、电流值(精确到0.01A)、有功功率、电量累计等字段。

  2. 云端推送:在控制台配置数据转发,设备上报的数据会实时推送到开发者指定的服务器地址。

4. 产品核心优势和需要注意的点

4.1 方案优势

  • 免网关直连:大多数工业断路器需要额外的4G DTU或网关才能联网,而该产品自带WiFi模块,直接降低了硬件成本和布线复杂度

  • 本地化与私有化部署:API不仅支持云端调用,还支持局域网(LAN)直接调用。在工厂内网环境下,可以不经过外网直接控制设备,响应速度更快且不受外网断网影响

  • 高精度计量:对于能耗管理类项目(如充电桩计费、空调计费),实时电量数据可帮助系统实现精确的计费逻辑。

4.2 安全与负载注意事项

  • 感性负载降额:该设备虽然阻性负载可达10000W,但对于电机、水泵等感性负载,启动电流往往是额定电流的5-7倍。手册感性负载控制在1700W以内,以防冲击电流导致断路器误动作或触点粘连

  • 合规安装:安装接线时必须断电操作。由于电流高达50A,进出线使用不低于6平方毫米的铜芯电缆。

5. 总结

对接芯步智能大功率断路器[计量数显版]|50A的技术门槛较低,其核心在于处理好MD5动态签名。一旦签名验证通过,开发者即可像操控普通继电器一样,通过简单的HTTP指令控制工业级强电线路。该方案融合了导轨式安装的便捷性和数字化管理的高效性,是传统配电箱升级为智能配电柜的优选方案。