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>

README.md

@@ -1,14 +1,16 @@
 # LCD1602A 液晶（CYD）
 
 触控 + LVGL 参考 `tftest` / `hw269test` / `hw069digitdisplaytest`。  
-LCD1602A（HD44780）经 **PCF8574 I2C 转接板** 驱动：改两行文字、清屏、背光。
+LCD1602A（HD44780）经 **PCF8574 I2C 转接板** 驱动：改两行文字、背光、脚位映射。
+
+用途：16×2 **字符提示屏**（状态、读数、短菜单）。驱动简单、资料多；不是彩屏替代品。本工程用于在 CYD 上验证接线与显示是否正常。
 
 ## 硬件
 
 | 项目 | 说明 |
 |------|------|
 | 板子 | CYD ESP32-2432S028R |
-| 模块 | LCD1602A + I2C 背包（PCF8574，常见地址 **0x27 / 0x3F**） |
+| 模块 | LCD1602A + I2C 背包（PCF8574，实测地址常为 **0x27**，亦见 **0x3F**） |
 | SDA | **GPIO22** |
 | SCL | **GPIO27** |
 
@@ -16,18 +18,30 @@ LCD1602A（HD44780）经 **PCF8574 I2C 转接板** 驱动：改两行文字、
 
 | LCD1602A(I2C) | CYD |
 |---------------|-----|
-| VCC | **5V**（屏对比度更稳；多数模块也可试 3.3V） |
+| VCC | **5V**（推荐；3.3V 可能对比度不稳） |
 | GND | GND |
 | SDA | GPIO22 |
 | SCL | GPIO27 |
 
-上电会扫描 `0x27 / 0x3F / 0x26 / 0x3E` 等。串口与 TFT 状态栏会显示是否找到地址。
+上电扫描 `0x27 / 0x3F / 0x26 / 0x3E / 0x20 / 0x38`。串口与 TFT 状态栏显示是否找到地址。
 
-### 背光有、字没有？
+### 对比度（蓝色电位器）
 
-1. **先拧 I2C 转接板上的蓝色电位器（对比度）**——这是最常见原因；背光晶体管和字符是两回事。
-2. 供电优先接 **5V**（不是 3.3V）。
-3. 仍无字：点 TFT 上 **Map** 切换另一种 PCF8574 脚位映射后再试 **Hello**。
+- 背光能亮但看不到字：**先拧 I2C 小板上的蓝色电位器**（最常见原因）。
+- **不能软件调节**。PCF8574 只控 RS/RW/E/数据线/背光，**不接 Vo**；Vo 只接到电位器。
+- 拧到字清晰、背景无明显黑块即可。
+
+### 背光与省电
+
+- **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**：循环示例文案
 - **Hello**：`Hello World!` / `LCD1602A`
 - **Map**：切换 I2C 背包脚位映射并重新初始化
-- **BL ON/OFF**：背光开关
+- **BL ON/OFF**：背光开关（关后通常不可读）
 
 ## 构建 / 烧录
 
@@ -56,3 +70,11 @@ cd firmware\cyd
 ```powershell
 .\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 | 文档：对比度仅硬件可调、关背光通常不可读、用途与排障说明 |

firmware/README.md

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

firmware/cyd/meta.json

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