如何接入分控PDU(5位)以实现分路开关控制5台设备电源_解决方案

CATALOG

芯步的5位分控PDU通过HTTP接口对外暴露控制能力，单条指令即可独立控制任一路电源的开关状态。以下方案涵盖配网准备、接口调用、批量控制及状态反馈的完整实现路径。

本方案的目标是指导开发者或系统集成商，利用芯步智能PDU（5位分控） 的开放API接口，实现对5台独立设备的远程电源控制。通过HTTP请求，您可以对PDU上的任意一个或多个插座位进行独立的开关、重启或批量操作。

适用场景：服务器机房远程重启、自动化测试设备电源管理、无人值守站设备运维、智能家居/办公设备分控。

核心技术点：通过向 api.thingboot.com 发送携带签名和特定参数的命令，操作 power1 至 power5 字段。

在开始编码前，需完成物理设备的初始化，这是接口调用的前提。

硬件上电与配网
- 将PDU接通电源，确保其指示灯处于待配网状态（通常为闪烁）。
- 使用微信小程序“芯步”或登录官网控制台，为设备配置2.4G Wi-Fi网络。PDU支持5组Wi-Fi热备份，确保网络稳定性。
获取关键凭证
- 登录芯步官网，进入“工作台” -> “物联网控制台” -> “开发设置”，记录 AppID 和 AppSecret（用于生成签名）。
- 在“设备列表”中找到已接入的PDU，记录其唯一的 DeviceID（设备ID）。
接口寻址
- 请求地址：http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
- 注意：开发测试阶段可在控制台打开“调试模式”忽略签名校验；生产环境需严格计算sign签名以保证安全性。

该PDU支持单路控制、多路批量控制及高级定时重启。

您可以分别控制5个插座的通断。参数 power1 对应第1个插座，以此类推至 power5。

命令示例（关闭第1路设备）
{ "device": "这里填写PDU的设备ID", "order": { "power1": 0 } }
命令示例（打开第3路设备）
{ "device": "PDU_Device_ID", "order": { "power3": 1 } }
代码片段（Python requests库实现）
import requests # 参数配置 app_id = "YOUR_APP_ID" device_id = "YOUR_PDU_DEVICE_ID" # 控制第2路开启 payload = { "device": device_id, "order": {"power2": 1} } # 需携带签名，此处仅为Body示例 url = f"https://api.thingboot.com/{app_id}/device/control/?sign=xxx&ts=xxx" response = requests.post(url, json=payload)

在需要重启所有设备或切换指定多路状态时，可使用 batch 命令以降低网络开销。

第一种场景：一键关闭所有电源（Emergency Shutdown）
{ "device": "ID", "order": { "power": 0 } }
（此处power不带数字代表所有位）
第二种场景：仅关闭第1、3、5路
{ "device": "ID", "order": { "batch": { "relay": [1, 3, 5], "power": 0 } } }
第三种场景：自动重启（定时通断）假设某一台网络设备死机，需要断电1分钟后重启（先断开，再闭合）：
{ "device": "ID", "order": { "reset": { "relay": [2], "interval": 60000 } } }
（该命令将断开第2路，等待60秒后自动重新接通）

由于HTTP请求返回的code 200仅代表指令被云端接收，并不代表设备实际执行成功（设备可能离线）。必须通过消息推送来获取设备的真实状态。

假设您有一个由5台服务器组成的机柜，通过本PDU供电。需求：监测到“服务器A”无响应时，远程强制重启。逻辑实现

检测：您的监控脚本检测到服务器A Ping不通或服务端口未响应。
动作：脚本调用API接口，发送针对 power1 的指令：
- 先发送 {"power1": 0}（断电）。
- 等待10秒（sleep(10000)）。
- 再发送 {"power1": 1}（通电）。
记录：接收异步推送的状态码，确认电源已按预期执行，并在日志中记录此次重启操作。

签名错误（sign error）：生产环境下需严格按照官方文档计算MD5签名，常见错误是将参数按字典序排列时遗漏了ts（时间戳）或AppSecret。开发阶段请开启“调试模式”绕过验证进行快速测试。
指令下发成功但设备不动
- 检查PDU的Wi-Fi信号强度，弱信号可能导致指令丢失。
- 确认命令参数格式是否为字符串或整型（接口文档中 power1:0 有时需带引号）。
设备离线：PDU仅支持2.4G Wi-Fi，请确认5G Wi-Fi名称与密码未误配。