芯步的智能断路器系列产品全线开放HTTP接口,这意味着无论你用Python、Java还是Go,都可以轻松实现对25A断路器的远程控制和批量管理。下面这套方案比较接地气,从接线到接口调用再到批量控制,一步步来。
一、 搞清楚硬件与参数(心里有底)
首先,咱们手头的这台智能断路器|25A (UNI-DLQ-25A) 有几个硬指标你需要注意一下,不然带不动设备:
额定电流:MAX 25A(也就是最大能承载25安培的电流)。
负载功率:如果是阻性负载(比如白炽灯、电暖气)最大5000W;如果是感性负载(比如电机、冰箱)控制在800W以内 。
联网方式:通常有纯WiFi版和WiFi+4G版。如果现场有WiFi信号,用普通版就行,能省点钱;如果环境复杂,可以考虑4G版,插卡即用 。
怎么连?设备支持导轨式安装,直接卡在电箱里就行。接线也很常规,上进下出 。
二、 核心思路:怎么“喊”动它?
这套方案的核心不是用手去按,而是发指令。芯步的接口设计得比较简单,不需要你是大神就能看懂。
所有控制本质上都是向服务器发送一个 HTTP请求。只要你的断路器在线,就能收到指令 。
你需要准备三样东西(注册登录芯步控制台就能看到):
AppID:相当于你在平台上的“账号ID”。
AppSecret:你的“私有密钥”,做签名用的,千万别泄露。
Device ID:这台断路器的唯一编号,贴在机身或者后台能查到。
三、 实战:从“单控”到“批量”
咱们先搞定单个控制,再把路子铺开到批量。
1. 签名计算(这是最常见的坑)
为了防止接口被乱刷,每次请求都要带一个动态签名 sign。算法很简单:sign = md5( md5(AppSecret) + ts )。
ts:当前的时间戳(秒数)。
简单说,就是把你的密钥算一遍,再拼上时间戳,再算一遍。大多数后端语言都有现成的MD5函数,照着公式写就行。
2. 控制单个设备(发个指令试试)
当你需要关掉某一台设备时,用 POST 方式调用这个地址:https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={时间戳}
请求体 (Body) 这样写:
power:1代表合闸(通电),power:0代表分闸(断电)。预计延迟:通常在80-120毫秒左右,基本上是秒响应 。
3. 进阶:批量控制的两种姿势
如果你有100个店铺,想在下班时一键全关,有两种办法。
方案A:多设备ID传参(适合少量设备)在请求里直接把多个设备的ID用逗号隔开
优点:简单直接。缺点:如果一次控制几百上千台,URL会变得很长。
方案B:使用“标签”管理系统(适合大批量/分组)这是芯步比较推荐的方式,也是最“正规军”的做法,适合批量管理。
第一步:打标签。在芯步的后台,把所有“A园区”的断路器都打上同一个标签,比如标签ID叫 101。第二步:控制标签。直接调用标签控制接口,不用关心具体有多少台设备,只要打上这个标签的设备都会收到指令:
https://api.thingboot.com/{AppID}/tag/control/?sign={sign}&ts={ts}
请求体:
只要看到返回 {"code": 200},就代表指令已经发给这一批设备了 。
4. 定时与自动化(省心配置)
你还可以利用接口做更精细的逻辑:
定时通断:配合你们自己的业务系统,比如“每天早上8点合闸,晚上10点断闸”。
点动/自复位:有时候需要“按一下,通1秒,再断开”。可以用
point命令,比如{"point": 1}(先通后断)或者{"reset": 1}(先断后通)。
四、 几个实际场景的小Tips
关于网络稳定性25A的断路器通常用在功率较大的设备上。如果现场WiFi信号不好,设备掉线了怎么办?芯步的设备支持设定5组WiFi网络,它会自动挑信号强的连,另外如果是4G版则不用担心WiFi信号问题 。
接口限流注意芯步对单个设备的访问频率限制了1次/秒。如果你要批量控制几百台,不需要一瞬间发几百个包,利用上面的“标签”功能一个包就能搞定,不会触发限流 。
私有化部署(可选)如果你的业务数据比较敏感,不想走公网,芯步的这套协议是支持私有化部署的。你可以把服务端部署在自己的局域网服务器上,断路器在内网跑,彻底断掉外网连接,安全性拉满 。
五、 总结一下开发步骤
接线:把25A断路器接好,通电。
配网:通过芯步的App或配网工具把设备连上WiFi(如果是4G版忽略此步)。
拿Key:在官网控制台拿到AppID、Secret和设备ID。
写代码:参考上面的签名算法,写一个封装好的函数,比如叫
sendCommand(deviceId, power_status)。搞逻辑:写一个循环,或者建几个标签,把你的业务逻辑串起来。