无人值守空间管理：怎么将2路墙壁门禁照明一体开关对接到项目中_解决方案

CATALOG

1. 背景与需求分析

在智慧园区、共享办公、无人值守会议室、24小时自习室等场景中，空间管理的痛点是：如何实现“无人化”的同时，确保空间使用的安全性与便捷性。

传统方案下，门禁控制与照明控制相互独立，存在以下问题：

操作割裂：用户需分别操作门锁和灯具开关，体验差
安全隐患：人员离开后常忘记关灯关电，造成能源浪费和电气风险
管理盲区：无法远程判断空间内设备状态（门是否锁好？灯是否关好？）
改造成本高：部署独立门禁系统和智能照明系统需两套网络、两套接口

芯步2路墙壁门禁照明一体开关（即智能墙壁复合开关|2路）正是为解决上述问题设计的产品。它将一路门禁控制与一路照明控制集成至一个标准86型开关面板中，通过统一的HTTP API接口实现远程控制与状态查询。

本方案将详细阐述如何将该设备集成到无人值守空间管理软件项目中，实现“扫码开门→自动亮灯→离开现场时自动关灯锁门”的全流程自动化。

2. 产品选型：2路墙壁门禁照明一体开关

2.1 产品核心特性

芯步2路墙壁门禁照明一体开关（智能墙壁复合开关|2路）是针对门禁+照明集成控制场景设计的产品，其关键参数如下

特性项	规格说明
控制路数	2路独立控制
典型配置	1路接门禁电磁锁/电插锁，1路接照明灯具
工作电压	100-250V AC（市电直连，无需额外电源适配器）
负载能力	阻性负载≤1000W/路，感性负载≤350W/路
待机功耗	全断状态约0.4W，全通无负载约1.3W
无线连接	WiFi IEEE 802.11 b/g/n 2.4GHz
安装方式	标准86型底盒安装，可直接替换原有墙壁开关
操作方式	按压按键（机械按键版）或触摸按键（玻璃面板版）
控制协议	HTTP API / MQTT，支持局域网和公网

2.2 产品核心优势

一机两用：一个设备同时解决门禁控制和照明控制，减少设备数量和安装复杂度
接口统一：通过HTTP API控制，10分钟即可完成对接
状态可查：支持实时查询每路开关状态，实现空间占用感知
私有化部署：支持局域网控制，数据不外流，满足安全要求
双控模式：支持“保持”模式（供门禁使用）和“瞬时”模式（供灯光场景使用）
标准安装：86型面板，替换原有开关即可，无需重新布线

2.3 命令支持说明

该设备支持的API命令如下

命令	功能说明	适用场景
`{"power1":1}`	第1路接通（开门/开灯）	开门供电、开灯
`{"power1":0}`	第1路断开（关门/关灯）	断电锁门、关灯
`{"power2":1}`	第2路接通	开灯
`{"power2":0}`	第2路断开	关灯
`{"point1":"2000"}`	第1路先通后断，延迟2000ms断开	电磁锁开门（通电2秒后自动断电保护电磁锁线圈）
`{"reset1":"2000"}`	第1路先断后通，延迟2000ms接通	特殊控制场景（如报警触发后自动恢复）
`{"power1":{"keep":"1","revert":"5"}}`	第1路保持开状态，用户手动关5秒后自动恢复	防止无关人员误关的关键设备

3. 无人值守空间管理场景设计

3.1 业务场景概述

以一个无人值守共享会议室为例，业务流程如下：

用户在小程序预约会议室 → 到达会议室 → 扫码开门 → 灯自动亮起 → 使用会议室 → 离开 → 按键关灯（或自动关灯）→ 关门后自动锁门 → 系统释放空间

3.2 核心功能点

功能	实现的方式是	涉及设备
远程开门	用户扫码后，系统调用API控制门禁路接通2秒后自动断开	2路开关第1路
自动亮灯	开门指令成功后，系统调用API接通照明路	2路开关第2路
灯光状态查询	API查询照明路当前开关状态，判断是否有人	2路开关
钥匙加电延时复位	使用`point`命令实现电磁锁的通电延时断电，保护电磁锁线圈	2路开关第1路
手动关灯检测	用户离开时手动按键关灯，系统通过状态查询感知	2路开关第2路
自动锁门	用户关门后，系统调用API确认门锁路为断开状态	2路开关第1路

3.3 核心设计——`point`命令的应用

电磁锁（如磁力锁、电插锁）的工作原理是：通电时锁止/开锁，断电时释放，但不同锁型有不同要求

