芯步的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 )
步骤详解:
获取密钥:在后台获取
AppSecret(开发者密码)。加密密钥:将
AppSecret进行一次 MD5 加密,得到encrypted_secret。拼接时间戳:获取当前的Unix时间戳(秒级)
ts,拼接到encrypted_secret字符串的 尾部。最终加密:将拼接后的字符串再次进行 MD5 加密,得到最终的
sign。
注意
ts参数也会在URL中明文传输,服务器会校验时间戳的有效性(通常几分钟内有效),以防止请求重放攻击。
4. 实现远程通断控制 (核心功能)
设备通电并联网后,通过向指定API endpoint发送JSON数据包即可控制通断。
请求概览:
Method: POST
URL:
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}Header:
Content-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. 常见问题与排障指南
设备不在线
现象:调用接口返回设备离线错误。
排查:确认40A断路器供电正常;检查WiFi密码是否更改(设备仅支持2.4G);检查信号强度。
签名错误(401 Unauthorized)
现象:接口返回签名错误。
排查:注意
ts单位为秒(而非毫秒);确认AppSecret加密大小写(统一使用小写字母);严格按照MD5(MD5(Secret)+ts)顺序拼接,不可调换。
控制延迟高或丢包
:若部署在局域网环境(如工厂或私有化部署),开启局域网直连功能,直接访问设备本地IP,减少云转发环节,延迟可降至20ms以内。
7. 结论
通过芯步提供的标准HTTP接口,开发者无需深入理解复杂的无线通信协议,只需通过简单的 POST 请求 即可实现对40A智能空开的远程控制与数据采集。利用 {"power":0} 和 {"power":1} 指令结合设备的状态反馈,可以高效地构建能源管理或智能安防系统。