办公场所门禁灯光管理：怎么将2路智能墙壁电源开关接入到项目中_解决方案

CATALOG

一、概述

在办公场所管理中，门禁与灯光是最基础的管理对象。传统方案需要人工巡查关灯、门禁系统与照明系统独立运行。芯步2路智能墙壁电源开关通过开放HTTP接口，实现2路独立回路的远程控制，可将门禁状态与灯光控制联动，构建智能化的办公管理系统。

核心能力

2路独立分控：分别控制办公区主照明、会议室灯光、门禁电源等
门禁联动：检测到门禁刷卡/人脸识别时自动开启对应区域灯光
开放HTTP API：任意编程语言均可接入
超低延迟：命令下发到设备响应80-120ms
私有化部署：支持局域网直连，数据不出企业内网

办公场所典型应用场景

场景	控制对象	联动逻辑
门禁刷卡开灯	区域照明 + 门禁电源	员工刷卡进入，对应区域灯光自动开启
下班一键关灯	全部照明回路	最后离开员工通过系统一键关闭所有灯光
会议室预约联动	会议室照明	会议开始前自动开启，结束后自动关闭
加班时段节能	指定照明回路	非工作时间仅保留必要照明

二、产品核心特性

2.1 产品选型对比

芯步提供两种2路智能墙壁开关，可根据办公装修风格选择

特性	UNI-KG-2（按键版）	智能触摸墙壁开关2路
操控方式	物理按键	触摸面板
外壳材质	防火V0级PC	钢化玻璃
产品尺寸	86×86×41mm	86×86×35mm
控制路数	2路独立分控	2路独立分控
工作电压	100-240V AC	100-240V AC
额定电流	MAX 10A/路	MAX 10A/路
负载功率	300-1200W/路	300-1200W/路
无线连接	WiFi 2.4GHz	WiFi 2.4GHz
控制接口	HTTP API	HTTP API
私有化部署	支持	支持

2.2 支持的命令类型

该设备支持以下核心命令，适用于办公场景的各类控制需求

命令类型	命令格式	说明	办公场景应用
单路开/关	`{"power1":"1"}` / `{"power1":"0"}`	控制第1路通断	开启/关闭办公区照明
双路独立控制	`{"power1":"1","power2":"0"}`	同时控制2路	分区控制会议室与工位区
状态保持	`{"power1":{"keep":"0","revert":"5"}}`	锁定状态，防止误操作	下班后锁定关灯状态
先通后断	`{"point1":"3000"}`	接通后自动断开	临时照明/清场模式
先断后通	`{"reset1":"3000"}`	断开后自动接通	门禁控制器远程重启

三、软件集成架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    企业OA系统 / 门禁管理系统                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  门禁联动   │  │  照明控制台  │  │  节能策略   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP API调用（携带签名）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
    ┌──────────┐       ┌──────────┐       ┌──────────┐
    │ 办公区   │       │ 会议室   │       │ 走廊     │
    │ 2路开关  │       │ 2路开关  │       │ 2路开关  │
    │ 路1=主灯 │       │ 路1=主灯 │       │ 路1=筒灯 │
    │ 路2=射灯 │       │ 路2=投影 │       │ 路2=应急 │
    └──────────┘       └──────────┘       └──────────┘

3.2 集成工作原理

芯步智能开关开放HTTP接口，适用于任何支持HTTP请求的编程语言。仅需在接口携带签名以及设备ID，即可向设备下发命令，支持接入Web、APP/小程序、SaaS/低代码等任何形式的软件项目。

集成工作流程

业务触发：门禁刷卡、OA系统会议开始、定时任务触发等事件
命令构建：系统生成MD5签名，封装HTTP请求
指令下发：向API发送POST请求
设备执行：智能开关执行通断控制（80-120ms响应）

四、API接口接入详解

4.1 接口地址与签名计算

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数说明

参数	说明	示例
{AppId}	应用ID（控制台获取）	`qtyVWcgeMq`
{ts}	当前Unix时间戳（秒）	`1747212640`
{sign}	签名（见下方计算公式）	`c484eb97...`

签名计算公式（两次MD5加密）

sign = md5( md5(AppSecret) + ts )

