芯步的智能PDU(5位)分为“总控”和“分控”两种版本,分控版支持5路独立控制,更适合自定义联动场景。以下方案以分控版为例,说明如何通过HTTP接口对接传感器数据,实现温度超标自动断电、开门联动照明等逻辑。
解决方案:基于芯步开放接口的机柜PDU(5位分控)自定义联动逻辑控制系统
1. 产品选型与环境准备
在开始开发之前,首先需要明确硬件选型。芯步针对机柜场景提供了5位PDU,主要分为两个型号,其核心区别如下:
智能PDU 5位[总控] :仅能整体控制所有插位的通断电,无法单独控制某一台设备。
智能PDU 5位[分控]:支持独立控制5个插位中的每一个,同时也支持批量控制。这对于实现“自定义联动逻辑”至关重要。
推荐方案:为了实现精细化逻辑(例如:仅重启端口3,而不影响其他端口),选用 《智能PDU[分控]|5位》。
环境评估
网络要求:设备仅支持 WiFi 2.4G 频段,不支持5G。需确保机柜所在环境有稳定的2.4G信号覆盖。
运行模式:芯步支持 公有云模式(通过API走云端)和 私有化模式(纯局域网控制)。对于数据安全性要求比较高的机房,采用私有化部署。
2. 核心技术原理:事件驱动的闭环控制
自定义联动逻辑的核心在于 “传感数据采集 -> 业务逻辑判断 -> PDU指令执行” 的闭环。芯步的开放接口设计使得开发者可以绕过其原生的SaaS控制台,直接通过服务器下发指令。
工作流程如下:
数据采集:机柜内的温湿度传感器、烟雾传感器或门磁传感器检测到环境变化(如温度超标),将数据上报到用户的私有服务器。
逻辑判断:用户服务器判断数值是否触发了预设规则(如
Temp > 35°C)。指令下发:触发条件满足后,服务器调用芯步的HTTP API,向指定PDU发送
powerX=0(断电)或powerX=1(通电)命令。设备执行:PDU接收指令,在 80-120ms 内执行对应插位的继电器动作。
3. 接口对接开发指南
要实现上述逻辑,需要完成以下三个层面的对接开发。
3.1 设备配网与基础信息获取
在开始编码前,需要通过官方控制台完成设备的初始化:
注册与创建:在芯步官网注册账号,创建“工作台”,获取
AppID和AppSecret(开发者密码)。配网:使用官方小程序或PC控制台,为PDU配置现场的WiFi名称和密码。
获取Device ID:配网成功后,在控制台获取这台PDU的唯一标识符(Device ID),后续所有API调用都需要此ID。
3.2 API 调用逻辑与签名机制
芯步的API通过签名机制保证安全性。所有指令都需要通过 HTTP POST 发送到指定端点。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}签名算法(Sign)
YourSign = md5( md5(AppSecret) + ts )。注:ts是Unix时间戳,秒级。需要先将AppSecret进行一次MD5,拼接上时间戳,再进行整体MD5。
3.3 自定义联动逻辑度的API指令集
为了实现自定义逻辑,需要重点关注 “分控” 和 “批量控制” 指令。以下是针对PDU 5位的核心JSON命令示例:
| 功能描述 | JSON命令格式 | 适用场景 |
|---|---|---|
| 独立控制 | {"power1":1} | 仅重启第1个端口的服务器,或独立打开散热风扇。 |
| 延时控制 | {"reset":{"relay":[2],"interval":5000}} | 实现“先断后通”,用于彻底重启第2位端口上卡死的网络设备。 |
| 批量联动 | {"batch":{"relay":[1,3,5],"power":0}} | 当烟雾传感器报警时,瞬间切断所有非关键设备电源。 |
4. 典型自定义联动场景实战
以下是几个通过代码实现的具体逻辑案例,展示了如何通过芯步接口解决实际问题。
第一种场景:机柜高温应急保护
逻辑需求:当机柜内温度传感器(第三方或芯步)检测到温度 > 40℃ 时,自动切断高功率设备(PDU端口5),保留散热风扇(端口1)。
开发实现
服务器接收温度Webhook:
Temp=42。触发判断:
if Temp > 40。执行指令:调用
curl发送{"power5":0}。
第二种场景:门禁联动与设备上电
逻辑需求:当门禁传感器检测到“门关闭”且“无人”时,为了节能,自动切断照明和显示器电源(端口3、4)。
开发实现
接收门磁信号:
Door=Close且 雷达传感器状态People=No。执行指令:服务器下发
{"batch":{"relay":[3,4],"power":0}}。
第三种场景:自动化资源释放
逻辑需求:在共享机柜或自习室场景中,用户订单结束后,系统自动切断对应机柜的电源。
开发实现服务器业务逻辑调用API:
POST {"device":"PDU_ID", "order":{"power2":0}}。这利用了芯步支持 多设备ID 和 快速响应 的特点。
5. 高级架构:私有化与高可用部署
对于不允许数据出园区的政企机房,芯步支持 私有化部署,这非常关键:
软网关模式:在局域网内的服务器(或PC)上安装“芯步软网关”。此时,设备控制请求不再经过公网
api.thingboot.com,而是直接访问局域网内的网关地址http://设备IP/control。优势:物理隔离,断外网仍可控制,响应延迟降至局域网级别(<10ms)。
6. 总结
通过对接芯步智能PDU(分控版)的开放式HTTP接口,开发者可以轻松构建远超传统定时功能的复杂逻辑系统。其核心优势在于:
协议简单:标准的HTTP,无需私有SDK。
颗粒度细:支持5位独立控制及批量操作,满足精细化运维需求。
部署灵活:支持公有云与私有化两种模式,适应不同安全等级的机房环境。
开发者在实施时,只需关注自身业务逻辑的判断(如计费时长、温度阈值),将最终的开关动作通过上述API封装即可完成闭环控制。