怎样对接智能通断器AC5-10A来实现远程批量控制_解决方案

CATALOG

这是一份基于芯步智能通断器AC5-10A开放接口的批量控制解决方案。由于你不需要附件，内容聚焦于可直接落地的技术架构、签名算法、批量控制实现逻辑及关键代码示例。

1. 背景与概述

在智慧照明、智能楼宇、农业灌溉及共享设备管理等场景中，往往需要同时控制成百上千个节点的电路通断。芯步推出的智能通断器 AC5-10A 是一款支持 100-250V AC、MAX 10A 负载的单路通断器。

本方案的目标是利用该设备全面开放的 HTTP 接口，解决“单控效率低”的痛点，通过携带设备 ID 列表，实现毫秒级响应的远程批量控制，且支持公网与局域网（私有化）两种部署模式。

2. 产品核心特性与接口优势

在对接前，需明确 AC5-10A 的底层技术优势，这为批量控制提供了基础：

直连免网关：设备直接通过 WiFi 2.4G 联网，无需购买额外网关，降低了大规模部署的硬件成本。
高效响应：实测从云端下发指令到设备执行，延迟稳定在 80-120ms 之间，商业场景体验流畅。
灵活接口设计：API 设计支持 单次请求多设备 的机制，这是批量控制的核心。

3. 接口鉴权与基础通信机制

要实现批量控制，首先必须完成安全的身份认证。芯步采用动态签名方式，所有控制指令均需通过 POST 请求发送。

3.1 签名生成规则

为了防止接口被恶意篡改，每个请求都需携带 sign 和 ts 参数。算法逻辑如下：

获取用户后台的 AppSecret（开发者密码）。
获取当前 Unix 时间戳 ts（单位：秒）。
Sign 计算流程
- 第一步：A = md5(AppSecret)
- 第二步：B = A + ts（字符串拼接）
- 第三步：sign = md5(B)

简单来说，签名的值为 md5( md5(你的密钥) + 时间戳 )。

3.2 请求地址结构

POST http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

{AppId}：在控制台获取，用于识别开发者身份。

4. 远程批量控制实现方案

这是本方案的核心。大多数传统方案需要循环调用单设备接口，效率低且容易触发频率限制。芯步的接口支持在 device 字段中传递逗号分隔的多个设备 ID。

4.1 单批控制逻辑

你可以在一个 HTTP 请求中，指定多个 AC5-10A 设备的 ID，实现同时开启或关闭。

请求体示例假设你需要同时关闭 ID 为 820720、820721、820722 的三台通断器。

字段解析
- device：字符串类型，ID之间用英文逗号隔开。
- order： JSON对象。{"power": 0} 表示关闭；{"power": 1} 表示开启。

4.2 精细化的批量场景：部分开/部分关

在实际业务中，你可能需要批量操作但状态不一致。例如：批量关闭“左侧区域”的设备，同时开启“右侧区域”的设备。由于 AC5-10A 是单路设备，通过构建并发请求或分批请求来实现：

统一执行：对不同 ID 组分别发送不同的控制指令包。

4.3 高级批量命令：定时恢复

在批量控制充电桩、广告牌等场景时，常需要“临时通电一小时自动关闭”。AC5-10A 支持硬件级的 Reset 指令，无需在服务器端维护复杂的定时队列。

批量定时命令示例需求：批量控制100台设备通电，并在1小时后自动断电。

reset：参数单位为毫秒。该指令会让继电器立即吸合（通电），并在设定的时间后自动断开。

5. 编程实现步骤

以下使用 Python 3 展示如何封装一个批量控制函数，你可以将其集成到现有的运维系统或 SaaS 平台中。

5.1 核心代码示例

import requests
import hashlib
import time

class YouyouController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_url = "https://api.thingboot.com/{}/device/control/".format(app_id)

def generate_sign(self, ts):
        # 第一步:md5(app_secret)
        md5_a = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 第二步:拼接时间戳
        str_b = md5_a + str(ts)
        # 第三步:md5(拼接字符串)
        sign = hashlib.md5(str_b.encode()).hexdigest()
        return sign

def batch_control(self, device_ids, power_status, delay_ms=0):
        """
        批量控制智能通断器
        :param device_ids: 列表，例如 [820720, 820721]
        :param power_status: 整数，1为开，0为关
        :param delay_ms: 延时毫秒，用于定时任务
        """
        # 1. 准备参数
        ts = int(time.time())
        sign = self.generate_sign(ts)
        
        # 2. 构建请求体 (重点:将列表转换为逗号分隔的字符串)
        device_str = ",".join(map(str, device_ids))
        
        # 基础通断指令
        order = {"power": power_status}
        
        # 如果有延时需求，转换为 reset 指令
        if delay_ms > 0 and power_status == 1:
            order = {"reset": delay_ms}
        
        payload = {
            "device": device_str,
            "order": order
        }
        
        # 3. 发起请求
        url = f"{self.api_url}?sign={sign}&ts={ts}"
        headers = {'Content-Type': 'application/json'}
        
        response = requests.post(url, json=payload, headers=headers)
        return response.json()

# 使用示例
if __name__ == "__main__":
    # 初始化（替换为后台真实数据）
    controller = YouyouController("Your_App_ID", "Your_App_Secret")
    
    # 场景1:批量关闭10台设备
    device_list = [100001, 100002, 100003, 100004, 100005] # 实际ID列表
    result = controller.batch_control(device_list, 0)
    print("批量关闭结果:", result)
    
    # 场景2:批量开启指定设备，并在30分钟后自动断电
    result_reset = controller.batch_control(device_list, 1, delay_ms=1800000)
    print("定时断电指令下发结果:", result_reset)

5.2 注意事项

设备 ID 获取：设备 ID 可以在芯步控制台查看，也可以通过 /device/list/ 接口动态拉取，便于自动化运维。
并发限制：虽然接口支持单次传多个 ID，但如果设备数量极大（超过 200 台），分批请求，避免 HTTP 报文过大导致的网络超时。

6. 私有化部署与局域网批量控制

对于数据安全性要求比较高的工业场景（如军工、政府或封闭内网），芯步支持私有化部署。

方案：你可以将 API 服务部署在自己的服务器上，AC5-10A 设备也只需配置局域网 WiFi。
优势：批量控制指令完全在局域网内传输，不经过外网，响应速度极快且断网可用。
调整：只需将上述代码中的 api.thingboot.com 替换为你自建服务器的 IP 及端口即可。

7. 总结

通过芯步智能通断器 AC5-10A 的开放接口，实现远程批量控制具备以下明显优势：

简单：无需网关，直连 WiFi，API 签名逻辑清晰，普通开发者 10 分钟即可完成对接。
高效：单接口批量传入多设备 ID 的设计，极大节省了服务器开销和网络延迟。
稳定：支持硬件级定时（reset），即使服务器宕机，设备也能按计划自动执行断电，保障安全。

按照上述方案，你可以快速构建一套支持数千点位的分布式电路控制系统。