智能办公照明控制：怎样把智能触摸墙壁开关 3 路集成到软件项目中_解决方案

CATALOG

一、解决概述

智能办公照明正在从“远程开关”向“场景自适应”演进。传统的单路开关只能控制一路灯具，而现代办公室往往需要分区照明——开放工位、会议室、独立办公室等区域需要独立控制，且需要根据人员活动、时间段动态调整。

芯步智能触摸墙壁开关3路（型号：UNI-KG-CM-3）采用标准86型底盒设计，支持三路独立输出，可直接替换办公室原有墙壁开关，通过HTTP接口实现分区域精细化照明管理。

核心价值

️ 三路独立控制：可分别控制工位区、会议室、走廊等不同区域照明
多端远程控制：Web后台、小程序、APP均可独立控制每一路
场景联动：与人体传感器、门禁系统联动，实现人来灯亮、人走延迟关灯
状态保持：可锁定关键区域照明状态，防止误操作
私有化部署：支持纯局域网运行，满足企业数据安全要求

二、核心技术能力分析

2.1 产品规格

智能触摸墙壁开关3路的核心参数如下

类别	特性说明
产品型号	UNI-KG-CM-3
安装方式	标准86型底盒安装，可直接平行替换原有墙壁开关
控制路数	3路独立输出
操控方式	触摸式（钢化玻璃面板）
工作电压	100-240V AC（交流/市电）
额定电流	MAX 10A/路
负载功率	300-1200W/路（LED/节能灯等感性负载需控制在300W以内）
待机功耗	0.4W（全断）- 1.7W（全通/无负载）
产品尺寸	宽：86mm；长：86mm；厚：35mm
产品外壳	防火V0级PC + 钢化玻璃面板
无线连接	WiFi 2.4GHz，直连路由器，无需网关
控制协议	开放标准HTTP接口，支持私有化部署

选型说明：触摸版采用钢化玻璃面板，外观更现代，适合办公环境；如预算有限，可选择按键版智能墙壁开关3路，功能一致。

2.2 核心命令表

根据芯步产品手册，3路开关支持以下核心命令

命令类型	JSON格式示例	功能说明
单路控制	`{"power1":1}`	开启第1路照明
三路独立控制	`{"power1":1,"power2":0,"power3":1}`	工位区开、会议室关、走廊开
全开全关	`{"batch":{"power":1}}` 或 `{"batch":{"power":0}}`	所有线路同时开启/关闭
选择性批量控制	`{"batch":{"relay":[1,3],"power":1}}`	开启第1、3路
状态保持（锁定开）	`{"power1":{"keep":"1","revert":"5"}}`	强制保持开，用户关灯5秒后恢复
状态保持（锁定关）	`{"power1":{"keep":"0","revert":"5"}}`	强制保持关，用户开灯5秒后恢复
先通后断（点动）	`{"point1":"30000"}`	开启30秒后自动关闭
先断后通（延时恢复）	`{"reset1":"5000"}`	关闭5秒后自动恢复

⚠️ LED/节能灯负载注意事项：LED灯、节能灯属于感性负载，实际功率需按标称值×3~4倍估算，单路感性负载控制在300W以内。

2.3 API接口签名规则

芯步设备采用动态签名验证机制，设备开放HTTP接口，适用于任何支持HTTP请求的编程语言

请求地址:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法:POST
Content-Type:application/json

签名算法:
md5_secret = md5(AppSecret)
sign = md5(md5_secret + ts)

参数说明:
- AppId:应用ID（控制台获取）
- AppSecret:应用密钥（控制台获取）
- ts:当前Unix时间戳（秒）

请求Body示例（开启第1路）：

多设备控制：支持一次向最多100台设备下发指令，设备ID用逗号分隔：

三、智能办公照明集成方案

3.1 整体架构

┌─────────────────────────────────────────────────────────────────┐
│                        办公室区域                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │     智能触摸墙壁开关3路（86型，替换原有开关）             │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐                   │   │
│  │  │  第1路  │ │  第2路  │ │  第3路  │                   │   │
│  │  │ 开放工位│ │ 会议室  │ │ 走廊    │                   │   │
│  │  └────┬────┘ └────┬────┘ └────┬────┘                   │   │
│  │       │           │           │                         │   │
│  │       ▼           ▼           ▼                         │   │
│  │    工位灯具     会议灯具     走廊灯具                    │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  联动触发:                                                     │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │  人体传感器 │  │  门禁系统   │  │  定时任务   │              │
│  │  (有人/无人)│  │  (刷卡开门) │  │  (时段控制) │              │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘              │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          │ HTTP API                             │
└──────────────────────────┼──────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────────┐
│                      办公管理系统                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    照明控制引擎                          │   │
│  │  - 单路/批量远程控制                                    │   │
│  │  - 时段自动策略（早/晚/午休）                           │   │
│  │  - 传感器联动逻辑                                       │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

