CATALOG

这是一份关于如何接入芯步智能断路器/通断器(20A)实现远程控制的解决方案。我尽量写得详细且口语化一些,方便技术和非技术的朋友都能看懂。

1. 为啥选这款设备?(先看硬货)

在我们开始写代码之前,得先确认一下咱们手里的“家伙什”够不够硬。芯步的这款20A智能断路器(具体型号通常是 UNI-TDQ-AC4-20A 或类似),有几个挺实在的优点:

  • 真的能扛大电流:额定20A,阻性负载(比如纯灯光、电热器)能到4400W。哪怕是电机、LED这种感性负载,也能扛700W。像工厂里的风机、家里的空调插座,基本都够用了

  • 接口极度开放:这玩意儿不依赖那些乱七八糟的第三方APP,它直接开放 HTTP API接口。这意味着啥?意味着只要你会上网,不管是Python、Java、PHP还是一行Shell脚本,都能直接指挥它干活

  • 接线简单:就是进线(L/N)和出线(L/N),电工师傅看一眼就懂,哪怕是自己动手,只要关了电闸,照着说明书拧螺丝就行

2. 准备工作:先得有个“遥控器”账号

设备买回来通上电,它现在还处于“懵圈”状态,不知道你家WiFi密码。得先把它带上网。

  1. 注册账号:去芯步官网注册一个账号,进到“工作台”

  2. 配网

    • 方法一(推荐):用微信小程序搜索“芯步”,登录后选“网络配置”。把你的WiFi名称和密码告诉它(注意:只能是2.4G WiFi,5G不行)。

    • 方法二:电脑端后台操作。

    • 操作的时候,指示灯会慢闪,连上网后灯就常亮了。这时候,这台断路器就真正属于你了

3. 核心环节:接口调试

这是最关键的一步。芯步的接口设计得比较人性化,甚至提供了 “调试模式” 。先不用管复杂的加密签名,把流程跑通再说。

3.1 打开调试模式(省去麻烦的签名计算)

  1. 登录工作台,进入“物联网控制台”。

  2. 左边菜单栏找到 “开发设置”

  3. 找到一个叫 “调试模式” 的开关,直接打开

    • 这时候,系统会暂时不校验你的签名(sign)和时间戳(ts)。就像进小区不查身份证一样,先让你进去看看房型

3.2 找到设备ID

在控制台的设备列表里,找到你刚才配网的那个设备,把那一串 设备ID 复制下来。这个ID就是你要控制的对象的“身份证号”。

3.3 发送第一条“断电”指令

打开你的API调试工具(比如Postman,或者直接用命令行终端,因为curl命令最简单)。

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/

  • 请求方式POST

  • Body参数 (JSON格式):

如果一切顺利,设备应该“咔”一声就断了。把 {"power": 0} 改成 {"power": 1},设备就通了。

是不是很简单? 这就是最核心的远程控制了

4. 玩点高级的:不仅仅是开关

如果只控制通断,那也太小看它了。这款断路器支持直接下发“定时”和“脉冲”指令,这个设计非常贴心。

第一种场景:我想让设备先通电,运行5秒钟,然后自动断开。

  • 老思路:你需要写一个脚本 -> 发“开”指令 -> 等待5秒 -> 发“关”指令。万一中间程序崩溃了或者断网了,那设备就关不掉了。

  • 新思路:直接用断路器的内部计时器。

这种模式对控制电暖气定时关闭、或者给电子设备复位,非常香

第二种场景:我想让设备断一下,像按重启键一样。

  • 指令

这对远程重启路由器、远程重启挂掉的工控机,绝对是神器。

5. 正式环境:把安全加上(签名计算)

调试没问题了,该上线了。这时候最好把“调试模式”关掉,启用签名验证,防止别人知道你的AppID后乱发指令。

签名的算法是:sign = md5( md5(你的密钥) + 时间戳 )

写段伪代码(或Java/Shell)来实现:

  1. 你在“开发设置”里拿到 AppIDAppSecret(密钥)。

  2. 生成当前的时间戳(秒)ts

  3. 计算签名:先把AppSecret做一次MD5,得到字符串A;再把字符串A拼接上ts,然后再做一次MD5,得到sign。

  4. 请求地址变成:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

以Shell脚本为例(极其适合跑在Linux服务器上的定时任务):

6. 总结与避坑指南

总结一下这套方案能做的事情:

  • 能耗管理:定时切断下班忘关的灯、饮水机、服务器。

  • 远程运维:配合reset指令,远程重启路由器或自助售货机。

  • 场景联动:因为它是HTTP接口,你可以轻松把它接入HomeAssistant、Node-RED或者你自建的管理后台。

最后,有几点小提示:

  1. WiFi频段:再次确认你的路由器打开了2.4G频段,现在很多智能设备都不认5G。

  2. 功率红线:看准 4400W(阻性)/700W(感性) 这两个数字。如果是控制大功率电机或一堆LED灯,记得给余量

  3. 安全第一:接220V强电的时候,一定一定把总闸拉了,别带电操作。