怎么对接60A智能电源保护开关来实现漏电保护控制_解决方案

CATALOG

60A智能电源保护开关的漏电保护对接，核心是通过HTTP接口下发指令，实现远程监测与断电控制。以下是完整的解决方案：

1. 概述

1.1 产品介绍

芯步智能大功率断路器[计量版]（型号：UNI-DLQ-M-60A-P，简称60A智能电源保护开关）是一款支持远程控制和电能计量的智能硬件设备。该设备具备以下核心特性

额定电流：60A，适用于大功率用电场景
通信方式：WiFi 2.4G直连，无需额外网关
控制能力：支持远程通断电控制和漏电保护
计量功能：实时监测电压、电流、功率、电量等参数
开放接口：提供标准HTTP API，支持第三方系统集成

1.2 漏电保护控制说明

漏电保护控制是指通过对设备进行远程监测和控制，实现漏电故障的及时发现与断电保护。主要包括：

漏电状态监测：实时获取设备的漏电告警状态
远程断电控制：基于漏电告警自动或手动下发断电指令
重新上电控制：排除故障后远程恢复供电

2. 对接架构

2.1 整体方案架构

整个对接方案采用“业务系统 + 芯步开放平台 + 智能设备”三层架构：

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  业务系统       │────▶│ 芯步开放平台 │────▶│ 60A智能断路器   │
│ (MES/EMS/自研)  │     │ (API + MQTT)     │     │ (UNI-DLQ-M-60A-P)│
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
        │   ①查询漏电状态         │                        │
        │◀───────────────────────│   ②返回实时状态        │
        │                        │◀───────────────────────│
        │   ③下发断电指令         │                        │
        │───────────────────────▶│   ④执行断电            │
        │                        │───────────────────────▶│

2.2 通信协议说明

HTTP接口：适用于设备控制和状态查询，请求-响应模式
MQTT协议：适用于实时状态推送和消息订阅
私有化部署：支持在纯局域网环境中部署

3. 对接准备工作

3.1 账号注册与设备配网

注册芯步账号：访问芯步官网完成注册
创建工作台：登录后在物联网控制台中创建工作台
设备配网
- 将60A智能断路器通电
- 通过“芯步小程序”或控制台PC端完成WiFi配网
- 确保设备连接至2.4G WiFi网络

3.2 获取开发凭证

在物联网控制台的“开发设置”页面获取以下信息

参数	说明
AppID	应用/开发者ID
AppSecret	开发者密码
Device ID	设备唯一标识（配网后生成）

4. 接口对接详解

4.1 接口基础信息

接口地址

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

请求方式：POST

Content-Type：application/json

签名算法

签名计算示例：

4.2 核心接口：设备控制（断电/通电）

请求参数

参数	类型	必填	说明
device	string	是	设备ID，支持多个设备用逗号分隔
order	json string	是	控制命令JSON字符串

控制命令格式

操作	order参数值	说明
接通电路（通电）	`{"power":1}`	恢复供电
断开电路（断电）	`{"power":0}`	切断供电，实现漏电保护

请求示例

返回示例

code=0表示发送指令成功，0表示指令已成功推送给设备（设备实际响应需查询状态）。

4.3 状态查询接口

通过查询接口获取设备的实时漏电状态和电量参数。

接口地址

https://api.thingboot.com/{AppID}/device/query/?sign={sign}&ts={ts}

请求参数

参数	类型	必填	说明
device	string	是	设备ID

返回字段说明（关注漏电相关字段）：

字段	类型	说明
leakage_status	int	漏电状态：0=正常，1=漏电告警
power_status	int	通断电状态：0=断开，1=接通
current	float	当前电流值（A）
voltage	float	当前电压值（V）
power	float	当前功率值（W）
energy	float	累计电量（kWh）

4.4 MQTT实时订阅（推荐）

为实现漏电状态的实时响应，使用MQTT协议订阅设备状态变更。

连接配置

参数	值
Host
Port	1883
Username	AppID
Password	AppSecret
Client ID	控制台获取

订阅主题

api/{AppID}/device/status

设备异常时自动推送漏电告警，业务系统可立即触发断电保护逻辑。

5. 漏电保护功能实现

5.1 主动漏电保护流程

    开始
      │
      ▼
┌─────────────┐
│ 定时查询设备 │◀───┐
│ 漏电状态     │    │
└──────┬──────┘    │
       │           │
       ▼           │
