AC5-10A这款智能通断器,最实用的地方在于它有HTTP接口——甭管你用Python、Java还是PHP,发个POST请求就能控制它开关,还能拿回电量数据。下面讲讲怎么把它接入自己的系统里。
一、 这玩意儿是什么?能干啥?
咱们先聊聊这个硬件本身。
AC5-10A 是芯步推出的一款“智能通断器”,你可以把它理解成一个 能联网、能计量、能远程控制的超级插座 ,只不过它背后是接线式的,专门用来嵌入你的设备内部或者电箱里。
它的核心亮点包括:
小身材大能量:体积只有火柴盒大小(45.2mm * 41.1mm),能塞进各种狭小空间,但额定电流高达10A,足以带动2000W左右的阻性负载(如灯光、加热器)。
控制与计量一体:这不仅是开关,它还能反馈实时的能耗数据。
开放接口:它不依赖特定的APP界面,通过HTTP接口,你可以把它无缝集成到自己的上位机、小程序或者云平台里。
适用场景:你想在软件后台远程重启路由器、控制生产线信号灯、定时启停广告屏,或者监测某台老旧设备的用电量,用它就对了。
二、 准备工作:把设备“连上网”
动手之前,得先让设备“认识”你家的Wi-Fi。AC5-10A只支持 2.4G Wi-Fi ,这点要注意,别连错了。
配网有两种姿势,看你的习惯:
电脑端操作:登录芯步官网,进“物联网控制台”,把你的Wi-Fi名称密码登记一下,然后通过设备配网模式推送给它。
小程序操作:微信搜“芯步小程序”,登录账号后,在“网络配置”里添加Wi-Fi。操作挺直观的,跟着走就行。
配网成功的标志:设备上的指示灯从“快闪”变为“常亮”或“熄灭”,这时候在控制台里应该能看到它显示“在线”了。
三、 接入:用代码“打电话”指挥它
设备上线后,接下来就是重头戏——写代码调用它的开放接口。
芯步的API设计得很直白,本质上就是发一个 HTTP POST 请求。下面以大家常用的PHP语言为例,看看怎么控制它。
1. 先看懂接口地址和参数
接口地址通常长这样:
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
这里面有几个关键要素:
AppID:你的应用ID,登录控制台就能看到。
device:你要控制的那个设备的ID。
order:你要下达的命令,这是核心。
2. 常用的“命令”有哪些?
根据AC5-10A的接口定义,你可以通过改变 order 里的JSON串来实现不同功能:
① 开关控制这是最基础的控制。在PHP代码里,你可以这样构建数据:
把这串数据扔给服务器,设备就能响应了。
② 重启功能如果你接的是路由器或者工控机,需要远程重启,可以用“先通后断”或“先断后通”功能。
reset 后面的数字单位是毫秒,5000 就是5秒。
③ 获取用电计量这是本次主题的重点——能耗计量。你可以发送指令查询设备当前的功率、电压、电流等数据。接口会返回一串数值,你解析一下就能在界面上生成能耗曲线图了。这类命令通常涉及数据查询的API,具体返回字段参考官方文档。
3. 代码实战片段
假设你已经在控制台拿到了 AppID、sign 和 device,这里演示一下如何下发“关闭”指令:
四、 进阶玩法:搭建自己的能耗看板
光能控制还不够,你不是要“实时能耗计量控制”吗?可以这样设计系统逻辑:
轮询机制:写一个定时脚本(比如每5分钟一次),去调用芯步的 “查询设备状态”接口。
数据存储:把拿到的电流、电压、功率数值存到数据库里。
逻辑判断
如果监测到 功率 > 设定阈值(比如空调缺氟导致电流异常),系统自动发送
{"power":"0"}指令切断设备,保护电路。如果监测到 功率 = 0 但设备处于开启状态,那可能就是设备故障了,赶紧给你发个报警。
五、 避坑指南
在实际接线和调试中,有几个坑别踩:
负载限制:虽然标称10A,但如果是电机、LED灯这种感性负载,功率要控制在 350W 以内,不然触点容易粘连或损坏。
强电安全:AC5-10A接的是 100V-250V 交流电!接线前一定要断电,火零线别接反了。如果不太熟悉强电,最好请电工帮忙。
局域网控制:如果你不希望数据经过外网,芯步的设备其实也支持局域网HTTP控制,延迟更低,也更安全。可以在路由里把API地址指向设备内网IP试试。
总结
接入AC5-10A其实就像调用一个第三方支付接口一样简单。它的核心逻辑就是 “发命令 -> 收反馈” 。拿到API文档后,半小时内应该就能跑通第一个“开关”流程,剩下的就是怎么把这些数据跟你业务场景结合了。