这是一份关于对接芯步智能总控PDU(5位)的技术解决方案。我会尽量写得详细、口语化,方便你们的开发或运维人员直接上手。
一、 我们先来明确一下“战场情况”
在开始写代码之前,我们得先搞清楚手里拿的是“总控”还是“分控”。根据你提到的型号,针对的是 智能PDU5位[总控] (型号:UNI-PDU-ZK-5)。
总控 vs 分控:“总控”意味着虽然插排上有5个孔位,但这5个孔位是“同生共死”的。你没法单独控制第1路开、第2路关。只要一发指令,5个孔位全部执行同样的动作。
核心优势:虽然简单粗暴,但最适合我们要做的“集中一键控制”。如果非要独立控制,那得去买该系列的“分控”版本,但今天我们聊的是总控,就按这个逻辑来。
二、 准备工作:硬件配网(这一步得先搞定)
要让代码控制硬件,得先把PDU拉上网。芯步这点做得比较友好,支持局域网私有化和公网控制。个人,如果是机房或内部使用,直接用局域网模式,速度飞快且没有延迟感。
简单三步走:
通电:把PDU插上电,等待指示灯进入待配网状态(通常是慢闪)。
配网:用微信小程序“芯步”或者电脑登录物联网控制台。
写入WiFi:在控制台里找到“网络配置”,输入你现场的2.4G WiFi密码(注意,不支持5G频段的WiFi,现在很多路由器双频合一,记得在路由器设置里分开,或者用手机2.4G热点测试)。
关键点:配网成功后,记下那个设备ID(通常是一串数字字母组合,比如 pdu_5zk_001),这就是你设备的“身份证”。
三、 核心环节:HTTP接口对接(程序员请看好)
芯步的接口确实挺开放的,不需要复杂的SDK,就是标准的HTTP请求。总控PDU的控制命令通常比较简单。
1. 接口逻辑
既然5个孔是同进退的,那接口命令里基本不会有 outlet_id 参数,直接是针对整机的开关。
开: 让5个孔全部通电。
关: 让5个孔全部断电。
2. 请求示例
假设我们要做一个“一键重启所有设备”的功能(先关再开)。
场景:机房里的服务器卡死了,你坐在工位上想重启第1路到第5路的所有电源。
步骤一:下发“关闭”命令
你需要向芯步的API地址发送一个POST请求。
URL:
http://{你服务器的IP或云平台地址}/open/api/device/control/Header
Content-Type: application/jsonAppID: xxxxx(从控制台获取,你的应用ID)Sign: xxxxx(签名,一般是AppID+设备ID+时间戳+Token的MD5,这个在官方文档签名章节有标准算法)
Body
步骤二:间隔几秒,下发“开启”命令
3. 如何实现“一键”?
这里稍微口语化一点。所谓的“一键集中控制”,其实就是前端界面上一个大大的圆形按钮。
逻辑伪代码:
为了提高用户体验,你还可以做一个“轮询”或者“状态刷新”。总控PDU也是支持查询状态的。你可以每隔5秒发一个查询指令: