口哨 / 声音传感器（CYD）

ESP32 Cheap Yellow Display + 三针口哨模块（高低电平）+ LVGL。

默认 2.8"（env:cyd）；可选 3.5" C（env:cyd_35r）。引脚约定见上级 CYD_PROJECT_GUIDE.md。

硬件

项目	2.8" · 2432S028R	3.5" C · 3248S035C
屏 / 触控	ILI9341 + XPT2046 SoftSPI	ST7796 + GT911 I2C
横屏 UI	320×240	480×320（UX/UY 缩放）
背光	GPIO21	GPIO27
口哨信号	GPIO22	GPIO22（两板相同）

模块：三针口哨/声音传感器（顶部黑头麦克风，OUT 高低电平）。

接线：VCC→3.3V，GND→GND，OUT / DO / S→GPIO22。

默认 高电平 = 有声。若实际相反，改 include/pins.h 里 SOUND_ACTIVE_HIGH 为 0。板上电位器调节灵敏度。

功能 / 操作

• 实时显示 QUIET / SOUND!、引脚 HIGH/LOW 与 active/idle
• 触发时进度条闪动；边沿计数 hits（约 40ms 消抖）
• 触控底部 Reset：清零 hits
• 无分贝：数字口 + GPIO22 非 ADC，无法测 dB

界面自上而下分区（互不重叠）：标题 → 引脚 → 状态 → 电平 → 条 → hits → Reset。

构建 / 烧录

依赖 PlatformIO。

# 2.8"
pio run -e cyd -t upload
# 3.5" C
pio run -e cyd_35r -t upload
pio device monitor -b 460800

预编译固件

cd firmware\cyd        # 2.8"
# 或 cd firmware\cyd_35r
.\flash.ps1
# 或 .\flash.ps1 -Port COM4

源码更新后重新打包：

.\firmware\export_from_build.ps1            # 2.8
.\firmware\export_from_build.ps1 -Env cyd_35r

项目结构

platformio.ini                 # env:cyd + cyd_35r，TFT_eSPI + lvgl
copy_lv_conf.py
include/
  pins.h                       # 按 CYD_BOARD_3248S035 分支；SOUND_PIN=22
  sound.h / touch.h / ui.h / lv_conf.h
src/
  main.cpp
  sound.cpp                    # 数字高低电平采样 + 消抖计数
  touch.cpp                    # 2.8 SoftSPI / 3.5 GT911，勿空想改脚
  ui.cpp                       # 横屏状态页
firmware/cyd / cyd_35r         # 预编译包 + export_from_build.ps1
README.md

变更记录

日期	说明
2026-10-23	初版：三针口哨 GPIO22 高低电平检测、hits、LVGL UI、可刷 firmware/cyd
2026-10-23	修 UI：Reset 与 hits/提示重叠，改为自上而下固定分区布局
2026-10-25	按指南修正 3.5：背光 GPIO27、GT911 INT 复位后改 INPUT；导出 firmware/cyd_35r