怎么对接30A智能远程控制开关来实现过流保护自动跳闸_解决方案

CATALOG

芯步30A智能开关支持通过HTTP接口进行远程控制与状态监测，实现过流保护的关键在于轮询设备状态并在检测到跳闸后自动恢复或报警。以下是具体对接方案：

1. 解决概述

为了实现“过流保护自动跳闸”的逻辑，我们需要利用 “状态监测” 与 “远程控制” 的结合：

硬件层：芯步30A智能断路器本身具备过流检测能力。当电流超过30A阈值时，硬件物理层面会自动断开（跳闸），并上报断开状态。
软件对接层：你的服务器通过芯步开放的HTTP接口，定期查询设备状态。
业务逻辑层：如果检测到设备状态为“关闭”且非人为指令关闭，则判定为“过流跳闸”，系统记录日志并发出告警。

2. 接口对接准备

在开始编码前，请准备好以下三个核心凭证（可在芯步控制台获取）

AppId：应用唯一标识。
AppSecret：开发者密码（用于生成签名）。
Device ID：30A智能断路器的设备编号。

签名算法（必读）为了接口安全，每次请求都需要携带签名 sign，算法规则如下

将 AppSecret 进行一次 MD5 加密，得到 Secret_MD5。
获取当前 Unix 时间戳（秒） ts。
将 Secret_MD5 与 ts 进行拼接，再进行一次 MD5 加密，得到最终的 sign。
- 公式sign = md5( md5(AppSecret) + ts )

3. 核心步骤：如何监测过流跳闸

过流保护的本质是硬件自动断开。在软件层面，你需要通过轮询或消息推送来感知这一变化。由于芯步强调HTTP接口的开放性，以下重点介绍基于HTTP API的主动轮询方案。

3.1 获取设备当前状态

系统需要定时（例如每1-2秒，视实时性要求而定）调用API获取设备最新状态。

请求地址https://api.thingboot.com/{AppId}/device/status/?sign={sign}&ts={ts}
请求方法：POST
请求参数
{ "device": "这里填写你的30A设备ID" }
逻辑处理流程
1. 发起状态查询请求。
2. 解析返回的JSON数据，找到电量或通断字段（通常如 power 或 status，具体字段名请参考对应设备的产品手册）。
3. 判定逻辑
  - 如果代码中记录的开关状态是 ON，但查询到的状态是 OFF。
  - 且过去几秒内系统并未发送关闭指令。
  - 结论：判定为过流跳闸或异常断开。

3.2 恢复供电（自动合闸）

检测到跳闸后，如果需要远程恢复供电，可以下发“闭合”指令。

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法：POST
请求参数
{ "device": "设备ID", "order": { "power": 1 // 1代表开启/吸合 } }
注意：考虑到安全，如果是严重过流故障，在自动合闸前增加cooldown（冷却期）或人工确认机制，避免频繁跳闸损坏设备。

3.3 配置过流阈值（可选）

虽然硬件默认30A跳闸，但部分固件版本支持通过接口设置阈值，以便在电流达到一定比例时预先告警，而非直接跳闸。你可以查阅产品手册中的“参数设置”部分，是否有相关的寄存器地址支持写入告警阈值。

4. 实战代码逻辑示例

以下伪代码展示了如何在一个服务程序中集成此逻辑：

# 模拟示例:基于芯步接口的过流保护监测服务
import requests
import time
import hashlib

class YoYoBreaker:
    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.last_known_state = True  # 假设初始为开启
        self.api_base = "https://api.thingboot.com"

def _generate_sign(self, ts):
        # 1. md5(AppSecret)
        secret_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. md5(secret_md5 + ts)
        sign_str = secret_md5 + str(ts)
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign

def check_and_recover(self):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 1. 查询设备当前状态
        url = f"{self.api_base}/{self.app_id}/device/status/?sign={sign}&ts={ts}"
        response = requests.post(url, json={"device": self.device_id})
        current_state = response.json().get('data', {}).get('power')  # 假设返回字段为power，1为通，0为断
        
        # 2. 过流跳闸判断逻辑
        # 条件:之前状态是开启(True/1)，现在查询状态是关闭(0)，说明发生了非人为跳闸
        if self.last_known_state == 1 and current_state == 0:
            print("警报:检测到设备异常断开！疑似过流保护触发。")
            # 记录日志，发送钉钉/微信告警
            self.send_alert()
            
            # 可选:延时5秒后尝试自动恢复
            # time.sleep(5)
            # self.turn_on() 
            
        # 3. 更新本地记录的设备状态
        self.last_known_state = current_state
        
    def turn_on(self):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        # 下发开启指令
        requests.post(url, json={"device": self.device_id, "order": {"power": 1}})
        print("已下发远程合闸指令")

# 主循环
breaker = YoYoBreaker("你的AppId", "你的AppSecret", "你的30A设备ID")
while True:
    breaker.check_and_recover()
    time.sleep(2)  # 轮询间隔2-3秒

5. 高级配置与优化

私有化部署与低延迟如果该系统部署在工厂或机房等局域网环境，芯步设备支持纯局域网通信。你可以将API地址指向设备内网的IP，这样不仅可以降低延迟，还能提高断网情况下的稳定性。
物理按钮动作自定义该30A设备支持屏蔽物理按钮动作。在某些无人值守场景，通过接口将物理按钮动作设置为“无效”或“仅触发告警”，防止现场人员意外手动关闭导致业务中断。
定时任务缓存可以利用设备自带的“定时任务”功能。例如，在开启大功率设备前，先通过接口设置一个“5分钟后关闭”的任务，作为过流保护的二次保险。

6. 总结

通过此方案，你可以利用芯步的开放接口轻松实现30A智能开关的过流保护监控：

无需轮询电流值（硬件自带30A脱扣），只需轮询通断状态。
关键指标：通过软件逻辑区分“指令关闭”和“异常跳闸”。
响应动作：对接告警系统（短信/邮件）并可选配自动合闸逻辑。