CATALOG

一、为什么选AC1?说说这玩意儿能干啥

AC1这货说白了就是一个“能上网的开关”,最大支持2200W功率(10A),家用电器基本都能带得动——热水器、电饭煲、鱼缸水泵、工厂小电机,统统没问题。

它的核心卖点就一个:给任何支持HTTP的东西发个请求,就能远程断闸合闸。不管你的项目是Web网页、手机APP、小程序还是桌面软件,只要会发HTTP请求,就能把这玩意儿集成进去

二、接入前准备——先把你家“钥匙”领了

在写代码之前,需要先去芯步的后台领几样东西:

  1. 注册个账号,登录芯步控制台

  2. 创建一个“工作台”(相当于你的项目空间)

  3. 在开发设置里找到两个关键信息:AppIDAppSecret——这俩相当于你家大门的“用户名”和“密码”

  4. 给AC1通上电,用小程序的“批量配网”功能把它连上WiFi(2.4G频段,5G不行)

  5. 在控制台找到你这个设备的Device ID,一串数字,记下来

东西备齐了,下面开始干活。

三、核心步骤:用代码控制AC1通断

3.1 签名怎么算?这里有点儿绕

芯步的接口为了安全,调用的时候要带一个签名(sign)。签名的算法稍微绕了一点,但照着做就行:

公式sign = MD5( MD5(AppSecret) + 当前时间戳 )

用人话说就是:

  1. 先把你的AppSecret做一次MD5加密,得到一串32位字符串

  2. 把这串字符串和当前的时间戳(秒数)拼在一起

  3. 再把拼好的字符串做一次MD5

碎碎念:时间戳是秒数,不是毫秒!别搞错了。另外时间戳前后误差不能太大,服务器那边会校验的。

3.2 发个请求控制设备

签名算好了,就可以发POST请求了。

请求地址

请求体(JSON格式)

{"power": 1}表示“接通”,{"power": 0}表示“断开”

3.3 来个完整的代码示例(Python版)

如果返回{"code": 200},恭喜,设备应该已经动作了

3.4 Java版本也来一个

3.5 前端JavaScript(浏览器/Node)

四、进阶技巧:让AC1更“智能”

光会开关还不过瘾,AC1还支持几个高级玩法:

4.1 定时动作(自动复位)

想实现“打开5分钟后自动关闭”?不用你自己写定时任务,AC1自己就能干:

这行命令的意思是:先断开,300000毫秒(5分钟)后自动接通

反过来,“先接通再延时断开”用point

实用场景:临时开一下排气扇、定时给鱼缸供氧、远程重启路由器——完美。

4.2 批量控制

要同时控制多个AC1?device参数支持逗号分隔:

4.3 实时获取设备状态

设备状态发生变化(比如有人按了AC1上的物理按钮,或者定时触发了),芯步会主动推送消息到你配置的URL地址。这个需要你在控制台设置一个“消息接收URL”,然后你的服务器就能收到实时回调,相当于设备状态实时同步。

五、实战案例一:接入Home Assistant

想把AC1搞进Home Assistant?HA里加个“RESTful Switch”就行。

configuration.yaml

不过签名那块儿比较麻烦,写个简单的代理服务放在本地,HA调本地接口,本地服务负责算签名。或者直接用Node-RED,里面写function节点计算签名。

六、实战案例二:集成到内部管理系统

假设你们公司有个内部管理后台,需要在界面上加个“远程重启服务器”的按钮。思路很简单:

  1. 后端:写个简单的API,比如POST /api/ac1/on,里面封装上面说的签名和请求逻辑

  2. 前端:按钮点击时调这个API

  3. 状态同步:配置消息回调URL,设备状态变化时推送到你们后端,然后WebSocket推给前端

这样用户点一下按钮,服务器就重启了——不用跑机房。

后端接口示例(Node.js/Express)

七、踩坑提醒

  1. WiFi频段:AC1只认2.4G WiFi,5G不行。企业级网络如果开了5G和2.4G双频合一,有时候会连不上,单独开个2.4G的SSID

  2. 签名时效:时间戳误差太大会验签失败,确保服务器时间和北京时间差不超过几分钟

  3. 响应时间:官方说80-120ms,实际从发请求到设备动作大概0.5-1秒,够用

  4. 功率别超:2200W是上限,感性负载(电机类)最好打个折,别满功率跑

八、总结

AC1这玩意儿接入软件项目,技术上说白了就是一个HTTP请求的事,核心难点在于那个嵌套MD5签名。搞定签名,剩下的就是:

  • 发POST → 设备动作

  • 收回调 → 状态同步

  • point/reset → 定时任务

无论是做智能家居中枢、设备运维系统,还是临时写个脚本远程关热水器,这套方案都能cover。整个接入流程算下来,熟悉的话半小时搞定——芯步官方也说“十分钟完成对接”,稍微夸张了点,但也差不太多。