将开发者密码（AppSecret）进行一次MD5
将这个结果拼接上时间戳ts
对整个拼接后的字符串再做一次MD5

签名计算示例

4.2 核心命令示例

4.2.1 单路独立控制

4.2.2 双路同时控制

4.2.3 状态保持（防误触）

适用于下班后锁定关灯状态，防止员工误操作

4.2.4 先通后断（临时照明）

适用于加班人员离开前需要临时照明的场景：

4.2.5 批量控制多设备（楼层集中管理）

单次请求可同时控制多个区域的开关设备：

4.3 多语言代码示例

Python

import requests
import time
import hashlib

class OfficeLightController:
    """办公照明控制器"""
    
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    
    def _generate_sign(self, ts):
        """生成签名: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, order):
        """发送命令到设备"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        payload = {"device": device_id, "order": order}
        
        response = requests.post(url, json=payload)
        return response.json()
    
    def turn_on_light1(self, device_id):
        """开启第1路照明（主照明）"""
        return self._send_command(device_id, {"power1": "1"})
    
    def turn_off_light1(self, device_id):
        """关闭第1路照明"""
        return self._send_command(device_id, {"power1": "0"})
    
    def turn_on_light2(self, device_id):
        """开启第2路照明（辅助照明）"""
        return self._send_command(device_id, {"power2": "1"})
    
    def turn_off_light2(self, device_id):
        """关闭第2路照明"""
        return self._send_command(device_id, {"power2": "0"})
    
    def all_on(self, device_id):
        """开启全部照明"""
        return self._send_command(device_id, {"power1": "1", "power2": "1"})
    
    def all_off(self, device_id):
        """关闭全部照明"""
        return self._send_command(device_id, {"power1": "0", "power2": "0"})
    
    def temporary_light(self, device_id, light_num=1, duration_ms=3000):
        """临时照明（先通后断）"""
        cmd = f"point{light_num}"
        return self._send_command(device_id, {cmd: str(duration_ms)})
    
    def lock_state(self, device_id, light_num, keep_state, revert_seconds=5):
        """状态保持锁定"""
        cmd = f"power{light_num}"
        return self._send_command(device_id, {
            cmd: {"keep": keep_state, "revert": str(revert_seconds)}
        })

# 使用示例
controller = OfficeLightController("your_app_id", "your_app_secret")

# 上班:开启全部照明
controller.all_on("office_light_001")

# 下班:关闭全部照明
controller.all_off("office_light_001")

# 加班人员临时照明:亮30秒后自动关
controller.temporary_light("office_light_001", 1, 30000)

Java

import okhttp3.*;
import java.security.MessageDigest;
import java.time.Instant;

public class OfficeLightController {
    private final String appId;
    private final String appSecret;
    private final OkHttpClient client;
    private static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    
    public OfficeLightController(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.client = new OkHttpClient();
    }
    
    private String md5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                sb.append(String.format("x", b));
            }
            return sb.toString();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    private String generateSign(long ts) {
        String md5Secret = md5(appSecret);
        return md5(md5Secret + ts);
    }
    
    public String allOff(String deviceId) throws Exception {
        long ts = Instant.now().getEpochSecond();
        String sign = generateSign(ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
            appId, sign, ts);
        
        String payload = String.format(
            "{\"device\":\"%s\",\"order\":{\"power1\":\"0\",\"power2\":\"0\"}}",
            deviceId
        );
        
        RequestBody body = RequestBody.create(payload, JSON);
        Request request = new Request.Builder().url(url).post(body).build();
        
        Response response = client.newCall(request).execute();
        return response.body().string();
    }
}

JavaScript/Node.js

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

class OfficeLightController {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.baseUrl = `https://api.thingboot.com/${appId}/device/control/`;
    }
    
    _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 sendCommand(deviceId, order) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this._generateSign(ts);
        const url = `${this.baseUrl}?sign=${sign}&ts=${ts}`;
        
        const response = await axios.post(url, { device: deviceId, order });
        return response.data;
    }
    
    async allOn(deviceId) {
        return this.sendCommand(deviceId, { power1: "1", power2: "1" });
    }
    
    async allOff(deviceId) {
        return this.sendCommand(deviceId, { power1: "0", power2: "0" });
    }
}

Shell（curl）

五、办公场所场景实战

