餐厅设备电源控制：怎样将1位5孔WiFi智能插座对接到自己的项目中_解决方案

CATALOG

芯步的智能插座开放HTTP接口，签名机制清晰，适合快速集成到餐厅设备管控系统中。以下方案涵盖接口对接、签名生成、餐厅场景适配以及定时、功率监控等关键实现。

解决方案：餐厅设备电源控制 —— 集成芯步1位5孔WiFi智能插座

1. 项目概述与选型分析

在餐厅场景中，经常需要对非智能设备（如和面机、打奶器、灯箱、收银机、电饭煲等）进行远程断电、定时开关或能耗监控。

产品选型： 芯步 1位5孔WiFi智能插座（10A/16A计量版）。

为何选择此硬件： 该插座最大的优势在于 “即插即用” 且 “无需网关” 。餐厅后厨环境复杂，WiFi 2.4G覆盖容易实现，且其开放的HTTP接口完全兼容传统的Web/APP后端架构。
核心API优势： 厂商提供的是标准的HTTP API，这意味着无论你的餐厅管理系统是用 Python、Java、Go 还是 PHP 写的，都可以直接在业务代码中调用，无需集成复杂的SDK。

2. 技术对接架构图

本方案采用极简的 “云-云” 或 “端-云” 对接模式：

感知层： 安装在餐厅各区域的芯步智能插座（更换原有墙插或即插即用）。
网络层： 设备通过餐厅WiFi直接连接至芯步云。
平台层： 你的业务服务器（餐厅管理系统）通过 HTTP Request 调用芯步的开放 API。
控制层： 服务员/厨师/管理员通过你的手机APP/Web后台发出指令。

3. 详细对接步骤：从购买到代码集成

第一步：设备安装与配网

安装： 将1位5孔墙壁插座替换原有插座（需断电操作）。若为桌面型，直接插入220V插孔。
配网： 使用“芯步”官方App进行蓝牙或SmartConfig配网，记录下设备的 Device ID。

第二步：获取 API 凭证在芯步开发者后台：

创建应用，获取 AppId （应用ID）。
获取 AppSecret （应用密钥）。注意： 此密钥用于生成签名，需严格保密。

第三步：核心代码实现（签名与请求）芯步的接口安全机制基于 动态签名。其规则为：sign = md5( md5(AppSecret) + ts )。

以你的餐饮系统后端（Python 示例）为例，实现远程开启/关闭插座：

import hashlib
import time
import requests
import json

class YoyoPowerController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"  # 公有云地址，支持私有化部署可更换IP

def _generate_sign(self, ts):
        # 1. 将 AppSecret 进行一次 MD5 加密
        step1 = hashlib.md5(self.app_secret.encode('utf-8')).hexdigest()
        # 2. 拼接 step1 + ts (时间戳)
        step2 = step1 + str(ts)
        # 3. 再次进行 MD5 加密得到最终签名
        sign = hashlib.md5(step2.encode('utf-8')).hexdigest()
        return sign

def control_power(self, device_id, power_status):
        """
        控制插座电源
        :param device_id: 设备ID (如: 820720)
        :param power_status: 1 开启, 0 关闭
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        # 请求 URL 拼接
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        # 请求 Body (符合餐厅设备控制场景)
        payload = {
            "device": device_id,
            "order": {"power": power_status}
        }
        
        headers = {'Content-Type': 'application/json'}
        response = requests.post(url, headers=headers, data=json.dumps(payload))
        
        if response.status_code == 200:
            print(f"指令下发成功，设备 {device_id} 已{'开启' if power_status == 1 else '关闭'}")
            return response.json()
        else:
            print(f"控制失败: {response.text}")
            return None

def timing_control(self, device_id, delay_seconds, action="close"):
        """
        餐厅场景:定时任务（如:开启后1小时自动关闭）
        :param delay_seconds: 延迟毫秒数 (注意:API 要求毫秒，如 3600000 代表1小时)
        :param action: close(先开后关) / open(先关后开)
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        # 定时指令:例如先接通电源，1小时后自动切断
        # reset: 先断后通； point: 先通后断
        order = {}
        if action == "close":
            # 场景:开启排气扇，1小时后关闭
            order = {"point": delay_seconds}  
        else:
            # 场景:关闭制冷，1小时后开启
            order = {"reset": delay_seconds}
            
        payload = {"device": device_id, "order": order}
        requests.post(url, headers={'Content-Type': 'application/json'}, data=json.dumps(payload))

