怎样二次开发AC5-10A 定时控制开关以实现实时能耗计量控制_解决方案

CATALOG

这是一个关于芯步AC5-10A智能通断器的二次开发方案。这个设备本身不带计量芯片，所以“能耗计量”需要通过外接传感器 + 云端推算的方式实现，思路是用Python把控制、计量、业务逻辑串起来。

方案：给AC5-10A装上“大脑”——实现实时能耗计量与智能控制

一、先摸清家底：AC5-10A有啥“硬货”？

咱们要先搞清楚手头的这个设备能干啥、不能干啥。

硬件底子：

额定功率：2200W（阻性负载），带个热水器、路灯、小电机绰绰有余。
网络：自带WiFi 2.4G，不需要网关，插电即连网。
物理输入：自带一路开关量输入，可以外接实体按键（比如墙上自复位开关），实现“物理按键+APP”双控。

关键接口：

控制：官方开放HTTP API。说白了，就是给你一个网址，你往这个网址发一条特定的“短信”（HTTP请求），设备就听话地开或关。
鉴权：要用AppID、AppSecret和动态生成的Sign签名来证明是你本人在操作。

重要提示：这款基础版AC5-10A 主要管通断，不带计量芯片。要实现“能耗计量”，需要曲线救国——通过采集电压电流来换算。

二、怎么玩出“实时计量”的花活？

既然硬件不带计量，我们可以通过二次开发给它加上“虚拟感知”能力：

外挂电能传感器：在被控电器的插座端或总线上加装一个PZEM-004T或类似的Modbus电能模块，用来采集真实的电压、电流、功率、电量数据。
数据融合与计算：写一个服务程序，一边读电能模块的数据，一边控制AC5-10A的通断。通过累计功率对时间的积分，算出“今日用了多少度电”。
策略执行：根据电费时段、实时功率阈值来自动触发AC5-10A动作。

系统架构大概长这样：

执行层：AC5-10A通断器（负责物理通断）感知层：PZEM-004T电能模块（负责采集电流电压）大脑层：你的Python服务 / 树莓派 / 云服务器用户层：微信小程序 / Web Dashboard

三、动手开干：Python + HTTP API 实战

芯步的接口挺友好的，用Python调用非常顺手。核心是要搞定那个签名(Sign)算法，否则设备不认你。

第一步：准备工作

在芯步控制台拿到你的 AppID 和 AppSecret。
给AC5-10A配网，拿到它的 DeviceID 。

第二步：搞定签名算法

这个平台的签名规则是：Sign = md5(md5(AppSecret) + ts)。

先把你的 AppSecret 做一次MD5。
把得到的结果拼接上当前的时间戳 ts 。
把拼接后的字符串再做一次MD5。

第三步：写代码实现“秒级计量控制”

我们要写一个Python类，里面包含发号施令和假装计量两个核心功能。

import requests
import hashlib
import time
import json

class YoYoAC5Controller:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = "https://api.thingboot.com"  # 官方API地址[citation:4]

# 核心:生成动态签名
    def _generate_sign(self, ts):
        # 第一步:md5(AppSecret)
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 第二步:拼接 ts
        sign_str = md5_secret + str(ts)
        # 第三步:再次 md5
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign

# 核心:发送指令 (0=关， 1=开)
    def control_device(self, power_status):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 拼接请求 URL
        url = f"{self.base_url}/{self.app_id}/device/control/"
        params = {
            'sign': sign,
            'ts': ts
        }
        # 构造 Body，注意 order 字段要传标准的 JSON 字符串
        payload = {
            'device': self.device_id,
            'order': json.dumps({"power": power_status})  # 开/关命令[citation:2]
        }
        
        headers = {
            'Content-Type': 'application/json'
        }
        
        try:
            response = requests.post(url, params=params, json=payload, headers=headers, timeout=5)
            print(f"控制指令已发送，设备状态: {'开启' if power_status == 1 else '关闭'}")
            return response.json()
        except Exception as e:
            print(f"控制失败: {e}")
            return None

# 假装有计量功能 (实际是去读外接的传感器，这里假设通过Modbus读到了)
    def get_energy_data(self):
        # 这里要替换成真实读取 PZEM-004T 等传感器的代码
        # 模拟返回: 当前功率 1234.5W，总用电 12.34kWh
        mock_data = {
            "voltage": 220.5,     # V
            "current": 5.6,       # A
            "power": 1234.5,      # W (真实计量核心)
            "total_energy": 12.34 # kWh
        }
        return mock_data

# 业务逻辑: 如果功率超过阈值 (比如2000W)，自动断电保护
    def smart_protect(self, threshold_w=2000):
        energy = self.get_energy_data()
        if energy['power'] > threshold_w:
            print(f"⚠️ 警告: 当前功率 {energy['power']}W 超过阈值，执行断电保护！")
            self.control_device(0)  # 关闭设备
            return True
        else:
            print(f"✅ 功率正常: {energy['power']}W")
            return False

# 使用示例
if __name__ == "__main__":
    # 初始化
    ac5 = YoYoAC5Controller(
        app_id="你的AppID",
        app_secret="你的AppSecret",
        device_id="你的设备ID"
    )
    
    # 1. 打开开关
    ac5.control_device(1)
    
    # 2. 模拟实时监控循环 (每5秒检查一次)
    import threading
    def monitor_loop():
        while True:
            ac5.smart_protect(threshold_w=1800)  # 设定1800W阈值
            time.sleep(5)
    
    # 启动监控线程 (这样你就有了一个带过载保护的智能开关了)
    # monitor_loop() 
    # 注意: 如果在本地IDE运行，实际测试过载保护记得去掉注释

四、进阶玩法：让定时任务“活”起来

单纯的定时开关没啥意思，结合计量数据可以玩出更高级的自动化。

1. 错峰充电（省钱模式）

需求：电动车只在电价低谷期充电。
实现
- 写脚本抓取国家电网的阶梯电价时间表（或设定固定时间段，如23:00-07:00）。
- 在23:00调用control_device(1)开启。
- 监测get_energy_data中的功率。如果功率突然掉到50W以下（说明充满了），立刻调用control_device(0)断电，防止浮充耗电。

2. “离家一键断电”但保留冰箱

需求：按一下实体墙上的开关（接入AC5-10A的输入引脚），关闭所有插座，但保持冰箱通电。
实现
- AC5-10A有一个物理输入口，按下会触发云端的事件推送。
- 你的服务器接收到按下事件后，执行逻辑：如果当前控制的是“普通插座组”，发指令断电；如果设备ID是“冰箱”，则忽略指令。

五、避坑指南

关于计量精度基础款没有计量功能，如果非要设备本身的“实时能耗”，必须选带CT互感器或专用计量芯片的版本（如AC5-10A计量版）。如果是自己DIY，用外挂Modbus电表是成本最低的方案。
签名时效签名里的时间戳ts和服务器时间误差不能太大，记得校准你的服务器时间。
网络稳定性AC5-10A只支持2.4G WiFi，确保你的路由器信号覆盖到位。另外它支持设置5组WiFi，可以把家里和公司的WiFi都填进去，带来带去不用重新配网。
负载限制虽然标的10A，但如果接感性负载（电机、冰箱压缩机），功率要降额到350W以下使用，否则触点容易粘合。

总结

芯步这款AC5-10A虽然是个“哑”设备（不带计量），但因为它开放了HTTP接口，二次开发极其灵活。你用上面这套Python方案，给它外挂一个电表模块，它就立马变成了一个支持过载保护、实时计费、云端策略控制的智能断路器。动手试试吧，代码跑通的那一刻还是很有成就感的。