基于芯步的开放接口，本文档介绍如何对接吸顶式人体红外传感器实现楼宇节能联动。涵盖设备选型、接口对接流程、核心联动逻辑（含防误报策略和延时补偿机制），以及常见场景配置方案。
1. 概述
在现代办公与楼宇环境中，照明及空调的能源浪费现象普遍。本方案基于芯步开放的 HTTP API 接口，通过对接智能人体存在传感器（吸顶式） ，实现“人来即开，人走即关”的自动化节能模式。该方案不仅涵盖基础的单设备控制，还引入防误报及延时补偿机制，以兼顾节能效率与用户体验。
2. 核心设备选型与能力
本方案核心采用 UNI-CGQ-RT-XD-H 智能人体存在传感器。
探测机制：采用红外感应技术，5米内探测范围，适合吸顶安装，覆盖办公室、卫生间、走廊等区域。
输出能力：设备自带一路 AC 输出（继电器），可直接串联进照明回路，实现物理通断；
通信协议：支持 Wi-Fi （2.4GHz） 联网，固件开放 HTTP 接口，支持云端/本地双向通信。
3. 开放接口对接流程
芯步的开放平台支持全量消息推送和设备控制，所有接口永久免费，对接步骤如下
3.1 环境准备
注册与创建：在芯步官网注册账号并创建工作台；
获取凭证：在“物联网控制台”获取 AppID 和 AppSecret（开发者密码），用于接口鉴权。
3.2 核心接口调用机制
| 交互方向 | 实现的方式是 | 技术说明 |
|---|---|---|
| 设备 → 服务器（上行） | HTTP 推 | 当传感器探测到有人/无人变化时，立即将 infrared_target（1有人/0无人）状态推送到开发者指定的服务器 |
| 服务器 → 设备（下行） | HTTP 命令 | 服务器收到上报后，下发控制指令给传感器（断开/闭合继电器）或联动第三方设备 |
下行控制示例：当服务器判断无人时，向设备发送断开指令：
4. 节能联动逻辑算法设计
为了实现真正的“无感节能”，单纯的“有人开、无人关”是不够的。必须结合物理安装特性与软件算法优化。
4.1 基础联动策略
利用设备自带的属性即可实现基础节能：
第一种场景：固定场所节能（卫生间/单间办公室）
逻辑：红外状态变化 → 触发动作。
配置：设置
relay_change_1为1（感测到有人时，继电器闭合通电）；设置relay_change_0为0（感测到无人时，继电器断开）。效果：开灯/关灯完全由传感器物理通断控制，延迟极低。
第二种场景：服务器逻辑控制（开放空间/会议室）
逻辑：传感器仅作为数据源，由服务器处理防误报策略，再控制智能开关或插座。
防误报（Debounce）处理红外传感器对细微移动敏感，但静止时（如人在办公桌前打字）可能误判为无人。服务器端设置 4-5 分钟 的确认窗口期。即：仅当连续上报“无人”状态达到
N分钟（如5分钟）后，才执行关闭电器动作。
4.2 高级容错与补偿策略
参考行业先进的补偿逻辑，为避免能源浪费或因误判导致用户体验下降，整合 “照度辅助判断”
| 上报状态 | 辅助条件（照度/时间） | 执行动作 |
|---|---|---|
| 无人 | 若照度传感器显示 超过 10分钟内 无剧烈变化 | 立即断电 |
| 无人 | 若处于 午休/加班时段（12：00-13：00/22：00后） | 缩短延时（立即断电） |
| 有人 | 若 光线充足（照度 > 300lux） | 只开空调/新风，不开灯 |
| 状态停滞 | 传感器故障一直报“有人” | 依赖服务器定时任务强制触发“无人”场景 |
5. 关键参数配置表（物模型调优）
在设备安装入网后，需通过接口或控制台修改以下配置项，以适配节能需求
| 配置项 ID | 名称 | 推荐节能设置值 | 作用说明 |
|---|---|---|---|
| infrared_change_1 | 红外“有人”触发持续时间 | 0 （马上） | 探测到人立即响应，减少等待时间 |
| infrared_change_0 | 红外“无人”触发持续时间 | 60 或 120 （秒） | 核心节能参数。防止人短暂不动（如坐姿）就误判关灯，设定为1-2分钟缓冲区 |
| led | 指示灯 | 0 （长灭） | 关闭传感器自带指示灯，节能且避免暗光环境下光污染 |
| relay_change_0 | 发现“无人”时线路动作 | 0 （关闭） | 确认无人后切断负载电源 |
| relay_change_1 | 发现“有人”时线路动作 | 1 （打开） | 确认有人后接通负载 |
| relay1 | 线路开机状态 | 0 （断） | 设备重启或断电上电后，默认保持关闭状态，确保安全 |
6. 典型应用场景解决方案
6.1 办公室/会议室
痛点：员工离开去吃饭或开会，空调/灯光常开。方案
在吊顶中央安装吸顶传感器；
联动逻辑
状态1（有人）：服务器记录时间戳，并保持电力供应；
状态2（无人保持 10分钟）：服务器下发
power：0命令，通过智能插座切断显示器和饮水机电源；状态2（无人保持 30分钟）：切断空调电源（保护压缩机延时）。
6.2 走廊/洗手间
痛点：需要比较高灵敏度，人走必须立刻灭灯，避免长明灯。方案
配合自带的 AC输出 接线，直接串联 LED 灯；
配置：设置
infrared_change_0（无人触发时间）为30（秒）。效果：人离开 30秒后，继电器断开，物理断电，无需经过云端服务器，即使断网也能节能。
7. 实施注意与异常处理
安装位置：吸顶安装应避免正对空调出风口（温差干扰）或大型金属物体（信号屏蔽），安装高度 2.5m-3.5m。
断网容灾：芯步设备支持本地联动规则设置。为确保节能策略在断网时依然生效，在设备配置中预设好
relay_change_0规则。负载限制：该传感器内置继电器负载能力有限，阻性负载 2200W，感性负载 350W。控制大型灯具或空调时，应通过传感器控制交流接触器，而非直接接入大功率设备。
8. 结论
通过对接芯步吸顶式人体传感器的 HTTP 开放接口，开发者可以快速构建响应迅速、逻辑严密的楼宇节能系统。方案不仅利用设备自身的硬件逻辑保障了基础功能（人走灯灭），更通过服务端的数据分析，实现了如下班断电、假日模式等高级节能联动，综合节能率预计可达 20%-35%。