CATALOG

仓储环境里,风机、传送带、照明这些设备的电源控制,如果靠人工去拉闸合闸,效率低还容易出错。芯步的 AC4-20A 这类智能通断器,走 HTTP API 控制,对接起来比想象中简单。下面这份方案会从硬件选型、接口调试,到代码落地、项目集成,一步步说清楚。

背景:为什么要用 API 控制仓储电源?

在仓储场景中,我们常常需要对风机、照明灯、传送带,甚至是充电桩进行远程开关或者定时控制。如果每次都让师傅跑过去按按钮,显然不太现实。

芯步的 AC4-20A 物联网关其实就是一个支持 WiFi 联网的“智能继电器”。它最香的地方在于,完全开放了 HTTP API 接口,意味着你可以通过写代码(或者用 Node-RED、Home Assistant 这类平台)直接给它发指令,让它“合闸”或者“拉闸”

第一步:硬件选型与准备

在开始写代码之前,先确认你手里的硬件。针对 20A 电流的场景,通常有以下选择:

  1. 主角:智能通断器 AC4-20A

    • 参数:支持 AC 85-265V 宽电压,20A 额定电流。对于仓储里常见的 4000W 以内的阻性负载(如照明、加热)或者 600W 左右的感性负载(如小型电机、风机)完全够用了

    • 安装:它是 导轨式 安装的,可以直接卡在配电箱的导轨上,不用单独买壳子,很方便

  2. 选配:如果你需要集中控制多路

    • 如果你的项目里不止一个设备,比如要同时控制 8 台传送带,可以考虑 8路智能通用控制器。它通过一个设备提供 8 个通道,每个通道都有独立的 API 接口,集成度更高,而且只需要一个 WiFi 入网

  3. 配网

    • 拿到设备后,需要先给它连上 WiFi(只支持 2.4G)。按照官方手册,用“芯步”小程序或者直接在后台的“物联网控制台”里,把仓库里的 WiFi 账号密码配进去,看到指示灯不闪了就是连上了

第二步:理解接口鉴权机制

芯步的接口不是随便谁都能调的,得带“签名”。不过不用怕,流程很固定。

你需要先在他官方的工作台里找到两个关键东西:AppIDAppSecret(相当于你的专属用户名和密码)

签名生成规则(这是核心,看清楚):签名 sign 的计算公式,其实就是嵌套两次 MD5 加密:

sign = MD5( MD5(AppSecret) + ts )

具体来说:

  1. 把你的 AppSecret 丢进 MD5 加密一次,得到一个 32 位的字符串。

  2. 把上面得到的字符串,再拼接上当前的时间戳 ts(单位是秒)。

  3. 把拼接后的整个字符串再丢进 MD5 加密一次,这就是 sign

第三步:调试接口——从“Hello World”开始

我们先用最通用的 curl 命令来测试一下,看看能不能把手里的灯或设备点亮。假设你的设备 ID 是 device_test_001

1. 获取必要参数

  • AppID123456

  • AppSecretabc123

  • 当前时间戳 ts1715678900 (请替换成你执行时的真实时间戳)

  • 设备 IDdevice_test_001

2. 计算 Sign (假设逻辑演示)

假设 md5(abc123) = 202cb962ac59075b964b07152d234b70拼接时间戳: 202cb962ac59075b964b07152d234b701715678900再次 MD5: 得到最终 sign(比如 e10adc3949ba59abbe56e057f20f883e)。

3. 发起请求

打开你的终端(或者 Postman),输入以下命令。这个操作就是要打开(power 为 1)这个设备:

预期结果:如果返回的 JSON 里包含 "code": 0 或者 "success": true,那么恭喜你,设备已经动作了,你会听到“哒”的一声继电器吸合声

第四步:在 Python 项目中封装 SDK

不可能每次控制都手算 MD5,肯定要写进代码里。下面是一段 Python 代码,可以把它封装成一个工具函数,方便你的主程序调用。