怎么在酒店客房门禁控制中对接智能设备来实现定时开门控制_解决方案

CATALOG

基于芯步智能硬件开放的 HTTP 接口，酒店 PMS 系统可以轻松实现对客房门的定时开关控制。以下是基于其 reset（先断后通） 和 point（先通后断） 命令构建的完整技术方案。

一、背景与需求

在现代酒店运营中，经常遇到需要定时开启门锁或强制断电的场景。例如：

免打扰/退房联动：客人退房结账后，原房卡自动失效，需定时清扫或关闭电源。
行政/钟点房管理：钟点房时间到点，系统自动锁门或断电，提醒客人续住。
安全巡检：特定时间段（如凌晨2点-5点）自动锁闭侧门或通道门，禁止通行。
欢迎模式：客人办理入住后，系统在指定时间自动激活门锁权限。

芯步的智能门禁产品（如智能墙壁出门开关、密码门禁）提供了开放的 HTTP API 接口，支持毫秒级响应与定时任务，可无缝对接酒店现有管理系统（PMS），实现全自动化定时管控。

二、解决方案架构

本方案采用“PMS/云端服务器 + 芯步API + 智能硬件”的轻量级架构。

应用层（酒店PMS/管理后台） ：
- 负责房态管理、计时收费逻辑。
- 触发定时任务（如：入住、退房、续住）。
服务层（芯步云接口） ：
- 接收HTTP指令，无需中间件，直连设备。
- 执行逻辑运算（如：延迟复位）。
执行层（前端智能硬件） ：
- 智能墙壁出门开关：控制电磁锁/电插锁的物理通断电。
- 智能密码门禁：控制数字密码面板的启用/停用与否。

三、核心实现逻辑：定时开门/断电

芯步硬件支持 reset（先断电开锁，延时后再通电锁门） 和 power 等命令，是实现倒计时开门控制的关键。

1. 技术命令

不需要在 PMS 侧维护复杂的定时队列，只需利用硬件自带的“延时复位”功能。

命令示例 (reset) ：
{ "device": "设备ID", "order": {"reset": 3600000} }
释义：立即断开电磁锁电源（门禁打开或失电锁门），保持断开状态1小时（3600000毫秒），随后自动恢复上电（门禁关闭或恢复待机）。

2. 典型业务流程

第一种场景：钟点房/租约到点自动锁门

这是最常用的功能。当客人购买3小时钟点房，系统通过API设置倒计时3小时后自动断电。

客人办理入住：前台在PMS系统点击“入住开卡”，选择时长（如3小时）。
PMS下发指令
- PMS后台调用芯步API接口。
- 目标设备：对应客房的智能墙壁出门开关（控制房间总电/门锁磁力锁）。
- 执行命令{“reset”: 10800000} (3小时=10,800,000毫秒)。
现场效果
- 房间门锁立即允许开启（如果是断电开锁类型，门锁即刻处于可开状态）。
- 3小时倒计时开始。
- 时间到：硬件自动复位，电磁锁上电锁门。此时客人房卡失效（或需额外供电才能开门），提醒客人续费。
续住操作
- 客人续费后，PMS重新下发新的 reset 命令，覆盖之前的定时任务。

第二种场景：退房后自动清空权限

客人退房结账后，为防止原房卡再次开门，需立即锁门。

前台退房：点击退房按钮。
PMS指令
- 发送 {“power”: 0} 命令（关闭线路，保持锁门状态）。
- 或发送一个极短的 reset，如 {“reset”: 0} 立即断开并复位，确保门锁常闭。
结果：原房卡失效，直到下一位客人入住下发新指令。

四、接口对接技术细节

芯步提供全公开的 HTTP 接口，开发的 PMS 或小程序可通过以下方式调用。

1. 签名与鉴权

为保证酒店安全，每次指令需携带动态签名。

算法规则Sign = md5(md5(AppSecret) + ts)
请求URLhttps://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

2. 代码对接示例