磁力锁：开门时断电，门关上后重新通电锁门
电插锁：开门时通电缩回锁舌，断电后锁舌弹出锁门

为防止电磁锁线圈长时间通电烧毁，门禁控制通常采用脉冲供电方式：通电开锁保持2秒后自动断电。芯步2路开关的point命令完美支持这一需求：

命令解释：第1路接通2000ms（2秒）后，自动断开。这正好满足电磁锁“通电开门，延时断电”的需求，软件开发者无需额外编写定时器逻辑，由设备硬件自动完成。

4. 集成设计

4.1 系统架构

┌─────────────────────────────────────────────────────────────────┐
│                         用户终端层                               │
│        小程序端    │    Web管理端    │    企业微信/钉钉           │
└────────────────────────┬──────────────────────────────────────┘
                         │ HTTPS
┌────────────────────────▼──────────────────────────────────────┐
│                    业务应用层（您的软件系统）                     │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │
│  │ 预约服务 │  │ 门禁服务 │  │ 照明服务 │  │ 空间状态服务 │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └──────┬───────┘  │
│       └─────────────┼─────────────┼───────────────┘           │
│                     │            │                             │
│           ┌─────────▼────────────▼─────────┐                  │
│           │      设备集成中间件模块          │                  │
│           │  - HTTP请求封装（签名生成）      │                  │
│           │  - 设备状态缓存（Redis）         │                  │
│           │  - 指令重试/超时处理             │                  │
│           └─────────┬──────────────────────┘                  │
└─────────────────────┼──────────────────────────────────────────┘
                      │ HTTPS / HTTP（支持局域网）
┌─────────────────────▼──────────────────────────────────────────┐
│                   芯步云平台 / 本地API                        │
│            （设备接入、指令路由、Webhook消息推送）                 │
└─────────────────────┬──────────────────────────────────────────┘
                      │ WiFi 2.4GHz
┌─────────────────────▼──────────────────────────────────────────┐
│              2路墙壁门禁照明一体开关  × N                         │
│    ┌─────────────────────────────────────────────────────┐    │
│    │  第1路 → 电磁锁/电插锁（门禁控制）                      │    │
│    │  第2路 → 照明灯具                                   │    │
│    └─────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────┘

4.2 架构特点

轻量级：无需专用网关，设备直连WiFi
灵活的API调用方式：支持公网云平台调用，也支持局域网直连设备IP调用
可扩展：单API调用即可同时控制门禁和照明

5. 详细实施步骤

5.1 准备工作：设备配网与平台配置

步骤1：注册芯步开发者账号，创建应用，获取AppID和AppSecret。

步骤2：为2路开关通电并完成WiFi配网。配网方式通常支持：

SmartConfig（手机App一键配网）
AP模式（设备发射热点，手机连接后配置WiFi）

步骤3：在控制台“设备”列表中找到设备，记录其device_id。该ID是后续所有API调用的核心标识。

步骤4：将设备配置为静态IP或通过路由器DHCP保留固定IP，以便局域网直连调用时地址稳定。

5.2 接口基础：签名与请求封装

芯步API采用签名鉴权机制，所有请求均需携带签名和时间戳。

签名算法

sign = md5( md5(AppSecret) + ts )

其中ts为Unix时间戳（秒级）。

请求地址

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

请求体结构

代码封装示例（Java）

@Component
public class YoyoDeviceService {
    
    @Value("${yoyo.app-id}")
    private String appId;
    
    @Value("${yoyo.app-secret}")
    private String appSecret;
    
    private RestTemplate restTemplate = new RestTemplate();
    
    /**
     * 生成签名
     * @param ts 时间戳
     * @return 签名字符串
     */
    private String generateSign(long ts) {
        String md5Secret = DigestUtils.md5DigestAsHex(appSecret.getBytes());
        String plain = md5Secret + ts;
        return DigestUtils.md5DigestAsHex(plain.getBytes());
    }
    
    /**
     * 向设备下发命令
     */
    public Map<String, Object> sendCommand(String deviceId, Map<String, Object> order) {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d",
                                   appId, sign, ts);
        
        Map<String, Object> requestBody = new HashMap<>();
        requestBody.put("device", deviceId);
        requestBody.put("order", order);
        
        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(requestBody);
        ResponseEntity<Map> response = restTemplate.postForEntity(url, entity, Map.class);
        
        return response.getBody();
    }
}

5.3 核心功能一：远程开门+自动亮灯

