办公场所门禁灯光管理：怎样将2路双功能墙壁开关对接到软件项目中_解决方案

CATALOG

针对办公场景，门禁与灯光的联动是提升能效管理和用户体验的切入点。下文基于芯步的开放接口体系，提供一套从硬件选型、接口调用到场景的完整方案。

解决方案：基于芯步开放接口的办公场所门禁与灯光联动管理

1. 项目概述与目标

在现代办公环境中，能源浪费（如无人时灯光长明）与体验差（手动操作繁琐）是普遍痛点。本方案的目标是利用芯步的 2路智能墙壁开关（UNI-KG-2） 与现有的门禁系统，通过软件接口对接，实现“人来灯亮，人走灯灭”及“第一种场景键切换”的自动化管理。

核心目标：

节能降耗： 解决公共区域（会议室、卫生间、走廊）无人时忘关灯的问题。
体验升级： 实现门禁刷卡/扫码成功即联动灯光，无需摸黑找开关。
集中管控： 通过后台软件实时查看灯光状态并远程干预。

2. 硬件选型与核心能力分析

针对该场景，选用芯步 智能墙壁开关2路（型号：UNI-KG-2） 作为执行单元。其核心特性对接本方案的优势如下

双路独立控制： 具备2路继电器输出。在方案中，第1路可接入办公区主照明，第2路可接入走廊灯或氛围灯带，实现分区独立控制。
零火线设计： 标准86型规格，可直接替换传统墙壁开关，无需重新布线。
负载能力强： 单路支持阻性负载1000W / 感性负载350W，完全覆盖办公室LED灯组需求。
API可控性： 设备支持通过云端API（HTTPS）下发指令，这是对接软件项目的关键。

此外，门禁系统可选用芯步生态中支持API读卡器或第三方具备韦根/RS485接口的门禁控制器，或直接利用现有门禁系统的事件触发机制。

3. 系统设计

本方案采用事件驱动的架构，通过软件中间件将门禁事件转化为灯光指令。

组件说明：

门禁子系统： 负责采集通行事件。当用户刷卡/人脸识别时，门禁控制器向服务器推送“开门事件”。
业务服务器（您的软件项目）： 核心逻辑层。接收门禁事件，判断时间段与区域，调用芯步API。
芯步云平台： 承上启下，维护设备在线状态，转发控制指令。
执行单元： UNI-KG-2墙壁开关，响应指令闭合/断开电路。

graph TD
    User[员工/访客] -->|刷卡/人脸| Access[门禁读卡器]
    Access -->|HTTP/MQTT推送| Server[您的业务软件/私有云]
    Server -->|调用芯步API| YoyoCloud[芯步开放平台]
    YoyoCloud -->|下发指令| IoTDevice[2路智能墙壁开关]
    IoTDevice -->|电路闭合/断开| Light[办公室灯具]
    
    subgraph 控制逻辑
        Server --> DB[场景规则库]
        DB -->|条件匹配| Decision{是否工作时间/是否加班模式}
    end

4. 软件对接详细步骤

4.1 设备初始化与管理

首先需在芯步控制台中获取设备凭证：

设备ID： 获取UNI-KG-2的唯一标识（通常为字符串或数字）。
网关ID： 若开关通过网关连接，需获取网关ID（API参数中的gateway字段）。
API密钥： 获取AppID、Sign签名密钥，用于后续鉴权。

4.2 核心API调用逻辑（以“门禁联动开灯”为例）

当门禁系统检测到“开门成功”事件时，业务服务器需调用设备控制接口。

接口详情：

地址：http(s)://api.thingboot.com/{AppID}/device/control/
方法： POST（推荐JSON格式）

请求示例（控制第一路照明开启）：

说明：如果是对接复合型设备，order 字段支持JSON字符串，可精准控制继电器动作。

4.3 状态同步与反馈机制

HTTP接口返回 code: 200 仅代表指令下达成功，不代表设备实际执行成功（如设备离线）。为确保状态一致性：

采用异步推送： 芯步平台支持消息推送。业务服务器需订阅设备上报的状态变更（channel_1_status）。
超时重试： 下发指令后，若在一定时间内未收到设备状态回传，且数据库记录不一致，则触发重试机制。

5. 关键场景逻辑实现

为了让方案更贴合“办公场所”，在软件项目中实现以下三种高阶逻辑：

5.1 第一种场景：门禁联动与无人节能

触发条件： 下班时间段（18：00-次日8：00），门禁由内向外刷卡（代表最后一人离开）。
执行动作： 调用API关闭该办公室区域内所有关联的灯光回路（channel_1=0， channel_2=0）。
扩展： 引入红外传感器，当传感器探测无人且门禁无记录达15分钟，强制关灯。

5.2 第二种场景：会议模式与场景预制

联动：OA系统预定会议室 -> 会议前5分钟 -> 软件自动触发。
API组合
1. 开启门禁权限（允许参会人员进入）。
2. 开启灯光：调用开关API将灯光调至“会议亮度”（若设备支持调光，使用对应亮度参数；若不支持，则全开）。
3. 注：芯步的“双功能开关”若支持“长按/短按”或“复合功能”，可用于调节氛围。