芯步的门禁产品开放标准HTTP接口，可快速将出门开关、密码门禁等设备集成到酒店PMS系统中。以下方案以“智能墙壁出门开关”为核心，实现客人按按钮出门即断电、插卡取电与门禁联动的完整控制逻辑。
1. 项目概述与背景
在现代酒店智能化改造中，能耗管理与无卡化体验是两大核心诉求。传统的机械式出门开关仅能控制门锁，无法与客房电源联动，常导致客人外出后空调、灯光空转，造成巨大能源浪费。
本方案基于芯步的智能硬件生态，利用其全系产品开放的HTTP API接口，将“智能墙壁出门开关”无缝集成至酒店现有的PMS（物业管理系统）或客房控制系统中。实现“一键离房，自动断电报退房预备；一键插卡，智能识人联动门禁”的智能化场景。
2. 硬件选型与接口能力
本方案主要选用芯步生态中的以下两款硬件，利用其统一的接口协议进行开发：
| 设备类型 | 推荐型号/示例 | 核心API能力 | 在本方案中的作用 |
|---|---|---|---|
| 智能墙壁出门开关 | Uni-YY-... (86型) | 支持 reset（先断后通）命令，支持线路通断控制、功率计量 | 替代传统出门按钮，检测“离房”动作，控制门锁及强电继电器 |
| 智能密码门禁 | 触摸版门禁控制器 | 支持 pwd（动态密码下发）、delete（密码清除）、事件上报 | 实现远程下发入住密码、定时清退权限 |
| 智能传感器 | 人体存在雷达传感器 | 支持 radar_enable、有人/无人状态上报 | 辅助判断房间是否有人，防止误断电 |
芯步开放接口优势：所有设备均支持HTTP/HTTPS请求，无需私有SDK，兼容局域网与公网环境，响应速度在80-120ms之间。
3. 硬件集成拓扑结构
为了实现“出门断电”且“非客人误触”，采用以下物理接线与网络拓扑：
接线逻辑
强电控制：智能出门开关的“线路输出端”串联至客房总电源接触器的线圈回路。
弱电控制：开关的IO接口连接门锁控制线（电磁锁）。
直连Wi-Fi：设备通过2.4G Wi-Fi直连酒店AP，无需额外网关。
数据流
开关触发 -> 发送HTTP POST请求至云端/本地服务器 -> 服务器鉴权 -> 下发“断开”指令（reset）至开关 -> 开关切断继电器（断电）并开门。
4. API接口调用详细逻辑
这是实现智能控制的关键环节。芯步的接口签名机制确保了数据安全。接口地址示例：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
以下是“出门开关”控制门禁断电的核心代码逻辑（伪代码）：
场景 A：客人按下出门开关
触发：客人离开房间按下开关。
上报：设备向酒店服务器上报
button_pressed事件。联动逻辑
服务器接收事件。
调用该设备的
reset接口。执行效果
线路断开 -> 电磁锁失电 -> 门锁打开。
线路断开 -> 继电器切断 -> 客房内空调、普通照明电源关闭（保留冰箱等常供电线路）。
状态同步：服务器通知PMS系统，该房间状态更新为“无人/真空”，保洁或退房系统可准备介入。
场景 B：客人插卡取电 / 入住激活
为了解决“客人刚进门还没插卡，门就关了”的问题，需要配合门磁或取电开关逻辑：
当客人在前台Check-in时，PMS通过接口下发初始化命令（清除上一个客人的密码）。
客人推门进入（门磁感应），传感器上报状态。
服务器自动禁止出门开关的“全屋断电”功能（或设置短时延时），给客人插卡取电预留时间。
5. 增值功能：从“出门断电”到“全场景智慧”
利用芯步产品的扩展性，可以进一步优化酒店体验：
A. 远程退房与延时断电
场景：客人通过手机APP点击“退房/出门”。
逻辑：调用
power（线路）接口关闭电源。优势：客人可直接离开现场时，无需返回前台，后台自动执行断电清洁流程。
B. 动态密码门禁联动
使用智能密码门禁替代实体房卡
下发：客人入住时，PMS系统调用
pwd接口，将客人手机号后四位设为临时密码，并设置有效期（如：start_time+end_time）。清理：退房时间到，系统自动调用
delete或clear接口清除密码，无需回收房卡。
C. 防误判机制（传感器联动）
痛点：客人在阳台抽烟或上厕 所，厕所内人体传感器检测到“有人”，此时如果误按出门开关，是否断电？
解决：通过服务器逻辑判断。如果收到“出门开关按下”指令，但该房间的雷达传感器（
radar_enable状态）仍显示“有人”，则服务器下发指令拒绝断电（或仅开门不断电），提升用户体验。
6. 开发实施步骤
注册开发者账号：在芯步开放平台（ThingBoot Open）获取 AppId 和 AppSecret，配置消息推送地址。
设备配网与绑定：将智能出门开关通电，配置Wi-Fi（支持5组Wi-Fi备份，确保网络稳定），并将设备ID与酒店房号在后台进行绑定映射。
搭建本地/云服务器
推荐使用私有化部署方案，将 API 地址指向酒店内网服务器，确保在外网断开时，客房控制依然正常。
实现签名算法（Sign），防止恶意篡改。
业务逻辑开发
编写处理“开关按下”事件的Webhook。
配置定时任务（例如：每天中午12点自动清除所有过期房客的密码权限）。
利用
power命令接口开发总控制台页面。
测试与联调：使用 Postman 模拟
reset命令，测试设备响应时间（应小于200ms），并进行压力测试。
7. 总结
即装即用：86盒标准尺寸，可直接替换传统开关，不需要大规模布线改造。
开发友好：标准的HTTP接口，JSON数据格式，任何后端语言（Java, Python, Go, Node.js）都能在1天内完成对接。
高 ROI（投资回报率）：通过精准的“人走电断”，预计为酒店节约 20%-30% 的空调与照明能耗，硬件成本通常在3-6个月内通过电费节省收回。
运维便捷：设备支持功率计量，工程部可远程监测门锁电流是否异常，提前发现门锁故障。
通过上述集成方案，酒店不仅实现了基础的“出门开关控制门禁”，更升级为了一套完整的 “智慧节能与无卡化入住系统” 。