餐厅包厢照明控制：如何把智能墙壁复合开关3路集成到软件项目中_解决方案

CATALOG

芯步的智能墙壁开关3路采用HTTP API驱动架构，支持3路照明独立控制和状态保持，开发者只需调用标准接口即可将灯光控制能力无缝嵌入餐厅包厢管理系统。以下是具体集成方案。

1 背景与需求分析

在现代餐厅经营中，包厢区域的照明控制不仅影响用餐体验，还直接关系到能耗管理与运营效率。传统管理模式面临以下痛点：

顾客离席忘关灯，能耗浪费严重：顾客用餐结束后直接离开，服务员需逐间检查关灯，既耗时又易遗漏。统计显示，餐厅包厢照明能耗中约20-30%源于无人时段空耗。
多路灯光切换不便：包厢通常设有主照明、氛围灯带、装饰射灯等多路光源，传统开关无法灵活切换场景模式（如用餐模式、生日模式、清洁模式）。
服务员巡场效率低：营业高峰期，服务员需频繁进出包厢查看灯光状态，影响服务质量。
与预定系统脱节：顾客通过小程序预订包厢后，需要服务员手动开灯，体验不佳且增加人力成本。

芯步推出的智能墙壁开关3路（型号：UNI-KG-3）是一款支持3路独立控制的智能墙面开关，采用标准86型底盒安装，可直接平行替换传统开关，具备HTTP接口远程控制、单路通断、状态保持、定时任务等特性。本文将提供完整的技术集成方案，帮助开发者快速实现餐厅包厢照明系统的智能化控制。

2 核心产品与技术规格

2.1 硬件参数

本次方案选用芯步智能墙壁开关3路，核心参数如下：

参数项	规格
产品型号	UNI-KG-3
控制路数	3路独立控制
外形尺寸	86mm × 86mm × 41mm（标准86型）
操控方式	物理按键
工作电压	100-240V AC（宽压输入）
额定电流	MAX 10A/路
负载功率	300-1200W/路（LED/节能灯负载应<300W/路）
待机功耗	0.4W（全断）~ 1.7W（全通/无负载）
联网方式	WiFi IEEE 802.11 b/g/n 2.4GHz
安装方式	标准86型底盒安装（支持零火/单火）
外壳材质	防火V0级PC，耐高温，符合安规标准

2.2 产品核心能力

3路独立分控：支持对3路输出分别进行通断控制，可精细管理包厢内不同区域的照明（如主灯、灯带、射灯）。
无损安装：标准86型设计，可直接平行替换传统墙壁开关，支持零火/单火接线。
HTTP接口零门槛集成：设备开放标准HTTP API，适用于Java、Python、PHP、Go、Node.js等任何支持HTTP请求的编程语言。
状态保持功能：支持下发“状态保持”命令，用户操作开关后，指定时间自动恢复预设状态。
定时任务支持：支持远程下发定时通断指令，无需额外维护定时任务队列。
私有化部署支持：支持自建消息服务器，可在餐厅局域网内运行，满足数据安全要求。

3 设计

将智能墙壁开关3路集成到餐厅包厢管理系统中，采用云-端分离的四层架构：

设备感知层：智能墙壁开关安装在包厢内，替换原有墙壁开关，3路输出分别连接主照明、氛围灯带、装饰射灯。
网络传输层：设备通过Wi-Fi（2.4GHz）接入餐厅局域网，与芯步云平台或私有化服务器保持连接，命令下发延迟约为80-120ms。
云平台层：芯步开放API提供设备控制、状态查询等能力。餐厅可选择私有化部署，数据直传本地服务器。
业务应用层：包厢管理系统（预定小程序/服务员APP/管理后台）集成开关控制能力，实现预定联动、场景切换、状态监测等业务功能。

4 详细集成步骤

4.1 设备部署与注册

安装准备
- 确认包厢内原有墙壁开关为86型底盒（中国标准尺寸）
- 断电后拆卸原有开关，标记火线、零线、负载线的接线位置
设备接线（由持证电工操作）：
- 火线输入（L_IN）：接市电220V火线
- 零线输入（N_IN）：接市电零线
- 路1负载（L1_OUT）：接主照明灯具
- 路2负载（L2_OUT）：接氛围灯带
- 路3负载（L3_OUT）：接装饰射灯
设备配网
- 通过芯步配网工具（支持AP配网/SmartConfig），将设备接入餐厅2.4GHz Wi-Fi网络
- 设备支持设定5组WiFi网络，优先连接信号最强的进行连接
平台注册：在芯步IoT平台注册账号，将设备添加到项目，获取唯一设备ID（Device ID）。