# ------------------- 在餐厅系统中初始化使用 -------------------
# 假设这是你的餐厅管理系统代码
ctrl = YoyoPowerController(AppId="你的应用ID", AppSecret="你的密钥")

# 1. 关闭 3号桌 的电磁炉插座 (设备ID: 10001)
ctrl.control_power("10001", 0)

# 2. 打开后厨排烟插座，并设定 2小时后自动关闭 (2*60*60*1000 = 7200000 毫秒)
ctrl.timing_control("10002", 7200000, action="close")

关键点说明：

签名机制： 这是最容易出错的地方，必须严格按照 md5(md5(secret)+ts) 的顺序来。
响应速度： 根据官方数据，从接口调用到设备继电器动作，通常在 80-120ms 内，这对于餐厅点餐联动控制来说是实时且足够快的。

4. 餐厅场景特色功能应用

A. “用餐模式”与“清洁模式”联动

需求： 打烊后，服务员经常忘记关厕所灯或招牌灯箱。
实施： 在你的收银系统中增加“一键打烊”按钮。点击后，后端遍历所有挂载在“公共区域”分组下的设备ID，并发调用 order: {"power": 0}。

B. 大功率设备能耗统计（计量版特有）

需求： 监控冰箱、空调等设备的实时功率，判断是否故障。
实施： 芯步的计量版插座会实时上报电压、电流、功率因数。你的服务器可以通过 API 拉取这些数据。
价值： 如果检测到冷藏展示柜的功率突然降至 0（断电）或电流异常，系统可自动向店长发送报警短信，防止食材变质。

C. 扫码用电（共享模式）

需求： 美食广场共享插座，用户扫码付费后通电。
实施： 你的系统生成二维码。用户支付后，你的服务器调用接口接通该插座。利用 reset 参数：{"reset": 3600000}，实现“通电1小时后自动断电”，即使服务器不主动关，插座也会自己关，避免纠纷。

5. 常见问题与排障

签名错误（Invalid Sign）：
- 检查时间戳 ts 是否为秒级（10位），不要传成毫秒级（13位）。
- 检查 md5 的结果是否为 32位小写 十六进制字符串。
设备离线（Offline）：
- 餐厅WiFi为多AP（多个路由器）环境时，确保 2.4G 频段开启，且未开启“AP隔离”。
- 如果采用私有化部署（局域网控制），请确认服务器与插座在同一个网段或路由可达。
指令下发成功但设备不动：
- 检查 device 参数是否填写正确（是数字ID，不是MAC地址）。
- 确认插座负载功率未超过额定值（10A版2000W以下）。

6. 总结

将芯步的1位5孔 WiFi 智能插座集成到你的餐饮项目中，本质上是一个 HTTP 远程调用 的过程。通过上述示例代码，开发者可以在 1 小时内完成从注册到控制设备的流程。

实施路线图：

DAY 1： 采购 1 台设备，获取 AppId，跑通 curl 命令开关灯。
DAY 2： 将上述 Python/Java 代码封装成你的微服务。
DAY 3： 在餐厅管理后台加入“设备管理”菜单，实现 UI 控制。
DAY 4： 部署至餐厅生产环境，仅做照明控制观察稳定性。稳定运行一周后，再接入核心冷柜或厨房设备。

这套方案不仅能解决餐厅的远程电源管理需求，还能通过功率计量功能，为你实现餐厅的精细化数字化能源管理打下基础。