怎样二次开发35A联动控制智能空开以实现漏电保护控制_解决方案

CATALOG

芯步35A智能断路器的开放接口基于HTTP协议，可以方便地集成到现有的监控系统中，实现漏保跳闸后的自动诊断与远程控制。以下方案涵盖硬件选型、接口调用逻辑、签名算法及典型场景的代码示例。

解决方案：基于芯步35A智能断路器的漏电保护二次开发

1. 概述与核心原理

在工业与商业用电场景中，漏电保护是安全红线。传统的漏电保护器（RCD）在检测到漏电时会机械跳闸，但无法上报状态，运维人员必须到场合闸。

通过二次开发芯步 UNI-DLQ-35A 智能断路器，可以实现：

实时状态感知：通过API轮询或消息推送，实时获取断路器的分/合闸状态及漏电故障标志位。
自动策略执行：开发后端服务，捕获漏电跳闸事件后，根据预设逻辑（如：延时检测、自复位尝试）自动下发合闸指令。
系统联动：结合环境传感器（如烟雾、浸水），在危险发生前主动切断电路，不仅限于漏电后的补救。

2. 硬件与接口准备

在进行二次开发前，请确保硬件环境和接口权限已就绪：

目标设备：芯步 智能断路器35A (型号：UNI-DLQ-35A) 。
通信保障：设备通过 WiFi 2.4G 联网，无需额外网关，需确保信号强度。
开发凭证
- AppID 与 AppSecret：登录芯步控制台获取，用于接口鉴权。
- Device ID：设备外壳上的唯一编号，用于指令寻址。

3. API 接口深度解析与二次开发封装

针对漏电保护的需求，需重点封装状态查询和指令下发两个核心接口。

3.1 签名算法 (Sign)

为防止接口被恶意调用，所有HTTP请求必须携带动态签名。二次开发时需在后端实现如下逻辑

公式Sign = MD5( MD5(AppSecret) + ts )
步骤
1. 将AppSecret进行MD5加密得到字符串 S1。
2. 拼接字符串：S1 + 当前Unix时间戳 ts (秒级)。
3. 对拼接后的字符串再次进行MD5加密。

3.2 状态监测：构建“漏电事件触发器”

要实现漏电保护，系统首先要能“感知”漏电。35A断路器在发生漏电时，其状态字段会发生变化。

接口地址http(s)://api.thingboot.com/{AppID}/device/status/
关键字段识别：在返回的JSON数据中，需要关注 leakage (漏电标志) 和 power (开关状态)。
- 场景判断：当 leakage = 1 且 power = 0 时，判定为漏电跳闸事件，而非手动关闭。

3.3 远程合闸：清除故障与复位

漏电跳闸后，若需远程恢复供电，二次开发系统需依次执行两条指令：

清除漏电故障标志 (可选/视具体固件)：部分版本需先发送漏电复位指令。
合闸指令
- 接口POST /{AppID}/device/control/
- 参数详解
  - device: 目标断路器ID。
  - order: {"power": 1} (1代表接通/合闸，0代表断开/分闸)。

3.4 核心代码逻辑伪代码

以下是一段高质量的后端二次开发伪代码，演示如何封装漏电保护逻辑：

# 芯步 35A 二次开发 - 漏电自恢复模块示例
import hashlib, time, requests

class YoYoCircuitBreaker:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = "https://api.thingboot.com"

def _generate_sign(self):
        # 实现 3.1 中的签名算法
        md5_pwd = hashlib.md5(self.app_secret.encode()).hexdigest()
        ts = str(int(time.time()))
        sign_str = md5_pwd + ts
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign, ts

def get_status(self):
        """ 获取实时状态，用于检测漏电 """
        sign, ts = self._generate_sign()
        url = f"{self.base_url}/{self.app_id}/device/status/?sign={sign}&ts={ts}&device={self.device_id}"
        response = requests.get(url)
        # 解析响应，假设返回的json中包含 leakage 字段
        return response.json()

