怎样接入智能5位总控PDU以实现总路过流自动断电控制_解决方案

CATALOG

芯步的智能PDU通过开放HTTP接口，支持实时电流采集和远程控制。以下方案基于其总控系列产品的接口特性，设计了一套完整的“检测-判断-执行”自动化保护流程。

1. 解决概述

本方案的目标是利用芯步智能PDU（如UNI-PDU-ZK-8等总控系列）的开放API接口，构建一套自动化的电源负载保护机制。

核心逻辑： 系统通过轮询或事件监听的方式，实时获取PDU总路（或回路）的实时电流值。当检测到电流超过预设的安全阈值（如额定值的90%预警，100%动作）时，系统自动向PDU下发“总路断电”指令，切断电源，从而保护后端设备免受大电流冲击或预防火灾风险。

适用场景：

无人值守机房（防止服务器短路导致火灾）。
共享空间/自习室（控制总功率防止跳总闸）。
智慧农业/工业自动化（电机过载保护）。

2. 技术准备与接口分析

要实现上述控制，需利用芯步开放平台的以下两类核心接口能力。

2.1 设备状态查询接口（获取电流）

开发文档规定了标准的HTTP API调用方式。

请求方式：GET / POST
接口路径https://api.thingboot.com/{AppID}/device/status
核心参数
- device: 目标PDU的设备唯一ID。
- sign 和 ts: 用于身份验证的签名和时间戳。
返回数据解析：接口返回的JSON数据中需解析 current_load（当前总负载电流），单位为安培。

2.2 设备控制接口（执行断电）

芯步的设备支持极速响应的HTTP命令下发。

请求方式：POST
接口路径https://api.thingboot.com/{AppID}/device/control
核心参数
- device: 设备ID。
- order: 命令字符串，对于总控PDU，控制总闸开关的命令通常为 {"total_power":"0"} （0代表断电，1代表上电）。

2.3 签名机制

开发需注意签名计算规则。所有请求都需要携带 sign 参数，通常是将 AppID、AppSecret、ts 及参数进行MD5或哈希加密。这是确保接口安全、防止恶意控制的关键。

3. 方案实施步骤

为实现总路过流自动断电，采用“轮询检测 + 阈值断路器”的逻辑。

3.1 环境搭建与设备接入

注册开发者账号：在芯步开放平台注册，获取AppID和AppSecret。
添加设备：在控制台通过扫描PDU二维码或手动输入SN码，将PDU绑定至账号下，记录下 device_id。
网络配置：确保PDU通过Wi-Fi（2.4G频段）或以太网正常联网，且能访问公网API（若为局域网部署，则需指向私有化部署的消息服务器地址）。

3.2 自动断电逻辑实现（核心代码逻辑）

你需要在服务器或具备后台运行能力的设备（如树莓派、云服务器、NAS）上运行一个脚本。由于芯步接口支持任何支持HTTP请求的编程语言，以下提供 Node.js 和 Python 的伪代码逻辑。

逻辑流程：

设定阈值（例如：总电流 > 20A 触发保护）。
调用查询接口获取电流。
判断：如果电流超过阈值，则调用控制接口发送“关”命令。
记录日志并发送告警（如邮件或钉钉通知）。

示例：Node.js 实现方案

利用 node-fetch 或 axios 库，结合芯步的接口规范进行控制。

const axios = require('axios');
const crypto = require('crypto');

// 配置参数 (芯步平台获取)
const CONFIG = {
    appId: 'YOUR_APP_ID',
    appSecret: 'YOUR_APP_SECRET',
    deviceId: 'PDU_DEVICE_ID',
    thresholdCurrent: 20.0, // 阈值:总电流超过20A则跳闸
    apiBase: 'https://api.thingboot.com' // 公有云API地址，私有化部署时替换内网IP
};

// 生成签名 (参考芯步官方文档签名算法示例)
function generateSign(params, secret) {
    // 具体实现需根据官方文档，通常为字典排序后拼接secret进行md5
    // 此处仅示意
    return crypto.createHash('md5').update(params + secret).digest('hex');
}

