芯步智能PDU（总控型）提供了开放的HTTP接口，支持通过API对8位输出端口进行独立控制、批量管理和时序操作。以下方案涵盖配网接入、接口调试、核心命令调用及系统集成，帮助快速实现设备总控管理。

解决方案：基于芯步开放接口的8位智能PDU设备总控管理接入方案

1. 背景与目标

在机房、数据中心或自动化控制机柜中，通常需要对多台设备的电源进行集中管理，包括远程重启、定时开关、用电监测及顺序上电。本方案基于芯步8位智能PDU（总控型），利用其开放的HTTP API接口，实现将物理设备无缝对接到您的现有IT运维平台、私有化系统或第三方业务软件中，达到对8个独立插位的状态感知、远程控制和策略化总控的目标。

2. 硬件准备与网络配置

在开始API对接前，需确保设备在线。

• 产品型号：UNI-PDU-ZK-8（总控型）。

• 通讯方式：设备仅支持 WiFi 2.4GHz 频段。无需网关，直连路由器。

• 配网流程

  1. 注册与创建：登录芯步官网，注册账号并创建“工作台”。

  2. 登记WiFi：在“物联网控制台” -> “网络配置”中，输入现场的2.4G WiFi名称和密码。

  3. 设备配网：长按PDU设备上的按钮进入配网模式（指示灯闪烁），通过手机热点或小程序将网络凭证推送给设备。

  4. 在线确认：配网成功后，设备会在控制台列表中显示为“在线”状态，此时即可获取设备ID。

3. 开放接口核心对接流程

芯步的开放接口基于HTTP协议，采用签名校验机制，支持任何支持HTTP请求的编程语言（Python, Java, Go, PHP等）。

3.1 接口鉴权参数（签名计算）这是接入的关键步骤，为保证安全性，每次请求需携带动态签名。

• AppID：在控制台“开发设置”中获取。

• AppSecret：开发者密码。

• ts：当前Unix时间戳（秒）。

• Sign（签名） 计算公式：

  $$Sign = md5( md5(AppSecret) + ts )$$

计算示例逻辑（Shell）：

1. 将AppSecret进行一次MD5加密。

2. 将第1步结果拼接上时间戳（纯字符串拼接）。

3. 将拼接后的字符串再次进行MD5加密，得到最终Sign。

3.2 核心请求地址

POST https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={ts}
Content-Type: application/json

3.3 基础请求体结构请求体为JSON格式，包含目标设备ID和指令

4. 设备总控管理指令详解

针对8位总控型PDU，您可以对总线路或单一路进行精细化控制。

4.1 单路独立控制如果您需要控制第2个插口的通断，指令如下：

• 开启第2路： "order": {"power2": 1} （1代表接通/开）

• 关闭第2路： "order": {"power2": 0} （0代表断开/关）

4.2 批量总控（全开/全关）如果您需要执行机柜整体下电或上电（如维护模式），使用批量指令：

• 全开： "order": {"power": 1} （操作所有8位）

• 全关： "order": {"power": 0}

4.3 高级运维指令（时序控制）对于服务器设备，突然断电或瞬间通电容易损坏电源。使用“先断后通”或“先通后断”功能实现远程重启或软启动。

• 先断后通：常用于远程重启死机的路由器或服务器。

  • "order": {"reset": "3000"}

  • 释义：先断开所有插位，等待3000毫秒（3秒）后，再自动重新接通电源。

• 先通后断

  • "order": {"point": "5000"}

  • 释义：先接通电源，等待5秒后再断开。常用于切换主备电源时的短暂切换。

4.4 状态查询与系统管理

• 查询状态：无需下发order，通常通过查询接口（需参考具体API文档）或通过平台消息推送获取当前各路电流、电压及开关状态。

• 软重启设备： "order": {"system": "restart"} （重启PDU主控系统，保持输出状态不变）。

5. 集成架构方案

采用以下架构将PDU纳入您的总控系统：

1. 后端微服务集成在您的业务后端中，封装一层 PDU Service。将上述的签名算法和控制指令封装成内部函数。业务逻辑（如：“宕机自动重启”）只需调用该服务，无需重复编写签名代码。

2. 私有化部署（可选）如果您的核心设备处于纯内网环境（无外网），芯步PDU支持私有化部署。您可以自建消息服务器（Broker），API请求在内网闭环完成，保障数据安全。

3. 对接流程逻辑

   • 自动化脚本：编写定时任务（Cron Job），每天早上8点发送 {"power": 1} 指令开启设备，下午18点发送 {"power": 0} 关闭设备，实现节能。

   • 联动策略：通过Ping检测服务器IP，若连续丢包，自动触发 {"reset": "10000"} 指令，尝试重启故障设备。

6. 总结

通过接入芯步8位智能PDU，您可以快速获得标准化的REST API控制能力。该方案利用简单的HTTP请求和MD5签名机制，将复杂的硬件控制转化为软件层面的函数调用，能够显著提升机房运维的自动化水平与响应效率。