芯步的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 准备阶段:获取密钥
注册账号:登录芯步官网,进入“物联网控制台”。
获取凭证:在控制台获取
AppID,并生成用于签名加密的API Key。设备注册:确保设备已添加至工作台并获得唯一的
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. 注意事项
Wi-Fi 频段:设备仅支持 2.4GHz Wi-Fi。若路由器开启了双频合一,请关闭或确保手机连接的是2.4G信号进行配网。
负载类型:20A版本驱动 LED灯或电机 时,负载能力下降至600W,严禁超载以防损坏设备。
网络稳定性:设备作为客户端连接路由器,需确保安装位置Wi-Fi信号良好以避免掉线。
通过上述步骤,您可以快速完成对芯步20A智能断路器的远程控制集成。具体接口参数细节(如签名算法)请参考官方《设备接口调用代码示例》文档。