如何二次开发AC4-10A通断器来实现过压欠压保护控制_解决方案

CATALOG

AC4-10A通断器本身不具备电压检测能力，因此二次开发实现过欠压保护的核心思路是：用外置传感器采集电压 → 云端/本地逻辑判断 → API下发指令切断设备。以下方案详细拆解这一实现路径。

一、核心挑战与解决方案思路

要基于AC4-10A实现过欠压保护，首先要明确硬件的物理限制：

硬件特性：AC4-10A 是一款智能通断器，主要功能是“通”和“断”，它本身不具备电压检测传感器。它的强项在于通过 HTTP 接口接受远程指令进行开关动作。
解决路径：既然设备无法测电压，就需要“外接大脑和感官”。即：电压检测传感器 → 逻辑判断单元（MCU/云服务器） → 调用API → AC4-10A执行断电。

二、硬件选型与连接

要实现此方案，需要在原电路（AC4-10A + 负载）的基础上，增加一个电压检测模块。

主控/逻辑单元：使用 ESP32 或 ESP8266 开发板。原因：AC4-10A 本身走 WiFi 协议，使用同生态的芯片作为“协处理器”，在局域网通信时延迟极低，无需经过云端。
电压检测模块ZMPT101B（交流电压互感器模块）。这是最成熟的方案，输出0-5V模拟信号，可直接接入 ESP32 的 ADC 引脚。
连接拓扑
- 强电侧：220V 输入并联接入 ZMPT101B（用于采样）；220V 输入串联接入 AC4-10A 的输入端，负载接输出端。
- 弱电侧：ZMPT101B 信号端接 ESP32；ESP32 通过 WiFi 与 AC4-10A 处于同一局域网内，直接调用其 HTTP API。

三、软件开发流程（二次开发核心）

此部分是方案的关键，围绕着 AC4-10A 的 HTTP 接口 进行开发。

1. 接口准备与鉴权

AC4-10A 的接口遵循简单的签名机制。你需要先注册/登录芯步平台，在控制台获取 AppID 和 AppKey。

控制指令POST https://api.yoyoiot.com/ordercontrol
关键参数device_id（你的AC4-10A设备ID）；switch（on 或 off）。
签名计算：根据文档，通常涉及 sign = md5(AppID + ts + AppKey + ...)。你需要写一个函数生成动态签名，这是防止接口被恶意调用的基础。

2. 主控程序逻辑（伪代码实现）

在 ESP32 或你的云服务器上，编写如下逻辑循环：

# 以 MicroPython 为例，运行在 ESP32 上

import time
from machine import ADC, Pin
import urequests
import hashlib

# 1. 配置参数
VOLTAGE_PIN = 35          # 电压传感器引脚
MAX_VOLTAGE = 245         # 过压阈值 (V)
MIN_VOLTAGE = 185         # 欠压阈值 (V)
DEVICE_ID = "你的AC4-10A的ID"
API_URL = "http://api.yoyoiot.com/ordercontrol"
APP_ID = "你的AppID"
APP_KEY = "你的AppKey"

# 2. 控制AC4-10A的函数
def control_switch(action):
    ts = int(time.time())
    # 构造待签名字符串 (根据官方文档调整格式)
    raw_str = f"{APP_ID}{ts}{APP_KEY}"
    sign = hashlib.md5(raw_str.encode()).hexdigest()
    
    payload = {
        "device_id": DEVICE_ID,
        "switch": action,  # "off" 或 "on"
        "ts": ts,
        "sign": sign,
        "app_id": APP_ID
    }
    try:
        response = urequests.post(API_URL, json=payload)
        print(f"Send {action} command result: {response.status_code}")
    except Exception as e:
        print("API call failed:", e)

# 3. 主循环:电压监测与保护
def read_voltage():
    # 这里需要校准算法，将 ADC 读取的原始值(0-4095)转换为实际电压值
    raw = ADC(Pin(VOLTAGE_PIN)).read()
    # 假设校准系数为 0.1 (具体需根据 ZMPT101B 校准)
    return raw * 0.1

while True:
    current_voltage = read_voltage()
    print(f"Current Voltage: {current_voltage}V")
    
    # 过压或欠压判断
    if current_voltage > MAX_VOLTAGE or current_voltage < MIN_VOLTAGE:
        print("Voltage anomaly detected! Cutting off power.")
        control_switch("off")
        # 触发保护后，延时一段时间再检测，避免频繁重启
        time.sleep(60) 
    else:
        # 电压正常，如果之前是断开状态，可以在这里加入自动合闸逻辑
        # control_switch("on") 
        time.sleep(5)  # 每5秒检测一次

四、高级保护策略优化

仅仅“检测即断电”可能不够人性化，你可以利用 AC4-10A 的接口特点进行优化：

延迟保护电网有时会有瞬时波动（几毫秒），AC4-10A 不应立即跳闸。在代码中增加滤波逻辑：连续监测到 3 次（如 15 秒内）电压超标，才执行断电。这能大幅减少不必要的断电次数，保护冰箱压缩机等设备。
自动重合闸（ARD）欠压通常是暂时性的（如大功率电机启动）。可以在代码中增加逻辑：
- 欠压断电后，等待 30 秒。
- 再次读取电压，如果恢复正常，调用 control_switch("on") 自动恢复供电。
- 如果重合闸后 1 分钟内再次欠压，则永久闭锁，等待人工干预（防止线路持续故障）。
日志与告警由于 AC4-10A 本身不计数据，你可以将 ESP32 采集的电压数据上报到另一个云端（如阿里云 IoT、ThingsBoard 或 HomeAssistant），生成电压曲线图。一旦触发保护，通过 Serverless 函数自动给手机推送通知（如 Bark/Server 酱）。

五、私有化部署与低代码方案

如果你不想维护复杂的后端代码，可以利用 AC4-10A 支持的私有化部署特性：

Webhook 联动：如果你的电压检测设备（如带有电压检测功能的可编程逻辑控制器）支持 HTTP 请求，可以直接配置 Webhook。当电压超标时，让第三方设备直接访问 AC4-10A 局域网内的 API。
Node-RED：这是一个低代码编程工具。你可以用 Node-RED 建立一个流程：
- Inject节点（定时触发） -> HTTP Request节点（读电压传感器数据） -> Function节点（判断 >245V？） -> HTTP Request节点（控制 AC4-10A 关断）。
- 这种方案无需编写复杂的 Python 循环，拖拽配置即可完成。

六、总结

组件	选型/配置	作用
执行器	芯步 AC4-10A	接受指令，切断/接通电源
传感器	ZMPT101B 模块	采集 220V 交流电实时数值
控制器	ESP32 开发板	运行逻辑判断，调用 AC4-10A 接口
核心代码	Python/Arduino	实现滤波算法、阈值判断、接口鉴权
扩展功能	局域网 API 调用	实现自动重合闸，无需经过外网，可靠性高

通过这种“分离式”设计，AC4-10A 从一个简单的遥控开关升级为了具备智能判断能力的保护器，且完全利用了其开放接口和私有化部署的优势，响应速度可达毫秒级（网络良好的情况下）。