如何接入智能PDU[分控]|8位以实现分路开关控制8台设备电源_解决方案

CATALOG

芯步智能PDU（8位分控）提供开放的HTTP接口，使开发者能够通过简单的API调用实现远程电源管理。以下方案涵盖从环境准备、接口鉴权到分路控制、状态监控的完整接入流程。

一、解决概述

本方案的目标是指导开发者如何利用芯步开放的API接口，将智能PDU[分控]|8位设备集成到现有的软件系统（如机房动环监控系统、办公管理平台、自助终端控制后台）中。通过集成，您可以实现对8台独立设备的远程开机、关机、重启以及电源状态监测，从而替代人工现场操作，提升运维效率。

二、准备工作与环境搭建

在开始编写代码之前，需要完成硬件配网与密钥获取，这是实现通信的基础。

硬件准备：确保智能PDU已上电，并插入有效SIM卡或连接至2.4G WiFi网络。
注册与登录：访问芯步官网，注册开发者账号。
设备配网
- 登录后进入“物联网控制台”。
- 在“网络配置”中添加现场的2.4G WiFi名称和密码。
- 使用手机热点或特定方式为设备配置网络，直至设备指示灯停止闪烁（表示上线成功）。
获取凭证：在控制台获取您的 AppID 和 AppKey（或签名密钥），这是后续API调用的身份标识。

三、核心技术接口解析

芯步的开放接口采用标准的HTTP协议，无需复杂的SDK，任何支持HTTP请求的编程语言均可调用。

3.1 接口鉴权机制

为了防止非法控制，每次请求需携带签名。请求URL结构通常如下：https://api.yoyoiot.net/device/v1/control/{AppID}/{DeviceID}

必填参数说明

AppID：在控制台生成的唯一应用标识。
DeviceID：智能PDU的设备序列号（在控制台或设备标签上查看）。
ts： Unix时间戳，用于防止重放攻击。
sign：签名串。
- 签名算法：通常为 md5(AppID + DeviceID + ts + AppKey)。将四个字符串拼接后进行MD5哈希计算。

3.2 核心指令：分路开关控制

该PDU的核心功能是针对8个插位的独立控制。

接口地址： /device/v1/control/{AppID}/{DeviceID}
请求方法： POST 或 GET
请求参数
- command：固定为 power。
- socket：指定插位，取值范围 1 至 8。
- status：动作指令，1 为开启，0 为关闭。

示例：关闭第3号插位的设备如果不通过官方SDK，直接使用浏览器或代码请求如下URL：https://api.yoyoiot.net/device/v1/control/APP_123456/DEVICE_881212?ts=1734567890&sign=xxxxxxx&command=power&socket=3&status=0

3.3 拓展指令：全量与状态查询

全量控制：通过一次请求控制所有插位，通常可以使用组播或循环调用接口实现，通过interval参数设置继电器吸合间隔，避免瞬间电流冲击。
状态查询：用于获取当前设备电压、电流以及每个插位的开关状态。
- 指令： command=status

四、代码接入实战

以下将以 Python 和 Java 为例，演示如何实现上述认证与控制逻辑。代码包含动态生成签名、错误处理及核心控制函数。

4.1 签名生成逻辑

无论是Python还是Java，第一步都需要编写生成签名的方法。签名规则为 sort(params matter)+ AppKey 进行MD5加密。根据芯步的通用规范，以下是一个标准的接入代码块。

Python 实现示例

import hashlib
import time
import requests

# 配置参数
APP_ID = "YOUR_APP_ID"
APP_KEY = "YOUR_APP_KEY"
DEVICE_ID = "YOUR_PDU_DEVICE_ID"
API_URL = "https://api.yoyoiot.net/device/v1/control"

