CATALOG

芯步的40A智能空开支持HTTP开放接口,可通过简单的POST请求实现远程通断控制。以下方案涵盖签名生成、接口调用、计量数据获取及落地注意事项,帮助快速完成对接。

解决方案:基于芯步开放接口实现40A智能空开远程通断控制

1. 概述

芯步的40A智能大功率断路器(带计量联动控制)支持通过HTTP协议进行远程控制。该设备无需网关,直连WiFi,通过向云端或本地服务器发送POST请求,即可实现设备的通断控制、状态查询及电力数据获取

本方案的目标是指导开发者如何利用TTP(HTTP/HTTPS)接口,实现对该设备的远程通断控制。

2. 准备工作

在开始开发前,请确保完成以下硬件与软件配置:

项目说明
设备型号芯步 智能大功率断路器 UNI-DLQ-M-40A
网络环境2.4GHz WiFi网络(设备不支持5G频段)
开发凭证需获取 AppID 与 AppSecret(登录芯步控制台获取)
设备ID设备成功联网后在控制台获取的唯一标识

3. 接口鉴权与签名生成

芯步的接口通过 动态签名 进行安全校验,所有控制请求均需携带签名。签名生成逻辑如下:

核心算法公式:sign = MD5( MD5(AppSecret) + ts )

步骤详解:

  1. 获取密钥:在后台获取 AppSecret(开发者密码)。

  2. 加密密钥:将 AppSecret 进行一次 MD5 加密,得到 encrypted_secret

  3. 拼接时间戳:获取当前的Unix时间戳(秒级) ts,拼接到 encrypted_secret 字符串的 尾部

  4. 最终加密:将拼接后的字符串再次进行 MD5 加密,得到最终的 sign

注意ts 参数也会在URL中明文传输,服务器会校验时间戳的有效性(通常几分钟内有效),以防止请求重放攻击。

4. 实现远程通断控制 (核心功能)

设备通电并联网后,通过向指定API endpoint发送JSON数据包即可控制通断。

请求概览:

  • Method: POST

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

  • HeaderContent-Type: application/json

请求体参数示例:

注意:根据产品手册,部分型号支持单路控制,使用 {"power":1}{"power1":1} 均可,以设备详情页的命令说明为准

不同场景命令对照表:

动作描述order 命令内容业务含义
开启电路{"power":1}{"power1":"1"}闭合内部继电器,输出端OUT通电
关闭电路{"power":0}{"power1":"0"}断开内部继电器,输出端OUT断电
定时断开{"reset":3600000}立即接通,并在1小时后(3600000毫秒)自动断开
先通后断{"point1":"5000"}接通线路1,5秒后自动断开

cURL 调用示例:

5. 获取计量数据与状态反馈

除了控制通断,该40A设备具备“计量”功能,可实时上报电流、电压、功率等数据。

方案A:主动查询(请求-响应)通过接口查询设备最新状态,获取实时电量数据。(具体API路径请参考芯步最新的“设备状态查询”接口文档)

方案B:被动接收(设备推送)如果服务器具备公网IP或域名,可在控制台配置消息推送URL。设备在上报数据时会主动POST数据包至指定服务器,包含如下字段:

  • voltage:电压值(V)

  • current:电流值(A)

  • power:功率值(W)

  • energy:用电量(kWh)

6. 常见问题与排障指南

  1. 设备不在线

    • 现象:调用接口返回设备离线错误。

    • 排查:确认40A断路器供电正常;检查WiFi密码是否更改(设备仅支持2.4G);检查信号强度

  2. 签名错误(401 Unauthorized)

    • 现象:接口返回签名错误。

    • 排查:注意 ts 单位为(而非毫秒);确认 AppSecret 加密大小写(统一使用小写字母);严格按照 MD5(MD5(Secret)+ts) 顺序拼接,不可调换。

  3. 控制延迟高或丢包

    • :若部署在局域网环境(如工厂或私有化部署),开启局域网直连功能,直接访问设备本地IP,减少云转发环节,延迟可降至20ms以内

7. 结论

通过芯步提供的标准HTTP接口,开发者无需深入理解复杂的无线通信协议,只需通过简单的 POST 请求 即可实现对40A智能空开的远程控制与数据采集。利用 {"power":0}{"power":1} 指令结合设备的状态反馈,可以高效地构建能源管理或智能安防系统