这是无人值守空间的核心流程。用户在小程序端完成预约后，需支持“扫码开门→灯自动亮起”。

时序流程

用户扫码 → 后端验证预约状态 → 调用point1开门(2秒) → 调用power2开灯 → 返回成功

代码实现

为什么用point而不是power？

power1=1：通电后保持，如不手动发power1=0则会一直通电，容易烧坏电磁锁线圈
point1=2000：通电2秒后自动断电，既完成开门动作，又保护设备

5.4 核心功能二：设备状态查询

无人值守空间管理中，实时掌握门锁状态和灯光状态是进行空间调度和能耗管理的基础。

查询所有状态

应用场景

空间占用判断：如果power2=1（灯亮），则可判断空间可能有人
离开现场时巡检：系统定期查询所有会议室灯光状态，发现灯亮但超时无人时自动关灯
门锁告警：如果非预约时段power1=1（门锁通电/解锁状态），触发安全告警

5.5 核心功能三：预约时段内的定时关灯/超时自动关灯

场景：用户预约时段结束后，系统需自动关灯并锁门。

实现方式一：定时任务

实现方式二：定时命令（设备自身支持定时）芯步平台支持为设备设置定时任务，可在管理后台预设“每日22:00自动关灯锁门”，无需软件系统介入。

5.6 高级功能：`keep`保持模式的应用

在无人值守场景中，存在“关键设备不允许无关人员误操作”的需求。例如：某路门禁供电不得被手动关闭。

2路开关的keep保持模式可以解决此问题

功能解释：第1路保持为“开”状态（即通电）。如果有人手动按下物理按键试图关闭，5秒后设备会自动恢复为“开”状态。这有效防止了非授权人员因好奇或误操作导致门禁断电。

6. Webhook异步消息接收（推荐）

为实现实时状态同步，配置芯步平台的Webhook回调。当设备状态发生变化时（用户手动按键、定时任务执行等），平台会主动推送消息到您的服务器。

6.1 Webhook配置

在芯步控制台的“开发设置”中配置回调URL：

https://your-domain.com/api/yoyo/callback

6.2 消息格式解析

6.3 业务集成

收到消息后，您的软件系统应：

更新本地Redis缓存中的设备状态
判断是否发生异常（如非预约时段有人开门）
触发前端UI刷新（如管理端显示当前会议室灯光状态）
按业务规则生成告警或审计日志

7. 集成难点与解决方案

常见问题	原因分析	解决方案
开门指令成功但电磁锁未动作	电磁锁功率过大超出开关负载能力；接线错误	检查电磁锁额定功率，应≤开关负载能力（阻性1000W/感性350W）；检查接线（火线进、出线接电磁锁）
电磁锁线圈发热严重	`point`延时时间不匹配，或误用了`power`命令	使用`point`命令而非`power`，延时1000ms-3000ms
灯亮但用户离开现场时未关	用户忘记手动关灯	软件层增加超时关灯任务；或设备层使用定时命令自动关灯
网络波动导致指令未送达	WiFi信号不稳定	软件层增加指令重试机制（最多3次）；设备直连5G WiFi信号更强；或考虑使用局域网直连IP方式
多用户同时操作同一设备	并发请求导致状态冲突	软件层加分布式锁（Redis），同一设备串行处理
Webhook消息丢失	回调接口网络问题	增加消息对账任务：每日拉取平台操作日志，与本地记录比对补漏

8. 方案价值总结

通过将芯步2路墙壁门禁照明一体开关集成到无人值守空间管理软件项目中，实现以下核心价值：

设备二合一，降低成本：一个设备解决门禁+照明两个需求，相比两套独立系统，硬件成本降低约40%，安装工时减少50%。
操作自动化，提升体验：用户扫码后门锁自动打开、灯光自动亮起，离开现场时后系统自动关灯锁门，全程无需人工干预。
状态可视化，管理无盲区：实时查询门锁状态和灯光状态，空间占用情况一目了然，后台可远程管理和排障。
保护设备，延长寿命point命令实现的脉冲供电模式有效保护电磁锁线圈，避免因长时间通电烧毁。
防误操作，提升安全性keep保持模式防止无关人员误关关键供电，确保门禁系统始终可用。
快速接入，降低开发成本：标准HTTP API，10分钟完成基础对接，支持任何编程语言。

该方案不仅适用于共享会议室，还可扩展至智能公寓、无人货柜、24小时自习室、企业办公室、仓库门禁等各类无人值守空间管理场景，是智慧空间管理的理想选择。