DESKTOP-PUHFO60\dsx2016
14d5f9f68e
Keep TFT_BL=27; do not remap UART to GPIO4. Co-authored-by: Cursor <cursoragent@cursor.com>
123 lines
3.9 KiB
Markdown
123 lines
3.9 KiB
Markdown
# CYD LD2420 雷达仪表盘
|
||
|
||
ESP32 Cheap Yellow Display + HLK-LD2420 24GHz 毫米波雷达 + LVGL 仪表盘。
|
||
默认 **2.8" ESP32-2432S028R**；可选 **3.5" ESP32-3248S035C**（`cyd_35r`）。板型差异见 [`../CYD_PROJECT_GUIDE.md`](../CYD_PROJECT_GUIDE.md)。
|
||
|
||
## 硬件
|
||
|
||
| 项目 | 2.8"（默认） | 3.5" C（`cyd_35r`） |
|
||
|------|--------------|---------------------|
|
||
| 板子 | ESP32-2432S028R（ILI9341 + XPT2046） | ESP32-3248S035C（ST7796 + GT911） |
|
||
| 横屏 UI | 320×240 | 480×320 |
|
||
| 背光 | GPIO21 | **GPIO27** |
|
||
| LD2420 OT1 | **GPIO22**（→ ESP RX） | **GPIO21**（→ ESP RX） |
|
||
| LD2420 RX | **GPIO27**（← ESP TX） | **GPIO22**（← ESP TX） |
|
||
| 供电 | 3.3V / GND（共地） | 同左 |
|
||
|
||
接线（固件 ≥ v1.5.3）：
|
||
|
||
```
|
||
# 2.8"
|
||
LD2420 3V3 → CYD 3.3V
|
||
LD2420 GND → CYD GND
|
||
LD2420 OT1 → GPIO22
|
||
LD2420 RX → GPIO27
|
||
|
||
# 3.5C
|
||
LD2420 3V3 → CYD 3.3V
|
||
LD2420 GND → CYD GND
|
||
LD2420 OT1 → GPIO21
|
||
LD2420 RX → GPIO22
|
||
```
|
||
|
||
> 旧固件（< v1.5.3）串口 TX 在 OT2，且默认波特率多为 **256000**。本工程会依次探测 115200 / 256000。
|
||
|
||
## 功能
|
||
|
||
- 横屏网格：距离圆弧 + 存在圆弧；底部左信息 / 右趋势图
|
||
- **显示 LD2420 固件版本**（启动时进入配置模式读取 `CMD 0x0000`）
|
||
- **存在逻辑**：移动或静止检到 → 保持 ON；离开约 **10s** 后才 OFF（ESPHome 同款超时/门限）
|
||
- 检测门默认 1–12（约 0.7–8.4 m），出厂静止门限（能坐着不动也保持有人）
|
||
- 短按切换背光；长按 ≥0.7s 重置 min/max
|
||
|
||
## 构建与烧录
|
||
|
||
依赖 [PlatformIO](https://platformio.org/)。
|
||
|
||
```bash
|
||
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/) | 2.8" ILI9341 |
|
||
| [`firmware/cyd_35r/`](firmware/cyd_35r/) | 3.5C ST7796 + GT911 |
|
||
|
||
```powershell
|
||
cd firmware\cyd_28r # 或 cyd_35r
|
||
.\flash.ps1
|
||
# 或 .\flash.ps1 -Port COM3
|
||
```
|
||
|
||
说明见 [`firmware/README.md`](firmware/README.md)。源码更新后重新打包：
|
||
|
||
```powershell
|
||
.\firmware\export_from_build.ps1 # 2.8
|
||
.\firmware\export_from_build.ps1 -Env cyd_35r # 3.5
|
||
```
|
||
|
||
### 环境选择
|
||
|
||
| 环境 | 适用 |
|
||
|------|------|
|
||
| `cyd_28r` | 标准 ILI9341 CYD（默认） |
|
||
| `cyd_28r_inv` | 颜色反相 / 发白 |
|
||
| `cyd_28_st7789` | USB-C 双口 / ST7789 变体 |
|
||
| `cyd_35r` | 3.5" 3248S035C（ST7796 + GT911，BL=27） |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
platformio.ini # 板级与库依赖
|
||
include/lv_conf.h # LVGL 配置
|
||
src/main.cpp # 仪表盘 + LD2420 驱动
|
||
scripts/exclude_lvgl_asm.py # 排除 ESP32 不兼容的 LVGL ASM
|
||
firmware/ # 预编译固件（可离线刷写）
|
||
.cursor/rules/ # Cursor 协作规则
|
||
README.md # 本文档
|
||
```
|
||
|
||
## 变更约定
|
||
|
||
每次功能或行为改动须：
|
||
|
||
1. 更新本 README（及必要时的注释）
|
||
2. 刷新 `firmware/cyd_28r/`（`.\firmware\export_from_build.ps1`）
|
||
3. `git add` + `git commit` 提交
|
||
|
||
详见 `.cursor/rules/git-and-docs.mdc`。
|
||
|
||
## 变更记录
|
||
|
||
| 日期 | 说明 |
|
||
|------|------|
|
||
| 2026-10-25 | 按 `CYD_PROJECT_GUIDE.md` 修正 3.5 BL=27；LD2420 接线 OT1→21、RX→22；GT911 INT 复位后 INPUT；归档 `firmware/cyd_35r/` |
|
||
| 2026-10-18 | 初版：CYD + LD2420 LVGL 仪表盘；OT1→GPIO22、RX→GPIO27；显示固件版本 |
|
||
| 2026-10-18 | 存在逻辑改为 ESPHome 出厂门限 + 10s 离开保持（动/静均保持 ON） |
|
||
| 2026-10-18 | 归档预编译固件到 `firmware/cyd_28r/`，附一键刷写；初始化本地 Git |
|
||
|
||
## 串口日志示例
|
||
|
||
```
|
||
CYD LVGL LD2420 Radar Dashboard
|
||
LD2420 probe @ 115200 baud RX=22 TX=27 # 3.5: RX=21 TX=22
|
||
FW=v1.6.1 mode=simple
|
||
set gates 1..12 to=10s (OK)
|
||
```
|
||
|
||
界面左下角会显示 `FW v1.6.1` 与波特率（后缀 `S`=Simple）。
|