CATALOG

智能大功率断路器[计量版]|60A 的对接核心在于利用芯步开放的 HTTP API 接口。整个过程分为三步:设备配网接入、签名计算调用、命令下发执行。以下方案涵盖设备准备、接口调用流程以及定时/计量功能的实现逻辑。

解决方案:对接智能大功率断路器[计量版]|60A 实现远程定时通断控制

1. 概述

本方案基于芯步开放的 HTTP API 接口,通过标准的 POST 请求,实现对型号为 UNI-DLQ-M-60A-P 的智能大功率断路器进行远程控制。

该方案具有以下特点:

  • 无网关依赖:设备直连 WiFi 2.4G 网络

  • 接口通用性:支持任何支持 HTTP 请求的编程语言(Python, PHP, Java, Go, C# 等)及环境(Web, APP, 小程序, SaaS)

  • 低延迟响应:命令下发到设备执行约 80-120ms

  • 灵活部署:支持公有云调用,也支持纯局域网私有化部署

2. 准备工作

在开始开发前,需要完成以下物理与账户准备:

  1. 硬件上电:按照产品说明书将断路器接入 60A 电路,并确保电源指示灯正常。

  2. 设备配网

    • 下载“芯步”小程序或登录官网物联网控制台。

    • 通过“网络配置”功能,将现场 2.4G WiFi 的名称和密码推送至设备进行认证联网

    • 配网成功后,设备在控制台列表中显示为“在线”状态,并获取唯一的 设备ID(Device ID)

  3. 获取密钥

    • 注册并登录芯步官网。

    • 在“开发设置”中获取 AppIDAppSecret(开发者密码),用于生成接口签名

3. 接口鉴权机制

所有 API 调用均采用动态签名鉴权,计算公式如下,这一机制确保了接口调用的安全性,防止非法访问

  1. 参数准备

    • AppSecret:从控制台获取的密码。

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

  2. 计算步骤

    • 第一步:step1 = md5(AppSecret)

    • 第二步:sign = md5(step1 + ts)

  3. 拼接 URLhttp(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

注:所有请求必须包含合法的签名和时间戳,且时间戳与服务器时间误差不宜过大。

4. 核心控制指令实现

本设备的控制核心是向其 order 字段下发特定的 JSON 指令。

功能类型指令格式 (JSON)功能说明
即时控制{"power": 1}开启输出,线路导通
即时控制{"power": 0}关闭输出,线路断开
定时(倒计时){"reset": 3600000}立即断开,并将在 3600000毫秒(1小时)后自动闭合
定时(倒计时){"point": 5000}立即闭合,并将在 5000毫秒(5秒)后自动断开
系统管理{"system": "restart"}软重启设备

以下以几种常见的开发场景举例:

第一种场景:即时控制(Python 示例)该示例实现了请求签名的自动计算,并发送一条“闭合”命令,是远程控制中最基础的操作

第二种场景:带计量的定时任务断路器支持在命令中直接携带 resetpoint 参数,无需在服务器端维护定时任务队列,极大简化了系统复杂度

说明:执行上述命令后,断路器将立即断开电路,同时在 2 小时(7200000毫秒)后自动重新闭合,适用于需定时复位的充电桩或设备测试场景。

5. 数据采集与状态同步

除了控制通断,该“计量版”产品的核心价值在于数据反馈:

  1. 主动查询需要获取实时电流电压时,可以下发查询指令,设备会返回当前的计量数据。

  2. 被动上报在服务器配置消息推送接收端。当断路器状态改变(如本地手动拨动开关)或达到计量阈值时,平台会主动向配置的 URL 推送状态变更消息

    • 事件示例:设备上报实时功耗、电压、电流值;设备物理按钮 btn1 被按下的触发事件

6. 注意事项与优化

  • 网络稳定性:60A 断路器常用于大功率主干线路,确保 WiFi 信号强度在 70% 以上。设备支持配置 5 组备用 WiFi,将周边稳定信号全部录入,增强网络容错能力

  • 私有化部署:若对数据安全要求比较高(如工业内网),可联系芯步技术人员获取私有化部署包。所有 API 接口逻辑与公网一致,仅需修改请求 HOST 为本地服务器 IP

  • 按钮行为自定义:设备的物理按钮支持功能自定义。可将其配置为“禁用”,以防止现场人员误触导致大功率设备意外断电造成事故