AC5-10A 这款智能通断器本质就是一个带计量的 WiFi 开关,核心对接思路就是“调用 HTTP 接口 + 处理回调数据”。下面我把整个对接流程拆开来讲,你可以根据自己用的编程语言来调整。
一、准备工作:先认识一下这个小东西
在动手写代码之前,得先搞清楚咱们要操作的对象是谁。
AC5-10A 是什么?它就是一个小型智能通断器,装在传统电器(比如灯、插座、电机)的线路上,你给它发个指令,它就能帮你“咔嚓”一下把电接通或断开。
为什么选它?
WiFi直连:这玩意儿不需要网关,你家有2.4G WiFi,它就能自己连上去。
带计量功能:不仅能控制通断,还能读取电流、电压、功率。这就是我们要的“用电数据上传”基础。
接口开放:芯步给它配了HTTP接口,说白了,你只要能在代码里发POST请求,就能搞定它。
二、核心思路:怎么让数据“上传”和“控制”?
实现这个需求,其实就是两个动作:
你要控制它(下发指令):你的服务器 -> 云端API -> 设备 -> 电器通断。
它要汇报数据(数据上传):设备 -> 云端API -> 你的服务器接收。
在这个模式下,AC5-10A 已经连上了芯步的云,我们需要做的,就是把我们的业务系统跟芯步的云对接起来。
三、动手对接:怎么实现远程控制?
既然我们要做“定时控制”,首先得学会怎么发命令。
1. 找到你的身份证
你需要先登录芯步的开发者后台,找到 AppID 和 AppSecret。这俩相当于你的账号密码,签名的时候要用。
2. 接口地址与签名
控制设备的地址是这个样子的:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}
这里稍微有一点点绕,但不是很难。为了防止接口被别人乱刷,我们需要搞一个 MD5 签名。规则如下Step 1:先把你的 AppSecret 做一次 MD5,得到 secret_md5。Step 2:把 secret_md5 和当前的时间戳(秒)拼在一起。Step 3:再把拼好的字符串整体做一次 MD5,这就是最终的 sign。
举个栗子,简单来说就是:sign = md5( md5(AppSecret) + ts )
3. 发送指令
我们需要发一个 POST 请求,Body 里放上 JSON 数据
device:设备的ID(在后台或设备标签上)。
order:你要干嘛。
4. 常用指令对照表
对于 AC5-10A,常用的 order 参数如下:
立即开
{"power":"1"}(1代表开)立即关
{"power":"0"}(0代表关)定时关/开(先通后断)
{"point":"5000"}—— 比如这个命令,就是先把设备打开,5秒(5000毫秒)后自动关闭。定时开/关(先断后通)
{"reset":"3600000"}—— 先把设备关闭,1小时后自动打开。(这个就是做定时任务的关键!)
划重点:想实现“定时控制”,并不是要你自己去写一个定时任务一直跑循环。你只需要调用一次
reset命令,告诉设备“一小时后开”,设备自己就会倒计时,哪怕你这时候把服务器关了,它到时候也会自己开。
四、进阶需求:怎么获取用电数据?
这才是这个方案里比较关键的部分。AC5-10A 既然带计量功能,数据怎么拿呢?主要有两种方式,按推荐程度排序:
方案 A:设置消息推送(推荐,省心)
芯步的云支持消息推送。你需要在芯步控制台设置一个你的 API 接收地址(Webhook)。
设置回调:在你的后台配置一个接口 URL,比如
https://你的域名/api/device/data。设备上报:设备每隔几秒(通常是30秒或1分钟)会自动把电压、电流、功率等消息推送到你这个地址。
你只需要接收:你写一个接口等着收数据就行了,收下来存到数据库里,想怎么展示就怎么展示。
方案 B:主动查询
如果你不想搭接收服务,也可以主动问。芯步有查询设备状态的接口,发个请求去问一下设备现在的状态,它会返回一个 JSON,里面包含电量信息。
五、实战小贴士(避坑指南)
关于 WiFi 频段:AC5-10A 只支持 2.4G WiFi。如果你家路由器开了双频合一(即2.4G和5G同名字),记得在配置设备的时候暂时关掉这个功能,或者用手机开个2.4G热点试试,不然配网大概率会失败。
关于负载:虽然它标称 10A / 2200W,但如果接的是 电机、水泵或灯(感性负载或容性负载),启动电流会比较大,降额使用,控制在 300-500W 以内比较稳妥,不然继电器容易粘死。
响应速度:从发命令到设备动作,大概 80-120毫秒。也就是你一按按钮,那边灯几乎是秒亮,基本感觉不到延迟。
如果你要批量控制
device参数支持传多个ID,用逗号隔开就行。比如"device":"id1,id2,id3",一条命令控制一排灯。
总结一下流程
接线:把 AC5-10A 串到电路里,通电。
配网:用友物联的 App 或者 SDK 把它连上你家 WiFi。
写代码
先算签名(MD5大法)。
发 POST 请求,带上
device和order。控制:想定时?调
reset或point。取数据:配置 Webhook 接收推送,或者写个脚本定时调查询接口。
搞定:你的系统就能看着用电量,定时开关灯了。
这套方案对开发者来说上手很快,基本就是调接口的事儿,不需要去折腾底层的嵌入式协议。