AC4-30A 这款开关的核心优势是开放了标准的 HTTP API,这意味着你可以用任何编程语言(Python、PHP、Java、Go 等)通过简单的网络请求来控制它。下面这份方案会从拿到设备到跑通代码,一步步拆解给你看。
1. 概述
AC4-30A 是一款支持 WiFi 联网的大功率智能通断器(额定电流30A,阻性负载可达6600W)。它最核心的亮点是开放了 HTTP API 接口,这意味着你可以绕过复杂的第三方公有云(尽管它也支持),直接将设备集成到你自己的系统里,实现数据本地化或私有化部署。
这篇方案主要面向开发者或系统集成商,指导你如何通过接口实现“开/关”这个最核心的动作。
2. 准备工作:硬件与参数
在敲代码之前,硬件层面的准备工作不能马虎,这不只是通电,还涉及到安全和配网。
2.1 硬件接线
AC4-30A 属于“火线进,火线出”的智能开关(通常适用于断火线控制)。
输入端(L IN):接市电的火线。
输出端(L OUT):接负载(灯、电机、插座)的火线。
零线(N)设备需要零线供电。AC4-30A 内部需要零线构成回路给 WiFi 模块供电,所以零线需要直通负载。
口语化提醒:千万别把 30A 的设备拿来接灯泡这种小电流就完事了,要看看你的电线是不是够粗。6600W 的功率配 2.5 平方及以上的铜线,不然容易发热。
2.2 设备入网(配网)
设备通电后,你会搜到一个名为 "TB-XXX" 的 AP 热点。需要用“芯步”的官方 App 或者通过他们提供的 "Esptouch"(一键配网)协议让设备连上家里的 2.4G WiFi。
注意:AC4-30A 不支持 5G WiFi,确保你的路由器开启了 2.4G 频段。
2.3 获取关键凭证
这是整个接入过程最“折腾”但必须做的一步。登录芯步的 开发者控制台,你需要拿到三样东西
AppID:标识你的应用/账户。
AppSecret:你的通信“密码”,绝对不能暴露在前端。
Device ID:贴在设备外壳上的那一串数字(例如 "1878"),或者通过控制台查到的设备编号。
3. 接入逻辑:HTTP API 调用
芯步的接口设计遵循 RESTful 风格,本质上是向服务器发送一个 HTTPS 请求,服务器再把指令下发给设备。
3.1 接口地址与签名计算
URL
https://api.thingboot.com/{AppID}/device/control/方法:POST
动态参数(Query String)
ts:当前 Unix 时间戳(秒)。sign:你的请求签名。
签名算法是这个方案的唯一难点,官方定义是 md5(md5(AppSecret) + ts)。翻译成人话就是:
先把你的
AppSecret取出来,做一次 MD5 加密,得到字符串A。把
A和当前的时间戳ts拼接在一起(直接拼,不用加号),得到字符串B。再把
B做一次 MD5 加密,得到的结果就是sign。
示例流程(伪代码) :
3.2 请求体(Body)
虽然 URL 需要带签名,但核心指令是放在 POST Body 里的 JSON 格式
4. 实战演练:单路负载控制代码示例
我们直接上代码,这里用最常见的 cURL(命令行)和 Python 来演示如何控制路灯或电机。
4.1 第一种场景:开启/关闭开关
针对 AC4-30A,它通常是单路控制,所以 power1 代表第一路。
开启
{"power1": 1}关闭
{"power1": 0}
Bash (cURL) 解决方案
Python 解决方案(更易理解):