CATALOG

8位分控PDU的核心价值在于“分路独立控制”——你可以精确控制每一个端口的通断,而非整台设备整体开关。结合芯步的开放接口,批量控制的实现思路是:在请求中同时传入多个设备ID(或单设备内的多个端口号),一次API调用即可完成对数十台乃至上百台设备的操作。以下是具体实现方案。

一、 解决方案架构概览

为了实现“远程批量开关控制”,需要利用芯步提供的 HTTP API 接口。这套方案基于请求/响应模型,即你的服务器(或云平台)作为客户端,携带设备信息和控制指令,向芯步的云端服务器发起HTTPS请求,云端再将指令下发给对应的PDU设备。

在批量控制场景下,该架构有两个关键优势:

  1. 设备直连:8位PDU分控设备自带WiFi模块,无需额外网关,简化了网络拓扑

  2. 接口复用:同一套HTTP接口既支持单设备控制,也支持多设备并发控制,只需在参数中传递多个设备ID即可。

二、 准备工作:账号、密钥与设备上线

在开始编写代码之前,需要完成物理设备与云端账号的绑定:

  1. 注册与创建:访问芯步官网注册账号,并创建一个“工作台”(即项目空间)

  2. 获取凭证:进入工作台的控制台,在“开发设置”中获取核心凭证:

    • AppID:应用的唯一标识。

    • AppSecret:用于计算签名的密钥。

  3. 设备配网:将8位分控PDU通电,使用“芯步”小程序或PC控制台,为其配置现场的2.4G WiFi网络,使设备状态变为“在线”

  4. 获取设备ID:在控制台设备列表中,找到已上线的PDU,记录下每一个PDU的 Device ID(设备唯一ID,通常在设备外壳上也有标注)。

三、 核心技术实现:批量接口调用

该方案的核心在于“向设备下发指令”接口。芯步的接口设计允许在一个请求包中携带多个设备的ID,从而实现批量操作。

1. 接口定义

  • 地址https://api.thingboot.com/{AppID}/device/control/

  • 方法POST

  • 鉴权:URL参数携带 sign(签名)和 ts(时间戳)

2. 签名机制

为了安全起见,所有API请求都需要签名验证。签名生成逻辑如下(通用逻辑):

  1. 将你的 AppSecret 进行一次MD5加密,得到 Secret_MD5

  2. Secret_MD5 与当前Unix时间戳(秒级,即 ts)拼接。

  3. 对拼接后的字符串再进行一次MD5加密,结果即为 sign

    • 公式sign = MD5( MD5(AppSecret) + ts )

3. 核心实现:批量控制多台PDU

场景: 假设你有3台8位分控PDU(设备ID分别为 10001, 10002, 10003),现在需要一次性关闭这三台设备上的第1路和第2路端口。

请求参数详解:

参数名类型是否必填说明
deviceString重点:支持批量操作。多个设备ID之间用英文逗号 , 或竖线 | 分隔。一次最多支持100台设备
orderJSON String控制指令。对于8位分控PDU,使用 power1power8 代表对应孔位,值为 "1"(通)或 "0"(断)。

代码示例(以Python为例):

  • 预期结果:只要三台设备均在线,云端会返回 {"code":200},且三台PDU的第1、2路端口会同时断开。

4. 核心实现:单台PDU内部批量控制

场景: 针对一台8位分控PDU,需要同时控制多个互不相邻的端口(例如:打开第3、5、7路,关闭其余路)。

为了实现原子性操作(一次性生效),可以利用 batch 命令。

指令构造:

这条命令会让该PDU仅将3、5、7路打开,其他路状态保持不变

四、 高级管理与可靠性保障

1. 接收设备状态反馈

API接口返回的 200 代码仅代表指令下达成功,并不代表设备执行成功(例如设备此时恰好离线)。

  • 机制:配置消息推送功能。在芯步控制台中配置你的服务器URL,设备执行指令后会主动上报结果(成功/失败),你的服务器通过接收异步消息来确认每一次开关动作是否生效

2. 私有化部署(局域网控制)

如果对数据安全或响应速度有比较高要求(如机房内部管控),芯步的这款PDU支持局域网私有化部署模式。

  • 方案:可以部署本地MQTT Broker或HTTP服务,PDU设备在局域网内直接与你的服务器通信,完全不经过外网,实现纯内网闭环控制

五、 方案总结

维度实现方式与优势
单次多设备控制通过在 device 参数中用逗号拼接ID,实现单条指令操控数百台PDU。
单设备多端口控制利用 batch 指令,精准且高效地调整单台PDU的8个端口状态。
数据可靠性结合API下发与异步消息推送,确认设备真实状态,避免“指令丢失”幻觉。
环境适应支持WiFi直连,无需网关;支持公网与私有化局域网两种模式,灵活适应机房或跨地域机房管理。

通过上述方案,你可以利用芯步的开放接口,构建一套覆盖数百台设备的集中式电源管理系统,实现自动化、脚本化的批量开关机维护流程。