弱电间机柜设备往往分散且数量多,一旦出现死机或过载,派人跑一趟机房只为了“重启一下”或“拔掉电源”,效率很低。芯步的5位总控PDU插排通过开放HTTP接口,可以将电源控制能力直接集成到你的现有系统中(如动环监控平台、IT运维系统或内部工单系统),实现远程重启、定时通断和用电监控。以下是具体的集成方案。
一、 核心集成思路(架构说明)
芯步的生态采用设备直连WiFi的模式,这意味着你的5位总控PDU不需要额外的网关硬件,可以直接通过你弱电间现有的2.4G WiFi网络与公网或内网服务器通信。
在集成架构上,通常采用 “业务系统/动环平台 -> 芯步开放API -> 智能PDU” 的链路。
由于支持私有化部署,如果你的弱电间处于纯内网环境(无公网IP),也可以将控制逻辑部署在本地服务器,保障数据不出机房。
二、 准备工作:获取API凭证
在开始编写代码前,需要在芯步开发者后台完成以下配置:
获取AppID与AppSecret:登录芯步工作台,在“开发设置”中获取。
AppID用于标识你的应用,AppSecret用于计算签名以保证接口安全。获取设备ID:将你的5位总控PDU(型号:UNI-PDU-ZK-5)添加至工作台后,控制台会为该设备分配唯一的
device标识(如:1878),后续所有指令都需要通过该ID定位目标。
三、 接口鉴权与调用流程
芯步的 API 接口通过动态签名(MD5)保证安全性。
请求地址: https://api.thingboot.com/{AppId}/device/control/请求方法: POST核心鉴权规则(以 Shell/Python 伪代码为例):
步骤1:将你的
AppSecret进行一次 MD5 加密。步骤2:获取当前的 Unix 时间戳
ts。步骤3:将步骤1的结果拼接上步骤2的字符串,再进行一次 MD5 加密,最终得到
sign。
签名计算公式本质上是 md5( md5(AppSecret) + ts )。
四、 针对5位总控PDU的集成命令详解
“总控” 意味着该 PDU 虽然拥有5个物理插孔,但在软件逻辑上通常作为一个整体或按线路索引进行控制。
根据产品手册,针对该 PDU 的控制命令主要通过 order 参数传递
1. 远程重启服务器(最常用场景)
当监控系统探测到某台交换机或服务器无响应时,系统自动调用此接口。
命令代码:
{"power1":0}(先断电) -> 等待5秒 ->{"power1":1}(再通电)参数解释:
power1代表第1个插孔(通常对应物理位置最左或标号1的孔位)。通过切换0(关)和1(开)实现重启。
2. 批量控制与定时任务
全开/全关
{"power":1}或{"power":0}。此命令会同时控制5个孔位的状态,适合下班后统一切断非核心设备电源以达到节能目的。自定义联动:结合环境传感器(如温度传感器),如果温度过高,自动下发
{"power5":0}强制关闭过热的设备,保护硬件安全。
五、 系统集成步骤详解(实战)
要将该PDU集成到你的弱电管理项目中,遵循以下流程:
步骤1:网络连通性配置
将PDU插排在弱电间上电,通过手机App或Web配网工具,为其配置弱电间的2.4G WiFi。注意:如果是企业级网络,请确保该WiFi所在的VLAN能够访问你的业务服务器或芯步公网API。
步骤2:封装控制服务(SDK层)
在你的后端服务中,封装一个通用的 PDUControl 函数。逻辑如下:
输入参数:设备ID,插孔号(1-5),动作(开/关/重启)。
自动生成动态
sign和ts。构造 JSON 数据:
{"device": "设备ID", "order": {"powerX": action}}。发送 POST 请求。
步骤3:集成到运维场景
场景A:自动巡检与自愈。在你的弱电运维系统中配置看门狗脚本。例如
Ping 网关失败,系统自动调用API重启对应PDU端口,成功率可达机器自动恢复。场景B:工单系统结合。在内部IT工单系统(如开源的Zabbix或自建平台)中增加“远程电源管理”按钮。工程师处理网络故障时,无需申请机房权限,直接在工单页面点击“重启端口”,系统调用API完成操作。
步骤4:接收设备状态(可选)
如果你需要做数据大屏或用电分析,该PDU支持实时状态上报。你可以在芯步控制台中配置消息推送地址(例如将消息推送到你的服务器http://your-server/api/receive)。当PDU的功率或开关状态变化时,芯步平台会主动将消息推送给你,实现双向数据同步。
六、 常见问题和需要注意的点
电力规格限制:该PDU总额定功率为3000W,单孔不超过1500W。在集成逻辑中,增加功率预检。若你的项目中有刀片服务器等高功率设备,需防止触发PDU的过载保护。
网络中断预案:该PDU依赖WiFi控制。在弱电间为PDU单独划分稳定的SSID,并在集成文档中注明:当网络中断时,PDU无法接收远程指令,仍需保留物理按钮操作作为应急手段。
私有化部署:如果你的项目对安全性要求比较高(如涉密机房),必须拒绝数据上公网。芯步支持私有化部署,你可以将消息服务器部署在内网,API请求地址指向内网IP,彻底与外网隔离。
通过以上集成,你的弱电间机柜管理将实现从“人工跑腿”到“软件定义电源”的转变。