怎样接入5位总控插排来实现设备总电源批量管控_解决方案

CATALOG

芯步的5位总控插排（智能PDU）与传统分控版本不同——它只有一路继电器控制整个插排的总电源，但通过HTTP接口的批量参数设计，依然可以实现对五路输出端口的精准批量管控。以下方案涵盖接口对接、签名计算、指令下发到业务集成的完整流程。

解决方案：基于芯步开放接口实现5位总控插排的设备电源批量管控

1. 概述

对于IDC机房、实验室或多设备办公场景，对多台设备（如服务器、路由器、测试仪器）进行统一的电源重启或能耗管理至关重要。芯步的智能PDU 5位[总控]（型号：UNI-PDU-ZK-5）虽然总控开关只有一个物理继电器，但结合其开放接口的批量处理能力，我们可以通过软件逻辑实现“单个指令控制单个插孔”或“一键控制所有插孔”的灵活管理。

本方案将指导你利用设备的 HTTP 接口，在无需网关的情况下，将插排集成进你的现有系统中。

2. 核心对接准备

在开始编码前，请确保完成以下硬件与软件准备：

硬件设备：芯步智能PDU 5位[总控]（UNI-PDU-ZK-5）一台，已接入 2.4G Wi-Fi 网络。
平台凭证
- AppID：在芯步控制台创建应用后获取。
- AppSecret：用于加密签名，保障通信安全。
- Device ID：插排通电联网后在控制台获取的唯一标识。
接口地址https://api.thingboot.com/{AppID}/device/control/

3. 接口鉴权与签名机制

芯步的接口采用动态签名防盗用，所有请求必须携带 sign 和 ts（时间戳）。签名生成规则如下（以 Python 为例）：

签名算法

sign = MD5( MD5(AppSecret) + ts )

安全提示

确保终端设备与服务器时间同步，否则会因时间戳误差导致签名失效。
严禁将 AppSecret 硬编码在前端或客户端中，应在业务后端完成签名和请求转发。

4. 总控设备的接口命令映射

虽然该设备物理上只有一个总控开关，但接口协议将其抽象为5个逻辑线路，支持独立控制。核心参数在 order 字段中定义。

关键参数对照表：

逻辑线路	命令字段	对应值及含义	功能描述
插孔1	`power1`	`"1"` (开), `"0"` (关)	控制第1个插孔的通断电
插孔2	`power2`	`"1"` (开), `"0"` (关)	控制第2个插孔的通断电
插孔3	`power3`	`"1"` (开), `"0"` (关)	控制第3个插孔的通断电
插孔4	`power4`	`"1"` (开), `"0"` (关)	控制第4个插孔的通断电
插孔5	`power5`	`"1"` (开), `"0"` (关)	控制第5个插孔的通断电

除了简单的开关，还支持定时脉冲指令（非常适合用于重启路由器等网络设备）：

先通后断{"point":"3000"} -> 立即通电，3秒后断电。
先断后通{"reset":"3000"} -> 立即断电，3秒后重启通电。

5. 批量管控的三种实现模式

针对5位插排，依据不同管理粒度，可采用以下三种对接策略：

模式一：单插孔独立控制 (精细化管控)

如果你的服务器有主备之分，或需要单独重启某个故障设备，可以针对特定 powerN 字段下发指令。

场景：仅关闭插孔3上的打印机，保持其他设备运行。
请求示例
POST /{AppID}/device/control/?sign=xxx&ts=1734567890 { "device": "设备ID", "order": {"power3": "0"} }

模式二：全量批量控制 (一键全局操作)

当需要下班断电或紧急关机时，可以通过在一个 order 对象中同时包含所有线路指令，实现“一键关所有”。

场景：关闭所有5个插孔。
请求示例
{ "device": "设备ID", "order": { "power1": "0", "power2": "0", "power3": "0", "power4": "0", "power5": "0" } }

模式三：顺序启动与时序控制 (防浪涌)

多台设备同时通电会产生巨大浪涌电流，可能跳闸。利用接口的先断后通功能，可以编写脚本实现“丢包式”顺序启动。

场景：每隔2秒依次启动插孔1至插孔5。
实现逻辑（后端代码思路）：
循环 i 从 1 到 5：下发指令 {"power" + i: "1"}等待 2000ms

6. 代码实战示例 (Python)

以下代码演示了如何通过 Python 脚本实现上述签名机制及批量重启操作。

import hashlib
import time
import requests
import json

# 配置信息
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

def generate_sign():
    # 1. MD5加密 AppSecret
    md5_app_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    # 2. 获取当前时间戳 (秒级)
    ts = str(int(time.time()))
    # 3. 拼接并再次MD5
    sign_str = md5_app_secret + ts
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

def control_pdu(commands):
    """
    控制PDU插排
    :param commands: dict, 例如 {"power1":"1", "power5":"0"}
    """
    sign, ts = generate_sign()
    
    payload = {
        "device": DEVICE_ID,
        "order": commands
    }
    
    # 拼接URL
    url = f"{API_URL}?sign={sign}&ts={ts}"
    headers = {"Content-Type": "application/json"}
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    print(f"Status Code: {response.status_code}")
    print(f"Response: {response.text}")

# ----- 业务调用示例 -----

# 1. 重启插孔2上的设备 (断电1秒后恢复)
print("正在重启端口2...")
control_pdu({"reset": "1000"})  # 注意:reset指令针对整个设备时可能重启全体，具体测试为准。
# 更稳妥的单路重启（如果是分控板）:control_pdu({"power2": "0"}); time.sleep(2); control_pdu({"power2": "1"})

# 2. 关闭所有端口
print("正在关闭所有端口...")
control_pdu({
    "power1": "0", "power2": "0", "power3": "0", "power4": "0", "power5": "0"
})

# 3. 仅开启机柜散热风扇（假设接在插孔4）
print("正在开启散热设备...")
control_pdu({"power4": "1"})

7. 高级集成与排障

状态同步（Webhook推荐）不要完全依赖开关的即时反馈。在芯步控制台中配置消息服务器（Webhook） 。当有人按插排物理按钮或执行了远程操作时，平台会主动推送设备当前状态到你的服务器，确保数据库状态与设备真实状态一致。
网络稳定性该设备支持设定5组WiFi。如果现场环境复杂，在接口中预先配置多个AP信号，设备会自动漫游切换，防止因WiFi波动导致控制指令丢失。
私有化部署（安全环境）若数据安全级别比较高（如政务内网），可向芯步申请私有化部署方案。接口协议不变，仅将 Host 指向本地服务器即可。
常见报错处理
- Code 401：签名错误。请检查 AppSecret 是否正确，以及服务器时间是否与标准时间同步。
- Code 404：设备不在线。PDU 依靠 WiFi 连接，检查设备是否掉电或 WiFi 信号强度。
- 无响应：检查 Content-Type 是否严格设置为 application/json。

通过以上方案，您可以快速利用芯步5位总控插排的开放接口，实现从“单点开关”到“智能化批量电源管理”的升级。