CATALOG

AC4-30A智能控制模块支持HTTP接口远程通断控制,通过实时监测功率并与设定阈值比较,可自动触发断电指令实现超限保护。以下是基于官方开放接口的完整技术方案。

1. 解决概述

1.1 背景

在许多工业及商业场景中(如智慧充电桩、学校限电、老旧电路增容保护等),需要对大功率设备进行监管。AC4-30A支持最大30A电流,在220V环境下阻性负载可达6600W。通过对接其API,可以设定功率阈值,当检测到功率/电流超过安全范围时,远程触发继电器断开,从而保护线路和设备安全。

1.2 技术路径

本方案采用 “后端轮询/监听 + API下发指令” 的闭环控制逻辑:

  1. 数据采集:通过API获取设备的实时功率(或电流)数值。

  2. 逻辑判断:业务系统比较实时数值与设定的阈值(如超过5500W)。

  3. 执行动作:调用控制接口,发送 {"power":"0"} 指令断开电路。

  4. 告警通知:记录日志并推送告警给管理人员。

2. 对接硬件与接口准备

2.1 硬件参数确认

  • 产品型号:UNI-TDQ-AC4-30A

  • 额定参数:Max 30A / 6600W(阻性负载)。若用于电机、LED等感性负载,降额至1100W以下使用

  • 网络要求:设备需连接至2.4G WiFi频段(无需网关)

2.2 接口通用规范

AC4-30A提供标准的HTTP API接口,格式如下

  • 请求方式:POST

  • URL结构https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • HeaderContent-Type: application/x-www-form-urlencoded

  • Body 参数

    • device:设备唯一ID(在芯步控制台获取)。

    • order:JSON字符串,用于控制设备行为。

3. 核心逻辑实现:功率超限保护

要实现“超限保护”,核心包含两个功能:读取实时功率下发断电指令。由于AC4-30A支持计量功能,我们需要结合读取数据的接口。

3.1 第一步:获取实时功率数据

系统需要先知道当前功率是多少。假设你已经通过 设备状态查询接口(通常有GET方法获取设备当前状态)拿到了设备上报的数据。

参考数据格式(根据通用物联网规范推定)通常返回的JSON数据中会包含:

3.2 第二步:逻辑判断与执行(代码示例)

你需要写一段后端脚本(Node.js/Python/Java等)来执行以下逻辑。

业务逻辑(伪代码):

  1. 设置阈值:MAX_POWER = 5500(瓦)。

  2. 获取实时功率:current_power = getDevicePower(device_id)

  3. 如果 current_power > MAX_POWER开关状态 == 开启,则调用断电指令。

调用断电指令的实现:利用官方提供的“线路控制”指令

  • 命令参数order = {"power":"0"} ("0"代表关,"1"代表开)。

示例:cURL 方式

示例:Java 方式利用OkHttp库发送指令

示例:Python 方式

3.3 进阶保护:延迟断开与恢复

有时候瞬时的浪涌功率会导致误判。在实际应用中优化逻辑:

  • 滤波判断:连续3次检测(如每5秒检测一次)均超限,再执行断电,防止误报。

  • 锁定机制:断电后,在未人工排除故障或未重置前,拒绝通过API自动开启(这需要你在业务代码侧加锁,或者利用设备的“按钮动作可屏蔽”特性,防止本地误开启)

  • 先断后通测试:若需要测试线路是否恢复正常,可使用点动模式(先断后通),发送 {"reset":"3000"},让设备断开3秒后自动尝试恢复通电(谨慎使用此功能用于大功率设备)

4. 保护方案优化细节

为了方便实施,参考以下配置表来规划你的保护策略:

策略项推荐配置/方式技术实现/依据
保护阈值额定功率的 90%-95% (约6000W-6200W)留出安全余量,保证设备寿命,AC4-30A最大阻性负载6600W
脱扣延迟3-10 秒通过脚本逻辑 sleepsetTimeout 去读取多次功率值
恢复机制需要人工点击“复位”按钮或接口远程开启必须显式发送控制指令:{"power":"1"}
本地安全禁用设备物理按键调用接口自定义按钮动作为“屏蔽”,防止现场人员误操作恢复供电

5. 常见问题与排障

  1. 为什么检测到超限了,却控制失败?

    • 检查 sign 签名是否过期(与 ts 时间戳有关)

    • 确认设备ID是否准确,以及设备网络是否在线(设备指示灯应常亮,慢闪表示离线)

  2. 感性负载(如电机)经常误报超限怎么办?

    • 感性负载启动瞬间电流远大于额定电流。在代码逻辑里增加“屏蔽启动浪涌”功能:即在设备开启后的前2-3秒不进行阈值判断,或者适当提高瞬时报警阈值。

  3. 如果想做“弹性伸缩”或“负载均衡”怎么办?

    • 芯步接口支持在 device 参数中传入多个设备ID(用逗号分隔)。可以设计策略:总功率超限时,优先断开次要负载,保留核心负载,实现动态调节。

通过以上方案,你可以利用 AC4-30A 的开放 HTTP 接口,快速构建一套高效、可靠的功率超限自动保护系统。