4.2 获取API凭证

在芯步控制台的“开发设置”中获取以下凭证：

AppID：应用唯一标识，用于接口路由
AppSecret：开发者密钥，用于签名计算

4.3 接口签名算法

芯步API采用双重MD5签名机制，确保请求的合法性和时效性。签名计算步骤如下：

对 AppSecret 进行MD5加密，得到 md5Secret = MD5(AppSecret)
获取当前Unix时间戳（秒级），记为 ts
拼接字符串：signStr = md5Secret + ts
对 signStr 再次进行MD5加密，得到最终签名 sign = MD5(signStr)

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

4.4 核心API接口

4.4.1 设备控制（开关灯）

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式：POST

请求参数

参数	类型	说明
device	string	设备ID
order	json字符串	控制命令

3路开关控制命令示例

命令	示例	功能说明
单路开	`{"power1":1}`	开启第1路（主照明）
单路关	`{"power2":0}`	关闭第2路（氛围灯带）
多路同时控制	`{"power1":1,"power2":1,"power3":0}`	路1、路2开，路3关
定时关闭	`{"reset1":3600000}`	开启路1，1小时后自动关闭
状态保持	`{"power1":0,"keep":10}`	关闭路1，用户若手动打开，10秒后自动恢复关闭

4.5 代码实现示例

Python实现

import hashlib
import time
import requests
import json
from typing import Dict, Optional

class RoomLightController:
    """餐厅包厢照明控制器"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"
    
    def _generate_sign(self, ts: int) -> str:
        """生成API签名"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def control_lights(self, device_id: str, power1: int = None, 
                       power2: int = None, power3: int = None) -> Dict:
        """
        控制3路照明
        :param device_id: 设备ID
        :param power1: 第1路开关状态（1开/0关）
        :param power2: 第2路开关状态
        :param power3: 第3路开关状态
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        # 构建命令，仅包含非None参数
        order = {}
        if power1 is not None:
            order["power1"] = power1
        if power2 is not None:
            order["power2"] = power2
        if power3 is not None:
            order["power3"] = power3
            
        payload = {
            "device": str(device_id),
            "order": json.dumps(order)
        }
        
        response = requests.post(url, data=payload)
        return response.json()
    
    def set_scene(self, device_id: str, scene: str) -> Dict:
        """
        切换场景模式
        :param scene: 场景名称 - dining(用餐)/birthday(生日)/cleaning(清洁)
        """
        scenes = {
            "dining": {"power1": 1, "power2": 0, "power3": 1},      # 主灯+射灯
            "birthday": {"power1": 0, "power2": 1, "power3": 1},    # 氛围灯+射灯
            "cleaning": {"power1": 1, "power2": 1, "power3": 1},    # 全开
            "energy_save": {"power1": 0, "power2": 0, "power3": 0}   # 全关
        }
        
        config = scenes.get(scene, scenes["dining"])
        return self.control_lights(device_id, **config)
    
    def timed_off(self, device_id: str, delay_ms: int) -> Dict:
        """
        定时关闭指定路（开启后延时自动关闭）
        :param delay_ms: 延时毫秒数（如3600000=1小时）
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        # 开启主灯，并在指定时间后自动关闭
        order = {"power1": 1, "reset1": delay_ms}
        payload = {
            "device": str(device_id),
            "order": json.dumps(order)
        }
        
        response = requests.post(url, data=payload)
        return response.json()

# 使用示例
controller = RoomLightController("YOUR_APP_ID", "YOUR_APP_SECRET")
device_id = "123456789"

# 场景1:顾客入座，开启基础照明
controller.set_scene(device_id, "dining")

# 场景2:顾客庆祝生日，切换生日模式
controller.set_scene(device_id, "birthday")

# 场景3:预定时段结束，自动关灯
controller.set_scene(device_id, "energy_save")

Node.js实现

const crypto = require('crypto');
const axios = require('axios');

class RoomLightController {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.apiBase = 'https://api.thingboot.com';
    }

_generateSign(ts) {
        const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
        const signStr = md5Secret + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }

