从产品参数来看,智能大功率断路器[计量数显版]|50A 采用标准导轨式安装(36mm宽度,占2P位置),支持WiFi 2.4G直连,无需网关即可上云。其核心价值在于:一是50A大电流承载能力(适用于10000W阻性负载),二是“计量数显”功能——可实时读取电压、电流、功率、电量等参数,三是通过开放HTTP接口实现远程通断控制。
以下是基于芯步开放 API 的对接方案。
1. 概述
本方案的目标是指导开发者如何利用芯步提供的标准 HTTP 开放接口 ,对接 智能大功率断路器[计量数显版]|50A 产品。通过该方案,用户或系统集成商可以在任何支持HTTP协议的环境(如Web应用、手机APP、微信小程序、Windows桌面软件或SaaS平台)中,实现对工业/商业配电箱内导轨安装的断路器进行远程通断控制及电力数据监测。
适用场景:智能充电桩控制、远程路灯控制、基站智能配电、工厂设备远程重启、共享设备租赁控制等。
2. 硬件准备与安装
在开始对接API之前,需确保硬件已正确物理安装并接入网络。
产品型号:UNI-DLQ-M-50A (计量数显版)
安装方式
导轨安装:将设备卡入标准的DIN导轨(35mm)上。该设备宽度为36mm(2P标准宽度),安装时需注意上下卡扣的紧固。
接线
输入端:接入火线(L)和零线(N),电压范围AC 85-265V。
输出端:接至负载端。由于是50A大功率设备,使用匹配的铜线或铜排,并确保螺丝拧紧以防发热。
上电:合闸后,设备数码显示屏应亮起,显示实时电压或电流数据。
网络配置该设备通过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。
计算
MD5(AppSecret)->e99a18c428cb38d5f260853678922e03拼接字符串:
e99a18c428cb38d5f260853678922e03+1714352400=e99a18c428cb38d5f260853678922e031714352400再次计算MD5得到最终签名。
步骤二:发起控制请求
请求URL
https://api.thingboot.com/{AppID}/device/control/Method:POST
Headers
Content-Type: application/jsonQuery参数
?sign={YourSign}&ts={ts}
步骤三:请求Body
注意:根据产品手册,对于单路大功率断路器,控制通断的字段为 power。
步骤四:Python代码示例
3.4 数据读取
除了通断控制,“计量数显版”的核心优势在于数据可视化。开发者可以通过以下两种方式获取电流、电压、功率等数据:
API拉取:调用设备状态查询接口,返回的JSON数据包中将包含电压值、电流值(精确到0.01A)、有功功率、电量累计等字段。
云端推送:在控制台配置数据转发,设备上报的数据会实时推送到开发者指定的服务器地址。
4. 产品核心优势和需要注意的点
4.1 方案优势
免网关直连:大多数工业断路器需要额外的4G DTU或网关才能联网,而该产品自带WiFi模块,直接降低了硬件成本和布线复杂度。
本地化与私有化部署:API不仅支持云端调用,还支持局域网(LAN)直接调用。在工厂内网环境下,可以不经过外网直接控制设备,响应速度更快且不受外网断网影响。
高精度计量:对于能耗管理类项目(如充电桩计费、空调计费),实时电量数据可帮助系统实现精确的计费逻辑。
4.2 安全与负载注意事项
感性负载降额:该设备虽然阻性负载可达10000W,但对于电机、水泵等感性负载,启动电流往往是额定电流的5-7倍。手册感性负载控制在1700W以内,以防冲击电流导致断路器误动作或触点粘连。
合规安装:安装接线时必须断电操作。由于电流高达50A,进出线使用不低于6平方毫米的铜芯电缆。
5. 总结
对接芯步智能大功率断路器[计量数显版]|50A的技术门槛较低,其核心在于处理好MD5动态签名。一旦签名验证通过,开发者即可像操控普通继电器一样,通过简单的HTTP指令控制工业级强电线路。该方案融合了导轨式安装的便捷性和数字化管理的高效性,是传统配电箱升级为智能配电柜的优选方案。