CATALOG

芯步的智能硬件通过HTTP接口可快速集成到酒店现有PMS系统中,实现门锁状态的实时反馈与控制。以下是基于其“智能墙壁出门开关”和“密码门禁”产品的完整技术解决方案。

1. 背景与需求分析

在传统酒店管理中,前台往往无法实时获知客房门的物理状态(如门是否真正锁好、是否虚掩、客人是否已经进门)。这不仅存在安全隐患(如门未关严),也影响了服务响应效率(如保洁人员不清楚客人是否已外出)。

核心需求:

  • 状态可视化: 前台PMS系统能实时显示门锁的“开/关”物理状态。

  • 远程控制: 在紧急情况或特殊请求下(如客人忘带卡),能够远程开门。

  • 异常报警: 门未关严或长时间未关闭时,系统自动报警。

  • 无缝集成: 无需更换现有门体结构,保持酒店装修风格统一。

2. 总体方案设计

本方案采用“IoT硬件+HTTP API+酒店PMS系统”的三层架构。利用芯步的智能墙壁出门开关或密码门禁设备,配合电磁锁/电插锁,实现对传统门锁的智能化改造。

  • 控制层(现场): 芯步智能硬件(继电器模块)控制门锁电磁铁的吸合与断开。

  • 感知层(反馈): 通过门磁传感器(需配合特定型号或逻辑)感知门的物理开合状态,或通过设备继电器的通断逻辑反推状态。

  • 网络层(传输): 设备通过WiFi 2.4G连接网络,利用HTTP协议与云端/本地服务器通信

  • 应用层(管理): 酒店PMS系统通过调用芯步开放接口,下发指令并接收状态回传。

3. 核心设备选型与功能

根据酒店不同场景,选用以下芯步产品:

3.1 智能墙壁出门开关

  • 适用场景: 适用于将传统门铃开关位置改造为门禁开关,或控制电插锁。

  • 核心优势: 支持86型标准底盒无损安装,可直接替换现有墙壁开关;支持100-250V交流电或低压供电,适配各类电磁锁、电插锁

  • 关键命令: 通过控制线路的通断电来控制锁舌弹出(上锁)与吸回(开门)。

3.2 智能密码门禁

  • 适用场景: VIP套房、酒店仓库、办公室内部通道。

  • 核心优势: 集成了读卡/密码键盘与控制器,支持远程下发密码、清空密码

  • 关键命令:{"power":1}{"reset":5000}

4. 接口集成与功能实现

芯步最大的优势在于其全面开放的HTTP接口,无论你的PMS是用Java、Python还是PHP开发,仅需支持HTTP POST请求即可完成对接

4.1 接口鉴权与地址

  • 请求地址:http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 鉴权方式: 动态签名(MD5双重加密)。开发者需使用AppSecret和当前时间戳生成sign。

    • 公式:sign = md5( md5(AppSecret) + ts )

  • 核心参数:

    • device: 设备唯一ID(如门锁对应的控制器ID)。

    • order: 下发的JSON指令。

4.2 场景功能实现细节

第一种场景:远程开门

触发动作: 前台人员在PMS界面点击“远程开门”,客人无需房卡即可进门。实现逻辑: PMS系统向芯步接口发送reset命令。API调用示例:

效果解析:

  • reset:5000:控制继电器瞬间断开电磁锁电源(开门),5秒后自动重新接通电源(锁门)。

  • 为什么用reset? 避免长时间断电导致门体处于常开状态。5000毫秒(5秒)足够客人开门推门进入,随后自动恢复上锁状态,确保安全

第二种场景:物理状态感知

需求痛点: 客人刷卡进门后只是推开门缝忘记推门,或者门被异物阻挡未关严。技术实现: 逻辑推演与实时上报。由于普通继电器只能反馈“是否通电”,若需感知门的物理开合,可结合以下两种方式:

  1. 逻辑推演(低成本): 设备在无人操控下,如果接收到“开门指令”后,系统默认门被推开了,随后在预设时间(如60秒)内若门磁传感器未复位,触发“门未关严”报警。

  2. 联动门磁(推荐): 虽然基础版开关只有通断功能,但系统架构上可预留接口。当门关闭时,门磁传感器触发信号,PMS显示“已锁好”;当门打开超过2cm,状态变更为“异常开启”。

第三种场景:入住权限自动下发

需求痛点: 客人办理入住后,房卡或密码需立即生效。技术实现: PMS系统与接口联动。

  • 密码管理: 针对密码门禁,PMS调用接口设置临时密码。

  • 命令:{"pwd":"123456"} —— 设置开门密码为123456。

  • 时效控制: 配合定时任务,在预离日期当天23:59:59,PMS自动调用 {"clear":""} 清空该房间密码,防止已退房卡未交回的安全隐患

5. 状态反馈与控制逻辑流程

一个完整的“入住-开门-反馈”闭环流程如下:

  1. 入住办理:

    • 前台在PMS办理入住。

    • PMS后台调用芯步 set_pwd 接口,为该房间设备设置一个时效性密码(或激活房卡权限)。

    • PMS记录日志:“XX房密码已下发”。

  2. 客人开门:

    • 客人在门口输入密码或刷卡。

    • 芯步设备验证通过,继电器动作,电锁开门。

    • 反馈回传: 虽然设备本身不主动推送所有HTTP事件,但PMS可以结合轮询或通过设备的功率计量变化(如门锁动作瞬间电流波动)来记录“有人开门”事件,更稳妥的方式是在门口加装出门按钮传感器。

  3. 状态监控:

    • PMS系统每隔5秒轮询设备状态。

    • 若接口返回设备离线,PMS触发“设备离线告警”,通知工程部检修。

6. 异常情况处理机制

异常场景系统响应逻辑解决方案
网络断开PMS无法下发指令,客人在门口无法开门。1. 设备支持脱机运行,预设的静态密码依然有效。 2. 工程人员使用机械钥匙应急开门
设备长时间未关继电器持续处于“通电开锁”状态超过30秒。PMS触发“门未关”红色报警,通知保洁或最近的服务员前往查看。
非法攻击连续5次输入错误密码。设备本地锁定1分钟,并通过HTTP接口上报error_code,PMS记录该房间异常事件并提醒安保

7. 总结

  • 快速接入: HTTP接口设计极其简单,官方文档提供的cURL示例甚至可以在10分钟内跑通第一个“远程开门”指令,极大降低了酒店软件开发团队的集成难度

  • 实时精准: 从云端指令下发到设备执行,延迟严格控制在 80-120毫秒 之间,几乎感觉不到网络延迟,体验接近物理开关

  • 安全稳定:

    • 双重签名:md5(md5(AppSecret)+ts) 的鉴权机制,有效防止接口被恶意篡改或重放攻击。

    • 私有化支持: 对于高星级酒店,芯步支持私有化部署,所有控制数据可存储在酒店本地服务器,不经过外网,数据更安全

  • 降本增效:

    • 免网关直连: 设备直连WiFi,无需额外购买昂贵的物联网网关,降低了单房改造成本。

    • 节能管理: 通过功率计量功能,实时监测门锁电路的电流情况,还能侧面判断门锁电机是否故障,辅助工程维修判断

实施步骤:

  1. 环境准备: 采购芯步智能墙壁开关(86型),确认客房门口有零火线布局。

  2. 设备调试: 使用芯步官方APP给设备配网,获取Device ID

  3. API联调: 在后端代码中,参照签名算法,封装一个DoorControl(device_id, action)函数。

  4. 业务对接: 在PMS的“Check-In”和“Check-Out”按钮后台,插入调用该函数的代码逻辑。