async controlLights(deviceId, power1, power2, power3) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
        
        const order = {};
        if (power1 !== undefined) order.power1 = power1;
        if (power2 !== undefined) order.power2 = power2;
        if (power3 !== undefined) order.power3 = power3;
        
        const payload = {
            device: String(deviceId),
            order: JSON.stringify(order)
        };
        
        const response = await axios.post(url, null, { params: payload });
        return response.data;
    }

async setScene(deviceId, scene) {
        const scenes = {
            dining: { power1: 1, power2: 0, power3: 1 },
            birthday: { power1: 0, power2: 1, power3: 1 },
            cleaning: { power1: 1, power2: 1, power3: 1 },
            energy_save: { power1: 0, power2: 0, power3: 0 }
        };
        
        const config = scenes[scene] || scenes.dining;
        return this.controlLights(deviceId, config.power1, config.power2, config.power3);
    }
}

// 使用示例
const controller = new RoomLightController('YOUR_APP_ID', 'YOUR_APP_SECRET');

// 场景:顾客预定时段开始，自动开灯
async function onBookingStart(roomId, sceneType) {
    const result = await controller.setScene(roomId, sceneType);
    console.log(`包厢${roomId}已切换至${sceneType}模式`, result);
}

5 餐厅包厢业务场景应用

5.1 预定-灯光联动

场景描述：顾客通过小程序预订包厢后，系统在预定时段开始前自动开启对应照明，提升体验。

实现逻辑

顾客在小程序选择时段并完成支付，订单状态变为“已预定”
系统记录预定开始时间，创建定时任务
预定开始前5分钟，调用灯光控制接口，开启包厢照明
预定结束后30分钟，自动关闭灯光（若无人使用）

5.2 多场景模式一键切换

场景描述：服务员通过APP可为包厢切换不同场景模式，满足多样化用餐需求。

实现逻辑

模式	路1（主照明）	路2（氛围灯带）	路3（装饰射灯）
用餐模式	✅ 开启	❌ 关闭	✅ 开启
生日模式	❌ 关闭	✅ 开启	✅ 开启
清洁模式	✅ 开启	✅ 开启	✅ 开启
节能模式	❌ 关闭	❌ 关闭	❌ 关闭

5.3 服务员离开现场时一键关灯

场景描述：顾客用餐结束离开现场时后，服务员通过手持终端一键关闭包厢所有灯光，避免能源浪费。

实现逻辑

5.4 定时关灯与节能策略

场景描述：包厢预定时段结束后，若灯光长时间未关，系统自动执行关灯，避免夜间浪费。

实现逻辑

预定结束时间后30分钟，自动下发关灯指令
若检测到包厢仍有客人在场（通过门磁/传感器联动），延迟关灯
深夜时段（23:00后）强制执行关灯

5.5 服务员巡场状态监测

场景描述：管理后台实时显示各包厢灯光状态，服务员无需逐间查看即可了解情况。

实现逻辑

定时轮询设备状态，获取3路照明状态
前端看板展示包厢灯光状态：
- 绿色：已关灯
- 黄色：部分开启
- 红色：全开且超过设定时长

6 高级功能与优化

6.1 状态保持功能

智能墙壁开关3路支持“状态保持”功能，适用于需要控制顾客临时开灯的场景。例如：清洁模式下发后，顾客若手动开灯，指定时间后会自动恢复关闭状态。

6.2 定时任务设定

设备支持一次性定时指令，无需在业务后端维护定时任务队列

6.3 负载兼容性说明

需要注意的是，如果用于LED或节能灯泡，每路负载应小于300W，以避免闪烁或不稳定。安装前确认灯具类型和总功率。

6.4 私有化部署（内网直连）

对于对数据安全要求较高的高档餐厅，芯步智能墙壁开关支持私有化部署方案

设备通过内网直连企业自建消息服务器
所有控制指令不经过公网
满足企业内部数据合规要求

7 总结与效益分析

芯步智能墙壁开关3路通过“硬件无损安装、接口标准开放、控制灵活多样”的设计理念，为餐厅包厢提供了一套完整的照明智能化解决方案。

核心价值总结

痛点	解决方案	预期效益
顾客离席忘关灯	远程一键关灯+定时策略	预计节省30%照明能耗
多路灯光切换不便	3路独立控制+场景模式	提升用餐体验和服务效率
服务员巡场效率低	实时状态监测看板	减少60%巡场人力
预定与灯光脱节	预定时段联动自动开灯	提升顾客第一印象

通过实施本方案，餐厅将实现包厢照明的自动化、精细化管理，在提升顾客用餐体验的同时，显著降低运营能耗和管理成本。