如何二次开发智能远程控制5位总控PDU以实现总开关控制5台设备电源_解决方案

CATALOG

一、概述

本方案基于芯步智能PDU（总控/5位）产品的开放HTTP接口，通过二次开发实现总开关一键控制5台设备电源的功能。该方案适用于机房设备管理、实验室仪器控制、远程办公设备维护等场景。

核心能力：开发者可使用任意支持HTTP请求的编程语言（Python、Java、Node.js、Go等）调用芯步开放API，实现对PDU各孔位的独立控制及批量控制。

二、硬件产品介绍

2.1 设备型号

产品型号：UNI-PDU-ZK-5
控制路数：总控（5个孔位独立可控）
额定功率：单孔位1500W，总额定功率3000W

2.2 关键特性

特性	说明
通信方式	WiFi 2.4GHz（无需网关，直连路由器）
控制接口	HTTP API（开放）
批量控制	单条命令支持多孔位同时控制
金属外壳	铝合金材质，散热良好

三、API接口说明

芯步平台开放完整的HTTP接口，设备控制的核心请求格式如下

3.1 请求地址

POST https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}

3.2 核心参数

参数	类型	说明
AppID	string	应用ID，在控制台获取
sign	string	请求签名，用于身份验证
ts	int	当前Unix时间戳（秒）
device	string	设备唯一ID，可在控制台查看
order	JSON string	控制命令

3.3 签名算法

sign = MD5( MD5(AppSecret) + ts )

即：先将AppSecret进行MD5加密，再拼接时间戳，最后对整个字符串再做一次MD5。

3.4 控制命令格式

四、二次开发实现方案

4.1 系统设计

┌─────────────────────────────────────────────────────────┐
│                      应用层                              │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐   │
│  │ Web页面 │  │ 手机APP │  │ 小程序  │  │ 定时任务 │   │
│  └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘   │
├────────┴───────────┴───────────┴───────────┴───────────┤
│                    业务逻辑层                            │
│  ┌─────────────────────────────────────────────────┐   │
│  │           总控开关逻辑模块                        │   │
│  │  • 查询当前各孔位状态                            │   │
│  │  • 批量生成控制命令                              │   │
│  │  • 执行结果汇总                                  │   │
│  └─────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────┤
│                    API封装层                             │
│  ┌─────────────────────────────────────────────────┐   │
│  │           芯步API SDK                        │   │
│  │  • 签名生成  • 请求发送  • 响应解析              │   │
│  └─────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────┤
│                    硬件设备层                            │
│  ┌─────────────────────────────────────────────────┐   │
│  │    芯步智能PDU（5位总控）                    │   │
│  │    孔位1 │ 孔位2 │ 孔位3 │ 孔位4 │ 孔位5        │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

4.2 API封装模块（Python示例）

import hashlib
import time
import json
import requests

