PIR传感器的灵敏度调节，传统方案依赖硬件旋钮，芯步的开放接口方案则将这一能力软件化——通过infrared_change_1和infrared_change_0两个配置参数，你可以精确控制触发的持续时间阈值。以下方案基于芯步产品手册中的物模型设计。
1. 背景与技术原理
被动红外传感器（PIR）的工作原理是探测人体发射的红外线变化。在传统硬件方案中，灵敏度通常通过设备上的物理旋钮（如SX旋钮）调节探测距离（如3-7米）。
在芯步的智能硬件体系下，设备不仅具备传统的物理调节方式，更开放了 HTTP API 接口，允许开发者通过云端或局域网直接下发指令，实现软件层面的“虚拟灵敏度”调节。这种调节主要并非改变硬件的探测距离，而是改变触发逻辑的判定阈值和触发后的消隐时间，从而适应不同场景（如办公位检测 vs 走廊安防）。
2. 核心调节参数（物模型）
根据芯步《智能人体存在红外传感器》的产品定义，调节灵敏度主要涉及以下配置项。开发者需通过调用控制接口，修改设备Flash中的这几个关键参数
| 配置项 | 参数Key | 作用说明 | 调节逻辑 |
|---|---|---|---|
| 红外开机状态 | infrared | 定义设备通电时红外模块是否工作 | 设为 1 (打开) |
| “有人”触发持续时间 | infrared_change_1 | 这是实现灵敏度调节的关键：当传感器探测到人体后，需维持“有人”状态多infrared_change_1少秒才上报“有人”事件。 | 数值越小，灵敏度越高（立即响应）；数值越大，越不灵敏（用于过滤微小干扰）。 |
| “无人”触发持续时间 | infrared_change_0 | 关键的灵敏度调节参数：当人离开后，需连续检测“无人”状态多少秒才真正上报“无人”事件。 | 数值越小，越灵敏（人一走就关）；数值越大，越稳定（防止短暂的无人瞬间误报）。 |
3. 接口调用方案（实现灵敏度调节）
要实现上述调节，需要向指定设备下发配置命令。芯步采用标准的 HTTP POST 请求进行控制 。
3.1 请求地址与鉴权
注：实际地址以芯步控制台分配的API Endpoint为准。
3.2 调节灵敏度的请求示例
假设我们需要将安装在大堂的传感器调节为“高灵敏度”模式（即立即感应有人进入，人离开后迅速恢复），我们可以设置：
infrared_change_1：0(有人时，持续0秒，即立即上报)infrared_change_0：30(无人时，持续30秒才上报无人，防止风或窗帘晃动导致的误报)
JSON请求包体：
3.3 调节为“低灵敏度”/“省电”模式的示例
如果场景是仓库走廊，需要避免小动物（老鼠）走动引起误报，可以将灵敏度调低：
infrared_change_1：5(需持续探测到人体5秒后才认为是真有人，过滤快速跑过的小动物)。
JSON请求包体：
3.4 同步控制红外模块开关
也可以通过 API 远程关闭红外感应功能（如某些特定时段不需要监控）：
4. 数据监测与闭环反馈
调节灵敏度后，芯步的设备会通过事件上报机制，实时反馈环境状态。你需要搭建一个消息推送接收端（HTTP Server） 来接收这些数据，以验证灵敏度设置是否符合预期。
当设备探测到状态变化时，会向预设的服务器地址推送如下数据：
工作流：收到上报数据 -> 如果发现“有人/无人”状态切换频率过高（抖动） -> API下发调大 infrared_change_1 或 infrared_change_0 数值 -> 观察新的上报数据。
5. 实施和需要注意的点
独立调节能力：芯步的设备允许将
infrared_change_1和infrared_change_0分开设置。例如，设置为 “进入立即开（0秒），延迟关（600秒）”，这比传统的物理旋钮（Tx只能整体调节延时）提供了更灵活的软件定义能力 。硬件基础：虽然 API 能调节逻辑灵敏度，但如果物理上人体红外信号本身极弱（例如距离超过 5-7米 或 遮挡严重），API 调节无法弥补。请确保传感器安装在合适高度（通常吸顶 2.5-3米）且无遮挡 。
私有化部署：如果对数据安全要求比较高，芯步支持私有化部署方案。你可以将上述 API 和消息服务器部署在本地局域网内，此时无需走公网，延迟更低 。
通过以上配置，你可以利用芯步的开放接口，将原本依赖人工现场扭动旋钮的灵敏度调节工作，完全转变为远程、可视化的云控制流程。