怎样接入AC3-10A 智能计量通断器以实现用电数据上传控制_解决方案

CATALOG

这是一篇关于如何对接芯步AC3-10A智能计量通断器的解决方案，我尽量写得详细且口语化一些。

一、选型与背景

咱们这次要聊的主角是 AC3-10A 智能计量通断器（计量版）。这东西说白了就是一个“装了大脑的继电器”。

它的核心价值：

控：可以远程把220V的电路“咔嚓”一下断开或接通。
测：不仅控，还能实时告诉你现在电流多大、电压多高、功率多少。
简单：它自带WiFi（只支持2.4G），不需要买额外的网关，只要家里/公司有网，插上电就能用。

本文的目的是帮你把它接入你自己的系统，实现“想看数据看数据，想控开关控开关”。

二、准备工作

在写代码之前，咱们得先把“场地”收拾好，也就是所谓的环境配置。

拿到钥匙登录芯步的控台。你需要找到两个关键字符串：AppID（你的用户名）和 AppSecret（你的密码）。这东西千万别泄露给外人。
小贴士：如果你是第一次玩，在开发设置里打开“调试模式”。在这个模式下，系统会暂时跳过密码（Sign）的复杂计算，让你先用Postman之类的工具把流程跑通，免得被签名校验搞得头大。
设备配网给AC3-10A通上电。这时候它应该会发出“滴”的一声或者指示灯快闪。你需要通过“芯步”的官方App或者配网工具，告诉它你家路由器的WiFi密码。注意，这家伙只认2.4G频段，5G频段它找不到。
拿到设备ID配网成功后，在控制台的设备列表里，你会看到一串数字，比如 1878 或者 820720。这就是 Device ID，相当于这台机器的身份证号，我们控制它就是靠这个号。

三、核心接口详解

芯步的接口设计得比较简洁，全都走HTTP协议。也就是说，不管你用Python、Java、Go还是Node.js，只要能发HTTP请求，就能玩。

1. 控制类接口（通/断）

这个接口用来让设备通电或者断电。

命令格式在请求体里塞一个JSON，只要包含 power 字段就行。

想让电路通（开）：{"power": 1} 或者 {"power": "1"}
想让电路断（关）：{"power": 0} 或者 {"power": "0"}
针对计量版，有时候会有 metering 字段来控制计量功能的开关，通常是默认开启的，但为了保险，下发 {"metering":1} 也没坏处。

2. 定时/延时类接口

这个功能很适合做自动化。比如给电动车充电，你想让它充2小时后自动断电，免得过充。

命令格式

先通后断（Point）：比如延时5秒后断开。
- {"point": "5000"} （单位是毫秒，5000毫秒=5秒）
先断后通（Reset）：比如断电3秒后自动重新启动（适合软路由重启）。
- {"reset": "3000"}

3. 数据查询与上报

重点来了，这是计量版的核心。

怎么拿到数据？通常有两种方式：

主动拉取：你写代码发请求去问设备“你现在多少瓦？”。
被动接收（推荐）：芯步支持私有化部署和消息服务器转发。简单说，你可以设置一个你服务器的回调地址（Webhook），设备每上报一次数据（比如每5秒或10秒），芯步的服务器就把消息推送到你的服务器上。

你能拿到什么数据？ （实际字段以产品手册最新版为准，通常包含）：

voltage：电压（V）
current：电流（A）
power：功率（W）
energy：累计用电量（kWh，也就是度）
status：当前开关状态（0/1）

四、实战：代码怎么写

咱们直接上干货，用 Shell 和 Python 分别演示一下怎么把这玩意控起来。

第一种场景：用命令行（Curl）控制

这种适合运维脚本或者简单的调试。

步骤

拼接签名（如果在调试模式，这步可以简化）。
POST 数据过去。

假设：

AppID: 12345
Device ID: 100001
想让设备打开。

请求示例

注：上面的签名算法参考自官方文档。

第二种场景：用Python接入（更适合写业务逻辑）

假设你想把数据存到数据库，或者做个仪表盘。

import requests
import hashlib
import time
import json

# 1. 配置参数
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID"

# 2. 搞一个函数生成签名（为了安全）
def generate_sign(secret, ts):
    # 也就是文档里的 md5(md5(AppSecret) + ts)
    step1 = hashlib.md5(secret.encode()).hexdigest()
    step2 = hashlib.md5((step1 + str(ts)).encode()).hexdigest()
    return step2

# 3. 控制设备
def control_device(cmd, value):
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    # 构造命令
    # 比如 cmd="power", value=1 就是开
    payload = {
        "device": DEVICE_ID,
        "order": {cmd: value}
    }
    
    response = requests.post(url, params=params, json=payload)
    print(f"命令下发结果: {response.text}")

# 4. 读取数据（如果是通过回调接收，则是写一个Flask接口）
# 假设你要主动查询，通常有个查询接口或者靠设备主动推。
# 如果是设备主动推，你的服务器需要接收 POST 请求。
# 例如数据格式可能是:{"id":"100001","power":123.4,"voltage":220,...}

if __name__ == "__main__":
    # 举例:打开开关
    control_device("power", 1)

第三种场景：小程序/前端控制

如果你是想做小程序，原理也一样，只不过是用 wx.request。

五、一些“过来人”的（避坑指南）

关于签名（Sign）很多开发者第一次搞容易踩坑。注意官方文档的描述：md5(md5(AppSecret) + ts)。注意：是先把你自己的 AppSecret MD5加密一次，得到32位小写字符串，然后拼接上时间戳（ts），最后再把整个拼接后的字符串做一次MD5加密。顺序搞反了或者忘了加盐，服务器会直接拒绝你。
网络稳定性AC3-10A 用的是 WiFi，虽然支持自动重连，但如果你把它安装在铁皮柜子里或者信号极差的地下室，可能会掉线。安装时关注一下信号强度。它支持设定 5 组 WiFi 网络，会自动切换。
计量数据的用途
- 不要完全依赖瞬时功率去做精准的电费结算，瞬时功率是有波动的。如果要算“用了多少度电”，用 energy 累计值的差值，或者自己后台累加秒级上报的数据。
- 可以做一个“功率过大保护”的逻辑：比如你写个定时任务，每5秒查一次功率，如果发现功率 > 2500W（超出额定），立即下发 {"power":0} 切断电源，这就是一个软件层面的过载保护器。
私有化部署如果你的数据比较敏感，不想走公有云，芯步是支持私有化的。这意味着你可以把数据完全存在自己的服务器上，甚至让设备只跟你的局域网服务器通信，物理隔离。

六、总结

接入 AC3-10A 其实就是“配网拿ID -> 计算签名 -> 发HTTP请求”这三板斧。

控制：记住 power 字段。
延时：用 point 和 reset。
数据：走回调或者主动查。

你先在后台打开调试模式，用 Postman 把这个流程跑通，看到设备真的“咔哒”一声响之后，再回去慢慢写复杂的业务逻辑。祝你接入顺利！