怎么接入AC3 计量版智能通断器以实现10A 额定电流控制_解决方案

CATALOG

AC3计量版通过开放HTTP接口实现远程控制，核心是调用签名鉴权的API下发指令。以下从硬件准备、接口对接、命令格式到安全机制逐层展开，方便你直接落地实施。

1. 产品核心能力与适用场景

在开始对接前，明确AC3计量版的核心特性，这有助于定义软件侧的边界条件。

核心功能：除了基本的分合闸控制，该设备还具备电能计量功能，能够实时读取电压、电流、功率等数据。这对于能耗监测场景（如基站电费分摊、机房能耗分析）非常有价值。
额定参数：版本为10A计量版，型号为UNI-TDQ-AC3-10A-P。在阻性负载下最大支持2200W，在感性负载（如电机）下控制在300W以内，以确保稳定性。
优势：设备直连Wi-Fi，无需购买额外的网关硬件，降低了集成硬件成本。

2. 硬件准备与网络配网

实施的第一步是确保设备在线。若设备不在线，API接口将无法下发指令。

接线：AC3采用零火线输入和输出。请严格按照产品手册，将输入端子接市电（L/N），输出端子接负载。对于10A版本，前端配备10A或更小规格的空气开关作为短路保护。
配网流程
1. 手机下载“芯步”或对应的商家版APP。
2. 设备上电后，若处于未配网状态，通常指示灯为“快闪”模式。
3. 通过APP配置Wi-Fi（仅支持2.4GHz频段）。配网成功后，设备在云端显示为“在线”状态。
4. 注意：为了确保API控制不受本地按键干扰，可以在逻辑上屏蔽设备上的物理按钮，防止现场人员误触导致断电。

3. 开放接口对接流程

芯步的接口采用标准的HTTP协议，核心难点在于签名的计算。

3.1 前置准备参数

登录芯步平台的后台，在“开发设置”中获取以下关键凭证：

AppID：应用的唯一标识（例如 12345）。
AppSecret：开发者密码（例如 abc123）。严禁将其硬编码在前端或客户端中，必须在安全的后端服务器中使用。

3.2 签名算法详解

每个API请求都必须携带 sign 和 ts（时间戳）参数，以防止接口被重放攻击。算法逻辑如下

令 ts = 当前Unix时间戳（秒级），例如 1715678900。
对 AppSecret 进行一次MD5加密：secret_md5 = md5(AppSecret)。
将 secret_md5 与 ts 拼接成新字符串：tmp_str = secret_md5 + ts。
对 tmp_str 再次进行MD5加密：sign = md5(tmp_str)。

3.3 接口调用详情

请求地址： https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方法： POST
请求头： Content-Type: application/json
请求Body

4. “10A额定电流控制”的软件实现方案

针对你的主题需求，控制操作主要体现在对继电器的开闭控制，并结合计量功能实现过载保护。

4.1 基本通断控制

这是最核心的10A线路控制逻辑。通过以下JSON命令可以切断或接通负载电路。

开启线路（闭合）"order": {"power": "1"} 返回成功响应后，设备内部继电器吸合，10A电路导通。
关闭线路（断开）"order": {"power": "0"} 继电器断开，电路切断。

4.2 高级保护机制“软实现”

题目涉及“10A额定电流控制”，仅仅开关是不够的，关键在于 “超限保护” 。虽然设备本身有硬件过载保护，但通过软件做二次策略更为保险。

读取实时计量数据"order": {"metering": "1"} 该指令会返回当前的电压、电流、功率等数据。
逻辑闭环在后端代码中，你应该写一个定时任务（例如每5秒请求一次计量数据）。
1. 读取当前电流值（例如 11.5A）。
2. 判断逻辑：如果 current > 10.5（留有余量），则立刻调用 4.1中的关闭指令{"power":"0"}。
3. 告警记录：记录此次跳闸事件，便于运维人员定位过载原因。这就是利用AC3计量版实现的10A精细化管控。

4.3 场景联动

如果需要实现“一键断电”或“按顺序断电”，可以使用以下命令

先通后断：模拟点动控制，{"point": "3000"}（先闭合，3秒后断开）。
先断后通：模拟复位重启，{"reset": "3000"}（先断开，3秒后闭合）。

5. 代码实现片段

以下是一段基于 Python 的对接示例，实现了签名生成和电流保护逻辑：

import hashlib
import time
import requests

class AC3Controller:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _generate_sign(self, ts):
        # 1. md5(AppSecret)
        secret_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接 ts
        tmp_str = secret_md5 + str(ts)
        # 3. md5(tmp)
        return hashlib.md5(tmp_str.encode()).hexdigest()

def control_device(self, device_id, order_cmd):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {
            "device": device_id,
            "order": order_cmd
        }
        headers = {'Content-Type': 'application/json'}
        response = requests.post(url, json=payload, headers=headers)
        return response.json()

# 业务逻辑:安全控制，确保不超过10A
    def safe_close_overload(self, device_id):
        # 1. 先获取计量数据（假设 meter_data 是读取到的当前电流）
        # meter_response = self.control_device(device_id, {"metering":"1"})
        # current = meter_response['data']['current']  # 示例解析
        
        # 模拟逻辑判断
        simulated_current = 10.8 
        if simulated_current > 10.0:
            print(f"电流 {simulated_current}A 超过10A额定值，执行断电保护")
            # 2. 执行断电
            return self.control_device(device_id, {"power": "0"})
        return {"status": "normal"}

# 使用示例
ctrl = AC3Controller("你的AppID", "你的AppSecret")
# 开启设备
ctrl.control_device("设备序列号", {"power": "1"})
# 检查过载
ctrl.safe_close_overload("设备序列号")

6. 注意事项

感性负载问题：如果控制的是电机、压缩机类设备（感性负载），10A AC3通常只支持约300W。如果用来控制10A的大功率电机，启动电流可能烧毁内部触点。对于此类场景，通过AC3控制中间继电器，再由继电器控制接触器，实现“小控大”。
网络延迟：API控制依赖网络，若现场网络不稳定，指令可能会有秒级延迟。对于需要极速切断保护的场景（如短路），依赖设备自带的硬件保护（保险丝或空气开关），软件层面的10A保护更适合防范“慢过载”。
调试模式：在开发测试阶段，可以在后台打开“调试模式”，此时系统会忽略复杂的签名校验，方便你用 Postman 等工具直接测试指令是否正确，上线前再关闭。