怎样二次开发智能分控PDU5位以实现过流自动断电控制_解决方案

CATALOG

芯步的智能PDU开放了HTTP接口，这意味着你可以用自己的服务器或脚本直接控制每个插孔。要实现“过流自动断电”，核心思路就是：持续获取电流数据 → 判断是否超标 → 调用断电接口。

下面是一个比较详细的二次开发方案，我会尽量写得口语化一点，方便你理解。

一、准备工作：让设备“上网”并找到“钥匙”

在写代码之前，需要先把硬件准备好，就像新电器拆箱要插电一样。

硬件上电与配网拿到芯步的5位分控PDU，先插上电。因为它是WiFi版本的，需要让它连上你办公室或机房的2.4G WiFi 。
- 操作路径：下载“芯步”小程序，或者登录他们的官网控制台。
- 步骤：在控制台里找到“网络配置”，输入WiFi密码，然后通过手机热点的方式（或者现在的蓝牙配网）把WiFi凭证推给PDU。看到设备状态变成“在线”，这第一步就搞定了。
获取API密钥（AppID/AppSecret）这是你写代码时的“身份证”，PDU得认你才听你话。
- 登录芯步控制台，进入“开发设置”。
- 你会看到AppID和AppSecret。这里有两个小
  - 开启调试模式：刚开始开发时，在后台打开“调试模式”，这样暂时不用算复杂的签名（sign），先跑通流程再说。
  - 记录设备ID：在“设备列表”里找到你这台PDU，把它的一长串设备ID复制下来，这就是你要控制的对象。

二、核心逻辑：如何判断“过流”？

所谓的“过流自动断电”，其实就是写一段程序，模拟人的判断：“电流超过5A了？马上把那个插孔给我掐了！”

要实现这个，你需要用到两个接口：

获取设备状态（查询电流）
- 目的：实时读取当前5个插孔各自的电流值。
- 接口方法：通常是一个POST请求，带上你的AppID和设备ID。
- 响应数据：返回的JSON里会包含类似 "outlet_1_current": 2.3 这样的字段，单位通常是安培。
控制分控开关（执行断电）
- 目的：给指定的插孔发送“关”指令。
- 接口形态：参考芯步的通用规范，请求地址通常有固定格式，比如 https://api.yoyoiot.com/ordercontrol/。
- 命令参数：你需要告诉PDU关哪一个口。例如：{"device_id": "xxx", "outlet": 3, "status": 0}（status: 0代表关，1代表开）。

三、实战方案：写代码（Python示例）

这里用Python写一个简单的死循环脚本为例，你可以把它部署在树莓派、云服务器，甚至是你的办公室电脑上。逻辑不复杂，就是轮询。

import requests
import time
import json

# 1. 配置参数 (替换成你自己的)
APP_ID = "你的AppID"
DEVICE_ID = "你的PDU设备ID"
# 假设后台开了调试模式，暂时忽略sign计算，或者按文档算好填进来

# 定义阈值:比如第3个口接了个大功率设备，限制电流不能超过8安培
THRESHOLD_CURRENT = 8.0 
TARGET_OUTLET = 3

# API地址（仅为示例，具体需查阅芯步文档）
API_BASE = "https://api.yoyoiot.com/v1"
QUERY_URL = f"{API_BASE}/device/status"
CONTROL_URL = f"{API_BASE}/device/control"

def get_current():
    """查询指定插孔的当前电流"""
    payload = {
        "app_id": APP_ID,
        "device_id": DEVICE_ID,
        # 这里可能需要ts（时间戳）和sign，调试模式下可简化
    }
    try:
        response = requests.post(QUERY_URL, json=payload, timeout=5)
        data = response.json()
        # 假设返回的数据结构里，电流在 data['outlets'][2]['current']
        # 注意:列表索引通常从0开始，用户口3对应索引2
        current_value = data['outlets'][TARGET_OUTLET-1]['current']
        return current_value
    except Exception as e:
        print(f"读取数据失败: {e}")
        return 0

def power_off():
    """执行断电操作"""
    payload = {
        "app_id": APP_ID,
        "device_id": DEVICE_ID,
        "outlet_id": TARGET_OUTLET,
        "switch": "off"  # 关闭
    }
    response = requests.post(CONTROL_URL, json=payload)
    if response.status_code == 200:
        print(f"【成功】已触发保护，第 {TARGET_OUTLET} 口已断电！")
    else:
        print("【失败】断电指令发送失败")

# --- 主循环逻辑 ---
print("启动过流保护监测程序...")
while True:
    # 获取电流
    current = get_current()
    print(f"实时监测第 {TARGET_OUTLET} 口电流: {current}A")
    
    # 判断是否过流
    if current > THRESHOLD_CURRENT:
        print(f"警告:电流 {current}A 超过阈值 {THRESHOLD_CURRENT}A，即将断电！")
        power_off()
        # 这里加一个break，避免重复断电；也可以不加，让程序继续监测
        break 
    else:
        print("电流正常，10秒后继续监测...")
    
    # 每隔10秒检查一次（不要太频繁，保护设备和网络）
    time.sleep(10)

四、进阶与优化：让方案更可靠

如果你觉得上面的死循环脚本在断电或重启后就没了，或者想更专业一点，可以考虑下面几种方案：

部署在云端/本地服务器（Docker）你完全可以把这个Python脚本打包成一个Docker镜像，运行在办公室的NAS或者任何一台Linux服务器上。芯步的设备支持局域网本地控制，如果你的服务器和设备在同一个网段，可以不经过云端直接下发指令，延时几乎为零。
利用Webhook/回调（推荐）一直在问“电流多少了？”其实挺费资源的（虽然HTTP请求还好）。更优雅的方式是利用芯步平台的规则引擎。
- 你可以在后台设置一个规则：“当设备A的插孔3电流大于8A时，触发Webhook”。
- 你的服务器只需要提供一个接收通知的接口。当PDU电流过大时，平台会自动调用你的接口，告诉你有异常了，你再通过API去断电。
- 好处：不用写轮询代码，响应更及时，且节省API调用次数。
故障隔离与重试机制参考华为PDU的设计理念，过流断开是为了保护设备。
- 锁定机制：一旦因为过流断电，在你的程序里加一个flag（标志位）。不要让它因为电流降下来了又自动通电，这样反复通断可能损坏设备。最好需要人工去后台确认故障排除后，再手动或者通过另一个接口恢复供电。

五、总结

用芯步的PDU做二次开发，体验还是比较顺滑的，因为它的接口足够开放。

核心代码：无非就是 Get（读电流） 和 Post（发指令） 两个动作。
部署：如果追求稳定，放在服务器上跑，利用好局域网控制功能。

你可以先拿着Postman（接口调试工具）测试一下开关指令，成功了再写代码。官方后台有10分钟对接指南，配合上面的逻辑，很快就能跑起来。