民宿场景中，人体感应照明最难解决的是“误判”——风扇吹动窗帘、宠物跑动都可能让普通传感器误亮灯。芯步的吸顶式传感器支持红外状态变化的持续时间配置，你可以在有人触发和无人触发两个维度分别设置延时参数，配合其开放接口，就能实现精准的人来灯亮、人走灯灭。
——基于芯步吸顶式智能人体感应器的开放接口
1. 项目概述与目标
在民宿场景中，客人入住时经常面临摸黑插卡取电、夜间如厕找不到开关等痛点。本方案的目标是利用芯步的吸顶式智能人体存在传感器和智能墙壁开关，通过标准的 HTTP 接口 将硬件无缝集成到您现有的民宿管理系统中，实现“人来灯亮，人走灯灭”的无感与节能体验。
该方案的核心优势在于：传感器与执行器之间通过 Wi-Fi 直连局域网或云端，无需网关，极大降低了集成门槛。
2. 硬件选型与特性
本方案主要基于以下两款硬件进行集成开发：
2.1 检测层：智能人体存在红外传感器 [吸顶]
型号参考：UNI-CGQ-RT-XD-H
安装方式：吸顶式（安装在卫生间、走廊或玄关天花板，探测直径约 4-6 米）。
核心物模型
infrared_target： 核心状态值。值为1表示“有人”，值为0表示“无人”。infrared_enable： 红外模块的开关，值为1或0。
2.2 执行层：智能墙壁开关（1路/2路/3路）
安装方式：标准 86 型底盒，直接替换原有机械开关。
核心功能：接收来自服务器或本地逻辑的控制命令，控制照明电路的通断。
3. 系统架构与数据流设计
为了实现高响应度的“感应照明”，采用边缘计算优先，云端备份的架构。由于该传感器支持 Wi-Fi 直连及局域网 HTTP 通信，室内无需部署额外的网关设备，降低了硬件成本和故障点。
3.1 消息上行（设备 to 服务器）
当传感器检测到环境状态变化（如从无人变为有人，或反之），它会立即通过 HTTP 协议推送数据到您配置的服务器地址。
消息推送格式（示例）：
3.2 消息下行（服务器 to 设备）
服务器解析传感器数据后，通过调用芯步的开放接口，下发控制指令到指定的墙壁开关。
4. 详细集成步骤
请遵循以下步骤完成从设备注册到逻辑控制的集成。
4.1 环境准备与设备注册
注册开发者账号：在芯步开放平台获取
AppId和AppSecret，这是后续接口调用的凭证。设备配网：通过官方 App 或自研小程序，将传感器和墙壁开关连接至民宿客房的 2.4G Wi-Fi 网络。
获取设备 ID：在后台记录下安装在“1号民宿-卫生间”的传感器 ID（如：820720）和开关 ID（如：820721）。
4.2 关键参数配置（物模型设置）
为了提高系统响应速度并避免误判，通过接口修改传感器的配置项，实现“二次确认”，详见文档第 4.4 节实现代码。
4.3 接口调用逻辑实现
你需要在后端编写两个核心逻辑：
A. 接收消息（Webhook 搭建）
在您的服务器中开放一个 API 接口（URL），将此地址配置到芯步平台的消息推送设置中。当有人进入房间时，传感器会立即向该地址发送 POST 请求。
路径示例：
POST /api/yoyoiot/webhook业务逻辑
接收 JSON 数据。
判断
infrared_target是否为 1。注意时效性：若传感器配置为“有人立即触发”，此时应立即调用控制接口开灯。
B. 下发命令
当后端判定“有人”后，需向开关发出“闭合”指令。
请求地址：
http(s)://api.thingboot.com/{AppId}/device/control/请求方法： POST
鉴权头部：需携带
sign(签名) 和ts(时间戳)。签名算法为md5(md5(AppSecret) + ts)。请求体
4.4 核心集成代码示例 (伪代码/逻辑演示)
以下逻辑需部署在您的后端服务中：
5. 关键功能深化：高级配置逻辑
为了避免出现“人还在动，灯却灭了”的糟糕体验，可以利用传感器的高级配置项优化逻辑。在设备初始化时下发如下配置
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 红外有人触发持续时间 | 0 (马上) | 检测到人的第一秒立即触发“有人”事件，保证开灯无延迟。 |
| 红外无人触发持续时间 | 60 (60秒) | 关键点。设置 60 秒。只有当传感器连续 60 秒检测不到人，才上报“无人”事件。这可以防止客人在洗澡或如厕时（动作幅度小）灯光突然熄灭。 |
| 发现无人时线路动作 | 0 (关闭) | 允许系统在确认无人后自动关闭线路。 |
| 发现有人时线路动作 | 1 (打开) | 允许系统在发现有人后自动打开线路。 |
注：如果开启设备的“设备联动”自主模式，这几项配置完成后甚至可以不写代码；但如果希望将“有人/无人”记录到订单报表中分析能耗，则仍需通过 HTTP 接口接收数据。
6. 私有化部署与数据安全（可选）
考虑到民宿可能涉及住客隐私（如卫生间使用时间等），芯步产品支持 私有化部署方案。
纯局域网运行：您可以在民宿的本地服务器（或高性能路由器）上部署 Broker 或接收端。
优势：所有的“有人/无人”数据只在民宿内部网络传输，不上传至公有云，满足高端民宿对客户隐私的合规要求。
7. 总结
通过集成芯步的吸顶式传感器，您不仅能实现基础的“照明联动”，还能通过其开放的 HTTP 接口和精细的物模型配置，解决误判、延时等行业痛点。其 Wi-Fi 直连 特性大幅简化了布线施工难度，非常适合民宿的轻量化、快速化改造需求。