3.2 硬件安装步骤

步骤1：开关选型与采购

根据办公室区域规划选择3路开关（工位区+会议室+走廊）
多个独立办公室可各配置一个3路开关

步骤2：开关安装

由电工在办公室内更换原有86型墙壁开关
接线方式与普通三开一致：火线(L)、零线(N)、三路线控线(L1/L2/L3)
重要：确认底盒内有零线，否则无法供电

步骤3：网络配置

确保办公室WiFi信号覆盖（设备仅支持2.4G频段）
设备支持配置5组WiFi网络，自动连接信号最强的
通过芯步控制台完成配网

步骤4：获取凭证

登录
在「开发设置」中获取 AppId 和 AppSecret
记录每个开关的设备ID，建立区域-设备-线路映射表

3.3 代码集成示例

以下提供Python和Node.js/小程序两种语言的完整对接示例。

Python实现（推荐用于后端服务）

import hashlib
import time
import requests
import schedule
import threading
from typing import Dict, Optional, List
from flask import Flask, request, jsonify

app = Flask(__name__)

class OfficeLightController:
    """办公照明3路开关控制类"""
    
    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签名:sign = md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id: str, order: Dict) -> Optional[Dict]:
        """发送控制命令"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {"device": device_id, "order": order}
        try:
            response = requests.post(url, json=payload, timeout=5)
            return response.json()
        except Exception as e:
            print(f"命令发送失败: {e}")
            return None
    
    # ========== 单路控制 ==========
    def power_on(self, device_id: str, channel: int) -> Optional[Dict]:
        """开启指定线路（1-3）"""
        return self._send_command(device_id, {f"power{channel}": 1})
    
    def power_off(self, device_id: str, channel: int) -> Optional[Dict]:
        """关闭指定线路"""
        return self._send_command(device_id, {f"power{channel}": 0})
    
    # ========== 三路独立控制 ==========
    def multi_control(self, device_id: str, 
                      channel1: int, channel2: int, channel3: int) -> Optional[Dict]:
        """
        同时控制三路不同状态
        :param channel1: 第1路状态（1=开，0=关）
        :param channel2: 第2路状态
        :param channel3: 第3路状态
        """
        return self._send_command(device_id, {
            "power1": channel1,
            "power2": channel2,
            "power3": channel3
        })
    
    # ========== 批量控制 ==========
    def batch_on(self, device_id: str, channels: List[int]) -> Optional[Dict]:
        """批量开启指定线路"""
        return self._send_command(device_id, {
            "batch": {"relay": channels, "power": 1}
        })
    
    def batch_off(self, device_id: str, channels: List[int]) -> Optional[Dict]:
        """批量关闭指定线路"""
        return self._send_command(device_id, {
            "batch": {"relay": channels, "power": 0}
        })
    
    def all_on(self, device_id: str) -> Optional[Dict]:
        """全开所有照明"""
        return self._send_command(device_id, {"batch": {"power": 1}})
    
    def all_off(self, device_id: str) -> Optional[Dict]:
        """全关所有照明"""
        return self._send_command(device_id, {"batch": {"power": 0}})
    
    # ========== 状态保持（防误触）==========
    def lock_channel_on(self, device_id: str, channel: int, revert_seconds: int = 5) -> Optional[Dict]:
        """
        锁定指定线路为开启状态
        用户手动关闭后，revert_seconds秒后自动恢复
        适用场景:重要区域强制保持照明
        """
        return self._send_command(device_id, {
            f"power{channel}": {"keep": "1", "revert": str(revert_seconds)}
        })
    
    def lock_channel_off(self, device_id: str, channel: int, revert_seconds: int = 5) -> Optional[Dict]:
        """
        锁定指定线路为关闭状态
        用户手动开启后，revert_seconds秒后自动关闭
        适用场景:下班后防止误开灯
        """
        return self._send_command(device_id, {
            f"power{channel}": {"keep": "0", "revert": str(revert_seconds)}
        })
    
    # ========== 定时控制 ==========
    def timed_on(self, device_id: str, channel: int, duration_ms: int) -> Optional[Dict]:
        """
        临时开启:开启后自动关闭
        适用场景:保洁/维修临时照明
        """
        return self._send_command(device_id, {f"point{channel}": str(duration_ms)})
    
    def timed_off(self, device_id: str, channel: int, delay_ms: int) -> Optional[Dict]:
        """
        延时关闭:关闭后自动恢复
        """
        return self._send_command(device_id, {f"reset{channel}": str(delay_ms)})

# ========== 设备配置 ==========
controller = OfficeLightController("YOUR_APP_ID", "YOUR_APP_SECRET")

# 区域设备映射（设备ID -> 区域名称）
AREA_DEVICES = {
    "820720": "开放办公区",
    "820721": "会议室区",
    "820722": "管理层办公区"
}

# 各区域线路规划（1=工位区/2=会议室/3=走廊）
CHANNEL_CONFIG = {
    "开放办公区": {"work_area": 1, "meeting": 2, "corridor": 3},
    "会议室区": {"main": 1, "projector": 2, "corridor": 3},
    "管理层办公区": {"office": 1, "reception": 2, "corridor": 3}
}

# ========== 场景模式 ==========
def work_mode(device_id: str):
    """工作模式:开启工位区照明，关闭会议室、走廊"""
    controller.multi_control(device_id, channel1=1, channel2=0, channel3=0)

def meeting_mode(device_id: str):
    """会议模式:开启会议室照明，关闭工位区"""
    controller.multi_control(device_id, channel1=0, channel2=1, channel3=0)

def cleaning_mode(device_id: str):
    """保洁模式:开启走廊照明，工位区和会议室关闭"""
    controller.multi_control(device_id, channel1=0, channel2=0, channel3=1)

def full_on(device_id: str):
    """全开模式:所有区域亮灯"""
    controller.all_on(device_id)

# ========== 定时任务 ==========
def setup_daily_schedule(device_id: str):
    """每日定时照明策略"""
    # 早晨8:30 开启工作模式
    schedule.every().day.at("08:30").do(work_mode, device_id)
    
    # 午休12:00 关闭工位区，保留走廊（节能）
    schedule.every().day.at("12:00").do(controller.batch_off, device_id, [1])
    
    # 下午13:00 恢复工作模式
    schedule.every().day.at("13:00").do(work_mode, device_id)
    
    # 晚间18:30 关闭所有照明，锁定状态防误开
    schedule.every().day.at("18:30").do(controller.all_off, device_id)
    schedule.every().day.at("18:30").do(controller.lock_channel_off, device_id, 1, 10)

# ========== API接口 ==========
@app.route('/api/light/control', methods=['POST'])
def light_control():
    """照明控制接口（供前端调用）"""
    data = request.get_json()
    device_id = data.get('device_id')
    action = data.get('action')  # 'work', 'meeting', 'clean', 'full_on', 'off'
    
    if action == 'work':
        work_mode(device_id)
    elif action == 'meeting':
        meeting_mode(device_id)
    elif action == 'clean':
        cleaning_mode(device_id)
    elif action == 'full_on':
        controller.all_on(device_id)
    elif action == 'off':
        controller.all_off(device_id)
    else:
        return jsonify({"code": 400, "message": "不支持的操作"})
    
    return jsonify({"code": 200, "message": f"已切换至{action}模式"})

@app.route('/api/light/channel', methods=['POST'])
def single_channel_control():
    """单路控制接口"""
    data = request.get_json()
    device_id = data.get('device_id')
    channel = data.get('channel')  # 1-3
    action = data.get('action')    # 'on', 'off'
    
    if action == 'on':
        result = controller.power_on(device_id, channel)
    else:
        result = controller.power_off(device_id, channel)
    
    return jsonify({"code": 200 if result else 500})

# ========== 启动定时任务 ==========
def start_scheduler():
    # 为每个区域开关配置定时任务
    for device_id in AREA_DEVICES.keys():
        setup_daily_schedule(device_id)
    
    while True:
        schedule.run_pending()
        time.sleep(1)

if __name__ == '__main__':
    # 启动定时任务线程
    scheduler_thread = threading.Thread(target=start_scheduler, daemon=True)
    scheduler_thread.start()
    
    app.run(host='0.0.0.0', port=5000)

微信小程序实现（前端调用）

PHP实现

<?php
class OfficeLightController {
    private $appId = 'YOUR_APP_ID';
    private $appSecret = 'YOUR_APP_SECRET';
    private $apiBase = 'https://api.thingboot.com';
    
    private function generateSign($ts) {
        $md5Secret = md5($this->appSecret);
        return md5($md5Secret . $ts);
    }
    
    private function sendCommand($deviceId, $order) {
        $ts = time();
        $sign = $this->generateSign($ts);
        $url = "{$this->apiBase}/{$this->appId}/device/control/?sign={$sign}&ts={$ts}";
        
        $payload = json_encode([
            "device" => $deviceId,
            "order" => $order
        ]);
        
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        
        $response = curl_exec($ch);
        curl_close($ch);
        
        return json_decode($response, true);
    }
    
    // 开启指定线路
    public function powerOn($deviceId, $channel) {
        return $this->sendCommand($deviceId, ["power{$channel}" => 1]);
    }
    
    // 关闭指定线路
    public function powerOff($deviceId, $channel) {
        return $this->sendCommand($deviceId, ["power{$channel}" => 0]);
    }
    
    // 三路独立控制
    public function multiControl($deviceId, $ch1, $ch2, $ch3) {
        return $this->sendCommand($deviceId, [
            "power1" => $ch1,
            "power2" => $ch2,
            "power3" => $ch3
        ]);
    }
    
    // 全开
    public function allOn($deviceId) {
        return $this->sendCommand($deviceId, ["batch" => ["power" => 1]]);
    }
    
    // 全关
    public function allOff($deviceId) {
        return $this->sendCommand($deviceId, ["batch" => ["power" => 0]]);
    }
    
    // 状态保持（锁定关闭）
    public function lockOff($deviceId, $channel, $revertSeconds = 5) {
        return $this->sendCommand($deviceId, [
            "power{$channel}" => ["keep" => "0", "revert" => (string)$revertSeconds]
        ]);
    }
}

// 使用示例
$controller = new OfficeLightController();
$controller->multiControl('820720', 1, 0, 0);  // 工作模式:开第1路，关第2、3路
// $controller->allOff('820720');              // 全关
?>

四、典型应用场景

4.1 时段自动化照明策略

时段	第1路（工位区）	第2路（会议室）	第3路（走廊）	说明
早晨 8:30	开启	关闭	开启	上班准备
上午 9:00-12:00	开启	按需	开启	正常办公
午休 12:00-13:00	关闭	关闭	开启	节能模式
下午 13:00-18:00	开启	按需	开启	正常办公
晚间 18:30	关闭	关闭	关闭	全关+锁定

4.2 传感器联动（人来灯亮）

结合人体存在传感器，实现节能自动化：

4.3 状态保持（防误触）

下班后锁定照明状态，防止保洁或加班人员误开灯：

4.4 多设备分区管理

当办公室有多个区域时，可配置多个3路开关实现分区独立控制：

4.5 私有化部署

对于数据安全要求高的企业，可选择私有化部署模式，直接向设备IP发送命令

五、集成步骤

步骤一：硬件采购与安装

根据办公区域数量采购智能触摸墙壁开关3路
触摸版（钢化玻璃）适合现代办公装修；按键版适合预算有限场景
由电工在办公室内更换原有86型墙壁开关
重要：确认底盒内有零线，否则无法供电

步骤二：平台配置

登录
在「开发设置」中获取 AppId 和 AppSecret
为每个开关配网，记录设备ID，建立区域-设备-线路映射表
设备支持配置5组WiFi网络，确保网络稳定

步骤三：后端集成

将上述OfficeLightController类集成到办公管理系统中
配置定时任务（工作日时段策略）
创建前端控制接口（场景模式切换）

步骤四：部署测试

测试单路控制、三路独立控制功能
验证定时任务自动化效果
测试状态保持功能

六、总结

优势	说明
三路独立控制	可分别控制工位区、会议室、走廊等三路照明，实现分区精细化管理
场景模式切换	工作/会议/保洁/全开模式一键切换，操作简单直观
定时自动化	早晚自动开关灯，午休自动节能，省去人工操作
状态保持	下班后锁定照明状态，防止误操作导致能源浪费
HTTP开放接口	任何编程语言均可对接，10分钟完成基础集成
零网关	WiFi直连，无需购买额外网关设备
私有化部署	支持纯局域网运行，数据不出企业内网
多网络备份	支持配置5组WiFi，自动连接信号最强的

七、注意事项

负载限制 ⚠️：LED灯、节能灯属于感性负载，单路功率需控制在300W以内；阻性负载不超过1200W
零火线确认：安装前确认开关底盒内有零线（N），否则开关无法工作
WiFi信号：确保开关安装位置WiFi信号良好（设备仅支持2.4G频段）
API响应说明：返回code:200仅表示平台接收指令，不代表设备执行成功
专业安装：涉及强电操作，必须由持证电工按照安全规范安装
多设备ID格式：批量控制时，多个设备ID用英文逗号分隔

通过以上方案，你可以快速将芯步智能触摸墙壁开关3路集成到办公照明管理系统中，实现分区独立控制、场景模式切换、定时自动化、状态保持等核心功能，显著提升办公照明管理效率和节能水平。如有疑问，可访问获取详细产品手册和技术支持。