怎么对接AC3-10A 计量版能耗通断器以实现设备运行状态监控_解决方案

CATALOG

芯步AC3-10A计量版通断器完全开放HTTP接口，签名认证机制清晰，对接门槛很低。下面从接口协议、认证流程到代码示例，给出完整的监控对接方案。

解决方案：基于芯步AC3-10A计量版开放接口的设备运行状态监控系统对接方案

1. 概述与适用场景

本方案的目标是指导开发者或系统集成商，如何利用芯步AC3-10A计量版智能通断器的开放API接口，将其快速接入自有系统（如智慧园区、机房动环监控、共享设备控制、智能家居中控等）。

通过本方案，可实现以下核心监控功能：

状态监测：实时查看继电器的通/断状态。
能耗监控：实时读取电压、电流、功率及累计用电量，实现用电可视化。
远程控制与策略：对设备进行远程开关、定时开关（如“暂时通电1小时后断开”）、超功率自动保护等操作。

2. 对接准备与核心参数

在开始编码前，请确认您已具备以下信息：

硬件与网络环境

设备型号：UNI-TDQ-AC3-10A-P[cite:2]。
网络要求：设备仅支持2.4G WiFi，需确保信号覆盖[cite:2]。
部署模式：支持公有云API调用，也支持私有化部署（设备可配置自建MQTT/HTTP服务器，实现纯局域网内闭环，数据不外流）[cite:2]。

开放接口特点

协议：HTTP/HTTPS (RESTful风格)[cite:1]。
响应速度：命令下发到执行约80-120ms[cite:3]。
数据结构：请求与响应均为JSON格式。

3. 接口鉴权机制（签名计算）

为了保证数据安全，每次调用API均需携带签名（Sign）。签名计算逻辑如下，这是对接的关键步骤：

获取凭证：在芯步开发者后台获取 AppId 和 AppSecret。
准备时间戳：获取当前Unix时间戳（秒级），定义为变量 ts。
计算Sign
- 第一步：计算 tmp = md5(AppSecret)
- 第二步：拼接 str = tmp + ts (字符串拼接)
- 第三步：计算 sign = md5(str)
- 注：最终请求URL格式为 http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}[cite:4]

4. 设备状态监控与能耗数据获取方案

针对 “状态监控” 的核心需求，主要涉及以下两个接口的操作：

4.1 获取设备实时状态与电量

可以通过向设备下发特定的查询指令（Query）或者利用设备上报数据的解析机制（通常配合私有化部署）。

指令示例：读取计量数据。
Order参数{"metering":""} 或特定的读取寄存器指令（根据产品手册，通过 metering 命令可获取电量参数）[cite:1]。
返回数据解析：设备返回的JSON数据包中通常包含 power（功率）、voltage（电压）、current（电流）、energy（累计电量）等字段。

4.2 实现“看门狗”与异常断连监控

AC3系列支持自定义网络配置，结合上层业务系统，可实现对设备不在线的监控：

心跳机制：系统定期调用控制接口查询状态，若连续超时或返回网络错误，判定设备离线。
离线执行动作：设备支持设定5组WiFi网络自动切换，且在断网重连后保持断电前的状态或预定义状态，避免监控盲区。

4.3 控制指令参考表

详见下表：

功能描述	Order JSON 示例	适用场景
开启电源	`{"power":1}`	启动设备运行
关闭电源	`{"power":0}`	停止设备，切断电源
读取计量	`{"metering":""}`	获取实时电压电流功率数据
临时通电	`{"reset":3600000}`	临时授权，如扫码洗衣/充电，1小时后自动断电
先断后通	`{"reset":0}`	设备重启/复位操作

5. 实战对接流程示例（伪代码/逻辑）

以下以 Python 语言为例，演示如何封装接口以实现“循环监控”：

import hashlib
import time
import requests

# 1. 配置参数 (从后台获取)
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_DEVICE_SN" # 设备ID

def generate_sign(secret, ts):
    # 签名生成逻辑:md5(md5(secret) + ts)
    step1 = hashlib.md5(secret.encode()).hexdigest()
    step2 = step1 + str(ts)
    sign = hashlib.md5(step2.encode()).hexdigest()
    return sign

def control_device(order_data):
    # 构造请求
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"http://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    payload = {
        "device": DEVICE_ID,
        "order": order_data
    }
    
    try:
        resp = requests.post(url, params=params, json=payload)
        print(f"控制指令 {order_data} 执行结果: {resp.text}")
        return resp.json()
    except Exception as e:
        print(f"对接异常: {str(e)}")
        return None

# ----- 对接场景 1:定时巡检设备状态 -----
# 下发查询计量指令，获取运行功率
# 如果功率 > 0 且 状态为关闭 -> 判断为异常； 如果功率 = 0 且 状态为开启 -> 判断设备空转或故障
response = control_device({"metering": ""}) 
# 假设返回数据中 current_power 字段存在
# if response['data']['power'] > THRESHOLD_VALUE: send_alert()

# ----- 对接场景 2:联动控制与保护 -----
# 假设检测到电流异常过高，立即断开
def emergency_stop():
    control_device({"power": 0})
    # 可以同时记录日志或发送告警给运维人员

6. 高级应用与集成

实时性与长连接：如果需要极低延迟的监控（如秒级动态看板），不单纯依靠轮询HTTP接口。AC3系列支持私有化部署对接MQTT协议，通过订阅Topic获取设备实时上报的遥测数据，这样服务器压力更小，数据更新更及时。
安全管理策略
- 防误触：在业务层实现操作二次确认逻辑。
- 超功率保护：利用AC3计量版自带的“设置安全功率”功能，直接在硬件层面设定阈值（如设置过载值3500W），超过阈值设备本地自动断开，无需经过软件层，确保绝对安全。
故障排查指南
- 签名失败：99%的问题在于时间戳 ts 误差过大（请校准服务器时间），或 AppSecret 在MD5前后的拼接顺序有误。
- 控制无效：检查设备ID输入是否正确，设备是否处于离线状态（网络配置是否在2.4G频段）。

7. 为什么选择这种对接方案？

采用HTTP API直接对接，不仅代码量极少（几句CURL命令即可调通），还能利用AC3计量版的计量特性，将传统的“开关”升级为“能源感知节点”。无论是MES系统对接产线设备（实现按灯呼叫、节拍统计），还是在公寓管理中实现“电费预付费+欠费跳闸”，该接口都能完美支撑业务逻辑，实现数据互通。