CATALOG

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 获取关键凭证

这是整个接入过程最“折腾”但必须做的一步。登录芯步的 开发者控制台,你需要拿到三样东西

  1. AppID:标识你的应用/账户。

  2. AppSecret:你的通信“密码”,绝对不能暴露在前端

  3. Device ID:贴在设备外壳上的那一串数字(例如 "1878"),或者通过控制台查到的设备编号。

3. 接入逻辑:HTTP API 调用

芯步的接口设计遵循 RESTful 风格,本质上是向服务器发送一个 HTTPS 请求,服务器再把指令下发给设备。

3.1 接口地址与签名计算

  • URLhttps://api.thingboot.com/{AppID}/device/control/

  • 方法:POST

  • 动态参数(Query String)

    • ts:当前 Unix 时间戳(秒)。

    • sign:你的请求签名。

签名算法是这个方案的唯一难点,官方定义是 md5(md5(AppSecret) + ts)翻译成人话就是:

  1. 先把你的 AppSecret 取出来,做一次 MD5 加密,得到字符串 A

  2. A 和当前的时间戳 ts 拼接在一起(直接拼,不用加号),得到字符串 B

  3. 再把 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 解决方案(更易理解):

通断器产品方案:
校园公共设备电源管理中:怎样把AC3-10A 计量版电源开关接入到软件项目中
查看 >>
自动化设备交流电源管理:怎么将2200W智能通断器AC1接入到软件项目中
查看 >>
共享场馆照明系统控制:怎样将4400W 线路控制器对接到自己的项目中
查看 >>
仓储设备电源控制:如何将AC4-30A 物联网开关对接到自己的项目中
查看 >>
共享麻将馆灯光插座管理:怎么将DC-10A 电器开关集成到自己的项目中
查看 >>
负载场景方案:
怎么对接8路智能直流控制器来实现低压直流负载通断控制
查看 >>
如何二次开发8 路智能分体远程多回路控制箱以实现单路负载25A/5000W控制
查看 >>
怎样对接60A带计量数显物联网断路器来实现额定功率负载控制
查看 >>
怎么二次开发智能 8 路分体远程信号控制箱来实现单路负载25A/5000W控制
查看 >>
如何接入AC4-10A开关以实现单路交流负载控制
查看 >>
单路用途方案:
怎么在培训教室灯光管理中集成智能硬件来实现单路照明或设备控制
查看 >>
怎么二次开发智能 8 路分体远程信号控制箱来实现单路负载25A/5000W控制
查看 >>
如何二次开发智能墙壁开关1路以实现单路照明或设备控制
查看 >>
如何在小型商铺门禁管理中接入智能硬件以实现单路门禁控制
查看 >>
怎样对接1路墙壁触摸智能开关来实现单路照明控制
查看 >>