CYD 温湿度仪表盘

ESP32 Cheap Yellow Display（ESP32-2432S028R）+ DHT11 + LVGL 温湿度仪表盘。

硬件

项目	说明
板子	CYD ESP32-2432S028R（2.8" ILI9341）
传感器	DHT11
DATA	GPIO22（CN1 / P3）
供电	USB 5V；电池需外接充电管理（板载 JST 多为供电口）

接线：VCC→3.3V，GND→GND，DATA→GPIO22。

功能

• 横屏温湿度圆弧仪表 + 数字读数
• EMA 平滑、min/max、舒适度、体感温度 / 露点
• 温湿度趋势折线
• 点按屏幕切换背光亮度（4 档）
• 偶发 DHT 读失败容错（连续失败才报错）
• 常亮运行（无自动熄屏 / 休眠）

构建与烧录

依赖 PlatformIO。

pio run -e cyd_28r -t upload
pio device monitor -b 115200

环境选择

环境	适用
cyd_28r	标准 ILI9341 CYD（默认）
cyd_28r_inv	颜色反相 / 发白
cyd_28_st7789	USB-C 双口 / ST7789 变体

3D 外壳

桌面斜立分体壳（前框 + 后盖支架 + DHT11 通风仓），可直接打印：

• STL：cad/export/front.stl、cad/export/back.stl
• 浏览器预览：cad/viewer.html（需本地 HTTP，见下）
• 参数源 / 说明：cad/README.md

# 浏览器查看
python -m http.server 8765 --directory cad
# 打开 http://localhost:8765/viewer.html

# 重新导出 STL
pip install trimesh manifold3d numpy
python cad/generate_stl.py

固定用 4 × M3×10；DHT11 装后盖通风仓，线接 CN1。

项目结构

platformio.ini                 # 板级与库依赖
include/lv_conf.h              # LVGL 配置
src/main.cpp                   # 仪表盘主程序
scripts/exclude_lvgl_asm.py    # 排除 ESP32 不兼容的 LVGL ASM
cad/                           # 3D 外壳（OpenSCAD + STL）
.cursor/rules/                 # Cursor 协作规则
README.md                      # 本文档

变更约定

每次功能或行为改动须：

1. 更新本 README（及必要时的注释）
2. git add + git commit 提交

详见 .cursor/rules/git-and-docs.mdc。

变更记录

日期	说明
2026-10-17	初版：LVGL 仪表盘 + DHT11(GPIO22)，平滑/舒适度/趋势/背光
2026-10-17	曾加入 ECO 熄屏休眠，后改回常亮正常版
2026-10-17	初始化 Git，补充 README 与提交约定
2026-10-17	新增 CYD+DHT11 桌面斜立 3D 外壳（OpenSCAD / STL）
2026-10-17	增加浏览器 Three.js STL 预览页 cad/viewer.html
2026-10-17	预览增强：合盖/开盖、分解、装配动画、剖切/线框等
2026-10-17	外壳改定：DHT11 后盖卡位微突出；前后盖止口合盖
2026-10-17	去掉旁侧多余凸块；修复合盖对齐；DHT 改为后盖平面卡位