DESKTOP-PUHFO60\dsx2016
d81383aaf6
Correct black-screen backlight, free GPIO21 after GT911 init (Wire1), export/flash cyd_35r package. Co-authored-by: Cursor <cursoragent@cursor.com>
82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
# CYD GY30 光照仪表盘
|
||
|
||
ESP32 Cheap Yellow Display + GY30（BH1750）+ LVGL 光照仪表盘。
|
||
|
||
默认 **2.8"**（`cyd_28r`）；可选 **3.5C**（`cyd_35r`）。布局与交互参考 [temperature](../temperature) / [sgp30test](../sgp30test)；板级约定见 [CYD_PROJECT_GUIDE.md](../CYD_PROJECT_GUIDE.md)。
|
||
|
||
## 硬件
|
||
|
||
| 项目 | 2.8"（默认 `cyd_28r`） | 3.5C（`cyd_35r`） |
|
||
|------|------------------------|-------------------|
|
||
| 板子 | ESP32-2432S028R（ILI9341） | ESP32-3248S035C（ST7796） |
|
||
| 触控 | XPT2046 SoftSPI | GT911 I2C（Wire1） |
|
||
| 背光 | **GPIO21** | **GPIO27** |
|
||
| GY30 SDA | **GPIO22** | **GPIO22**（不变） |
|
||
| GY30 SCL | **GPIO27** | **GPIO21**（2.8 的 27→21） |
|
||
| 供电 | USB 5V；传感器 **3.3V** | 同左 |
|
||
|
||
接线：
|
||
|
||
- **2.8**：`VCC→3.3V`，`GND→GND`，`SDA→GPIO22`，`SCL→GPIO27`
|
||
- **3.5**：`VCC→3.3V`，`GND→GND`，`SDA→GPIO22`，`SCL→GPIO21`（勿接 27，那是背光）
|
||
|
||
## 功能
|
||
|
||
- 横屏网格布局：双圆弧仪表（LUX / 感知 LEVEL%）+ 底部左场景分级 / 右趋势图
|
||
- EMA 平滑、min/max、场景（DARK…DIRECT）、近似 EV、感知亮度条
|
||
- 圆弧与亮度条缓动动画；趋势折线 SHIFT 更新
|
||
- 短按切换背光（4 档）；长按 ≥0.7s 重置 min/max
|
||
- 连续读失败容错；常亮运行
|
||
|
||
## 构建与烧录
|
||
|
||
依赖 [PlatformIO](https://platformio.org/)。
|
||
|
||
```bash
|
||
# 2.8"
|
||
pio run -e cyd_28r -t upload
|
||
|
||
# 3.5"
|
||
pio run -e cyd_35r -t upload
|
||
```
|
||
|
||
### 预编译固件
|
||
|
||
```powershell
|
||
cd firmware\cyd_28r # 或 cyd_35r
|
||
.\flash.ps1
|
||
```
|
||
|
||
源码更新后重新打包：
|
||
|
||
```powershell
|
||
.\firmware\export_from_build.ps1 # 2.8
|
||
.\firmware\export_from_build.ps1 -Env cyd_35r # 3.5
|
||
```
|
||
|
||
| 环境 | 适用 |
|
||
|------|------|
|
||
| `cyd_28r` | 标准 2.8" ILI9341 CYD（默认） |
|
||
| `cyd_28r_inv` | 颜色反相 / 发白 |
|
||
| `cyd_28_st7789` | USB-C 双口 / ST7789 变体 |
|
||
| `cyd_35r` | 3.5" ESP32-3248S035C（ST7796 + GT911） |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
platformio.ini # 板级与库依赖（含 cyd_35r）
|
||
include/lv_conf.h / touch.h
|
||
src/main.cpp / touch.cpp
|
||
scripts/exclude_lvgl_asm.py
|
||
firmware/cyd_28r/ firmware/cyd_35r/
|
||
README.md
|
||
```
|
||
|
||
## 变更记录
|
||
|
||
| 日期 | 说明 |
|
||
|------|------|
|
||
| 2026-10-20 | 初版：GY30(BH1750) SDA=GPIO22 / SCL=GPIO27，LUX/LEVEL 双表盘 |
|
||
| 2026-10-20 | 增加 `meta.json` 与 `media/preview.html`，供 cydweb 本地目录展示 |
|
||
| 2026-10-25 | 按 CYD_PROJECT_GUIDE 修正 3.5：背光 GPIO27、GY30 SCL=GPIO21、GT911 Wire1、导出/刷写 `cyd_35r` |
|