# 三脚按键模块计数（CYD）

GPIO22 读三脚轻触按键模块：每按一次，屏幕计数 +1。

跨板对照与避坑：上级目录 [`../CYD_PROJECT_GUIDE.md`](../CYD_PROJECT_GUIDE.md) **§A**（2.8 vs 3.5：触控 / 背光 / 外设脚）。

## 硬件

| 项目 | 2.8"（默认 `cyd`） | 3.5C（`cyd_35r`） |
|------|-------------------|-------------------|
| 板子 | ESP32-2432S028R · ILI9341 | ESP32-3248S035C · ST7796 |
| 触控 | XPT2046 SoftSPI | GT911 I2C |
| 背光 | GPIO21 | **GPIO27**（误用 21 = 黑屏） |
| 按键 OUT | **GPIO22** | **GPIO22**（第一脚不变；3.5 勿接 27） |
| 供电 | USB 5V | 同左 |

### 接线（两板相同）

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

开机自动采空闲电平，反相视为按下（兼容「按下变高」或「按下变低」）。

屏上 `OUT HIGH/LOW` 与 `act=`：按下时 OUT 应变到 `act` 那一侧并 +1。

## 操作

- 按一下：计数 +1（上电时请勿按住）
- 触控 **Reset**：清零

## 构建与烧录

```bash
# 2.8"
pio run -e cyd -t upload

# 3.5C
pio run -e cyd_35r -t upload
```

### 预编译固件

| 目录 | 板型 |
|------|------|
| [`firmware/cyd/`](firmware/cyd/) | 2.8" |
| [`firmware/cyd_35r/`](firmware/cyd_35r/) | 3.5" |

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

源码更新后重新打包：

```powershell
.\firmware\export_from_build.ps1
.\firmware\export_from_build.ps1 -Env cyd_35r
```