如何二次开发AC4-10A物联网开关以实现漏电保护控制_解决方案

CATALOG

AC4-10A是一款支持HTTP接口控制的智能通断器，原本设计用于远程通断控制。通过合理的二次开发，可以为其扩展漏电保护功能——关键在于接入漏电检测传感器，并开发一套逻辑判断与控制程序。以下是具体实现方案。

一、背景与目标

芯步 AC4-10A 智能通断器是一款额定电流 10A、支持 WiFi（2.4G）连接的智能开关设备。其核心优势在于开放了完整的 HTTP API 接口，支持远程控制、定时任务以及状态查询，非常适合集成到第三方系统中。

目标：在不拆解设备硬件（或仅进行简单传感器串联）的前提下，利用 AC4-10A 的接口能力，通过软件逻辑实现类似“漏电保护器”的功能。当检测到漏电（剩余电流）异常时，自动触发 AC4-10A 断开电源，并通过 API 上报告警。

二、设计

本方案不改变 AC4-10A 原有通断功能，而是在其外部串联“漏电检测传感器”，并通过一个中间服务（二次开发的服务端）进行逻辑判断。

感知层：AC4-10A 开关 + 外接漏电检测模块（如剩余电流互感器，需配合检测电路输出高低电平或 RS485 数据）。
传输层：AC4-10A 的 WiFi 网络及 HTTP 协议。
控制逻辑层（二次开发核心）：运行在云服务器或局域网本地的 Python/Node.js/Java 服务。
执行层：调用 AC4-10A 的 HTTP 接口进行“断开”动作。

数据流向漏电传感器（检测到漏电） -> 单片机/采集器 -> 调用芯步 API（关闭开关） -> AC4-10A 断电 -> 调用回调接口通知用户。

三、技术准备

根据官方文档，AC4-10A 提供了标准的 HTTP 接口，这是二次开发的基础。

1. 接口能力分析

控制接口：用于下发开关指令。
状态查询接口：获取当前继电器通断状态。
身份认证机制：接口调用需携带 AppID、sign（签名）和 ts（时间戳）参数，防止非法篡改。

2. 漏电检测输入方案

由于 AC4-10A 本身无漏电检测针脚，二次开发需解决 “如何让系统知道漏电了” 的问题，推荐以下两种方案：

方案 A（IO 电平方案）：购买带有“漏电保护器专用脱扣器”或“电平输出”的漏电检测模块。该模块在漏电时输出高/低电平，通过一个物联网采集板（如 ESP32）读取，再由采集板转发 HTTP 指令给 AC4-10A。
方案 B（Modbus 方案）：使用智能漏电监控模块（如 DDSU666 等带有 RS485 接口的电表），服务端定时轮询读取漏电电流值，当 >30mA 时触发断开。

四、二次开发详细步骤

本方案假设采用 方案 B（服务端轮询 + API 控制） ，因为这是纯软件二次开发的典型场景，无需焊接电路。

步骤 1：环境搭建与凭证获取

注册芯步官方平台账号。
在控制台创建应用，获取 AppID 和 API Key（用于生成签名）。
将 AC4-10A 设备配网并绑定到该账号下，获取唯一的 Device ID。

步骤 2：开发控制核心模块

编写服务端代码（以 Python 为例），封装芯步的 API 签名逻辑。签名算法通常为：sign = md5(AppID + API Key + ts)。

需要实现的函数接口

control_device(device_id, switch)：向 AC4-10A 下发开启或关闭指令。
get_device_status(device_id)：读取当前开关状态，用于故障复位判断。

步骤 3：集成漏电检测逻辑（核心算法）

这是实现“漏电保护”的关键代码逻辑。

数据采集：连接漏电检测仪的串口或 Modbus 协议，读取实时漏电电流 leakage_current。
阈值判断（保护逻辑）
- 设定安全阈值（例如：剩余电流 > 30mA）。
- 为了防止信号抖动误判，加入 去抖动逻辑：连续 3 次采样（间隔 200ms）均超过阈值，才认定为漏电事件。
执行动作
- 触发 control_device(device_id, "OFF")。
- 记录日志：记录漏电值、动作时间、设备 ID。
- 防重合闸逻辑：漏电保护跳闸后，普通漏保需要手动复位。在软件中应设计：跳闸后锁定该设备，拒绝自动重合闸，必须由管理员或现场人工按下物理复位按钮（或通过二次开发的“复位”按钮调用 ON 指令，并先检测当前是否仍有漏电）。

