Document LCD1602 contrast pot, backlight readability, and usage notes.

Clarify Vo is hardware-only, backlight-off is usually unreadable on blue/white modules, and refresh meta/changelog.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-10-23 14:36:36 +08:00
parent 1817fce92b
commit 81caf7c95a
3 changed files with 35 additions and 11 deletions

View File

@@ -1,14 +1,16 @@
# LCD1602A 液晶(CYD) # LCD1602A 液晶(CYD)
触控 + LVGL 参考 `tftest` / `hw269test` / `hw069digitdisplaytest`。 触控 + LVGL 参考 `tftest` / `hw269test` / `hw069digitdisplaytest`。
LCD1602A(HD44780)经 **PCF8574 I2C 转接板** 驱动:改两行文字、清屏、背光。 LCD1602A(HD44780)经 **PCF8574 I2C 转接板** 驱动:改两行文字、背光、脚位映射。
用途:16×2 **字符提示屏**(状态、读数、短菜单)。驱动简单、资料多;不是彩屏替代品。本工程用于在 CYD 上验证接线与显示是否正常。
## 硬件 ## 硬件
| 项目 | 说明 | | 项目 | 说明 |
|------|------| |------|------|
| 板子 | CYD ESP32-2432S028R | | 板子 | CYD ESP32-2432S028R |
| 模块 | LCD1602A + I2C 背包(PCF8574,常见地址 **0x27 / 0x3F**) | | 模块 | LCD1602A + I2C 背包(PCF8574,实测地址常为 **0x27**,亦见 **0x3F**) |
| SDA | **GPIO22** | | SDA | **GPIO22** |
| SCL | **GPIO27** | | SCL | **GPIO27** |
@@ -16,18 +18,30 @@ LCD1602A(HD44780)经 **PCF8574 I2C 转接板** 驱动:改两行文字、
| LCD1602A(I2C) | CYD | | LCD1602A(I2C) | CYD |
|---------------|-----| |---------------|-----|
| VCC | **5V**(屏对比度更稳;多数模块也可试 3.3V) | | VCC | **5V**(推荐;3.3V 可能对比度不稳) |
| GND | GND | | GND | GND |
| SDA | GPIO22 | | SDA | GPIO22 |
| SCL | GPIO27 | | SCL | GPIO27 |
上电会扫描 `0x27 / 0x3F / 0x26 / 0x3E` 等。串口与 TFT 状态栏会显示是否找到地址。 上电扫描 `0x27 / 0x3F / 0x26 / 0x3E / 0x20 / 0x38`。串口与 TFT 状态栏显示是否找到地址。
### 背光有、字没有? ### 对比度(蓝色电位器)
1. **先拧 I2C 转接板上的蓝色电位器(对比度)**——这是最常见原因;背光晶体管和字符是两回事。 - 背光能亮但看不到字:**先拧 I2C 小板上的蓝色电位器**(最常见原因)。
2. 供电优先接 **5V**(不是 3.3V)。 - **不能软件调节**。PCF8574 只控 RS/RW/E/数据线/背光,**不接 Vo**;Vo 只接到电位器。
3. 仍无字:点 TFT 上 **Map** 切换另一种 PCF8574 脚位映射后再试 **Hello**。 - 拧到字清晰、背景无明显黑块即可。
### 背光与省电
- **BL ON/OFF** 只开关背光晶体管,不影响已写入的字符内容。
- 常见蓝底白字模块:**关背光后室内几乎看不清字**(靠背光透射);关背光是为了省电/息屏,不是“暗光可读”。
- 要关背光仍可读,需反射型字符屏等另一类硬件。
### 仍无字时
1. 确认已调对比度 + VCC=5V
2. TFT 点 **Map** 换 PCF8574 脚位映射,再点 **Hello**
3. 看串口是否有 `PCF8574 found @ 0x..` / `LCD1602A OK`
## 操作 ## 操作
@@ -35,7 +49,7 @@ LCD1602A(HD44780)经 **PCF8574 I2C 转接板** 驱动:改两行文字、
- **Demo**:循环示例文案 - **Demo**:循环示例文案
- **Hello**:`Hello World!` / `LCD1602A` - **Hello**:`Hello World!` / `LCD1602A`
- **Map**:切换 I2C 背包脚位映射并重新初始化 - **Map**:切换 I2C 背包脚位映射并重新初始化
- **BL ON/OFF**:背光开关 - **BL ON/OFF**:背光开关(关后通常不可读)
## 构建 / 烧录 ## 构建 / 烧录
@@ -56,3 +70,11 @@ cd firmware\cyd
```powershell ```powershell
.\firmware\export_from_build.ps1 .\firmware\export_from_build.ps1
``` ```
## 变更记录
| 日期 | 说明 |
|------|------|
| 2026-10-23 | 初版:I2C LCD1602A(SDA22/SCL27)+ SoftSPI 触控 + LVGL;Demo/Hello/背光 |
| 2026-10-23 | 修空白屏:对齐 LiquidCrystal_I2C 时序;增加 Map;提示拧蓝色对比度电位器 |
| 2026-10-23 | 文档:对比度仅硬件可调、关背光通常不可读、用途与排障说明 |

View File

@@ -5,6 +5,8 @@
板子:**CYD ESP32-2432S028R**(ILI9341) 板子:**CYD ESP32-2432S028R**(ILI9341)
功能:LCD1602A I2C(SDA=GPIO22,SCL=GPIO27,PCF8574)+ SoftSPI 触控 + LVGL 功能:LCD1602A I2C(SDA=GPIO22,SCL=GPIO27,PCF8574)+ SoftSPI 触控 + LVGL
说明见仓库根目录 [`README.md`](../README.md)(对比度电位器、背光、Map 脚位)。
## 刷写 ## 刷写
```powershell ```powershell

View File

@@ -1,7 +1,7 @@
{ {
"boardId": "esp32-2432s028", "boardId": "esp32-2432s028",
"name": "CYD LCD1602A", "name": "CYD LCD1602A",
"summary": "LCD1602A HD44780 via PCF8574 I2C: SDA GPIO22, SCL GPIO27 — demo / hello / clear / backlight", "summary": "LCD1602A HD44780 via PCF8574 I2C: SDA GPIO22, SCL GPIO27 — demo / hello / map / backlight; contrast = blue pot only",
"description": "SoftSPI touch + LVGL. LCD1602A character LCD on I2C backpack (scan 0x27/0x3F).", "description": "SoftSPI touch + LVGL. LCD1602A character LCD on I2C backpack (scan 0x27/0x3F). Contrast is hardware pot (Vo), not software. Backlight off usually unreadable on blue/white modules.",
"tags": ["lcd1602a", "hd44780", "pcf8574", "i2c", "display", "touch", "lvgl"] "tags": ["lcd1602a", "hd44780", "pcf8574", "i2c", "display", "touch", "lvgl"]
} }