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格式)
| 字段 | 类型 | 说明 |
|---|---|---|
| device | String/Int | 设备唯一ID(可在控制台查看) |
| order | Object | 控制指令(见下表) |
4. 延时通断控制指令集
为了实现精准的延时控制,开发者需关注 order 参数中的 point 和 reset 指令,而非简单的 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)构造如下逻辑:
准备参数:获取当前的Unix时间戳
ts。计算签名
第一步:
step1 = md5(AppSecret)第二步:
sign = md5(step1 + ts)
发起POST请求:携带JSON数据
{"device":"你的设备ID", "order":{"point":"3000"}}。
步骤 2:设备端逻辑处理
设备在收到 {"point":"3000"} 命令后,其内部MCU会执行以下逻辑:
立即闭合继电器(OUT端通电)。
启动内部定时器,计时3000毫秒。
计时结束,断开继电器。
上报当前状态至云端。
此过程完全在设备本地完成,即使在这3秒内WiFi断开,延时断开动作依然会执行,这是该方案高可靠性的核心。
6. 高级配置:固化按钮行为
如果需要实现物理按钮按下时的延时功能,可以在芯步控制台进行产品配置,无需编写代码:
进入设备配置项。
设置 按钮行为 (action1) 为
point(先通后断)或reset(先断后通)。设置 按钮延时 (time1) 为所需时长(如3000)。配置保存后,用户每次物理按下设备按钮,都将自动执行延时通断逻辑。
7. 总结和需要注意的点
通过芯步AC4-30A的开放接口实现延时通断控制,具有低延迟、高可靠、跨平台三大特点。开发者无需处理复杂的定时器线程,只需调用标准HTTP API即可将强大的时序控制能力集成到现有的系统中。
重要注意事项:
负载限制:虽然额定电流为30A,但若用于LED或电机等感性负载,功率需降至1100W以下。
私有化部署:若对数据安全要求比较高,AC4-30A支持私有化部署(局域网直连),API调用地址可更换为局域网服务器地址。
Flash 寿命:频繁修改配置项会擦写Flash,在应用层控制延时,而非频繁修改设备配置。