步骤 4：异常处理与安全保障

断网续传：考虑到 AC4-10A 可能离线，二次开发服务应具备本地缓存（Redis），记录最近一条指令状态。当设备重连后，延迟下发“断开”指令确保安全。
心跳巡检：每隔 5 分钟调用状态查询接口，若发现开关状态与预期不符（如硬件被人为强行打开），重新执行关闭动作。
接口鉴权：确保所有的控制请求都在后端服务发起，前端只读，防止漏电保护接口被恶意调用导致无法断电。

五、核心代码逻辑示意（伪代码/Python思路）

以下代码展示了核心的监控进程逻辑：

# 引入 requests 库用于 HTTP 调用
import requests
import time

# 配置参数
APP_ID = "YOUR_APP_ID"
DEVICE_ID = "YOUR_AC4_10A_ID"
LEAKAGE_THRESHOLD = 30 # 漏电阈值:30mA

# 芯步 API 地址 (参考官方文档)
API_URL = "https://api.yoyoiot.com/ordercontrol"

def check_leakage():
    """模拟读取 Modbus 漏电传感器的数值"""
    # 实际开发中这里会是读取串口/485的代码
    current_leakage = read_from_sensor()
    return current_leakage

def send_command_to_ac4_10a(action):
    """向 AC4-10A 下发指令"""
    # 1. 生成签名 (ts, sign)
    ts = int(time.time())
    sign = generate_md5(APP_ID + API_KEY + str(ts))
    
    # 2. 构建请求体
    payload = {
        "appId": APP_ID,
        "deviceId": DEVICE_ID,
        "switch": action, # "on" 或 "off"
        "ts": ts,
        "sign": sign
    }
    
    # 3. 发送请求
    response = requests.post(API_URL, json=payload)
    return response.json()

def main_loop():
    leak_detected_count = 0
    while True:
        try:
            # 1. 获取实时漏电值
            l_val = check_leakage()
            
            # 2. 漏电保护逻辑 (防抖)
            if l_val > LEAKAGE_THRESHOLD:
                leak_detected_count += 1
            else:
                leak_detected_count = 0
            
            # 3. 确认漏电 (连续3次超过阈值)
            if leak_detected_count >= 3:
                print(f"危险！检测到漏电电流 {l_val}mA，正在执行断电...")
                
                # 调用芯步接口断电
                result = send_command_to_ac4_10a("off")
                
                if result["code"] == 200:
                    print("断电成功，请检查线路并手动复位。")
                    # 发送告警邮件/钉钉
                    send_alert("漏电保护已触发")
                
                # 触发保护后暂停循环，防止自动恢复（需人工介入）
                break 
            
            time.sleep(0.5) # 采样间隔
        
        except Exception as e:
            print(f"系统异常: {e}")
            time.sleep(5)

if __name__ == "__main__":
    main_loop()

六、数据可视化与告警

为了达到完整的解决方案，结合芯步支持的“自定义联动操作”或二次开发 Web 界面

仪表盘：展示实时漏电电流曲线、开关动作记录。
告警推送
- 当触发漏电保护时，通过企业微信、钉钉或邮件推送告警。
- 告警内容：“AC4-10A 开关已因漏电跳闸，请检查绝缘情况。”

七、总结

通过上述二次开发方案，普通的 AC4-10A 智能通断器可以被升级为一个具备漏电保护能力的智能断路器。该方案的核心价值在于：

复用性强：不浪费现有物联网设备资源。
逻辑灵活：相比传统机械式漏保，可以通过软件调整漏电阈值（30mA 或 15mA），适应不同场景需求。
远程可控：跳闸后无需亲赴现场，可通过远程复位（需先确认漏电隐患已排除）。

注意事项：本方案提供的软件逻辑保护不能完全替代物理漏电保护器（RCD）的机械脱扣安全标准。在高安全等级场景（如住宅总进线），请请一定要保留机械式漏电保护开关，AC4-10A 的二次开发可作为远程监控与后备切断的补充手段。