ESP32 使用 MicroPython 驱动 LCD1602 显示屏主要涉及两种连接方式：**直接 GPIO 连接**和**通过 I2C 模块（PCF8574T）连接**。后者因接线简单、占用引脚少而成为主流方案 [ref_1][ref_4]。 ### 一、硬件连接与 I2C 地址确认 LCD1602 的 I2C 模块通常基于 PCF8574T 芯片。连接时，ESP32 的 **SDA** 和 **SCL** 引脚需分别连接至模块的对应引脚。ESP32 的 I2C 引脚可自定义，常见的硬件 I2C 引脚为 **GPIO21 (SDA)** 和 **GPIO22 (SCL)** [ref_3]。连接后，首先需要扫描确认模块的 I2C 地址。 ```python from machine import Pin, SoftI2C import time # 初始化 I2C，使用软件 I2C 可避免硬件引脚限制 [ref_6] i2c = SoftI2C(scl=Pin(22), sda=Pin(21), freq=100000) # 扫描 I2C 总线上的设备地址 devices = i2c.scan() if len(devices) == 0: print("未找到 I2C 设备！请检查接线。") else: for device in devices: print("找到 I2C 设备，地址：", hex(device)) # 常见地址为 0x27 或 0x3F [ref_3] ``` ### 二、驱动库与基本显示 确认地址后，需要导入或编写 LCD1602 的驱动库。以下是基于 PCF8574T 的一个常用驱动类示例： ```python import time from machine import Pin, SoftI2C class I2cLcd: # 初始化函数，需要传入 I2C 对象和设备地址 def __init__(self, i2c, addr, num_lines=2, num_columns=16): self.i2c = i2c self.addr = addr self.num_lines = num_lines self.num_columns = num_columns self._backlight = True self._init_display() # 初始化显示屏 [ref_4] def _write_byte(self, data, rs_mode=0): """核心写字节函数，将数据/命令通过 I2C 发送到 PCF8574T""" # 高4位和低4位分两次发送，是4位数据总线模式的标准操作 [ref_2] high_nibble = data & 0xF0 low_nibble = (data << 4) & 0xF0 # 组装控制字节：包含数据、使能信号（E）、读写选择（RS）和背光 for nibble in [high_nibble, low_nibble]: byte = nibble | rs_mode | (0x08 if self._backlight else 0x00) | 0x04 # E=1 self.i2c.writeto(self.addr, bytes([byte])) time.sleep_us(1) byte &= ~0x04 # E=0，形成下降沿，锁存数据 [ref_1] self.i2c.writeto(self.addr, bytes([byte])) time.sleep_us(50) def _init_display(self): """初始化LCD的序列，必须严格按照时序进行""" time.sleep_ms(50) # 三次初始化序列，确保进入4位模式 [ref_2] for _ in range(3): self._write_byte(0x30) time.sleep_ms(5) # 切换到4位模式 self._write_byte(0x20) time.sleep_ms(1) # 设置显示行数、字体等 self._write_cmd(0x28) # 2行，5x8字体 self._write_cmd(0x0C) # 开显示，关光标 self._write_cmd(0x06) # 地址递增，文字不动 self.clear() def _write_cmd(self, cmd): """发送命令（RS=0）""" self._write_byte(cmd, 0x00) def _write_data(self, data): """发送数据（RS=1）""" self._write_byte(data, 0x01) def clear(self): """清屏""" self._write_cmd(0x01) time.sleep_ms(2) def putstr(self, string): """在当前位置显示字符串""" for char in string: self._write_data(ord(char)) def move_to(self, col, row): """移动光标到指定位置（列，行）""" addr = col | (0x40 if row == 1 else 0x00) # 第二行起始地址为0x40 [ref_4] self._write_cmd(0x80 | addr) def backlight(self, state): """控制背光""" self._backlight = state # 发送一个空操作来更新背光状态 self.i2c.writeto(self.addr, bytes([0x00 | (0x08 if state else 0x00)])) # 使用示例 i2c = SoftI2C(scl=Pin(22), sda=Pin(21), freq=100000) lcd = I2cLcd(i2c, 0x27) # 地址替换为扫描到的实际地址 lcd.clear() lcd.putstr("Hello, World!") lcd.move_to(0, 1) # 移动到第二行第一列 lcd.putstr("MicroPython") ``` ### 三、两种连接方式对比 | 特性 | **直接 GPIO 连接 (4/8位模式)** | **通过 I2C 模块 (PCF8574T) 连接** | | :--- | :--- | :--- | | **占用 GPIO 数** | 至少 6-10 个 (RS, E, D4-D7, 背光等) [ref_2] | 仅需 2 个 (SDA, SCL) [ref_1][ref_4] | | **接线复杂度** | 高，线束多 | 低，仅需4根线 (VCC, GND, SDA, SCL) | | **编程复杂度** | 较高，需精确控制多个引脚时序 | 较低，通过 I2C 发送字节即可 | | **稳定性** | 受GPIO干扰影响相对较大 | I2C协议有校验，抗干扰性较好 | | **适用场景** | 对GPIO数量不敏感或需极致性能的项目 | 绝大多数需要节省引脚、简化布线的项目 | ### 四、常见问题与解决方案 1. **显示屏不亮或乱码** * **检查电源**：确保 LCD1602 和 I2C 模块的 **VCC** 接 5V，**ESP32** 的 3.3V 可能驱动不足 [ref_5]。 * **检查地址**：务必使用 `i2c.scan()` 确认正确的 I2C 地址（常见为 `0x27` 或 `0x3F`）[ref_3][ref_6]。 * **检查上拉电阻**：I2C 总线（SDA, SCL）通常需要接 **4.7kΩ** 上拉电阻到 VCC。许多模块已内置 [ref_5]。 2. **只能显示一行或字符错位** * **初始化时序**：确保 `_init_display` 函数中的延时（`time.sleep_ms`）足够，过快可能导致初始化失败 [ref_1]。 * **行列地址设置**：确认 `move_to` 函数中行地址偏移计算正确（第一行 `0x00`，第二行 `0x40`）[ref_4]。 3. **背光无法控制** * **电路差异**：部分模块的背光控制通过 PCF8574T 的一个独立 IO 控制（如上述代码），另一些则直接接 VCC 或 GND。请根据模块原理图调整 `backlight` 函数中的控制位 [ref_1]。 4. **使用特定 GPIO 导致 ESP32 启动异常** * **规避 STRAP 引脚**：避免使用 **GPIO0, GPIO2, GPIO12, GPIO15** 等启动配置引脚作为 I2C 引脚，它们可能影响设备启动模式 [ref_6]。使用 `SoftI2C` 可以灵活选择其他 GPIO。 ### 五、进阶应用：显示 RTC 时间 结合 ESP32 的内部 RTC，可以实现一个简易的时钟 [ref_5]。 ```python import machine import time from machine import RTC, Pin, SoftI2C # 假设使用上述 I2cLcd 类 from i2c_lcd import I2cLcd # 初始化 RTC rtc = RTC() # 通过网络或手动设置时间，例如：rtc.datetime((2024, 1, 15, 1, 12, 30, 0, 0)) # 初始化 LCD i2c = SoftI2C(scl=Pin(19), sda=Pin(18), freq=100000) # 使用非STRAP引脚 lcd = I2cLcd(i2c, 0x27) while True: now = rtc.datetime() # 获取时间元组 (年,月,日,星期,时,分,秒,微秒) time_str = "{:02d}:{:02d}:{:02d}".format(now[4], now[5], now[6]) date_str = "{:04d}/{:02d}/{:02d}".format(now[0], now[1], now[2]) lcd.move_to(4, 0) lcd.putstr(time_str) lcd.move_to(3, 1) lcd.putstr(date_str) time.sleep(1) # 每秒更新一次 ``` **关键点**：RTC 在深度睡眠模式下仍可运行，但需要外部电池供电以保持计时 [ref_5]。显示更新时，建议只刷新变化的部分，而非全屏刷新，以提高效率和避免闪烁。