怎样二次开发8位智能分控PDU以实现分路开关控制8台设备电源_解决方案

CATALOG

芯步8位智能分控PDU提供完整的HTTP API接口，支持独立控制每个插座的通电与断电。以下方案涵盖接口准备、签名计算、代码实现到高阶应用的全流程，帮助你在现有系统中快速集成远程电源管理能力。

解决方案：基于芯步智能PDU的二次开发实现8路独立电源控制

1. 背景与目标

在现代数据中心、实验室或自动化机房中，经常需要对多台服务器或网络设备进行远程重启、定时开关或顺序上电。芯步的 8位智能分控PDU 允许您通过网络独立控制每一个插座，但官方提供的通用控制台可能无法直接满足个性化的业务逻辑。本文将指导开发者利用其开放的 HTTP API 接口，将PDU集成到自有系统中，实现对8台设备电源的精准控制。

2. 技术准备与核心原理

硬件：芯步8位智能分控PDU（已连接Wi-Fi）。
接口协议：HTTPS / HTTP POST请求。
核心原理：通过向芯步云端服务器（或局域网服务器，若支持私有化）发送携带设备ID和控制指令的HTTPS请求，服务器下发指令给PDU，从而控制对应插座的继电器通断。

3. 二次开发关键步骤

3.1 获取关键凭证

在开始编码前，需要进行初始配置：

注册与登录：访问芯步官网注册账号并登录。
配网：按照产品手册，通过“物联网控制台”或小程序将PDU接入2.4G Wi-Fi网络。
获取凭证（至关重要） ：
- 在控制台获取 AppID 和 AppSecret（开发者密码/密钥）。
- 查看已添加的设备，获取目标PDU的 Device ID。

3.2 理解签名机制

为了安全，API请求需要进行签名加密。根据官方规范，签名算法如下

$\text{Sign} = \text{MD5}\left( \text{MD5}(\text{AppSecret}) + \text{ts} \right)$

其中：

ts是当前Unix时间戳（秒级）。
AppSecret 需先进行一次MD5加密得到一个32位字符串，再拼接时间戳，最后对整个字符串再次进行MD5。

这种双重加密机制能有效防止请求被篡改。

3.3 API 接口调试

请求地址https://api.thingboot.com/{AppID}/device/control/
请求方法：POST
HeadersContent-Type: application/json
参数结构

3.4 指令格式映射

针对您 “分路控制8台设备” 的需求，请参考以下 order 参数指令集

操作目标 (第x路)	JSON指令 (`order` 值)	功能说明
控制第1路	`{"power1":1}`	开启插口1（给设备上电）
关闭第1路	`{"power1":0}`	关闭插口1（给设备断电）
控制第2路	`{"power2":1}`	开启插口2
...以此类推	...	...
控制第8路	`{"power8":1}`	开启插口8
批量控制	`{"batch":"11111110"}`	一次性控制8个口，1开0关
重启设备	`{"point":"3"}`	先断后通，重启第3路设备

4. 代码实现示例

以下基于 Python 和 Bash (cURL) 展示如何实现控制逻辑。

Python 实现示例该脚本封装了核心的签名计算和请求发送逻辑，适合集成到现有的Python后端服务中。

import requests
import hashlib
import time
import json

class YoYoPDU:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret

def _generate_sign(self, ts):
        # 第一步:md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 第二步:md5(step1 + ts)
        step2 = hashlib.md5((step1 + str(ts)).encode()).hexdigest()
        return step2

def control_socket(self, device_id, socket_num, action):
        """
        action: 1为开启, 0为关闭
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"https://api.thingboot.com/{self.app_id}/device/control/"
        params = {
            "sign": sign,
            "ts": ts
        }
        # 构建指令，例如 power1: 1
        order_cmd = {f"power{socket_num}": action}
        payload = {
            "device": device_id,
            "order": json.dumps(order_cmd)  # 注意这里要转为json字符串
        }
        
        response = requests.post(url, params=params, json=payload)
        return response.json()

# 使用示例
if __name__ == "__main__":
    # 初始化 (替换为真实数据)
    pdu = YoYoPDU(AppID="你的AppID", AppSecret="你的AppSecret")
    
    # 控制第3路开启电源
    result = pdu.control_socket(device_id="设备ID", socket_num=3, action=1)
    print(result)

Bash/cURL 命令行实现如果您需要通过脚本直接调用，可以使用此 Shell 版本。它完整演示了签名计算与请求发送的全过程。

5. 进阶应用架构

为了实现更健壮的“二次开发”，您不要仅仅编写简单的脚本，而是构建一个中间层服务，架构如下：

前端/业务系统 (如监控平台、工单系统) → 您的后端控制服务 (Python/Java/Node.js) → 芯步 API → PDU设备

为什么需要中间层？

多设备管理：您的系统中可能不止一台PDU。中间层可以维护所有Device ID和对应的物理位置映射。
权限与审计：在此层控制谁可以执行“重启服务器”操作，并记录每次断电行为。
自动化逻辑：集成监控告警，例如“Ping不通服务器A -> 自动调用API关闭第1口 -> 等待10秒 -> 开启第1口”，实现自动化故障恢复。
环境适应：支持局域网私有化控制。如果安全要求比较高，可选购私有化版本，将API请求地址指向局域网内的自建服务器，完全脱离外网。

6. 总结

通过芯步开放的HTTP接口，开发者可以像调用普通REST API一样轻松控制硬件。关键在于：

正确计算 MD5 签名以通过鉴权。
熟悉 powerX 或 batch 等 Order 指令。
设计 中间件架构 将物理控制转化为业务逻辑接口。

按照上述方案，您可以在几小时内完成从配网到代码调用的全过程，实现8台设备的远程智能电源管理。