芯步的智能硬件通过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秒)足够客人开门推门进入,随后自动恢复上锁状态,确保安全 。
第二种场景:物理状态感知
需求痛点: 客人刷卡进门后只是推开门缝忘记推门,或者门被异物阻挡未关严。技术实现: 逻辑推演与实时上报。由于普通继电器只能反馈“是否通电”,若需感知门的物理开合,可结合以下两种方式:
逻辑推演(低成本): 设备在无人操控下,如果接收到“开门指令”后,系统默认门被推开了,随后在预设时间(如60秒)内若门磁传感器未复位,触发“门未关严”报警。
联动门磁(推荐): 虽然基础版开关只有通断功能,但系统架构上可预留接口。当门关闭时,门磁传感器触发信号,PMS显示“已锁好”;当门打开超过2cm,状态变更为“异常开启”。
第三种场景:入住权限自动下发
需求痛点: 客人办理入住后,房卡或密码需立即生效。技术实现: PMS系统与接口联动。
密码管理: 针对密码门禁,PMS调用接口设置临时密码。
命令:
{"pwd":"123456"}—— 设置开门密码为123456。时效控制: 配合定时任务,在预离日期当天23:59:59,PMS自动调用
{"clear":""}清空该房间密码,防止已退房卡未交回的安全隐患 。
5. 状态反馈与控制逻辑流程
一个完整的“入住-开门-反馈”闭环流程如下:
入住办理:
前台在PMS办理入住。
PMS后台调用芯步
set_pwd接口,为该房间设备设置一个时效性密码(或激活房卡权限)。PMS记录日志:“XX房密码已下发”。
客人开门:
客人在门口输入密码或刷卡。
芯步设备验证通过,继电器动作,电锁开门。
反馈回传: 虽然设备本身不主动推送所有HTTP事件,但PMS可以结合轮询或通过设备的功率计量变化(如门锁动作瞬间电流波动)来记录“有人开门”事件,更稳妥的方式是在门口加装出门按钮传感器。
状态监控:
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,无需额外购买昂贵的物联网网关,降低了单房改造成本。
节能管理: 通过功率计量功能,实时监测门锁电路的电流情况,还能侧面判断门锁电机是否故障,辅助工程维修判断 。
实施步骤:
环境准备: 采购芯步智能墙壁开关(86型),确认客房门口有零火线布局。
设备调试: 使用芯步官方APP给设备配网,获取
Device ID。API联调: 在后端代码中,参照签名算法,封装一个
DoorControl(device_id, action)函数。业务对接: 在PMS的“Check-In”和“Check-Out”按钮后台,插入调用该函数的代码逻辑。