怎么接入智能通断器 AC2-10A以实现自定义联动逻辑控制_解决方案

CATALOG

AC2-10A 智能通断器的开放接口采用标准的 HTTP 协议，签名机制清晰，可轻松集成到各类软件项目中。以下方案涵盖接口对接、自定义联动逻辑实现、状态监听及代码示例。

解决方案：基于芯步 AC2-10A 开放接口的自定义联动逻辑控制

1. 解决概述

芯步智能通断器 AC2-10A 支持通过标准的 HTTP 接口进行远程控制与状态监听。为了实现“自定义联动逻辑”（例如：温度传感器触发断电、多设备顺序启动、定时循环控制等），开发者需要利用其开放接口构建一个中心控制服务。该服务作为“大脑”，接收各种触发源（传感器、定时器、其他设备状态）的信号，通过计算逻辑，调用 AC2-10A 的 API 接口执行相应的“通”或“断”指令。

核心优势

标准协议：基于 HTTP，支持 Python, Java, Node.js, PHP 等任何主流语言。
实时反馈：设备状态变化会主动推送到开发者服务器，便于维护联动状态机。
无需网关：设备直连 WiFi，降低集成复杂度。

2. 准备工作与环境配置

在开始编码前，请按以下步骤在芯步控制台进行配置：

获取凭证：登录芯步控制台，在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。这相当于您操作设备的“账号”和“密码”。
设备配网：将 AC2-10A 通断器接通电源，使用微信小程序进行 WiFi 配网。确保设备在控制台状态显示为“在线”。
获取设备 ID：在控制台的设备列表或设备详情页，获取 Device ID（如 1878）。这是控制指令发送的目标地址。
设置消息推送 URL：为了实现复杂的联动逻辑，您需要让设备状态“主动说话”。在控制台的“开发设置”中配置 消息推送 URL（需公网可访问或使用内网穿透）。当设备状态变化时，芯步云会向该地址发送 JSON 数据包。

3. 接口鉴权与签名生成 (Sign)

所有 HTTP 接口调用均需携带动态签名，以保证安全性。签名生成逻辑如下（以 Shell/Python 为例）：

参数AppSecret, Timestamp (ts)
算法Sign = md5( md5(AppSecret) + ts )

逻辑解析：先将 AppSecret 进行一次 MD5 加密，得到字符串 A；将字符串 A 与当前时间戳拼接，再进行一次 MD5 加密，最终得到 Sign。

4. 实现自定义联动逻辑的三种核心接口

4.1 执行控制指令 (下发命令)

这是实现联动逻辑的基础。当触发条件满足时，通过调用此接口执行开关动作。

请求地址https://api.thingboot.com/{AppID}/device/control/
Method：POST
Body (JSON)
{ "device": "设备ID", "order": {"power1": 1} // 1为开启，0为关闭 }
高阶联动：该设备支持“自定义动作”，例如让设备在开启 500ms 后自动关闭，模拟“点动”或“脉冲”信号。只需将 order 参数设为 {"point":500} 即可。

4.2 接收设备状态反馈 (关键联动环节)

为了实现闭环联动（如：灯开了之后自动关闭风扇），我们需要知道设备的实时状态。

机制：设备状态改变（物理按键按下或远程控制成功）时，芯步云会立即向您第 2 步设置的 消息推送 URL 发送回调。
处理逻辑：您的服务器需开发一个接口（例如 /webhook/callback）来接收此 POST 请求。
数据用途：解析数据包中的设备 ID 和当前状态（power1 值），作为下一轮自动化逻辑的触发源。

4.3 查询设备状态 (同步校验)

在某些定时任务或联动执行前，先查询一次设备当前状态，避免重复下发无效指令。

命令示例：通过标准控制接口查询状态（具体命令参考产品手册的查询章节）。

5. 实战场景搭建：智能温控风扇联动系统

场景需求：假设有一个温度传感器（假设通过 Modbus/其他 API 获取数据），当室温超过 30℃ 时，自动闭合 AC2-10A 通断器（开风扇）；当温度低于 25℃ 时，自动断开（关风扇）。

逻辑代码伪代码设计

import requests
import time
import hashlib

class YoYoAC2Controller:
    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.api_base = f"https://api.thingboot.com/{app_id}/device/control/"

def generate_sign(self, ts):
        # 步骤1: md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 步骤2: md5(step1 + ts)
        step2 = hashlib.md5((step1 + str(ts)).encode()).hexdigest()
        return step2

def control_device(self, power_status: bool):
        ts = int(time.time())
        sign = self.generate_sign(ts)
        
        payload = {
            "device": self.device_id,
            "order": {"power1": 1 if power_status else 0}
        }
        
        response = requests.post(f"{self.api_base}?sign={sign}&ts={ts}", json=payload)
        return response.json()

def custom_logic_loop():
    # 初始化控制器
    controller = YoYoAC2Controller("Your_AppID", "Your_AppSecret", "Your_Device_ID")
    
    while True:
        # 模拟获取温度数据 (实际应用中请替换为真实的传感器API调用)
        current_temp = get_temperature_from_sensor() 
        
        # --- 核心自定义联动逻辑 ---
        if current_temp > 30.0:
            # 温度过高，开启通断器
            print("温度过高，触发开启风扇")
            controller.control_device(True)
        elif current_temp < 25.0:
            # 温度适宜，关闭通断器以节能
            print("温度适宜，触发关闭风扇")
            controller.control_device(False)
        # -------------------------
        
        time.sleep(60)  # 每60秒循环一次

6. 高级自定义动作与异常处理

为了更精细的控制，您可以利用 AC2-10A 的内置逻辑来减少服务器负载：

先通后断/先断后通：用于保护某些敏感电器（如 HDD 硬盘盒），避免瞬间电流冲击。命令参数支持 point (先通后断) 和 reset (先断后通)。
断电记忆功能：在联动逻辑中，如果服务器重启，先查询设备状态，重新同步一次现场状态，防止逻辑失控。
多设备组控：在 device 参数中，可用英文逗号 , 拼接多个设备 ID（例如 "device": "1878,1879,1880"），实现同步控制。

7. 总结

通过接入芯步 AC2-10A 的开放 API，开发者无需修改硬件固件，仅需在服务器端编写少量代码，即可实现极其灵活的自定义联动逻辑。关键在于利用 sign 签名机制保障安全，以及利用 callback 消息推送 实现实时的状态感知闭环。