From 81caf7c95a5b3f1eabe4fb0b2cc48e856e4c9749 Mon Sep 17 00:00:00 2001 From: "DESKTOP-PUHFO60\\dsx2016" Date: Fri, 23 Oct 2026 14:36:36 +0800 Subject: [PATCH] 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 --- README.md | 40 +++++++++++++++++++++++++++++++--------- firmware/README.md | 2 ++ firmware/cyd/meta.json | 4 ++-- 3 files changed, 35 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index aa7a83b..423c942 100644 --- a/README.md +++ b/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 | 文档：对比度仅硬件可调、关背光通常不可读、用途与排障说明 | diff --git a/firmware/README.md b/firmware/README.md index c0cb59c..3fd2333 100644 --- a/firmware/README.md +++ b/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 diff --git a/firmware/cyd/meta.json b/firmware/cyd/meta.json index 678164f..35fa2f1 100644 --- a/firmware/cyd/meta.json +++ b/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"] }