如何接入5位远程控制PDU来实现场景联动总控电源_解决方案

CATALOG

芯步智能PDU支持完整的HTTP API接口，可以通过签名鉴权对每个插座进行独立控制。以下方案涵盖接口接入、签名计算、场景联动配置三个核心环节，可直接用于系统集成开发。

1. 项目概述与目标

在数据中心、实验室或智能机房等场景中，设备的管理往往面临物理位置分散、应急响应慢、能源浪费等问题。本方案的目标是利用芯步5位/8位分控智能PDU及其开放API接口，构建一套总控联动系统。

核心目标：

集中总控：通过一个软件平台，同时管理多达5台独立的设备电源。
场景联动：实现“一键开机”、“一键关机”或特定的时序启动（如先开路由器，再开服务器）。
远程运维：无需人工到场，即可远程重启死机设备，结合定时任务节约能源。

2. 核心技术架构

基于芯步提供的免费HTTP接口，采用标准的AppID + Sign(签名) + Ts(时间戳)鉴权机制。

该架构支持局域网本地控制和互联网远程控制，适用于任何支持HTTP请求的编程语言（如Python, Java, Go, Node.js）或低代码平台。

架构逻辑流：

用户控制端 (Web/App) -> 业务服务器 (处理签名与逻辑) -> 芯步云API -> 5位PDU设备 (执行通断)

3. 硬件与接口准备

3.1 硬件准备

智能PDU（5位分控）：芯步标准款，支持5路独立控制，总控款无法独立控制各插座，必须使用分控款。
网络环境：2.4GHz WiFi网络，PDU需注册上线至芯步控制台。

3.2 接口鉴权准备

在开始编程前，需要从芯步控制台获取以下凭证，用于构造请求签名（Sign）

AppID：应用唯一标识。
AppSecret：开发者密钥（绝不能暴露在前端）。
Device ID：PDU设备的唯一ID（通常贴在设备外壳或控制台内）。

3.3 签名算法

这是对接中最关键的一步，芯步采用双层MD5加密策略来保证接口调用的安全性。公式如下：Sign = MD5( MD5(AppSecret) + Ts )

注：公式中的 + 代表字符串拼接。

4. 场景联动总控实现

为了实现“场景联动总控”，我们可以将物理按钮或一个总控界面，映射为如下几个核心API命令。由于PDU支持单路精确控制，我们可以灵活组合。

4.1 单路控制（基础动作）

这是所有联动的基础接口。例如控制第1路插座通电。

请求URL： https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
Method： POST
Headers： Content-Type: application/json
Body (JSON)

4.2 场景联动：一键全部开机

当所有设备需要启动时，无需逐条发送5次命令，可以利用PDU的批量控制指令（Batch Control），极大节省网络开销并保证同步性。

指令逻辑：将5位端口全部设置为通电状态。
Order参数

*释义：relay数组指定了要控制的端口位（1-5），power:1执行开启动作。*

4.3 场景联动：时序启动（防止浪涌）

在机房环境中，所有设备同时通电会产生巨大的浪涌电流，可能跳闸。总控系统应支持时序启动。虽然基础API支持立即通断，但业务层可通过编程逻辑实现“顺序启动”。

业务代码逻辑（伪代码示例）：

1. 发送命令:打开端口1（路由器/核心交换机）
2. 等待 10秒
3. 发送命令:打开端口2（存储设备）
4. 等待 30秒
5. 发送命令:批量打开端口3、4、5（计算节点）

这种“联动”非常适合嵌入到自动化脚本或Node-RED等流式编程工具中。

4.4 应急联动：远程重启死机设备

这是PDU最实用的功能。当监控系统检测到某台服务器无响应时，系统可自动调用API执行“重启”动作（即先断电，再延时通电）。

操作指令
1. 下发 {"power2":"0"} （断开端口2电源）。
2. 延时 5秒（可根据设备电容放电特性调整）。
3. 下发 {"power2":"1"} （重新接通电源）。

5. 实战：代码示例（Python）

以下是一个基于Python的总控联动函数，集成了签名生成、单控和总控逻辑。此脚本可直接运行在树莓派或任何云服务器上作为联动中枢。

import hashlib
import time
import requests
import json

# --- 配置信息（请替换为控制台实际内容）---
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的PDU设备ID"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"
# ------------------------------------------

def generate_sign(secret, ts):
    """生成接口签名"""
    # 1. MD5(AppSecret)
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 2. MD5(md5_secret + ts)
    sign_str = md5_secret + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign

def control_pdu(order_json):
    """下发指令至PDU"""
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    params = {
        "sign": sign,
        "ts": ts
    }
    
    payload = {
        "device": DEVICE_ID,
        "order": order_json
    }
    
    try:
        response = requests.post(API_URL, params=params, json=payload, timeout=10)
        print(f"状态码: {response.status_code}")
        print(f"响应: {response.text}")
        return response.json()
    except Exception as e:
        print(f"错误: {e}")
        return None

# --- 场景联动逻辑示例 ---
if __name__ == "__main__":
    print(">>> 1. 执行批量总控:开启所有端口")
    control_pdu({"batch": {"relay": [1,2,3,4,5], "power": 1}})
    
    time.sleep(2)
    
    print("\n>>> 2. 执行场景全关（下班/收工）")
    # 也可以单独发 {"batch": {"relay": [1,2,3,4,5], "power": 0}}
    control_pdu({"power1":"0", "power2":"0", "power3":"0", "power4":"0", "power5":"0"})
    
    print("\n>>> 3. 模拟自动化联动:服务器看门狗")
    print("检测到服务器Ping不通，执行端口3重启...")
    control_pdu({"power3":"0"})
    time.sleep(5)
    control_pdu({"power3":"1"})

6. 总结

通过对接芯步的5位远程控制PDU，我们实现了以下价值：

接口灵活性：只需HTTP POST请求即可完成复杂的【场景联动】，无需购买昂贵的中间件。
总控策略：利用batch指令实现毫秒级全开全关；利用业务代码逻辑实现精准的时序上电，确保设备安全。
运维自动化：结合监控脚本，系统具备了“自愈”能力，能在设备死机时自动远程硬重启。

此方案可直接复制粘贴代码进行测试，无需网关中转，实施门槛低，适合快速集成进现有的机房动环系统或智能家居中枢中。

注：以上代码示例中的签名算法与命令格式基于芯步标准产品手册。实际开发中请注意保管AppSecret，严禁在客户端代码中暴露。