怎么二次开发20A 智能开关来实现漏电保护控制_解决方案

CATALOG

基于芯步20A智能开关的硬件特性和开放HTTP API接口，结合漏电保护的技术原理，这里整理了一份二次开发解决方案。

怎么二次开发20A智能开关来实现漏电保护控制

一、这个方案的思路是什么？

说白了，咱们就是想给普通的智能开关加一个“安全卫士”的功能。芯步的这个20A智能开关本身是不带漏电检测的，它只能听你的话开灯关灯。那我们就在外面给它加一个漏电检测模块，让模块去“感知”危险，然后通过HTTP接口命令开关立刻断电。

核心逻辑就是：

漏电监测模块（外挂）实时检测 → 发现漏电（比如≥30mA）→ 触发脚本/程序 → 调用芯步HTTP接口 → 20A智能开关立即关闭 → 避免触电事故

这里面不涉及改开关里面的电路，就是纯软件层面的“联动”。所有的二次开发，都是基于芯步开放的HTTP API接口来做的。这个开关支持局域网控制，所以速度非常快，能做到毫秒级响应，完全满足漏电保护的速度要求。

二、需要准备什么东西？

硬件方面：

芯步20A智能开关：这个是大功率的，咱们就接在总回路或者大功率电器（比如热水器、空调）的前端。
漏电检测模块/电流互感器（互感线圈，Zero Sequence Current Transformer）：市面上有现成的，比如那种精度高的漏电保护器模块，或者零序电流互感器。它能感应到火线和零线流出去的电流有没有“跑冒滴漏”。
一个“大脑”：树莓派（Raspberry Pi）、旧的电脑、NAS（网络附加存储），甚至是能跑脚本的路由器。只要能联网、能发HTTP请求（HTTP POST Request）就行。

软件方面：

Python或者Node-RED（一个可视化编程工具）：写个简单的脚本，用来读取传感器的数据，然后发命令。

三、具体怎么“接”和“调”？

咱们分三步走：采集（听声音）、决策（判断危险）、执行（拉电闸）。

第一步：让“大脑”能感知漏电

你得把漏电检测模块连接到你的“大脑”（比如树莓派的GPIO（通用输入输出）引脚或者串口）。一般来说，漏电模块检测到问题后，会输出一个高/低电平信号，或者通过串口发送一串数据（比如漏电电流值30mA）。

如果是数字量（DO，数字输出）：设置一个阈值。一旦模块拉高了电平，就说明“漏电了！”
如果是模拟量（AO，模拟输出）：你需要通过ADC（模数转换）芯片读取具体数值。这里有个关键点：国标规定，一般漏电保护的动作电流是 30mA（人体安全电流阈值）。当读数大于等于30mA时，就必须动作。

第二步：写一段“翻译官”代码

既然要芯步的开关听话，咱们得按它的规矩来。芯步的接口非常友好，是标准的HTTP POST JSON格式。

如果你用Python写，核心代码大概长这样（伪代码）：

import requests
import time
import RPi.GPIO as GPIO  # 假设用树莓派读取漏电信号

# 1. 配置芯步开关的参数 (这部分可以去官网控制台获取)
TB_API_URL = "http://192.168.1.xxx/control"  # 替换成你家里开关的局域网IP [citation:3]
# 如果你是在外网控制，需要用云API地址，但在局域网为了速度，直接控制IP最快！
# 云API地址示例: https://api.thingboot.com/{AppId}/device/control/?sign=xxx&ts=xxx [citation:4]

# 假设漏电检测模块接在GPIO 17号口，高电平表示漏电
LEAK_DETECT_PIN = 17

def setup():
    GPIO.setmode(GPIO.BCM)
    GPIO.setup(LEAK_DETECT_PIN, GPIO.IN)

def turn_off_switch():
    """给芯步开关下发关闭指令"""
    # 这个是局域网直连的指令格式，响应最快 [citation:3]
    payload = {"power": 0}  # 0是关，1是开
    # 如果开关是多路的，可能是 {"power1":0}
    try:
        # 注意:如果设置过密码可能需要加sign验证，这里先忽略复杂情况
        response = requests.post(TB_API_URL, json=payload, timeout=1)
        if response.status_code == 200:
            print("断电指令发送成功，开关已跳闸！")
        else:
            print("指令发送失败，请检查网络")
    except Exception as e:
        print(f"报错啦:{e}")

# 主循环:一直在那盯着
if __name__ == "__main__":
    setup()
    print("漏电保护系统已启动，正在监控...")
    while True:
        if GPIO.input(LEAK_DETECT_PIN):
            print("警告:检测到漏电电流！立即执行断电！")
            turn_off_switch()
            # 断电后，可能需要人工复位，这里可以加个死循环或者发通知
            break
        time.sleep(0.05)  # 50毫秒扫描一次，响应够快了

关于接口的特别提示：芯步的设备支持两种控制模式：

云控模式：不管你在不在家，只要有网就能发指令。但绕一圈云端大概需要80-120毫秒。
局域网直连模式强烈推荐用这个做漏电保护！ 直接在局域网内POST设备的IP地址（例如http://192.168.1.100/control），延迟极低，不受外网断网影响，这才是安全设备的正确姿势。

第三步：实现“自锁”与“复位”

漏电保护有个行业规矩：一旦跳闸，不能自动复位。也就是说，如果你不在家，漏电跳了，程序不能自动又把电合上，否则人正在修插座突然来电会出事的。

所以代码逻辑里要加上：

一旦执行了turn_off_switch，立刻退出监控循环，或者忽略后续的“合闸”指令。
需要人为去按一下开关的物理按键，或者通过APP手动点一下“开”，并且确保此时漏电故障已经排除。

四、高级一点的玩法

如果你觉得上面用GPIO电平的方式太Low（而且自己焊电路板也麻烦），你可以直接买一个带RS485通讯（一种工业通讯接口）或WiFi通讯的漏电保护器。这种设备本身就是个物联网设备，它自己就会发MQTT（一种物联网通讯协议）消息。这时候，你只需要在Home Assistant（开源智能家居平台）或者Node-RED里写一条流规则：

规则触发条件：漏电传感器数值 > 30mA规则执行动作：调用芯步HTTP服务，命令：{"power":0}

这样连代码都不用怎么写，拖拖拽拽就搞定了。

五、总结一下注意事项

速度就是生命：漏电保护要求动作时间快，虽然芯步的接口很快，但你的检测逻辑尽量用中断，别用那种好几秒才扫一次的循环。
控制好功率：你用的是20A的开关，理论上支持4000W（220V*20A）。如果接大功率空调或者总闸，一定要确认负载不超过额定值，否则开关容易烧，发热也容易误触发。
强调一下安全：再次强调，漏电检测部分涉及强电（220V交流电），如果你不是专业电工，千万不要自己打开开关盒子接线。你只做软件二次开发就好，硬件接线必须让持证电工来操作。我们做二次开发的，只负责让“大脑”去呼叫那个HTTP地址。
API鉴权：上面代码为了简洁省掉了sign（签名）计算。在实际局域网环境中如果没设密码可以直接发；如果设了密码，记得算一下md5（一种加密算法）拼进去。

这样一通操作下来，你就把一个普通的远程开关，变成了一个带智能漏电保护的安防设备了！