CATALOG

AC4-30A 物联网开关的开放接口支持三种控制模式:直接通断(power)、先通后断(point)和先断后通(reset)。实现延时控制的核心在于利用后两种模式,它们将延时逻辑固化在设备端,即使网络中断也能可靠执行。以下是具体实现方案。

1. 产品与技术背景

芯步智能通断器AC4-30A是一款支持WiFi直连的大功率继电器控制模块(最大30A/6600W),广泛应用于工业控制、智能家居、农业灌溉等领域。其核心优势在于开放了标准的HTTP API接口,允许开发者通过任何支持HTTP协议的编程语言(如Python、Java、PHP、Node.js等)进行二次开发,实现远程控制和状态监测

2. 延时通断控制的核心机制

在工业自动化和智能控制场景中,“延时通断”通常包含两种逻辑:

  • 先通后断:继电器立即闭合(通电),维持一段时间后自动断开。

  • 先断后通:继电器立即断开(断电),维持一段时间后自动闭合。

AC4-30A的固件原生支持这两种指令,无需在应用层通过定时任务轮询下发命令,从而避免了因网络延迟或中断导致的控制不精确问题

3. API接口详解与签名认证

调用API需要先完成身份认证。芯步采用动态签名方式,具体参数如下:

3.1 请求地址

http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

3.2 认证参数构造

  • AppId:平台生成的唯一应用标识。

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

  • sign:签名值,计算逻辑为 md5(md5(AppSecret) + ts)

3.3 请求体结构(JSON格式)

字段类型说明
deviceString/Int设备唯一ID(可在控制台查看)
orderObject控制指令(见下表)

4. 延时通断控制指令集

为了实现精准的延时控制,开发者需关注 order 参数中的 pointreset 指令,而非简单的 power 开关

指令类型JSON 示例功能描述适用场景
瞬时通断{"power": 1}立即开启设备基础控制
{"power": 0}立即关闭设备基础控制
先通后断{"point": "5000"}立即开启,持续5秒后自动关闭喷淋系统、门禁电插锁、信号触发
先断后通{"reset": "10000"}立即关闭,持续10秒后自动重启路由器/网关重启、设备故障复位

注意:时间单位均为毫秒(ms)。根据产品手册,预置支持1秒(1000)、2秒(2000)、3秒(3000)、5秒(5000)。虽然理论上支持自定义数值,但在控制台配置中设定,以确保设备Flash正确保存

5. 具体实现方案(代码逻辑示例)

以下是实现“按下按钮后,插座通电3秒自动断电”的核心逻辑伪代码。由于搜索结果中未提供特定语言的完整SDK,此处以通用的Shell/PHP逻辑演示流程,开发者可轻松移植

步骤 1:生成签名并发起请求

你需要根据你使用的编程语言(如Python、Java、Go或PHP)构造如下逻辑:

  1. 准备参数:获取当前的Unix时间戳 ts

  2. 计算签名

    • 第一步:step1 = md5(AppSecret)

    • 第二步:sign = md5(step1 + ts)

  3. 发起POST请求:携带JSON数据 {"device":"你的设备ID", "order":{"point":"3000"}}

步骤 2:设备端逻辑处理

设备在收到 {"point":"3000"} 命令后,其内部MCU会执行以下逻辑:

  1. 立即闭合继电器(OUT端通电)。

  2. 启动内部定时器,计时3000毫秒。

  3. 计时结束,断开继电器。

  4. 上报当前状态至云端。

此过程完全在设备本地完成,即使在这3秒内WiFi断开,延时断开动作依然会执行,这是该方案高可靠性的核心

6. 高级配置:固化按钮行为

如果需要实现物理按钮按下时的延时功能,可以在芯步控制台进行产品配置,无需编写代码:

  1. 进入设备配置项。

  2. 设置 按钮行为 (action1)point(先通后断)或 reset(先断后通)。

  3. 设置 按钮延时 (time1) 为所需时长(如3000)。配置保存后,用户每次物理按下设备按钮,都将自动执行延时通断逻辑

7. 总结和需要注意的点

通过芯步AC4-30A的开放接口实现延时通断控制,具有低延迟高可靠跨平台三大特点。开发者无需处理复杂的定时器线程,只需调用标准HTTP API即可将强大的时序控制能力集成到现有的系统中。

重要注意事项:

  1. 负载限制:虽然额定电流为30A,但若用于LED或电机等感性负载,功率需降至1100W以下

  2. 私有化部署:若对数据安全要求比较高,AC4-30A支持私有化部署(局域网直连),API调用地址可更换为局域网服务器地址

  3. Flash 寿命:频繁修改配置项会擦写Flash,在应用层控制延时,而非频繁修改设备配置