CATALOG

芯步的智能PDU开放了标准的HTTP接口,这意味着你可以直接用任何编程语言调用,把它无缝集成到自己的管理后台或教室中控系统里。下面是一份对接方案,尽量讲得直白一些。

智慧教室设备机柜电源管理:如何将芯步智能PDU对接到自己的项目?

一、 为什么需要把PDU接到自己的系统里?

你肯定不想每次给设备断电都要跑到机柜前按按钮,或者在好几个APP之间来回切换。

把PDU的接口对接到你自己的管理平台后,就能实现:

  • 远程搞定一切:坐在办公室甚至在家,就能给教室的设备远程重启或断电。

  • 自动化联动:比如“一键下课”,PDU自动切断所有设备电源,不用挨个检查。

  • 实时监控:如果你用的是带计量功能的型号,还能在后台看到每路设备的功耗情况。

前提条件:你手头需要有 芯步的智能8位总控PDU(一般是 UNI-PDU-ZK-8 这款)。这款设备支持 2.4G WiFi,最重要的是,芯步开放了 HTTP 接口

二、 准备工作

在写代码之前,我们需要先把设备“点亮”并接入网络。

  1. 注册开发者账号:去芯步官网注册一个账号。登录后,在控制台里找到你的 AppIDAppKey,这个相当于你调用接口时的“用户名和密码”

  2. 设备配网

    • 给PDU插上电。

    • 用手机微信小程序搜索“芯步”,登录你的账号。

    • 在 App 里输入教室里的 2.4G WiFi 密码(注意,不支持 5G 频段),让 PDU 连上网

  3. 获取设备ID:在后台的设备列表里,你能看到一个唯一的设备编号(Device ID)。记下它,后面控制设备就靠它了。

三、 核心对接流程

芯步的接口设计得比较简单,不用搞复杂的SDK,直接发HTTP请求就行。

接口基本格式:请求地址通常指向:https://api.yoyoiot.com/open/device/v1/control签名机制:为了安全,除了传AppID设备ID,还需要通过一定的算法生成签名(sign),防止接口被别人随便调用。

1. 获取设备状态想知道当前8个插孔哪些是通电的,直接调用状态查询接口。后台会返回一串JSON数据,解析一下就能在前端界面显示出来,比如让按钮变绿或变灰。

2. 执行开关控制这是最常用的。假设你的服务器需要重启,但你人在外面,就可以发一条指令。

  • 目标:控制第3个插孔断电再通电。

  • 操作

    • 构建一个JSON请求体,包含deviceIdport(端口号,比如3),以及status(0代表关,1代表开)。

    • 发送POST请求。

    • 头部(Header)带上签名信息。

    • 命令发出大概几百毫秒后,PDU就“咔哒”一声执行动作了。

3. 设置定时任务(可选)学校的设备最好能自动管理。比如要求晚上11点教学楼断电图省电。你可以在自己的后端写一个定时脚本(Cron Job),每天晚上11点触发,调用PDU接口发送“全关”命令。完全不用人工干预。

四、 实操场景:集成到“智慧教室”后台

假设你正在开发一个教室中控大屏,想在界面上做一个“重启网络设备”的按钮。

你的前端代码逻辑大概是这样:

  1. 老师点击“重启路由器”按钮。

  2. 你的后端收到指令,拼装数据:

    • id 告诉PDU要动哪个口(比如第5口插着路由器)。

    • status 设为 0(关)。

  3. 等待 10 秒(给路由器缓冲时间)。

  4. 再次调用接口,status 设为 1(开)。

API请求示例(伪代码):

一切顺利的话,你会发现PDU第5口的指示灯灭了,几秒后又重新亮起。

五、 一些实用

  1. 关于网络:PDU连的是WiFi,一定保证教室里信号稳定,别把PDU塞在铁皮机柜最底层,四周全是网线,那信号容易不好。如果环境特殊,可以了解一下他们是否支持局域网私有化部署,这样控制指令不经过外网,速度更快更稳

  2. 时序问题:“总控”意味着你只能控制这8个孔一起开或一起关。如果需要每个孔单独控制(比如幕布降下来但投影机先不亮),你可能需要用“分控”型号。

  3. 调试工具:在对接初期,先用 Postman 之类的工具把接口调通,再去写代码,这样可以省很多事。

把芯步的PDU接进自己的项目,说到底就是调用接口的过程。只要你搞定了签名算法,剩下的就是根据业务逻辑去开和关。这对于智慧教室的整体运维来说,能明显降低跑现场维修的频率,也让学生或者教务老师操作起来更方便直观。