怎么接入5位远程控制PDU以实现集中控制5路设备电源_解决方案

CATALOG

芯步的智能PDU开放标准HTTP接口，通过简单的API调用即可实现远程电源控制。以下方案以5位总控PDU为例，涵盖接口对接、签名计算、批量控制等关键环节，开发者约30分钟即可完成集成。

1. 背景与概述

在现代数据中心、自动化工作站及无人值守机房中，对多台设备电源进行远程集中控制是运维管理的刚需。传统的人工现场通断电不仅效率低下，且无法应对突发故障（如设备死机）的快速恢复需求。

本方案基于 芯步 5位智能PDU（产品型号：UNI-PDU-ZK-5），利用其开放的 HTTP 接口，实现任意支持网络请求的编程语言（Java, Python, PHP, Node-RED等）或物联网平台对5路独立电源的远程控制。该方案支持公有云远程控制，也支持局域网本地化/私有化部署，无需网关，设备直连WiFi 2.4GHz网络。

2. 硬件与接口特性

2.1 硬件规格

控制路数：5位（5个新国标插座）。
额定功率：单孔位最大支持 1500W，总额定功率 3000W (MAX 10A)。
控制精度：支持独立控制每一位插座的通断，即“分控”逻辑。
通讯方式：WiFi 2.4GHz (IEEE 802.11 b/g/n)，直连路由器，无需额外网关。

2.2 开放接口能力

芯步提供的API具有比较高的集成友好性，核心优势如下：

协议简单：基于 HTTPS POST 请求，数据格式为 JSON。
鉴权清晰：采用 MD5 双重加密签名（Sign），有效防止重放攻击。
批量控制：单次 API 调用支持同时控制多个设备或多个插孔。
实时反馈：接口同步返回执行结果，亦可配合设备状态查询接口获取当前功率、开关状态。

3. 接入流程与实施步骤

要实现对5路设备的集中控制，需经历以下三个阶段：环境准备、接口调试、系统集成。

3.1 第一阶段：设备配网与就绪

在代码开发前，需确保 PDU 在线。

注册与登录：访问芯步官网或使用“芯步小程序”注册企业/开发者账号。
设备配网
- 将 PDU 通电。
- 在“物联网控制台”或小程序中，选择“添加设备” -> “智能PDU[总控]|5位”。
- 输入现场 2.4G WiFi 的密码，通过声波或热点模式完成配网。
- 确认设备状态显示为“在线”。此时，控制台会生成唯一的 设备ID (Device ID)，如 184771991。

3.2 第二阶段：接口鉴权与协议解析

芯步的接口安全机制基于 AppID 和动态 Sign。任何控制指令都需要携带以下参数。

核心参数说明：

AppID / AppSecret：在控制台“开发设置”中获取，用于标识开发者身份。
ts：当前 Unix 时间戳（秒），用于防止请求重放。
Sign：动态签名。
- 计算公式Sign = MD5( MD5(AppSecret) + ts )
- 步骤拆解
  1. 将 AppSecret 进行第一次 MD5 加密，得到字符串 S1。
  2. 将 S1 与时间戳 ts 进行字符串拼接，得到 S2。
  3. 对 S2 再次进行 MD5 加密，得到最终的 Sign。
Device：目标设备ID。
Order：控制指令（JSON 字符串）。

3.3 第三阶段：控制指令设计（5路独立/集中控制）

针对5位PDU，order 参数是关键。接口文档定义了 power 字段的用法。

场景 A：独立控制（控制第 x 路）

如果你的业务需要分别控制每一路（例如只关掉第3路连接的交换机），协议如下：

开启第1路order 值为 {"power1":1}
关闭第3路order 值为 {"power3":0}
开启第5路order 值为 {"power5":1}

场景 B：批量控制（一键全开/全关）

如果你需要实现集中管理的核心诉求（如同时重启5台设备），使用以下指令以减少网络请求：

全开（所有5路通电）order 值为 {"power":1} 或 {"power1":1,"power2":1,"power3":1,"power4":1,"power5":1}
全关（紧急断电）order 值为 {"power":0}

3.4 代码实战示例（Python）

以下示例展示了如何封装 HTTP 请求来重启第2路设备（先关后开）。

import requests
import hashlib
import time
import json

# 1. 配置参数（从控制台获取）
AppID = "YOUR_APP_ID"
AppSecret = "YOUR_APP_SECRET"
DeviceID = "YOUR_PDU_DEVICE_ID"  # 5位PDU的设备ID

# 2. 生成签名 (Sign)
def generate_sign(secret):
    ts = str(int(time.time()))
    # 第一次MD5
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 拼接时间戳并第二次MD5
    sign_str = md5_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

# 3. 发送控制指令
def control_pdu(order_cmd):
    sign, ts = generate_sign(AppSecret)
    
    url = f"https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}"
    
    payload = {
        "device": DeviceID,
        "order": order_cmd  # 传入JSON对象
    }
    
    headers = {'Content-Type': 'application/json'}
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    return response.json()

# 4. 业务逻辑:远程重启第2路设备（模拟断电再通电）
if __name__ == "__main__":
    print("正在关闭第2路电源...")
    # 关闭指令:power2 = 0
    result_off = control_pdu({"power2": 0})
    print("关闭结果:", result_off)
    
    time.sleep(3)  # 等待3秒，模拟设备放电或机械响应
    
    print("正在开启第2路电源...")
    # 开启指令:power2 = 1
    result_on = control_pdu({"power2": 1})
    print("开启结果:", result_on)

4. 高级集成与运维

4.1 本地化部署（内网控制）

对于数据安全要求比较高的机房，避免数据经过外网是非常必要的。芯步 PDU 支持 局域网通信。

实现的方式是：只要你的服务器与 PDU 连接在同一个路由器/交换机下，API 请求可直接指向 PDU 的本地 IP（需在控制台开启局域网模式或解析设备本地 IP）。
优势：控制指令响应速度提升至毫秒级，且完全脱离互联网运行。

4.2 设备状态监测（运维闭环）

单纯的“远程开关”是不够的，结合 状态查询接口（如 device/status）配合使用。

电流/电压监测：查询5路设备当前的实时负载功率。如果某一路设备死机，其电流往往会进入异常低值或恒定值，可通过程序判定自动触发重启。
离线告警：若 PDU 断网，接口会返回超时，系统应自动通知运维人员检查机柜供电。

4.3 跨平台集成

Node-RED / HomeAssistant：由于是标准 HTTP 接口，可直接通过 HTTP Request 节点接入，编写简单的 function 节点计算 Sign 即可。
小程序/APP：芯步的 HTTP 接口支持跨域，可直接在前端 JS 中调用（需注意 AppSecret 前端暴露风险，由后端代理签名）。

5. 总结

通过接入芯步 5位智能PDU的开放接口，可以在不改变现有网络结构的前提下，快速构建一个集中电源管控系统。

效率提升：运维人员无需亲临现场，即可通过脚本实现5台设备的批量开机、重启或顺序上电。
自动化：结合监控脚本，可实现“故障即重启”的自愈机制。
灵活性：既支持公有云 API 的便捷调用，也支持局域网私有化的安全对接。