// 1. 获取PDU当前状态(总电流)
async function getCurrentLoad() {
    const ts = Date.now();
    const sign = generateSign(`appId=${CONFIG.appId}&ts=${ts}`, CONFIG.appSecret);
    
    const response = await axios.get(`${CONFIG.apiBase}/${CONFIG.appId}/device/status`, {
        params: {
            device: CONFIG.deviceId,
            ts: ts,
            sign: sign
        }
    });
    
    // 假设返回数据中 current_load 字段代表总电流
    // 具体字段名需参照芯步官方API文档
    if(response.data && response.data.status === 'success') {
        return parseFloat(response.data.data.current_load); 
    }
    throw new Error('获取电流失败');
}

// 2. 下发断电命令 (总控)
async function cutOffPower() {
    const ts = Date.now();
    const order = JSON.stringify({ total_power: "0" }); // 总控断电命令
    const sign = generateSign(`appId=${CONFIG.appId}&device=${CONFIG.deviceId}&order=${order}&ts=${ts}`, CONFIG.appSecret);
    
    const response = await axios.post(`${CONFIG.apiBase}/${CONFIG.appId}/device/control`, null, {
        params: {
            device: CONFIG.deviceId,
            order: order,
            ts: ts,
            sign: sign
        }
    });
    
    console.log('断电指令已发送', response.data);
    // 可在此添加告警推送逻辑
}

// 3. 巡检任务
async function monitoringTask() {
    try {
        const current = await getCurrentLoad();
        console.log(`当前总负载电流: ${current}A`);
        
        if(current > CONFIG.thresholdCurrent) {
            console.warn(`触发过流保护！电流 ${current}A > 阈值 ${CONFIG.thresholdCurrent}A，即将断电。`);
            await cutOffPower();
        }
    } catch (error) {
        console.error('监控异常:', error.message);
    }
}

// 启动轮询 (每5秒检查一次，具体频率可视风险等级调整)
setInterval(monitoringTask, 5000);

3.3 高级策略：防抖与自动重合闸

为了避免电流瞬间波动导致频繁跳闸（例如电机启动瞬间电流很大），在逻辑中加入“防抖机制”：

延时确认：当第一次检测到过流时，不立即跳闸，而是间隔1秒后再次读取电流（二次确认）。若2-3次连续检测均过流，再执行断电。
锁定与恢复：过流断电后，系统不应自动恢复（除非人工确认故障排除），但对于某些非关键场景，可以设定5分钟后尝试 {"total_power":"1"} 恢复供电，如果恢复瞬间再次过流，则永久锁定并发送紧急告警。

4. 硬件特性与保护策略

芯步智能PDU（总控系列）具备一些硬件原生特性，结合本方案可以获得更好的效果：

4.1 主动过载保护

虽然芯步PDU内部可能具备熔断或空开保护，但通过软件实现的前置保护（Soft Protection）响应速度更快，且可记录日志。软件保护可以在电流达到额定值90%时发出预警通知，在100%时断电，避免直接触发硬件空开导致“硬损坏”。

4.2 阈值配置

在软件逻辑中，必须为阈值设置临界区。

预警阈值：例如额定电流的 80%。此时只发通知短信，不断电。
动作阈值：例如额定电流的 100% 或 110%。此时触发断电逻辑。这种分级策略能有效平衡可用性与安全性。

5. 接口安全与运维

私有化部署：对于对延迟敏感或安全要求比较高的内网环境，芯步支持私有化部署方案。你可以将消息服务器部署在本地局域网，此时 api_base 指向本地服务器地址。这样，即使外网断开，过流保护逻辑依然生效。
日志审计：利用芯步接口返回的数据，建立数据库记录每一次的电压、电流波动。一旦发生跳闸，可回溯跳闸前5分钟的电流曲线，快速定位是“哪一台设备”的接入导致了过流。

6. 总结

通过芯步提供的标准HTTP开放接口，开发者只需具备基础的编程能力（发送GET/POST请求），即可快速实现针对5位总控PDU的过流自动断电保护。本方案不仅提升了设备的安全性，也为远程无人值守场景提供了智能化的运维手段。