10A额定电流属于智能断路器产品的标准规格,芯步的开放接口采用HTTP协议,支持远程分合闸控制、状态监测和定时任务,可快速集成到各类软件平台中。以下是具体的接入方案:
一、 硬件选型:为什么选择 10A / 20A 规格
要实现10A额定电流的精准控制,首先需要确认硬件选型。虽然在物理参数上,选择额定电流稍大的断路器(如20A)去控制10A回路是常见的安全做法,但针对10A目标,芯步生态中有以下适配方案:
推荐型号芯步 智能断路器20A (UNI-DLQ-20A)。
选型依据
额定功率:该型号支持20A电流,用于控制10A负载时拥有充足的余量,能有效抵抗电机、压缩机等感性负载启动时的瞬间浪涌电流,避免误触发。
电压适配:通常支持AC 110V-240V,覆盖全球主要民用和工业标准。
安全保障:具备过载保护和短路保护功能。当实际电流超过设定的阈值(如11A)时,设备会执行硬件级断路,同时通过接口上报故障信息。
二、 核心接口对接:如何实现“通断控制”
芯步的核心优势在于其开放且简洁的HTTP接口体系。你的上位机系统(如SaaS后台、手机App、桌面软件)无需集成复杂的SDK,只需通过标准的HTTP POST请求即可控制设备。
1. 接口基本信息
协议:HTTP/HTTPS
方法:POST (也支持GET)
数据格式:JSON
核心地址
https://iot-api.thingboot.com/{AppID}/device/control/
2. 鉴权与参数构造(签名计算)
为了防止接口被恶意调用,所有请求需携带签名(sign)和时间戳(ts)。这是接入过程中唯一稍有技术门槛的环节,具体步骤如下:
获取开发者密码(Secret Key)。
生成动态签名:
sign = md5(md5(Secret Key) + ts)。在URL中携带参数:
?ts=当前Unix时间戳&sign=计算出的签名值。
3. 下发“合闸/分闸”指令详解
这是最常用的功能,通过指定device_id(设备ID)和commands(命令数组)来实现。
请求示例 (JSON Body) :
代码逻辑实现假设你需要集成到工厂的PLC系统或楼宇自控系统中,仅需封装一个函数,核心逻辑如下
拼接URL(包含动态Sign)。
设置Header:
Content-Type: application/json。发送POST请求,Body中包含上述JSON。
接收返回:若收到
{“code”:200, “msg”: “ok”},则代表指令下达成功。
4. 状态监测与数据上报
控制不是单向的,你需要知道当前电路的状态。芯步提供了状态查询接口和消息推送机制。
主动查询:调用
GET /device/status/接口,获取断路器当前的实时电流(mA)、电压(mV)、功率(W)及开关状态。被动接收:配置消息服务器(Webhook)。当断路器状态发生变化(如被人手动按下物理按钮,或检测到过载跳闸)时,平台会主动推送数据到你配置的服务器地址,实现毫秒级响应。
三、 针对“10A额定电流”的特定配置策略
虽然断路器自身的物理保护决定了“硬件上限”,但通过软件接口,你可以定义“软件上限”,实现对10A额定电流的精细化管理。
过载保护阈值设定利用芯步的参数写入接口,向设备下发
over_current_protection指令。你可以将保护阈值设定为 10A,并将延迟时间设定为5-10秒(以容忍电机启动时的短暂电流尖峰)。局域网(LAN)与私有化部署针对工业生产对稳定性的严苛要求,芯步支持局域网纯闭环控制。即使外网断开,你的本地服务器依然可以通过路由器的局域网IP直接向断路器发送HTTP指令,保证生产不中断。
定时与联动任务通过调用 “任务类接口” ,你可以直接为10A回路创建定时策略。例如:
场景A:每晚23:00自动分闸(断开10A照明回路),早8:00自动合闸。
场景B:联动温湿度传感器,当温度过高时,自动合闸10A风扇回路。
四、 接入流程总结
为了帮助你快速落地,按以下步骤推进:
物理安装:将UNI-DLQ-20A断路器安装在配电箱的DIN导轨上。请一定要断电操作,输入端接火线进线,输出端接10A负载的火线,零线直通或根据型号接线。
设备配网
登录芯步控制台。
利用“网络配置”功能,将现场的2.4G WiFi凭证通过“手机热点配网”或“蓝牙配网”方式写入设备。
确认设备指示灯变为常亮,控制台显示设备“在线”。
接口调试
在控制台获取设备的ID和你的AppID/Secret。
使用Postman等工具,按照第三节的格式手动发送一次
set_switch命令,验证断路器是否能正常吸合与断开。
业务集成
将封装好的HTTP请求代码集成到你现有的能源管理系统(EMS)或生产执行系统(MES)中。
五、 总结
通过芯步的开放接口接入大功率断路器实现对10A电流的控制,本质上是利用标准化的HTTP API将传统配电设备转化为数字化终端。你不需要深入底层无线通讯协议,只需关注业务逻辑:什么时候该合闸?什么时候该跳闸?收到告警后如何处理?凭借芯步提供的多语言API文档和私有化部署能力,开发团队通常 1-2天 内即可完成从设备上电到业务系统集成的全流程。