# 人体红外感应模块（CYD）

GPIO22 读人体红外（PIR）模块 OUT：每次检测到运动开始，屏幕计数 +1。

## 硬件

| 项目 | 说明 |
|------|------|
| 板子 | CYD ESP32-2432S028R |
| 模块 | 三脚小型人体红外（卖家常写 mini SR501，实际多为 **HC-SR505**） |
| 供电 | **3.3V**（本工程已实测可用） |
| 输出 | **GPIO22** |

> 大圆头带电位器的是 HC-SR501，接线相同；大模块更稳妥用 5V。本仓库默认按小模块 + 3.3V 写。

### 接线

| 模块 | CYD |
|------|-----|
| VCC | **3.3V** |
| GND | **GND** |
| OUT / S / DO | **GPIO22** |

引脚用浮空 `INPUT`（无内部上/下拉）。默认空闲 LOW、有人 HIGH；开机若采样明显偏 HIGH 则自动反相。

屏上：

- `MOTION` / `IDLE`：当前是否感应到人
- `hold` + 进度条：本次连续有人时长（约 0～5s 满格）
- `OUT HIGH/LOW` 与 `act=`：原始电平与有效电平 —— 挥手时 OUT 应变 HIGH

注意：

- 上电后约 **30～60 秒** 预热，此前可能无反应或乱跳
- OUT 接 **GPIO22**（勿接 21 背光），必须共地
- 小模块一般无灵敏度旋钮；检测距离大约 3m 量级

## 操作

- 在感应范围内走动/挥手：计数 +1（模块保持时间内只计一次开始边沿）
- 触控 **Reset**：清零

## 构建 / 烧录

```bash
pio run -e cyd -t upload
```

预编译包：

```powershell
cd firmware\cyd
.\flash.ps1
# 或 .\flash.ps1 -Port COMx
```

导出固件：

```powershell
.\firmware\export_from_build.ps1
```