怎样对接AC5-10A 物联网开关来实现漏电保护控制_解决方案

CATALOG

一、写在前面

大家好！今天我们来聊一个很实用的场景：怎么用芯步的AC5-10A智能通断器，搭建一套远程漏电保护控制系统。

可能有的朋友会问：这玩意儿本身不就是个开关吗？跟漏电保护有啥关系？其实思路是这样的——我们可以外接漏电检测装置（比如漏电保护模块或电流互感器），把它接到AC5-10A的开关量输入端。一旦检测到漏电，开关会立刻把信号传给云端，你的后台系统收到消息后，再发指令把开关断开。整个过程自动完成，妥妥的一套智能漏电保护方案。

下面我就从硬件准备到代码实现，一步步跟大家说清楚。

二、硬件准备与接线

2.1 主角介绍

首先登场的是我们的核心设备——芯步智能通断器AC5-10A。这玩意儿个头不大（也就41×45×20毫米），但本事不小：

支持100-250V交流电，最大10A电流，额定功率2200W
自带WiFi，直接连2.4G网络，不需要买网关
开放HTTP接口，支持远程控制
重点：提供一路开关量输入，可以外接检测设备

2.2 还需要准备什么

要实现漏电保护，你还需要：

漏电检测模块：比如漏电保护专用互感器或漏电检测继电器
连接线：用来把检测模块的信号端接到AC5-10A的开关量输入端

2.3 怎么接线

其实不复杂：

漏电检测模块的信号输出端 → AC5-10A的开关量输入端（设备上有标注）
检测模块本身按说明书接好被测电路

接线完成之后，当检测模块发现漏电，它会输出一个开关量信号（相当于“啪”一下把输入端接通）。AC5-10A收到这个信号后，会上报到平台，你的系统就能知道“出事了”，然后马上发命令切断电源。

三、对接思路

整体流程大概是这样的：

漏电发生 → 检测模块触发 → AC5-10A输入端收到信号 
→ 设备上报平台 → 你的后台收到推送 → 你发断开命令 → 开关断开

这里有两种实现方式，看你需要什么程度的自动化：

方式一：纯后台控制

这种方式下，你的后台系统需要：

接收平台推送的“输入端被触发”事件
根据业务逻辑判断（比如确认是漏电而非误报）
调用接口下发断开命令

优点：可以在命令里加extra字段携带订单号之类的业务信息，方便追踪

方式二：设备本地联动（推荐）

AC5-10A支持自定义联动操作。你可以在物联网控制台设置规则：当输入端被触发时，设备自动断开输出端。

优点

响应更快，不依赖网络
即使服务器挂了也能保护
省心，设置一次就不用管了

我个人两种都用：本地联动做第一道防线，后台推送做记录和二次确认。

四、接口调用详解

如果你选择方式一（后台控制），或者想保留手动远程断开的能力，那就需要调用芯步的开放接口了。

4.1 准备工作

先去芯步开放平台注册，拿到三样东西：

AppID：你的应用ID
AppSecret：你的应用密钥（记得保密）
设备ID：在控制台找到你的AC5-10A设备ID

4.2 签名计算方法

芯步的接口需要签名验证，规则是：

sign = md5( md5(AppSecret) + ts )

其中ts是当前时间的秒级时间戳（10位数字）

举个例子：

假设AppSecret = "abc123"
先算md5("abc123")，得到32位字符串，比如xxx
把xxx和ts（比如1699999999）拼起来：xxx1699999999
再算一次md5，得到最终的sign

不要用旧的时间戳，每次请求都要用当前时间，否则会报错

4.3 下发控制命令

接口地址http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式：POST

请求头Content-Type: application/json

请求体（JSON格式）：

"power": 1 表示接通
"power": 0 表示断开

如果需要携带业务信息（比如记录这次断开是由哪个漏电事件触发的），可以在order里加extra字段：

extra字段会被平台原样返回，方便你做消息追踪。

4.4 接收设备上报的事件

当AC5-10A的输入端被触发（也就是检测到漏电），平台会推送消息到你配置的接收地址。

推送的内容里会包含设备ID、触发时间、输入端口状态等信息。你需要：

在控制台设置好消息接收URL
写一个接口接收并解析平台推送的JSON
根据业务逻辑决定是否需要进一步处理（比如记录日志、发告警等）

4.5 代码示例（Python版）

import hashlib
import time
import requests
import json

class YoYoSwitch:
    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 = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts):
        """生成签名"""
        # 第一次md5
        first_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 拼接时间戳
        combined = first_md5 + str(ts)
        # 第二次md5
        sign = hashlib.md5(combined.encode()).hexdigest()
        return sign
    
    def control(self, power_on, extra=None):
        """
        控制开关通断
        power_on: True=接通, False=断开
        extra: 自定义业务信息（可选）
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        order = {"power": 1 if power_on else 0}
        if extra:
            order["extra"] = extra
        
        payload = {
            "device": self.device_id,
            "order": order
        }
        
        headers = {"Content-Type": "application/json"}
        
        response = requests.post(url, json=payload, headers=headers)
        return response.json()
    
    def emergency_off(self, reason="漏电保护触发"):
        """紧急断电"""
        return self.control(False, extra=f"emergency_off_{reason}")

# 使用示例
if __name__ == "__main__":
    # 初始化
    switch = YoYoSwitch(
        app_id="你的AppID",
        app_secret="你的AppSecret", 
        device_id="你的设备ID"
    )
    
    # 紧急断电
    result = switch.emergency_off("检测到漏电")
    print(result)

五、进阶玩法

5.1 定时任务

芯步平台支持远程定时任务。你可以设置每天定时自检，比如半夜自动通断几次，确认设备状态正常。

5.2 功率监控

AC5-10A支持功率计量（计量版本），可以实时监测电流、电压、功率。这能帮你做一些辅助判断——比如突然断电但功率还在，说明开关可能坏了。

5.3 私有化部署

如果你对数据安全要求比较高，AC5-10A支持私有化部署，可以在局域网环境运行。这样所有控制指令都不经过公网。

六、注意事项

负载限制：AC5-10A最大2200W阻性负载，感性负载（比如电机）要控制在350W以内
响应延迟：正常网络下，命令下发到执行大约80-120ms，做保护是够的
频率限制：单个设备访问限制1次/秒，不要高频轮询
可靠性：强烈用本地联动做兜底，网络断了也能保护
测试验证：部署前一定要做漏电模拟测试，确认整个链路通畅

七、总结

通过芯步AC5-10A实现漏电保护控制，整体思路其实不复杂：

硬件层：AC5-10A + 漏电检测模块，通过开关量输入连接
控制层：优先用本地联动自动断电，后台控制做补充
接口层：HTTP接口调用，签名验证后下发命令
业务层：接收平台推送，记录日志、发告警

开放接口的好处是灵活——你可以把这个漏电保护功能无缝集成到你现有的管理系统里，不管是Web、APP还是SaaS平台都能对接。

有什么问题欢迎留言交流！