CATALOG

这是一个关于如何将芯步的智能PDU(分控)集成到自有管理系统中的方案。我假设你是一个负责楼宇智能化或者IT运维的负责人,有一定编程基础,但不是专门做嵌入式开发的。

方案:把写字楼设备机柜“锁”进你的系统里

主题: 基于芯步智能PDU(5位/8位)的HTTP接口对接实战针对产品: 芯步 智能PDU[分控] (适用于5位/8位标准机柜插座)

一、 为啥要用接口管起来?

咱们写字楼的机柜,以前设备重启或者跳闸,哪怕是个小交换机死机了,你也得拿着一串钥匙亲自跑进弱电间去拔插头。如果机柜放在地下室或者远端楼层,更让人头大。

咱们的目标很简单:把这个物理的插排,变成你代码里的一个“对象”。通过芯步的开放接口,以后不管是服务器死机了,还是摄像头没画面了,你先点一下鼠标远程“断电-通电”,大概率 80% 的问题就这么解决了,不用动腿,动动手指就行。

二、 准备工作

在写代码之前,先把物理设备弄上线。芯步的设备上电后,需要通过WiFi或网线连网。

  1. 硬件上架:把PDU固定到机柜后背板上,插上电。

  2. 配网

    • 下载“芯步”小程序或者在电脑端登录物联网控制台。

    • 用小程序里的“配网”功能,把现场的 2.4G WiFi 账号密码通过蓝牙或声波配置进设备里(如果用的是有线版,直接插网线DHCP自动获取就行)。

    • 关键点:设备必须和你未来的服务器在同一个局域网,或者设备能上网(云端模式),如果你要局域网纯内网控制,记得在控制台开启“私有化部署”模式

  3. 获取CID:在控制台的后台,找到这台刚添加的PDU,你会看到一个设备ID。记下这个数字,这就是它的身份证。

三、 核心玩法:HTTP接口怎么调?

这个方案比较爽的地方在于,他们没搞复杂的SDK,就是简单的 HTTP请求 。意味着不管你用 Python,Java,还是 Node.js,甚至是用 Windows 的计划任务写个命令行,都能控制

1. 先搞到钥匙登录芯步工作台,去“开发设置”里:

  • AppID:你的账号ID。

  • AppSecret:你的密码。

  • 注意:本地测试阶段,可以把“调试模式”打开,这样就不用算复杂的 MD5 签名了,直接发请求就行,比较省事儿

2. 看一眼接口地址URL 结构长这样:http(s)://api.thingboot.com/{AppID}/device/control/?sign={签名}&ts={时间戳}

如果是内网部署,把域名换成你私有化服务器的 IP 就行。

3. 怎么写代码?假设我们要控制机柜里那台总是卡死的门禁服务器,它插在 PDU的第3号位

场景 A:重启第3号插口(先断后通)很多网络设备直接断电再给电,会自动启动。我们需要发送一个“先断后通”的命令。

场景 B:某台开发测试服务器下班了要省电,直接关闭第5号插口

从官方文档看,power1power8分别对应那五个(或八个)插孔

4. 轮询状态光控不行,还得看电流。你可以定时发请求去查这个PDU的状态,看看是空载(设备挂了)还是电流过大(短路了)。通常接口会返回每个插位的实时功率和电流,这个数据很有用。

四、 实战小脚本

我用 Python 写个最简单的例子,你可以放到你的服务器上跑,或者集成到你现有的 OA 后台里。

五、 落地避坑指南

在实际项目中,有几个点需要注意一下,不然可能会踩坑:

  1. 关于 5位 vs 8位你说的是“5位”,但他们官网产品多是 8位 。没关系,不管是几位,控制逻辑都是一样的。如果是 5位设备,order 里的 power6 命令会无效或报错,记得先通过 获取设备信息 的接口拉一下配置。

  2. 局域网依赖问题既然是写字楼机柜,网络稳定性是关键。强烈用有线版如果用 WiFi,万一机柜附近信号干扰大,你连不上 WiFi 也就控制不了电源了,这比较尴尬。如果必须用 WiFi,保证信号强度。

  3. 自建消息服务器如果你对实时性要求很高,不想走云端绕一圈(虽然云端也挺快),可以在你的服务器上部署一个 MQTT 或 HTTP 服务端芯步的设备支持“私有化”,直接让 PDU 把数据往你内网的一台服务器 IP 上推,断网了也能本地闭环控制

  4. 安全机制千万记得设置 IP 白名单。你的控制服务器 IP 加到后台白名单里,只有这台服务器能发指令改电源,防止哪个好事者抓包模拟请求把总闸给拉了

六、 总结

这样一来,你的机柜管理就完全自动化了:

  1. 嵌入 OA 系统:员工离职或者服务器迁移,直接在工单系统里点一下,自动断电。

  2. 联动告警:配合 Zabbix 或 Prometheus,只要监控到路由器 PING 不通,自动触发这个脚本,重启对应的 PDU 端口。

  3. 能耗统计:定期拉取接口数据,看看哪个机柜耗电高,方便核算电费。

先把 PDU 装上机柜,连上网,调通第一个 power1=1 命令,后面的一切就顺理成章了。