CATALOG

芯步的8位远程控制PDU通过开放API接口,可以实现设备电源的远程通断控制、状态监控和自动化管理。以下方案从接口对接、集成流程到应用场景,帮你理清如何将PDU快速纳入现有运维体系。

1. 背景与概述

在现代企业机房运维中,频繁的设备重启、能耗管理以及安全防范是日常工作的重点。传统的机柜电源分配单元(PDU)仅具备电力分配功能,无法实现远程控制和实时监测。芯步提供的8位远程控制总控PDU,结合其开放的物联网接口,允许开发者将电源控制能力无缝集成到企业现有的运维系统、私有化部署平台或第三方监控软件中。

该方案的目标是解决以下痛点:

  • 远程运维难:设备死机或需要维护时,无需运维人员深夜赶往机房现场拔插电源。

  • 能源管理粗放:无法精确统计各设备的用电量,难以进行能耗优化和成本核算。

  • 系统孤岛:机房的动环监控系统与电源设备脱节,无法实现自动化联动。

通过集成芯步开放接口,您可以实现对机柜内8路独立端口的精细化权限管理定时任务以及异常自动断电

2. 核心技术能力

芯步的8位PDU设备具备以下核心开放能力:

功能模块技术参数/能力接口支持
远程控制单路/总路开关、重启、延时通电HTTP/MQTT
电力监测电压、电流、功率、实时能耗属性上报
安全保护过载保护、阈值告警事件回调
自动化定时任务、连锁触发云端逻辑
通信协议TCP/IP、MQTT、HTTP/HTTPSAPI/SDK

3. 接口集成方案设计

要将8位PDU集成到您自己的项目中,主要涉及设备认证、指令下发和数据订阅三个核心环节。

3.1 集成架构

推荐采用 “设备-云平台-应用服务器” 的标准物联网架构。

  1. 设备层:8位PDU通过4G/WiFi/以太网连接至芯步云端。

  2. 平台层:芯步开放平台处理设备连接、指令转发和数据存储。

  3. 应用层:您的业务系统(如OA、运维后台)通过调用OpenAPI或订阅MQTT消息与平台交互。

3.2 接口集成步骤

第一步:环境准备与认证

在芯步控制台获取开发必备信息:

  • AppID:用于标识您的应用项目。

  • AppSecret:用于接口签名加密的密钥。

  • 设备ID:PDU设备的唯一标识(在设备外壳或控制台获取)。

签名算法示例(Node.js/Python通用逻辑):系统要求每次请求需携带 signts(时间戳)。签名规则为:sign = md5( md5(AppSecret) + ts )这确保了接口调用的安全性,防止重放攻击

第二步:对接核心API:设备控制(下发指令)

这是集成过程中最核心的部分,用于远程开启或关闭PDU上的某个插口。

  • 接口地址http(s)://api.thingboot.com/{AppID}/device/control/

  • 请求方式:POST(推荐,指令参数较长)

  • 核心参数

    • device:PDU的设备ID。

    • order:命令内容。对于8位PDU,通常协议定义如下(依据产品手册):

      • 控制第1路开:{"power1": 1}

      • 控制第1路关:{"power1": 0}

      • 控制第8路重启:{"reset8": 1} (先断后通)

      • 全开:{"power": 1}

技术要点

  • 支持批量控制,device 字段可用逗号分隔多个ID,实现同时对多个机柜PDU操作。

  • 支持携带业务标识 extra,例如 {"power1":1, "extra":"work_order_001"}。当设备执行结果回调时,会携带该extra,方便业务系统做状态流转关联

第三步:获取设备状态与数据同步

您的项目需要实时展示电流、功率及端口开关状态。有两种实现路径:

  1. 主动查询(拉模式):调用设备状态接口,定时轮询获取PDU的最新数据。适用于展示类面板或非实时性要求较高的场景。

  2. 被动接收(推模式 - 推荐)

    • 在您的服务器搭建一个公网可访问的HTTP回调接口MQTT客户端

    • 在芯步控制台配置消息推送地址。

    • 当PDU状态变化(如电压过高、端口被手动按下)时,平台会实时推送数据到您的服务器。这种方式延迟最低,对服务器压力最小。

第四步:进阶开发:自动化与场景联动

利用芯步的云定时功能,或您自行开发逻辑:

  • 定时任务:通过API设置每周一至周五9:00开启某设备,18:00关闭,无需人工干预。

  • 联动策略:结合环境传感器(温度/烟雾)。例如,当机柜温度超过35°C时,自动调用接口开启风扇或关闭高负载设备。

4. 在自己项目中的落地流程

以下是将该PDU集成到“企业IT运维中心”系统的标准流程:

  1. 设备部署与配网

    • 将8位PDU安装进19英寸标准机柜。

    • 为PDU接入220V市电,并连接网线或配置WiFi。

    • 登录芯步控制台,将设备添加至工作台,记录下 设备ID

  2. 系统后端集成

    • 编写SDK模块:在您的后端代码中(Java/Go/Python),封装签名生成函数和控制API。

    • 数据库设计:在您的资产管理表中,增加 pdu_device_id 字段,将内部资产(如“核心交换机”)与PDU的第1端口绑定。

  3. 前端可视化界面开发

    • 控件设计:在运维界面上,为每个机柜生成8个开关按钮。使用绿色代表“通电”,灰色代表“断电”。

    • 实时看板:通过WebSocket连接后端,将PDU的电流、功率数据以图表形式在前端大屏展示。

  4. 异常处理机制

    • 离线检测:如果PDU断网,API调用会返回 code 200 仅表示平台收到指令,但设备实际未执行。您的系统应监听设备离线事件,并提示“设备不在线”。

    • 过载保护:监听平台推送的告警消息,当某端口电流超过设定阈值时,系统自动锁定该端口的开启操作并向管理员发送短信告警。

5. 应用场景举例

  • 第一种场景:无人值守机房自动重启当监控系统探测到某台服务器Ping不通时(死机),系统自动调用API:{"reset1":1},断开该服务器对应的第1端口电源,等待10秒后自动通电,实现无人值守重启。

  • 第二种场景:多用户机柜租用如果您是IDC服务商,将不同客户的设备放在同一机柜的不同位置。通过该系统,您可以给客户A分配“端口1-2”的权限,给客户B分配“端口3-4”的权限。客户登录自己的账号时,只能看到并控制属于自己的那2个电源端口(权限在您的业务系统根据Device ID和端口号进行逻辑隔离)。

  • 第三种场景:能耗账单统计每天通过API读取PDU的电量数据,结合企业内部的财务系统,计算出每个业务部门IT设备的电费成本。

6. 常见问题和需要注意的点

  1. 接口返回值200但设备没反应

    • 这是物联网系统中的正常现象。200仅代表指令被云平台接收且格式正确。如果设备离线,指令无法送达。解决方案是开启“消息推送”回调,若设备执行失败,您会收到一条执行失败的回调消息

  2. 网络稳定性

    • 如果您的机房网络环境极其严格(纯内网、不允许上公网),芯步支持私有化部署方案。即MQTT服务器和API服务器可以部署在企业内网,PDU设备只在内网通信,数据不外流

  3. 安全性

    • 所有的API调用必须使用动态签名机制,严禁在客户端代码中硬编码AppSecret。后端服务应作为代理,由前端通过内部接口调用,避免密钥泄露。

通过以上方案,您可以充分利用芯步PDU的开放能力,快速构建一套高效、安全、智能的企业机房电源管理系统。