def control_socket(socket_num, action):
    """
    控制指定插位的电源
    :param socket_num: 插位号 (1-8)
    :param action: 动作 (1:开, 0:关)
    """
    timestamp = str(int(time.time()))
    
    # 1. 构建待签名字符串 (注意:参数需按字典序排序)
    # 根据芯步通用鉴权规范:将请求参数值拼接
    raw_str = f"{APP_ID}{DEVICE_ID}{timestamp}{APP_KEY}"
    sign = hashlib.md5(raw_str.encode()).hexdigest().lower()
    
    # 2. 构建请求参数
    params = {
        "appId": APP_ID,
        "deviceId": DEVICE_ID,
        "ts": timestamp,
        "sign": sign,
        "command": "power",
        "socket": socket_num,
        "status": action
    }
    
    # 3. 发送GET请求
    try:
        response = requests.get(API_URL, params=params, timeout=10)
        if response.status_code == 200:
            result = response.json()
            if result.get("code") == 200:
                print(f"成功: 插位 {socket_num} 已{‘开启’ if action else ‘关闭’}")
            else:
                print(f"控制失败: {result.get(‘msg’)}")
        else:
            print(f"HTTP异常: {response.status_code}")
    except Exception as e:
        print(f"网络错误: {e}")

# 示例:重启第2个插位 (先关再开)
def reboot_socket(socket_num):
    control_socket(socket_num, 0)  # 关闭
    time.sleep(2)                  # 等待2秒断电缓冲
    control_socket(socket_num, 1)  # 开启

Java 实现示例

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class PDUController {
    private static final String APP_ID = "YOUR_APP_ID";
    private static final String APP_KEY = "YOUR_APP_KEY";
    private static final String DEVICE_ID = "YOUR_DEVICE_ID";
    private static final String BASE_URL = "https://api.yoyoiot.net/device/v1/control";

// MD5加密工具函数
    private static String md5(String s) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] bytes = md.digest(s.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : bytes) {
                sb.append(String.format("x", b));
            }
            return sb.toString();
        } catch (NoSuchAlgorithmException e) {
            throw new RuntimeException(e);
        }
    }

public static void control(int socket, int status) {
        long ts = System.currentTimeMillis() / 1000L;
        String raw = APP_ID + DEVICE_ID + ts + APP_KEY;
        String sign = md5(raw);
        
        String url = String.format("%s?appId=%s&deviceId=%s&ts=%d&sign=%s&command=power&socket=%d&status=%d",
                BASE_URL, APP_ID, DEVICE_ID, ts, sign, socket, status);
        
        Request request = new Request.Builder().url(url).get().build();
        try (Response response = new OkHttpClient().newCall(request).execute()) {
            if (response.isSuccessful()) {
                // 解析JSON响应逻辑
                System.out.println("控制指令发送成功");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

五、高级应用与场景

防止电流浪涌（时序启动）机房重启时，若8台设备同时启动，瞬时电流可能过大。在发送批量开启命令时，代码中增加延时循环。策略：每个插位间隔 500ms 启动，即 for i in 1..8: control_socket(i, 1); sleep(0.5)。这不仅保护了电源模块，也保护了后端设备电源。
心跳与断网重连芯步设备支持WiFi连接。若网络不稳定，开启设备的“离线定时”或利用API定期（如每5分钟）查询设备状态（command=status）。若发现设备离线，系统可触发告警或尝试重连机制。
局域网直连与私有化如果您的服务器与PDU处于同一个局域网段，且注重外网断开时的稳定性，芯步设备支持私有化部署。可以在控制台开启“局域网模式”，通过本地IP地址直接调用HTTP接口，不经过云端。

六、总结

通过接入芯步智能PDU的开放API，您可以快速实现“硬件即服务”的落地。整个过程仅需遵循标准的HTTP协议进行签名交互，即可将8位独立控制的电源插座位集成至您的业务流中。无论是用于机房服务器重启、远程实验室设备管理，还是共享设备（如快递柜、充电桩）的电源控制，该方案都能提供稳定、高效的技术底座。

如果在对接过程中遇到设备配网失败或签名错误，优先检查时间戳同步性及WiFi的2.4G频段模式。