CATALOG

芯步的智能PDU通过开放HTTP接口,提供了标准的API调用方式和清晰的签名机制,可快速集成到仓储管理系统中。以下方案涵盖接口对接、签名计算、局域网部署及实战代码示例。

解决方案:仓储设备电源控制——芯步分控PDU(5位)项目对接指南

1. 背景与概述

在仓储自动化管理中,设备的远程重启、能耗控制以及故障恢复是高频需求。芯步的智能PDU(5位分控)支持通过HTTP协议进行远程控制,允许开发者直接通过API对每一个独立的插座位进行开关、重启或电量监控

本方案的目标是解决如何将这款硬件无缝对接到您现有的仓储管理系统(WMS)、机架监控平台或自研运维后台中。

2. 核心技术架构

对接基于请求-响应模型,不依赖网关,设备直连Wi-Fi 2.4G网络。

  • 集成模式:支持公网SaaS模式与私有化部署(局域网模式)。

  • 通信协议:HTTP/HTTPS。

  • 数据格式:JSON。

  • 核心流程:您的后端服务器 -> 芯步API -> 云端 -> 设备。

3. 前期准备与配置

在编写代码前,需要完成硬件的网络配置(配网)以使其获得IP连通能力。

  1. 硬件上电与配网

    • 注册芯步账号并创建工作台。

    • 使用“芯步小程序”或控制台进行网络配置。需注意,设备仅支持 2.4G Wi-Fi,不支持5G频段

    • 将设备配置到与您的服务器同一局域网(针对私有化部署)或有外网权限的网络中。

  2. 获取密钥

    • 在芯步开放平台的控制台中,获取以下三个关键参数:

      • AppID:应用的唯一标识。

      • AppSecret:用于签名的密钥。

      • DeviceID:PDU设备的唯一ID(通常在设备标签或控制台列表中获得)。

4. 接口对接核心逻辑:签名与命令下发

芯步的接口安全机制基于动态签名。为了防止接口被篡改,每次请求都必须携带随时间变化的签名。

签名算法(Sign)为了防止重放攻击,签名采用双重MD5加时间戳的方式:

Sign=MD5(MD5(AppSecret)+ts)Sign = MD5( MD5(AppSecret) + ts )
  • 步骤1:将您的 AppSecret 进行第一次MD5加密,得到字符串 S1

  • 步骤2:获取当前Unix时间戳(秒级) ts

  • 步骤3:拼接 S1ts,得到字符串 S2

  • 步骤4:将 S2 再次进行MD5加密,得到最终的 Sign

请求示例:控制第1路电源开启

  • URLhttps://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}

  • Method: POST

  • HeaderContent-Type: application/json

  • Body (JSON)

参数说明: "power1": 1 代表开启第一路;"power1": 0 代表关闭第一路。

批量控制如果需要同时控制多个端口(例如只开第2和第5口),order 字段可以传入完整的JSON对象:

如果需要一键控制所有端口,使用 {"power":"all"}{"status":"on"} 等指令,具体请参考设备手册

5. 实战:代码集成片段

以下是一个通用的后端集成逻辑(伪代码/逻辑示例),适用于Java、Python、Go或Node.js。

6. 高级场景:局域网与私有化部署

对于仓储环境,网络稳定性至关重要。如果公网中断,依赖云端的控制可能会失效。

  • 私有化模式:芯步支持私有化部署,允许设备将数据上报到您自建的服务器,或让您的服务器直接与设备在局域网内通信

  • 操作:如果您的WMS服务器与PDU在同一网段,可以部署本地消息推送服务。设备的状态变化(如电流异常、开关状态变化)会直接推送到您的本地服务器,延迟可降至毫秒级。

7. 在仓储场景中的应用案例

案例:无人磅房/机柜自动化某钢铁集团利用类似技术(改造闲置PDU)实现了磅房的远程维护

  • 痛点:设备死机需要人员跑到现场拔电源重启。

  • 解决方案

    1. 将服务器/称重终端电源接入芯步PDU。

    2. 监控中心集成API。

    3. 流程:监控软件检测到“称重应用无响应” -> 调用API查询PDU状态 -> 调用API执行 powerX=0(断电) -> 等待10秒 -> 调用 powerX=1(通电重启)。

    4. 收益:MTTR(平均修复时间)从小时级降低至秒级。

8. 注意事项

  1. 设备ID唯一性DeviceID 是字符串格式,不是数字ID,请严格复制控制台显示的值。

  2. 配网频段:配置Wi-Fi时,请一定要使用2.4G网络。如果手机开启热点,也需确保热点为2.4G模式

  3. 并发控制:API接口支持批量控制,如果需要同时控制多个PDU,可以在 device 字段中用英文逗号拼接多个ID,这样单次请求即可控制多台设备。

  4. 状态同步:控制命令下发是异步的,如果需要有状态反馈(如确认继电器真的吸合了),结合芯步的设备状态主动推送功能,或者发送查询指令。

通过以上步骤和设计,您可以轻松地将芯步的5位分控PDU集成到您的仓储管理生态中,实现远程运维与自动化能源控制。