餐厅设备机柜电源控制：怎么将5位总控PDU插排接入到项目中_解决方案

CATALOG

芯步的5位总控PDU通过HTTP接口实现远程电源控制，适合餐厅场景中按营业节奏统一管理设备柜供电。以下方案涵盖设备选型、接口对接流程、核心代码实现及餐厅部署注意事项，可直接复用于Web/小程序/低代码项目。

解决方案：餐厅设备机柜电源控制 —— 芯步5位总控PDU接入指南

1. 背景与需求

在智慧餐厅场景中，后厨或前台通常部署着打印机、路由器、点餐终端、音乐播放器等多种设备。传统的电源管理需要人工逐一插拔或关闭，不仅效率低下，且容易因忘记关闭导致待机能耗和安全风险。

通过引入芯步5位总控智能PDU插排（UNI-PDU-ZK-5），您可以利用其开放的HTTP接口，将电源控制深度集成到现有的餐厅管理系统（如ERP、小程序或自动化脚本）中，实现：

定时策略：配合营业时间自动上下电。
远程维护：当设备死机时，无需到场即可远程重启。
能耗监控（视具体型号固件）：监测设备柜整体功耗。

2. 硬件参数

在系统设计前，请确认硬件的物理规格以匹配现场环境：

设备型号：UNI-PDU-ZK-5
控制路数总控（即5个孔位同时通断，非分控）。
负载能力：总额定功率 2500W，单孔不超过1500W，完美覆盖餐厅内的非大功率设备集群。
网络连接：仅支持 WiFi 2.4GHz（IEEE 802.11 b/g/n）。
接口协议：支持 HTTP/HTTPS 请求，无网关设计，直接上云或局域网控制。

注意：文中使用的是“总控”型号。如果涉及核心服务器与辅助设备分开控制的需求，请选用“分控”型号。

3. 系统设计

芯步采用 “设备-云/本地API-业务系统” 的直连架构，无需复杂的网关配置。

设备层：PDU接入餐厅WiFi，获取IP地址并连接芯步云（或私有化部署的服务器）。
接口层：业务系统通过携带签名（Sign）和时间戳（Ts）的POST请求，调用 device/control/ 接口。
业务层：餐厅的收银系统、中控大屏或手机端小程序触发指令。

4. 接入与调试步骤

4.1 网络配网

使用“芯步”控制台或配网工具，将PDU添加到项目中并配置WiFi。

关键点：确保餐厅WiFi信号强度，该设备仅支持2.4G频段，需确认路由器未开启“双频合一”导致连接不稳。

4.2 获取凭证

在芯步开发者后台获取以下三要素，这是API签名的核心：

AppId：应用唯一标识。
AppSecret：开发者密码（用于加密）。
Device ID：PDU的设备编号。

4.3 API签名与调试

芯步的接口安全机制要求动态签名，防止接口被恶意调用。签名算法规则如下：

将 AppSecret 进行一次 MD5 加密得到 encrypted_secret。
将 encrypted_secret 拼接当前时间戳 ts（秒级），得到字符串 encrypted_secret + ts。
将上述拼接结果再次进行 MD5 加密，得到最终的 sign。

公式：sign = md5( md5(AppSecret) + ts )

4.4 下发控制指令

餐厅需要“开机”或“关机”时，只需向指定URL发送JSON报文。

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法：POST
请求体
{ "device": "这里填写Device_ID", "order": {"power": 1} // 1为开启，0为关闭 }

5. 实战：Python 调度脚本示例

以下脚本展示了如何集成到餐厅的中央管理服务器中。例如：设置每天早上 9:00 开机，晚上 21:00 关机。

import hashlib
import time
import requests
import json
from datetime import datetime

# 配置参数 (从控制台获取)
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_PDU_DEVICE_ID"

# 签名生成函数
def generate_sign(secret, ts):
    # 第1次MD5
    md5_once = hashlib.md5(secret.encode()).hexdigest()
    # 拼接时间戳
    combined = md5_once + str(ts)
    # 第2次MD5
    sign = hashlib.md5(combined.encode()).hexdigest()
    return sign

def control_pdu(status):
    # status: 1 开启, 0 关闭
    ts = int(time.time())
    sign = generate_sign(APP_SECRET, ts)
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    payload = {
        "device": DEVICE_ID,
        "order": {"power": status}
    }
    headers = {'Content-Type': 'application/json'}
    
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=5)
        print(f"[{datetime.now()}] 指令下发成功: {'开机' if status else '关机'}, 响应: {response.text}")
        return True
    except Exception as e:
        print(f"[{datetime.now()}] 控制失败: {e}")
        return False

# 餐厅业务集成示例:营业结束自动断电
if __name__ == "__main__":
    # 模拟:21:00 自动关闭机柜电源
    # 实际场景中，这行代码应由定时任务触发器调用
    control_pdu(0)

6. 餐厅场景注意事项

1. 总控的逻辑限制由于本型号是总控，意味着一旦执行“断电”，插排上所有设备（如路由器、打印机、收银机副机）会瞬间全部断电。

应对方案：在软件层面实现“软关机”逻辑。例如：先通过API发送指令让POS系统退出程序，延迟30秒后再发送PDU断电指令。或者，将必须保持供电的网络设备单独接入普通插座，PDU仅控制可完全断电的辅助设备。

2. 定时任务的实现芯步控制台本身支持云端定时，但如果您希望与餐厅的订单系统联动（例如：接单高峰期间禁止断电，闲时自动断电），使用您自己的服务器做 Cron Job 或使用 Node-RED 等低代码工具进行流程编排。

3. 网络断连后的恢复机制

断网行为：PDU设备在断网后会保持本地断电记忆状态。
来电/来网行为：在餐厅路由器中设置DHCP地址池预留（IP绑定），防止IP变动导致API寻址失败。如果是公网控制，依赖芯步的云服务；如果是纯局域网控制，请确保服务器与PDU在同一网段。

4. 电源安全餐厅厨房附近油烟、湿气大。请一定要确认PDU安装在设备机柜内（非水汽直接接触处）。铝合金外壳虽然散热好且阻燃，但仍需避免油污堆积。

7. 结论

通过接入芯步5位总控PDU，餐厅仅需几行代码即可实现设备机柜的数字化管理。利用其简单的 HTTP接口 和 双MD5签名机制，开发者可以在不增加复杂运维成本的前提下，轻松完成设备控制、状态同步及自动化节能策略的部署。

*注：如果你需要的是“分控”API（独立控制每一个插孔），请将硬件型号更换为UNI-PDU-FK-5，对应的命令参数需调整为 {"power1":1} 的形式。*