def control(self, cmd):
        """ 下发控制指令 
        cmd: {"power": 1} 或 {"power": 0}
        """
        sign, ts = self._generate_sign()
        url = f"{self.base_url}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        payload = {
            "device": self.device_id,
            "order": cmd
        }
        headers = {'Content-Type': 'application/json'}
        response = requests.post(url, json=payload, headers=headers)
        return response.json()

def leakage_recovery(self):
        """ 漏电跳闸后的二次开发处理逻辑 """
        status = self.get_status()
        
        # 假设返回的数据结构为 {"status": {"leakage": 1, "power": 0}}
        if status.get('status', {}).get('leakage') == 1:
            print("检测到漏电跳闸，正在执行保护逻辑...")
            
            # 1. 可选逻辑:记录日志，通知管理员
            self.log_event("Leakage detected on device", self.device_id)
            
            # 2. 判断是否允许自动复位（例如:设定只允许自动复位3次）
            if self.recovery_count < 3:
                # TODO: 针对特殊场景，可先下发 {"leakage_reset": 1} 清除故障状态
                
                # 3. 延时5秒后尝试合闸
                time.sleep(5)
                result = self.control({"power": 1})
                print("合闸结果:", result)
            else:
                print("超过最大尝试次数，请人工检修")

4. 关键场景联动与策略优化

在实际项目中，单纯的“跳闸-合闸”是不够的。根据以下工程经验进行二次开发优化：

第一种场景：防触电安全联锁

硬件组合：35A断路器 + 芯步人体传感器。
逻辑：当系统检测到有人进入配电柜区域时，若线路处于通电状态，禁止自动合闸；或当传感器检测到人员移动时，若发生漏电，立即切断总闸并锁定远程合闸功能，必须人工现场确认（防止远程合闸导致正在检修的工人触电）。

第二种场景：潮湿环境自适应

逻辑：在浴室、水泵房等环境，因空气湿度大，初次漏电可能是误报或轻微凝露。
策略：二次开发服务监测到漏电跳闸后，先向设备下发 “状态查询” 指令。
- 若漏电标志消失 -> 判定为瞬态干扰 -> 等待10秒 -> 下发合闸指令 {"power":1}。
- 若合闸后1分钟内再次漏电 -> 判定为持续性漏电故障 -> 锁定设备 -> 推送钉钉/企业微信告警：“35A断路器漏电故障，需现场检修”。

第三种场景：电量与过载预保护

逻辑：利用35A的计量功能，监测回路电流。
策略：如果电流持续接近35A额定值（如 >32A），即使未跳闸，系统也主动发送 {"power":0} 切断电路，起到过载预保护作用，防止高温烧毁触点。

5. 部署架构

针对不同的网络环境，芯步的开放接口支持两种模式，二次开发时需对应调整：

公网SaaS模式
- 架构：设备 -> 芯步云 -> 您的业务服务器。
- 适用：分布式站点、连锁店铺。
- 开发注意：确保 AppSecret 存储在云端，严禁放在客户端（小程序/APP）中，防止密钥泄露导致设备被恶意控制。
局域网私有化模式
- 架构：设备 <-> 本地路由器 <-> 本地服务器。
- 适用：工厂、园区、对公网依赖低的场景。
- 开发注意：将API请求的 Host 改为设备所在局域网内的指定IP（如果设备支持自定义Host）或通过本地DNS解析。此模式延迟极低（约80ms），最适合需要快速切断的漏电保护逻辑。

6. 总结

围绕芯步35A的二次开发，关键在于状态机的准确轮询与故障标志位的处理。通过上述方案，开发者不仅能够实现基础的“漏电跳闸 -> 远程合闸”闭环，还能结合传感器数据，构建具有“感知-决策-执行”能力的主动安全防御系统。这充分利用了其开放接口的灵活性，将硬件能力无缝融合进现有的业务平台中。