商业店铺灯光电源管理：怎么把AC3-10A 计量版电源开关接入到自己的项目中_解决方案

CATALOG

芯步的AC3-10A计量版电源开关支持HTTP接口控制，可以很方便地集成到你自己的管理后台或App中。下面从硬件准备、接口调用、代码示例到业务场景，完整讲一遍接入过程。

一、设备选型与硬件准备

首先确认你手里的设备是 AC3-10A 计量版。从硬件参数上看，这款设备有几个关键点需要注意：

额定功率：10A版本支持最大2000W-3500W（纯阻性负载）。对于商业店铺来说，一路回路控制一整排射灯（通常几百瓦）绰绰有余。
计量功能：既然你指定要“计量版”，那它不仅能开关，还能读取电压、电流、功率。这是做能耗分析的关键。
安装位置：设备体积小巧，安装在店铺的配电箱内，或者靠近被控电器的吊顶检修口处。

接线

输入：接市电的火零线。
输出：接你控制的那一路灯光电源。
注意：由于是强电设备，接线时请一定要断电，注意线径匹配（10A一般1.5平方毫米以上铜线）。

二、接口对接流程（核心步骤）

芯步的设备采用 HTTP API 的方式控制。这意味着不管你后端用Python、Java、PHP，还是前端用小程序，只要发个HTTP请求就行了。

第1步：设备配网

设备通电后，你会搜到一个叫 “TB-IoT-xxx” 的热点。需要用官方的小程序或App，把店铺的WiFi密码告诉设备。这里有一个经验：必须用2.4G频段的WiFi，商用路由器通常都支持，但注意不要连到5G信号上。

第2步：获取凭证

登录芯步控制台，找到“开发设置”。你需要拿到两个关键字符串：

AppID：标识你是哪个开发者。
AppSecret：相当于你的密码，打死也不能写在客户端代码里，只放在后端用。

第3步：签名计算（避坑指南）

这是唯一有点绕的地方。为了防止接口被别人乱刷，请求需要携带签名。规则是：Sign = md5( md5(AppSecret) + ts )

解释一下：把AppSecret先MD5加密一次，得到的结果拼接上当前时间戳（秒），再把拼接后的字符串MD5一次。

第4步：下发控制指令

AC3-10A 的主要命令如下

开启/关闭：核心命令 power
读取数据：核心命令 metering

请求示例：

URLhttp(s)://api.thingboot.com/{你的AppId}/device/control/?sign={计算好的签名}&ts={当前时间戳}
Method：POST
Body (JSON)

第5步：获取计量数据

如果想把电费算清楚，需要主动去查询数据。命令把 order 里的内容换成 metering。返回的数据里通常包含：

V：电压 (V)
I：电流 (A)
P：功率 (W)
Elec：用电量 (kWh)

三、代码实战：如何写到你的项目里？

假设你用 Python 写后端服务（如果是PHP、Nodejs逻辑完全一样）。

import requests
import hashlib
import time

# 1. 配置你的钥匙
app_id = "YOUR_APP_ID"
app_secret = "YOUR_APP_SECRET"
device_id = "DEVICE_ID" # 在后台复制的那串数字

# 2. 计算签名
def calc_sign(secret):
    # 第一次md5
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 获取当前秒级时间戳
    ts = str(int(time.time()))
    # 拼接并第二次md5
    sign_str = md5_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

# 3. 控制灯光开关
def control_light(state):
    sign, ts = calc_sign(app_secret)
    url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": device_id,
        "order": {
            "power": 1 if state else 0
        }
    }
    
    response = requests.post(url, json=payload)
    print("控制结果:", response.json())

# 4. 读取电量数据
def get_metering():
    sign, ts = calc_sign(app_secret)
    url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": device_id,
        "order": {
            "metering": 1
        }
    }
    response = requests.post(url, json=payload)
    data = response.json()
    # 假设返回的数据里包含功率，具体字段看官方文档
    print(f"当前功率: {data.get('power')}W")
    return data

# 测试:打开灯
control_light(True)

四、商业店铺场景的落地应用

光能开关还不够，既然你要写入自己的项目，可以利用计量功能做点“高级玩法”：

1. 无人自动断电（省电模式）

集成店铺的人体传感器（芯步家也有）或者直接用你收银系统的状态。

逻辑：如果连续30分钟收银台无操作+传感器无人，程序调用AC3接口 power=0。
收益：很多店铺打烊后忘记关装饰灯，一夜浪费几十度电，这个开关一年就能回本。

2. 用电安全监控

在后台写一个监控脚本。

场景：咖啡店或火锅店，负载一般都是大功率。
逻辑：如果发现 metering 返回的功率 > 2500W（或你自己设定的阈值），立即执行 power=0 切断电源。
结果：避免线路过热起火，你不仅卖开关，还卖了一份“保险”。

3. 动态电价与能耗报表

场景：如果你的项目是多店铺连锁管理。
逻辑：每天凌晨自动读取前一天的 Elec 增量，存入数据库。
结果：老板不用去现场，直接看你的SaaS后台就知道A店今天电费200，B店150，方便做成本核算。

五、一点小提示

响应速度：实测通过公网控制，延时大约在 80-200ms 之间。关灯可能会有半秒延迟，不适合需要频闪的场景，但普通商业照明完全够用。
局域网（LAN）模式：如果你对稳定性要求比较高（比如断网也不能中断控制），芯步的接口支持局域网发现和局域网控制。你可以让服务器和AC3在同一个网段下，直接走内网IP请求，速度更快、完全不依赖外网。
状态同步：在你的项目中，每次控制后把状态存一份在Redis里，不要每次都去读设备。因为设备是沉睡低功耗模式，频繁唤醒可能会有延迟。

按照这个方案，你应该能在一两个小时内把这台AC3开关跑通并集成到你现有的店铺管理系统里。如果遇到连不上网的情况，记得先检查WiFi是不是2.4G频段的。