共享自习室照明门禁控制：怎样把2路墙壁智能开关对接到项目中_解决方案

CATALOG

共享自习室的照明和门禁控制，核心难点在于“无人化管理”——用户如何自助开灯、预约时段结束后如何自动断电。芯步的2路智能墙壁开关正好可以解决这两路控制需求，一路接照明，一路接门锁，通过HTTP接口与预约系统打通。

1. 解决背景与选型

在共享自习室场景中，运营者面临的痛点是 “人力成本高”和 “能源浪费” 。传统模式下，需要专人带客开门、收费、关灯，且经常出现人走灯未灭的情况。

产品选型：选用 芯步智能墙壁开关2路。

为什么选它：该产品直接替换标准86型墙壁开关，无需重新布线，安装方便。
如何解决痛点：它提供两路独立的物理控制（正好对应：一路控制 “座位顶灯” ，一路控制 “房间门锁” ），并支持通过HTTP接口远程控制，是实现无人值守自助入座的硬件基础。

2. 硬件安装与线路对接

在软件对接之前，需要先完成硬件的物理接线，这是控制逻辑实现的前提。

线路1（照明）：将自习室座位的顶灯或氛围灯的火线接入 “线路1” 接口。这是最常规的控制方式，直接替代原有的机械开关。
线路2（门禁）：这是实现自助开门的关键。
- 接法：将第二路开关的接线端连接到 “电插锁” 或 “电磁锁” 的控制线上。
- 原理：利用开关的通断来控制锁的通断电。通常设置为：断电开锁（符合消防规范），或者通电开锁。通过控制开关的闭合时间来模拟“按开门按钮”的动作。
- 注意：开关直接输出220V电压，若门禁锁是低压（如12V/24V），必须串联变压器，否则会烧毁锁具。

3. 接口对接流程

芯步的设备开放标准HTTP API接口，这意味着你可以在任何后端语言（Java, Python, PHP）或前端（小程序）中调用它们。

3.1 准备工作

在芯步开放平台完成以下配置：

获取 AppID 和 AppSecret（用于身份验证）。
记录下设备的 Device ID（每个开关的唯一标识）。
配置消息推送URL：将你的服务器地址配置给平台，用于接收设备回传的状态（如门锁状态、灯开关状态）。

3.2 接口鉴权（签名计算）

每次调用API控制设备前，需要动态计算签名，这是一般物联网平台的安全性要求。规则为：sign = md5( md5(AppSecret) + ts )。在代码中，你需要编写一个函数来生成这个动态的URL。

4. 业务逻辑实现：对接“共享自习室系统”

将硬件接口对接到你的项目中，核心是通过代码实现 “订单状态”与“设备状态”的联动。假设你的项目已有一个基于Spring Boot或Node.js的后端服务。

4.1 用户端：用户扫码开门（启动控制）

场景：用户在小程序端购买了时段，点击“开门”。

后端逻辑

当小程序调用"开门"接口时:
1. 校验用户订单有效性（是否付款、是否在有效时间内）。
2. 调用芯步API请求:
   URL: https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
   Method: POST
   Body: {"device":"设备ID", "order":{"power1":1}} // 假设power1接了灯光
   Body: {"device":"设备ID", "order":{"point2":"2000"}} // 假设power2接了锁，点动2秒开锁
3. 记录日志:设备某某已开启。

针对门锁的控制，采用 “点动模式” 。电子锁不宜长时间通电。使用 point2 命令发送 2000（毫秒），代表开锁2秒后自动断电，这模拟了人手按一下开门键的动作，保护锁具电机。

4.2 自动化：订单结束自动断电（节约能源）

场景：用户预订的时间到了，系统自动关灯并锁门，防止下一位用户进入。

后端逻辑（使用定时任务或延迟队列）：

当用户订单创建时，在Redis或数据库中记录结束时间。
定时任务扫描到订单结束:
1. 调用API关闭照明:
   Body: {"device":"设备ID", "order":{"power1":0}}
2. 如果是座位区域，直接关灯。
3. （可选）如果用户超时未走，系统可发送提醒；若已走，确认门锁状态。

4.3 管理端：远程巡场与干预

场景：运营者在后台网页上看到所有房间的状态。

通过调用获取设备状态的API，你可以：

可视化看板：在后台用红点/绿点显示每个座位的灯是否亮着。
远程救援：当用户反馈“灯不亮”或“门打不开”时，管理员在后台点击“重置开关”按钮，发送重置命令{"reset1":"1000"}（对该线路重启）。

5. 关键代码逻辑示意 (伪代码)

以下是集成到你项目中的核心函数示例（以Node.js为例）：

// 1. 封装统一控制函数
const axios = require('axios');
const crypto = require('crypto');

async function controlSwitch(deviceId, orderJson) {
  // 获取配置
  const AppId = 'YOUR_APP_ID';
  const AppSecret = 'YOUR_SECRET';
  const ts = Math.floor(Date.now() / 1000);
  
  // 签名算法: md5(md5(secret) + ts)
  const md5Secret = crypto.createHash('md5').update(AppSecret).digest("hex");
  const sign = crypto.createHash('md5').update(md5Secret + ts).digest("hex");
  
  const url = `https://api.thingboot.com/${AppId}/device/control/?sign=${sign}&ts=${ts}`;
  
  // 发起请求
  return await axios.post(url, {
    device: deviceId,
    order: orderJson
  });
}

// 2. 业务调用:用户开门流程
app.post('/api/scan_open', async (req, res) => {
  const userId = req.body.userId;
  const seatId = req.body.seatId;
  
  // 1. 检查用户是否已预约此时间段
  const isValid = await checkBooking(userId, seatId);
  if (!isValid) return res.status(403).send("无有效订单");
  
  // 2. 控制硬件:开灯 + 点动开锁
  try {
    // 开灯 (power1)
    await controlSwitch(deviceMap[seatId], {"power1": 1});
    // 点动开锁2秒 (point2)
    await controlSwitch(deviceMap[seatId], {"point2": "2000"});
    
    res.send({code: 200, msg: "欢迎光临，灯光已开启，门锁已打开"});
  } catch (e) {
    res.send({code: 500, msg: "设备控制异常，请联系管理员"});
  }
});

// 3. 定时任务:订单结束自动关灯
// 每隔1分钟扫描一次数据库中的过期订单
cron.schedule('* * * * *', async () => {
  const expiredOrders = await getExpiredOrders(); // 获取刚结束的订单列表
  for (let order of expiredOrders) {
    // 关闭对应座位的灯
    await controlSwitch(deviceMap[order.seatId], {"power1": 0});
    console.log(`座位 ${order.seatId} 订单结束，已自动关灯`);
  }
});

6. 总结

通过将芯步的2路开关对接你现有的共享自习室项目中，可以实现：

低成本改造：相比更换整套昂贵的智能家具，仅替换开关即可实现存量自习室的数字化改造。
真正的无人值守：用户闭环操作（线上下单 -> 扫码开门/开灯 -> 时间到自动断电），极大地降低了人力成本。
精细化能源管理：系统自动检测空闲状态并断电，避免长明灯，预计可节省20%-30%的电费。
高可用性：HTTP接口简单稳定，即使服务器宕机，用户依然可以通过墙壁开关的物理按键进行应急操作。