以下是一个简单的定时开门控制逻辑（伪代码/概念）：

# 酒店PMS系统调用示例
import requests
import hashlib
import time

def control_door_timer(device_id, minutes, action="reset"):
    """
    控制门禁定时开关
    :param device_id: 芯步设备编号
    :param minutes: 定时分钟数
    :param action: reset(先断后通，用于计时关门) / power(直接开关)
    """
    # 1. 构造签名
    app_id = "YOUR_APP_ID"
    secret = "YOUR_APP_SECRET"
    ts = int(time.time())
    sign = hashlib.md5( hashlib.md5(secret.encode()).hexdigest() + str(ts) ).hexdigest()
    
    # 2. 构造命令
    # 将分钟转换为毫秒
    delay_ms = minutes * 60 * 1000
    
    # order字段:reset是指立即断电（开门），等待delay_ms毫秒后再通电（锁门）
    order_data = {action: delay_ms} 
    
    # 3. 发送请求
    url = f"https://api.thingboot.com/{app_id}/device/control/？sign={sign}&ts={ts}"
    payload = {
        "device": device_id,
        "order": order_data
    }
    
    response = requests.post(url, json=payload, headers={"Content-Type": "application/json"})
    return response.json()

# 酒店前台操作实例:客官入住308房，预定钟点房2小时自动锁门
result = control_door_timer(device_id="308_device_code", minutes=120)

五、实施部署

针对酒店不同的网络环境和硬件现状，提供两种部署模式：

1. 公有云模式（推荐连锁/快捷酒店）

拓扑：酒店 PMS $\rightarrow$ 芯步云端 API $\rightarrow$ 酒店客房 WiFi $\rightarrow$ 智能门禁设备。
优势：零服务器维护，支持跨门店统一管理（连锁总店可控制分店房门），支持小微商户即买即用。
注意：客房 WiFi 需保持 2.4GHz 信号覆盖良好，每个楼层部署信号增强器。

2. 私有化/局域网模式（推荐星级/高隐私酒店）

拓扑：酒店内网服务器 $\rightarrow$ 芯步私有化 SDK $\rightarrow$ 局域网 $\rightarrow$ 设备。
优势：数据不出酒店，极低延迟（局域网内 < 10ms），不依赖外网带宽，断外网仍可控制。
适用：芯步支持私有化部署，这在同类产品中是较大优势。

六、硬件选型

为了实现“定时开门控制”，根据场景推荐以下硬件组合：

推荐产品	适用场景	关键特性与定时逻辑	安装方式
智能墙壁出门开关	标准客房、钟点房	控制磁力锁/电插锁的电源通断。支持 `reset` 命令，是实现“通电上锁、断电开锁”定时逻辑的硬件。	替换房间门口或过道的标准86盒面板。
智能密码门禁	民宿、行政办公室、库房	控制电子锁。可通过 HTTP 接口下发 `pwd`（密码）并设置生效时间段。	配合电子锁体安装。

七、安全与异常处理

断网应急机制如果 WiFi 中断，芯步设备在断网前收到的最后一条 reset 指令依然会生效（倒计时由设备本地芯片执行，不依赖网络）。断网期间无法远程开门，但客人可使用物理机械钥匙或传统的房卡（如果未切断读卡模块电源）开门。
防误锁机制在发送 reset 命令进行长时间断电锁门时，结合 point （先通电后断电）命令做一个短暂的“提示闪烁”。
- 逻辑：先发送 point：3000（通电3秒，门锁吸合又断开，发出声响）提示客人门即将锁定，3秒后再执行 reset，避免突然断电夹伤客人或损坏锁体。

八、总结

通过芯步开放接口，酒店无需复杂的硬件布线，只需在 PMS 系统中集成几行代码，利用 reset（先断后通） 硬件级定时命令，即可实现高精度的客房进出权限自动化管理。该方案不仅提升了钟点房、在线续住的运营效率，还利用硬件本身的计时能力降低了服务器负载，是构建智慧酒店高性价比的选择。