CATALOG

芯步的20A智能断路器/通断器系列产品统一通过HTTP API进行远程控制,接口协议在通断器、传感器、控制器等产品线中保持一致。以下方案以20A规格为例,涵盖设备选型、接口调用和代码实现。

1. 解决概述

本方案的目标是指导开发者如何通过芯步开放平台,利用HTTP接口对 20A智能电源控制断路器(智能通断器) 进行二次开发,实现远程通断控制。

  • 适用设备:芯步 UNI-DLQ-20A 系列、AC4-20A 系列。

  • 通信协议:HTTP/HTTPS。

  • 数据格式:JSON。

  • 核心优势:无网关依赖(设备直连WiFi)、毫秒级响应(约80-120ms)、支持公网与局域网私有化部署

2. 硬件参数

在开发前,请确认设备规格符合现场需求:

  • 额定电流:MAX 20A。

  • 工作电压:AC 85-265V(宽压设计,适配全球市电)。

  • 负载功率

    • 阻性负载(如白炽灯、电热器):MAX 4000W。

    • 感性负载(如电机、LED灯、节能灯):MAX 600W。

  • 联网方式:Wi-Fi IEEE 802.11 b/g/n 2.4GHz(不支持5G频段)

3. 接口对接流程

整个开发流程分为三个步骤:准备阶段、设备配网、API集成。

3.1 准备阶段:获取密钥

  1. 注册账号:登录芯步官网,进入“物联网控制台”。

  2. 获取凭证:在控制台获取 AppID,并生成用于签名加密的 API Key

  3. 设备注册:确保设备已添加至工作台并获得唯一的 Device ID

3.2 设备配网:连接网络

设备通电后需配置Wi-Fi以连接云端。支持两种方式:

  • 小程序配网:使用“芯步小程序”,扫描设备二维码,输入2.4G WiFi密码。

  • 控制台配网:在PC端物联网控制台的“网络配置”中,录入现场WiFi信息并下发至设备

3.3 API集成:实现远程控制

芯步的开放接口采用标准HTTP POST请求,签名机制保障了接口调用的安全性。

基础信息:

  • 请求地址http(s)://api.thingboot.com/{AppId}/device/control/

  • 请求方法:POST

  • 必传参数sign(签名)、ts(时间戳)用于身份验证

核心命令说明:针对20A断路器,order 参数支持以下操作

功能order 格式说明
开启电源{"power": 1}接通电路,负载通电
关闭电源{"power": 0}断开电路,负载断电
临时通电{"point": 3000}先通后断,单位毫秒(如3000表示通电3秒后自动断开)
短暂断电{"reset": 3000}先断后通(设备重启),单位毫秒(如断开3秒后自动恢复通电)

4. 开发示例

以下展示如何通过不同语言调用HTTP接口关闭断路器:

命令行 (cURL)

Java (OkHttp)

Python (Requests)

5. 高级应用与架构

5.1 私有化部署

对于对数据安全要求比较高的内网环境,芯步支持私有化部署。开发者可将API接口部署在本地服务器,设备通过局域网直连,无需经过公网

5.2 场景联动

利用该断路器的开放接口,可轻松实现设备间的逻辑联动。例如:

  • 传感器联动:通过接口接收温湿度或人体雷达传感器的数据,当传感器检测到无人时,自动调用断路器的 {"power":0} 命令切断电源,实现节能

  • 定时任务:在业务系统中设置定时器,定时调用API接口,实现定时开关路灯或广告牌。

6. 注意事项

  1. Wi-Fi 频段:设备仅支持 2.4GHz Wi-Fi。若路由器开启了双频合一,请关闭或确保手机连接的是2.4G信号进行配网

  2. 负载类型:20A版本驱动 LED灯或电机 时,负载能力下降至600W,严禁超载以防损坏设备

  3. 网络稳定性:设备作为客户端连接路由器,需确保安装位置Wi-Fi信号良好以避免掉线。

通过上述步骤,您可以快速完成对芯步20A智能断路器的远程控制集成。具体接口参数细节(如签名算法)请参考官方《设备接口调用代码示例》文档