Align 3.5C pins with CYD_PROJECT_GUIDE: TFT_BL=27, SGP30 SDA22/SCL21.

Leave 2.8 wiring unchanged; release GT911 INT after reset so SCL21 can share CN1.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-10-25 10:53:33 +08:00
parent 1b2fe27fd9
commit ee2ca3edfc
16 changed files with 487 additions and 92 deletions

View File

@@ -1,20 +1,22 @@
# CYD SGP30 空气质量仪表盘
ESP32 Cheap Yellow Display(ESP32-2432S028R)+ SGP30 + LVGL 空气质量仪表盘。
ESP32 Cheap Yellow Display + SGP30 + LVGL 空气质量仪表盘。
布局与交互参考同目录下的 [temperature](../temperature) 温湿度项目。
默认 **2.8" ESP32-2432S028R**;可选 **3.5" ESP32-3248S035C**(`cyd_35r`)。
引脚约定见同目录 [CYD_PROJECT_GUIDE.md](../CYD_PROJECT_GUIDE.md);布局参考 [temperature](../temperature)。
## 硬件
| 项目 | 说明 |
|------|------|
| 板子 | CYD ESP32-2432S028R(2.8" ILI9341) |
| 传感器 | SGP30(eCO2 / TVOC) |
| SDA | **GPIO22** |
| SCL | **GPIO27** |
| 供电 | USB 5V;传感器接 **3.3V** |
| 项目 | 2.8" · 2432S028R | 3.5" C · 3248S035C |
|------|------------------|---------------------|
| 屏驱 | ILI9341 | ST7796 |
| 触控 | XPT2046 SoftSPI | GT911 Wire1(SDA33/SCL32/INT21/RST25) |
| 背光 TFT_BL | **GPIO21** | **GPIO27** |
| SGP30 SDA | **GPIO22** | **GPIO22** |
| SGP30 SCL | **GPIO27** | **GPIO21**(CN1;勿占 27=BL、32/33=触控) |
| 供电 | USB 5V;传感器 **3.3V** | 同左 |
接线:`VCC→3.3V`,`GND→GND`,`SDA→GPIO22`,`SCL→GPIO27`。
接线(SGP30):`VCC→3.3V`,`GND→GND`,再按上表接 SDA/SCL。
## 功能
@@ -30,21 +32,30 @@ ESP32 Cheap Yellow Display(ESP32-2432S028R)+ SGP30 + LVGL 空气质量仪表
依赖 [PlatformIO](https://platformio.org/)。
```bash
pio run -e cyd_28r -t upload
pio run -e cyd_28r -t upload # 2.8"
pio run -e cyd_35r -t upload # 3.5C
pio device monitor -b 115200
```
### 预编译固件(随时刷,不必编译)
已归档到 [`firmware/cyd_28r/`](firmware/cyd_28r/)(含 bootloader / partitions / app):
| 板型 | 目录 |
|------|------|
| 2.8" | [`firmware/cyd_28r/`](firmware/cyd_28r/) |
| 3.5" | [`firmware/cyd_35r/`](firmware/cyd_35r/) |
```powershell
cd firmware\cyd_28r
cd firmware\cyd_28r # 或 cyd_35r
.\flash.ps1
# 或 .\flash.ps1 -Port COM3
```
说明见 [`firmware/README.md`](firmware/README.md)。源码更新后重新打包:`.\firmware\export_from_build.ps1`。
说明见 [`firmware/README.md`](firmware/README.md)。重新打包:
```powershell
.\firmware\export_from_build.ps1 # 2.8
.\firmware\export_from_build.ps1 -Env cyd_35r
```
### 环境选择
@@ -53,6 +64,7 @@ cd firmware\cyd_28r
| `cyd_28r` | 标准 ILI9341 CYD(默认) |
| `cyd_28r_inv` | 颜色反相 / 发白 |
| `cyd_28_st7789` | USB-C 双口 / ST7789 变体 |
| `cyd_35r` | 3.5" ST7796 + GT911(BL=27,SGP30 SDA22/SCL21) |
## 项目结构
@@ -79,5 +91,6 @@ README.md # 本文档
| 日期 | 说明 |
|------|------|
| 2026-10-25 | 按 CYD_PROJECT_GUIDE:3.5 修正 TFT_BL=27;SGP30 保持 SDA=22/SCL=21;GT911 INT 复位后改 INPUT;不动 2.8 |
| 2026-10-18 | 初版:LVGL 空气质量仪表盘 + SGP30(SDA=GPIO22 / SCL=GPIO27),eCO2/TVOC 双表盘、质量条、趋势图、背光与 min/max |
| 2026-10-18 | 初始化 Git;归档预编译固件到 `firmware/cyd_28r/`,附一键刷写脚本 |