5.1 第一种场景：门禁刷卡联动开灯

需求：员工在门禁处刷卡/人脸识别进入办公区时，自动开启该区域照明。

设备配置

门禁设备（可直接对接或通过API触发）
2路智能开关 ×1（接入办公区照明回路）

联动逻辑

5.2 第二种场景：下班一键关灯与防误触

需求：管理员或最后离开员工可通过系统一键关闭所有区域灯光，并锁定状态防止误操作。

设备配置：每层/每区2路开关

5.3 第三种场景：会议室预约联动

需求：会议室管理系统在会议开始前自动开启照明，会议结束后自动关闭。

设备配置：会议室2路开关（路1=主照明，路2=投影/设备电源）

5.4 场景四：加班时段节能策略

需求：非正常工作时段，仅保留办公区部分照明，走廊等区域灯光人走灯灭。

设备配置：各区域独立2路开关

5.5 场景五：企业微信/钉钉小程序集成

需求：员工通过企业微信/钉钉小程序远程控制工位照明。

小程序端代码示例

六、私有化部署方案

对于企业办公场景，数据安全和系统稳定性要求较高，芯步智能开关支持纯局域网运行。

部署模式对比

特性	公有云模式	私有化模式
设备联网	WiFi连接互联网	连接企业内网WiFi
API地址	`api.thingboot.com`	自建服务器IP
数据流向	经过芯步云端	内网直连，数据不出企业
网络依赖	需要互联网	仅需企业内网
适用场景	快速接入、中小型公司	大型企业、安全合规要求高

私有化配置要点

设备支持配置5组WiFi网络，自动连接信号最强的网络
需自建HTTP服务，所有API调用在内网完成
支持自建消息服务器，接收设备状态回调

七、设备安装部署指南

7.1 安装要求

项目	要求
安装方式	标准86型底盒直接替换原有开关
接线要求	需接入零火线（智能开关需要零线供电）
负载要求	LED灯单路总功率 < 300W；白炽灯 < 1200W
网络要求	WiFi 2.4GHz信号覆盖良好
安装空间	底盒深度 ≥ 35mm

7.2 接线注意事项

必须接入零线：智能开关需要零线供电，如原开关只有火线，需请电工增加零线
LED负载限制：LED灯启动电流较大，单路总功率不超过300W
WiFi信号：金属底盒可能屏蔽信号，安装前测试信号强度
随附电容：LED灯闪烁时需并联产品附带的补偿电容

7.3 办公场所部署

部署区域	数量	控制对象
开放办公区	每40-60㎡ 1台	主照明 + 辅助照明
会议室	每间1台	主照明 + 投影/设备电源
独立办公室	每间1台	主照明 + 射灯/装饰灯
走廊/茶水间	每区域1台	筒灯 + 应急照明

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
开关无法控制灯	LED负载过低	并联产品附带的补偿电容
灯闪烁	负载功率不足	增加负载或并联电容
远程控制失败	签名错误/设备离线	检查AppSecret和时间戳，确认签名算法
手动按键无反应	静电/硬件问题	断电重启开关
面板松动	底盒变形	更换标准86底盒

九、总结

本方案基于芯步2路智能墙壁电源开关，实现了办公场所门禁与照明的联动控制与智能管理

能力	实现的方式是
2路独立分控	`power1`/`power2`命令分别控制两路照明回路
门禁联动开灯	门禁刷卡事件触发HTTP API开灯
远程开关管理	HTTP API随时随地控制
一键关灯	批量控制命令，单次关闭全部照明
状态锁定	防误触状态保持功能
节能策略	定时任务自动执行不同时段的照明策略

集成核心步骤

获取AppID/AppSecret，实现MD5签名算法
开发HTTP调用模块，封装开关灯命令
根据办公需求，配置门禁联动或定时任务
物理安装设备，注意零线接入和负载配置

方案优势

✅ 接口统一：标准HTTP API，任意编程语言10分钟对接
✅ 安装简单：标准86底盒直接替换原有开关
✅ 部署灵活：支持公有云和私有化部署
✅ 功能丰富：支持状态保持、定时任务、批量控制
✅ 安全可靠：防火V0级PC外壳，符合安规标准
✅ 超低延迟：80-120ms响应，门禁联动体验流畅

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。