CATALOG

芯步的智能PDU通过标准HTTP接口对外开放控制能力,这意味着无论你的软件项目是用什么语言开发的(Web、小程序、桌面应用),都可以直接调用。下面从接口对接方案、代码实现思路到落地注意事项,完整梳理一遍。

一、 解决概述

在许多无人餐厅、智能厨房或机房场景中,往往需要远程重启卡死的设备(如收银机、厨房展示屏)、定时关闭电磁炉/灯带,或者监测机柜电流以防火灾隐患。

核心逻辑: 软件项目(SaaS后台/App)通过HTTP请求调用芯步云端API -> 云端转发指令到指定PDU设备 -> PDU执行通/断动作并返回结果。

二、 接口对接核心机制

基于芯步的开放接口,对接主要涉及两个步骤:设备配网与HTTP指令下发。其接口设计非常轻量,无需复杂的SDK,直接构造URL和Body即可

1. API 请求结构

所有的设备控制都基于以下端点(以官方最新文档为准,通常结构如下):

项目说明
请求方式POST
URL结构https://api.thingboot.com/{AppID}/device/control?sign={sign}&ts={timestamp}
HeaderContent-Type: application/json
Body参数{ "device": "设备ID", "order": "命令内容" }

2. 签名机制 (Sign)

为了保证安全性,防止接口被恶意调用,需要对参数进行签名。公式通常为:sign = md5(AppID + AppSecret + ts)注:在开发测试阶段,可在芯步控制台开启“调试模式”暂时忽略签名校验,但生产环境必须开启

三、 软件对接实现步骤

第一步:设备配网与准备

在写代码之前,需要让PDU连上WiFi:

  1. 登录芯步控制台,录入餐厅现场的Wi-Fi名称和密码(注意:仅支持2.4G频段)

  2. 设备通电,通过“小程序配网”或“控制台配网”将PDU注册到云端。

  3. 在控制台的“设备列表”中获取唯一的Device ID

第二步:实现核心控制函数

假设后端使用 PythonNode.js,需要封装一个控制PDU(8位总控)的函数。由于该型号是总控,命令主要控制整体电源通断

方案 A:总控逻辑如果你用的是“8位总控”型号,一个命令控制整个设备。

  • 开机命令:{"power": "1"}

  • 关机命令:{"power": "0"}

方案 B:分控逻辑如果你希望只重启某个插座而不影响其他设备,需要选用“8位分控”型号。芯步的分控设备接口同样开放,支持独立控制每一个位口

  • 独立控制:{"power1": "1"} (单独控制第1位开), {"power2": "0"} (单独控制第2位关)。

  • 批量控制:{"batch":{"relay":[1,3,5],"power":"0"}} (同时关闭第1,3,5位)。

Python 示例:

第三步:集成到业务逻辑

在实际的餐厅软件项目中,可以创建以下功能模块:

  1. 异常自动重启(看门狗):你的软件可以定时检测机柜里的核心设备(如路由器、主服务器)是否在线。如果Ping不通或检测到掉线,立即调用API 重启PDU对应端口。在数据机房场景中,这种“远程重启”是解决设备死机最直接的手段

  2. 定时策略任务:

    • 午餐高峰期(11:00): 自动开启所有展示屏、灯光、排烟。

    • 夜间休整(02:00): 自动关闭非必要设备电源(如广告屏、备用充电口),仅留服务器和网络设备通电。这种方式不仅节能,还能延长设备寿命

  3. 人机交互:在后厨管理界面或老板手机端App上,放置一个“急停/复位”大按钮。点击时弹出二次确认框,执行断电操作。支持远程SSH或Web管理是现代PDU的标准功能

四、 技术细节与优化

1. 局域网直连 vs. 云端控制

芯步的设备支持私有化部署和局域网直接控制

  • 云端模式: 适合连锁餐厅总部的中央系统,需要设备能上互联网。

  • 局域网模式: 适合单店本地部署的软件,可以不经过外网直接给PDU发指令。如果你的软件系统部署在餐厅本地的机柜服务器上,采用此模式,延迟更低且不依赖宽带。

2. 网络配置的鲁棒性

餐厅环境可能存在多AP同名Wi-Fi或信号干扰。芯步PDU支持设定5组WiFi网络,它会自动选择信号最强的连接。在项目实施时,将主Wi-Fi和手机热点都配置进去,以防主网络故障时失联。

3. 硬件安装

  • 供电: 确认PDU的总负载功率。例如餐厅的大功率烤箱等设备不接在普通PDU上(除非有专门的工业高功率版),PDU一般用于机柜设备(交换机、服务器、收银机、路由器)。

  • 固定: 使用机架式安装或固定在墙面上,避免电源线松动导致瞬断

五、 总结

利用芯步的开放接口对接智能PDU,本质上就是“调用HTTP API”。工作量主要集中在:

  1. 写签名算法(芯步的签名逻辑相对简单,容易实现)。

  2. 写业务逻辑(定时、联动、自动重启)。

  3. 界面开发(在软件项目中增加开关按钮和日志)。

通过这种对接,餐厅的机柜电源管理就纳入了数字化体系,实现了从“人工手动按开关”到“系统自动远程运维”的升级。