CATALOG

AC3-10A计量版的核心价值在于“可控+可测”——不仅能远程通断,还能实时读取电量数据并设置安全阈值。以下方案从签名算法、命令构造到参数配置,梳理了完整的对接流程。

1. 解决概述

1.1 产品核心特性

芯步推出的 AC3-10A 计量版能耗通断器 (型号:UNI-TDQ-AC3-10A-P) 是一款支持 WiFi 直连的智能控制设备。其核心优势在于:

  • 无需网关:设备直接连接 2.4G WiFi,降低了硬件成本与故障点

  • 双向通信:不仅支持远程开关(输出),还支持电压、电流、功率等电能数据的采集(输入),并提供“功率过载保护”功能。

  • 接口开放:提供全平台通用的 HTTP 协议 API,支持任何支持 HTTP 请求的编程语言或开发工具进行对接

1.2 对接目标

本文旨在指导开发者如何通过芯步的开放 HTTP 接口,将 AC3-10A 计量版集成至第三方系统中,实现以下高级管理功能

  1. 远程参数配置:动态设定设备的过载功率阈值。

  2. 远程控制:执行合闸/分闸操作。

  3. 数据采集:定时读取电能计量数据。

2. 接口对接基础

2.1 接口鉴权机制

芯步的接口采用 动态签名 机制,每次请求都需要计算签名,以防止重放攻击。核心逻辑如下:

YourSign = md5( md5(Your AppSecret) + ts )

  • AppID / AppSecret:登录芯步控制台后,在“开发设置”中获取

  • ts:当前的 Unix 时间戳(秒级)。

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={ts}

2.2 准备步骤

  1. 确保 AC3-10A 计量版已通过“芯步小程序”或“控制台”配置好现场 2.4G WiFi 并成功联网

  2. 在控制台获取目标设备的 Device ID

3. 核心:远程参数配置方案

对于“计量版”设备,远程参数配置主要指的是修改“安全功率阈值”。业务场景:假设某宿舍线路负载能力有限,管理员需将设备功率上限动态调整为 1800W,一旦超过自动断电,无需手动操作。

3.1 配置命令构造

根据芯步的命令集规范,AC3-10A 计量版配置阈值的 order 参数通常涉及 powermetering 相关指令的扩展。

命令示例(设定功率上限):

(注:具体命令字段请参考官方最新《计量版设备指令集》,依据产品手册,计量版支持设置安全功率

3.2 代码实现流程

以下以 Python 为例,展示如何下发配置指令:

4. 配套管理功能实现

为了实现完整的远程运维,通常需要将“参数配置”与“状态监测”结合。

4.1 远程通断控制

这是最基础的接口调用,用于参数调整后的恢复供电或紧急断电。

  • 合闸(通电){“power”: “1”}

  • 分闸(断电){“power”: “0”}

4.2 计量数据采集(状态反馈)

要验证“远程配置”是否生效,或者查看当前功率是否超过新阈值,需要读取计量数据。

请求命令示例:

预期返回数据解析:系统应能解析返回的 JSON 包,提取关键参数用于展示或判断:

  • voltage: 当前电压 (V)

  • current: 当前电流 (A)

  • power: 当前功率 (W) —— 用于判断是否超限的关键指标

  • energy: 累计电量 (kWh)

4.3 定时与联动配置

除了实时控制,还可通过接口配置定时任务,实现基于时间的参数自动调整。例如:晚上 23:00 后自动降低功率阈值,或关闭设备。(注:具体定时任务接口可参考“物联网控制台”的 API 文档)

5. 关键注意事项

  1. WiFi 频段限制:AC3 系列仅支持 2.4G WiFi,在配置路由器或手机热点时需特别注意,混合频段路由器需单独开启 2.4G 选项

  2. 计量版 vs 普通版

    • 普通版:仅支持开关 power 指令。

    • 计量版:支持 metering 读取与阈值写入。

    • 请一定要确认硬件型号:请检查设备外壳标签是否为 UNI-TDQ-AC3-10A-P (带 -P 后缀通常代表计量版)

  3. 签名时效性:签名中的时间戳 ts 与服务器时间误差不宜过大,在执行请求前实时获取系统时间戳。

  4. 私有化部署:如果系统运行在纯内网环境,芯步设备支持 局域网自建MQTT服务器 模式,此时 API 地址需变更为内网服务器地址,不依赖外网 API

6. 总结

通过对接芯步 AC3-10A 计量版的开放 HTTP 接口,实现“远程参数配置”的关键在于:

  1. 突破传统控制:不再仅限于“开/关”,而是通过 order 指令直接修改设备寄存器中的阈值参数(如 max_power)。

  2. 逻辑闭环:形成“配置下发 -> 设备执行 -> 读取计量数据验证 -> 触发保护/恢复”的管理闭环。

  3. 简易集成:利用简单的 POST 请求和 MD5 签名,即可将硬件无缝融入现有的任何软件 backend 或 SaaS 平台。