class YoYoPDUController:
    """芯步PDU控制器封装类"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, timestamp):
        """生成请求签名"""
        # 第一层MD5加密AppSecret
        first_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 拼接时间戳
        combined = first_md5 + str(timestamp)
        # 第二层MD5
        sign = hashlib.md5(combined.encode()).hexdigest()
        return sign
    
    def _send_command(self, device_id, order_dict):
        """发送控制命令"""
        timestamp = int(time.time())
        sign = self._generate_sign(timestamp)
        
        url = f"{self.base_url}?sign={sign}&ts={timestamp}"
        payload = {
            "device": device_id,
            "order": json.dumps(order_dict)
        }
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def control_single_outlet(self, device_id, outlet_num, on=True):
        """控制单个孔位"""
        power_key = f"power{outlet_num}"
        command = {power_key: 1 if on else 0}
        return self._send_command(device_id, command)
    
    def control_all_outlets(self, device_id, on=True):
        """控制全部5个孔位"""
        command = {f"power{i}": 1 if on else 0 for i in range(1, 6)}
        return self._send_command(device_id, command)

4.3 总控开关核心逻辑实现

class MasterSwitchController:
    """总控开关控制器"""
    
    def __init__(self, pdu_controller, device_id):
        self.pdu = pdu_controller
        self.device_id = device_id
        self.outlet_count = 5
    
    def master_on(self):
        """总开关开启:同时开启所有设备"""
        print(f"正在开启全部{self.outlet_count}台设备电源...")
        result = self.pdu.control_all_outlets(self.device_id, on=True)
        print(f"执行结果:{result}")
        return result
    
    def master_off(self):
        """总开关关闭:同时关闭所有设备"""
        print(f"正在关闭全部{self.outlet_count}台设备电源...")
        result = self.pdu.control_all_outlets(self.device_id, on=False)
        print(f"执行结果:{result}")
        return result
    
    def master_restart(self, delay_seconds=2):
        """总重启:先关后开，实现设备重启"""
        print("正在执行设备群重启...")
        # 步骤1:关闭所有设备
        off_result = self.pdu.control_all_outlets(self.device_id, on=False)
        if not self._is_success(off_result):
            return {"error": "关闭设备失败", "detail": off_result}
        
        # 步骤2:等待指定时间
        time.sleep(delay_seconds)
        
        # 步骤3:开启所有设备
        on_result = self.pdu.control_all_outlets(self.device_id, on=True)
        return {
            "action": "restart",
            "delay_seconds": delay_seconds,
            "off_result": off_result,
            "on_result": on_result
        }
    
    def selective_master(self, device_ids, on=True):
        """选择性总控:控制指定的一组设备"""
        if not device_ids:
            return {"error": "请指定要控制的设备孔位"}
        
        command = {f"power{i}": 1 if on else 0 for i in device_ids}
        return self.pdu._send_command(self.device_id, command)
    
    def get_device_status(self):
        """获取设备状态（需配合设备状态查询接口）"""
        # 注:状态查询需调用相应的设备信息接口
        pass
    
    def _is_success(self, result):
        """检查API调用是否成功"""
        return result.get("code") == 0 or result.get("status") == "success"

4.4 Web控制端示例（Flask）

from flask import Flask, render_template, request, jsonify

app = Flask(__name__)

# 配置信息（从环境变量或配置文件读取）
APP_ID = "your_app_id"
APP_SECRET = "your_app_secret"
DEVICE_ID = "your_device_id"

# 初始化控制器
pdu = YoYoPDUController(APP_ID, APP_SECRET)
master = MasterSwitchController(pdu, DEVICE_ID)

@app.route('/')
def index():
    """控制面板页面"""
    return render_template('pdu_control.html')

@app.route('/api/master/on', methods=['POST'])
def api_master_on():
    """总开关-开启"""
    result = master.master_on()
    return jsonify(result)

@app.route('/api/master/off', methods=['POST'])
def api_master_off():
    """总开关-关闭"""
    result = master.master_off()
    return jsonify(result)

@app.route('/api/master/restart', methods=['POST'])
def api_master_restart():
    """总开关-重启"""
    delay = request.json.get('delay', 2)
    result = master.master_restart(delay)
    return jsonify(result)

@app.route('/api/outlet/<int:num>/<action>', methods=['POST'])
def api_outlet_control(num, action):
    """单孔位独立控制"""
    on = action.lower() == 'on'
    result = pdu.control_single_outlet(DEVICE_ID, num, on)
    return jsonify(result)

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000, debug=True)

4.5 前端控制页面示例（HTML/JS）

<!DOCTYPE html>
<html>
<head>
    <title>智能PDU总控系统</title>
    <style>
        .master-control { text-align: center; margin: 20px; }
        .master-btn { 
            font-size: 24px; padding: 15px 30px; margin: 10px;
            border: none; border-radius: 8px; cursor: pointer;
        }
        .btn-on { background-color: #4CAF50; color: white; }
        .btn-off { background-color: #f44336; color: white; }
        .btn-restart { background-color: #ff9800; color: white; }
        .outlet-grid { display: grid; grid-template-columns: repeat(5, 1fr); gap: 10px; margin-top: 30px; }
        .outlet-card { border: 1px solid #ddd; padding: 15px; text-align: center; border-radius: 8px; }
        .outlet-led { width: 20px; height: 20px; border-radius: 50%; margin: 0 auto 10px; }
        .led-on { background-color: #4CAF50; box-shadow: 0 0 5px #4CAF50; }
        .led-off { background-color: #999; }
    </style>
</head>
<body>
    <h1 style="text-align: center;">智能PDU远程电源管理系统</h1>
    
    <div class="master-control">
        <h2>总控开关（控制全部5台设备）</h2>
        <button class="master-btn btn-on" onclick="masterControl('on')">一键开启全部</button>
        <button class="master-btn btn-off" onclick="masterControl('off')">一键关闭全部</button>
        <button class="master-btn btn-restart" onclick="masterControl('restart')">一键重启全部</button>
    </div>
    
    <div class="outlet-grid" id="outletGrid">
        
    </div>
    
    <div id="status" style="text-align: center; margin-top: 20px;"></div>
    
    <script>
        const outletCount = 5;
        
        function initOutlets() {
            const grid = document.getElementById('outletGrid');
            grid.innerHTML = '';
            for (let i = 1; i <= outletCount; i++) {
                grid.innerHTML += `
                    <div class="outlet-card">
                        <div class="outlet-led led-off" id="led${i}"></div>
                        <h3>设备 ${i}</h3>
                        <button onclick="outletControl(${i}, 'on')" style="background:#4CAF50">开启</button>
                        <button onclick="outletControl(${i}, 'off')" style="background:#f44336">关闭</button>
                    </div>
                `;
            }
        }
        
        async function masterControl(action) {
            const endpoints = { on: '/api/master/on', off: '/api/master/off', restart: '/api/master/restart' };
            showStatus(`正在执行${action}操作...`);
            
            const response = await fetch(endpoints[action], { method: 'POST' });
            const result = await response.json();
            showStatus(`${action}操作完成: ${JSON.stringify(result)}`);
        }
        
        async function outletControl(num, action) {
            showStatus(`正在控制设备${num} ${action === 'on' ? '开启' : '关闭'}...`);
            const response = await fetch(`/api/outlet/${num}/${action}`, { method: 'POST' });
            const result = await response.json();
            showStatus(`设备${num}操作完成: ${JSON.stringify(result)}`);
        }
        
        function showStatus(msg) {
            document.getElementById('status').innerHTML = `<p>${msg}</p>`;
        }
        
        initOutlets();
    </script>
</body>
</html>

五、部署配置步骤

5.1 前期准备

注册账号：访问芯步官网注册企业/开发者账号
创建工作台：登录后创建物联网工作台
获取凭证：在控制台的"开发设置"中获取AppID和AppSecret

5.2 设备配网

方式一（电脑端）：在物联网控制台中添加现场WiFi（2.4GHz频段），通过手机热点为设备配置网络
方式二（小程序）：使用"芯步小程序"扫码完成配网

5.3 部署应用程序

六、扩展功能

6.1 定时任务控制

可通过芯步平台自带的定时任务功能或自行集成APScheduler实现：

6.2 设备状态监控

结合设备状态查询接口，实现电源状态的实时监控和异常告警。

6.3 集成第三方平台

HomeAssistant：可参考相关实现方式，通过命令行开关集成
Node-RED：利用HTTP Request节点快速搭建控制流

七、注意事项

网络安全：API签名使用MD5双重加密，在生产环境中启用HTTPS并妥善保管AppSecret
设备负载：总额定功率3000W，使用前请确认接入设备总功率不超过限制
网络环境：设备仅支持2.4GHz WiFi，确保路由器开启对应频段
接口限流：注意API调用频率限制，避免频繁请求导致被封禁
异常处理：在代码中加入重试机制和异常捕获，提高系统稳定性

八、总结

本方案基于芯步智能PDU开放的HTTP接口，实现了总开关控制5台设备电源的核心功能。通过二次开发，开发者可以快速构建Web端、移动端或桌面端的远程电源管理系统，实现设备的集中控制、定时任务和状态监控。整个开发过程门槛较低，支持任意编程语言，可灵活集成到现有IT管理系统中。

一、概述

二、硬件产品介绍

2.1 设备型号

2.2 关键特性

三、API接口说明

3.1 请求地址

3.2 核心参数

3.3 签名算法

3.4 控制命令格式

四、二次开发实现方案

4.1 系统设计

4.2 API封装模块（Python示例）

4.3 总控开关核心逻辑实现

4.4 Web控制端示例（Flask）

4.5 前端控制页面示例（HTML/JS）

五、部署配置步骤

5.1 前期准备

5.2 设备配网

5.3 部署应用程序

六、扩展功能

6.1 定时任务控制

6.2 设备状态监控

6.3 集成第三方平台

七、注意事项

八、总结

插排产品方案：

如何在共享棋牌室设备机柜电源管理中接入智能硬件来实现自定义总控联动逻辑

餐厅设备机柜电源控制：怎样把8位远程控制PDU接入到软件项目中

仓储设备机柜电源管理：怎么将8位机柜总控PDU对接到自己的项目中

酒店客房设备机柜电源管理：怎么把8位分控插排接入到自己的项目中

数据中心机柜电源能耗管理：怎么把5位智能分控PDU对接到软件项目中

电源场景方案：

大功率设备电源管理：怎样将带计量智能断路器50A集成到项目中

如何二次开发4 路智能照明控制器来实现定时开关照明设备电源

如何在设备机房远程运维电源管理中对接智能设备以实现故障告警通知

自助售货机电源管理：怎样将AC1-10A电器开关集成到软件项目中

便利店收银机电源管理：怎么将60A带计量远程智能空开集成到软件项目中

5台用途方案：

怎样在创客工坊设备机柜电源控制中对接智能设备来实现总开关控制5台设备电源

怎么在车间设备机柜电源控制中集成智能硬件来实现分路开关控制5台设备电源

怎样在设备机房远程管理中集成智能设备以实现总开关控制5台设备电源

如何在餐厅设备机柜电源控制中对接智能硬件以实现总开关控制5台设备电源

怎样在产线自动化机柜电源管理中对接智能硬件来实现分路开关控制5台设备电源