┌─────────────┐    │
│ 漏电状态=1? │────┼───否──┐
└──────┬──────┘    │       │
       │是         │       │
       ▼           │       │
┌─────────────┐    │       │
│ 下发断电指令 │    │       │
│ {power:0}   │    │       │
└──────┬──────┘    │       │
       │           │       │
       ▼           │       │
┌─────────────┐    │       │
│ 记录漏电日志 │    │       │
│ 发送告警通知 │    │       │
└──────┬──────┘    │       │
       │           │       │
       ▼           │       ▼
┌─────────────┐    │   ┌─────────┐
│ 等待人工确认 │    │   │ 间隔    │
│ 排除故障     │    │   │ 5秒     │
└──────┬──────┘    │   └────┬────┘
       │           │        │
       ▼           └────────┘
┌─────────────┐
│ 手动/远程   │
│ 恢复供电     │
└──────┬──────┘
       │
       ▼
    结束

5.2 代码实现示例（Python）

import hashlib
import time
import requests
import threading

class LeakageProtectionController:
    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"
        self.leakage_protection_enabled = True
        
    def _generate_sign(self, ts):
        """生成签名"""
        inner_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        return hashlib.md5((inner_md5 + str(ts)).encode()).hexdigest()
    
    def get_device_status(self):
        """获取设备状态"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}/{self.app_id}/device/query/?sign={sign}&ts={ts}"
        
        try:
            response = requests.post(url, json={"device": self.device_id})
            if response.status_code == 200:
                data = response.json()
                return {
                    "leakage_status": data.get("leakage_status", 0),
                    "power_status": data.get("power_status", 0),
                    "current": data.get("current", 0),
                    "voltage": data.get("voltage", 0)
                }
        except Exception as e:
            print(f"状态查询失败: {e}")
        return None
    
    def control_power(self, power_on):
        """控制通断电"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        order = {"power": 1 if power_on else 0}
        payload = {"device": self.device_id, "order": order}
        
        try:
            response = requests.post(url, json=payload)
            return response.status_code == 200 and response.json().get("code") == 0
        except Exception as e:
            print(f"控制指令失败: {e}")
        return False
    
    def leakage_protection_loop(self, interval=5):
        """漏电保护主循环"""
        print("漏电保护监控已启动")
        while self.leakage_protection_enabled:
            status = self.get_device_status()
            
            if status and status.get("leakage_status") == 1:
                print(f"⚠️ 检测到漏电！立即执行断电保护")
                if self.control_power(False):
                    print("✅ 已切断电源")
                    # 可在此添加告警通知逻辑
                    self.leakage_protection_enabled = False  # 触发后停止，等待人工重置
                    break
            
            time.sleep(interval)
    
    def reset_and_restore(self):
        """故障排除后恢复供电"""
        self.leakage_protection_enabled = True
        if self.control_power(True):
            print("✅ 已恢复供电")
            return True
        return False

# 使用示例
if __name__ == "__main__":
    controller = LeakageProtectionController(
        app_id="your_app_id",
        app_secret="your_app_secret",
        device_id="your_device_id"
    )
    
    # 启动漏电保护监控
    controller.leakage_protection_loop()

6. 常见问题和需要注意的点

6.1 接口调用注意事项

问题	解决方案
签名错误(code 5006)	检查AppSecret是否正确，ts是否为中国时间
IP白名单限制(code 5008)	在控制台将服务器IP加入白名单
请求频率超限(code 5009)	单设备限制1次/秒，请控制查询频率
设备离线	检查WiFi连接，设备支持5组WiFi自动切换

6.2 漏电保护功能

双重确认机制：连续两次查询确认漏电状态一致后再执行断电，避免误判
告警通知集成：断电后应通过短信、钉钉、企业微信等方式通知相关人员
操作日志记录：所有漏电告警和断电操作应记录日志，便于事后追溯
自动恢复策略：排除故障后需手动确认恢复供电，或在安全条件下设计自动重试（如间隔1小时尝试重合闸1次）
私有化部署：对于对响应延迟敏感的场景，采用私有化部署，避免公网延迟

以上方案基于芯步开放平台的标准HTTP接口实现60A智能电源保护开关的漏电保护控制。如需获取设备具体返回字段的完整定义或最新的接口文档，访问芯步官网的物联网控制台查阅对应产品手册。