ESP32+ST7789 LCD屏实战:5分钟搞定中文显示与图片渲染(附完整代码)
如果你手头正好有一块ESP32开发板和一块ST7789驱动的LCD屏幕,想要快速点亮它,显示一些中文信息或者渲染一张图片,这篇文章就是为你准备的。很多朋友在初次接触这类嵌入式显示项目时,常常被SPI配置、字库处理、图片格式转换这些细节绊住,折腾半天屏幕还是没反应。其实,只要理清了核心流程,借助ESP-IDF框架的强大支持,从硬件连接到显示内容,真的可以在几分钟内跑通。今天,我们就抛开复杂的理论,直接上手,用最清晰的步骤和可直接复用的代码,带你一次搞定ESP32驱动ST7789 LCD屏的显示难题。
1. 硬件连接与SPI总线初始化:奠定通信基础
任何显示项目的第一步,都是确保硬件“对话”畅通。ESP32与ST7789 LCD屏之间通过SPI(串行外设接口)通信,这是一种高速、全双工的同步通信协议。理解引脚定义和配置参数,是避免后续一切玄学问题的关键。
首先,根据你的屏幕模块,确认引脚定义。常见的1.54英寸或1.3英寸ST7789屏幕,其引脚通常包括以下几类:
| 引脚名称 | 功能描述 | ESP32连接示例 | 备注 |
|---|---|---|---|
| VCC | 电源正极 (3.3V) | 3.3V | 切勿接5V,会损坏屏幕 |
| GND | 电源地 | GND | |
| SCL/SCK | SPI时钟线 | GPIO 18 | 主设备输出时钟,同步数据 |
| SDA/MOSI | SPI数据线(主出从入) | GPIO 23 | ESP32发送数据到屏幕 |
| RES/RST | 复位信号 | GPIO 4 | 用于硬件复位屏幕控制器 |
| DC/RS | 数据/命令选择 | GPIO 2 | 高电平:数据;低电平:命令 |
| CS | 片选信号 | GPIO 5 | 低电平选中该SPI设备 |
| BL | 背光控制 | GPIO 12 | 可通过PWM调光 |
提示:部分屏幕的
BL引脚可能标注为LED,接高电平(3.3V)即可点亮背光。如果屏幕不亮但通信正常,首先检查背光是否供电。
连接好硬件后,我们进入代码层面。在ESP-IDF环境中,SPI总线的初始化是一个结构化的过程。我们需要配置两个主要部分:SPI总线本身和连接到该总线的设备(LCD)。
// 首先,在头文件中定义引脚,方便全局修改
#define LCD_HOST SPI2_HOST // 使用ESP32的SPI2控制器
#define PIN_NUM_SCLK 18
#define PIN_NUM_MOSI 23
#define PIN_NUM_MISO -1 // ST7789通常只接收数据,不发送,故设为-1
#define PIN_NUM_CS 5
#define PIN_NUM_DC 2
#define PIN_NUM_RST 4
#define PIN_NUM_BCKL 12
// SPI总线配置结构体
spi_bus_config_t buscfg = {
.mosi_io_num = PIN_NUM_MOSI,
.miso_io_num = PIN_NUM_MISO,
.sclk_io_num = PIN_NUM_SCLK,
.quadwp_io_num = -1, // 非QSPI模式,设为-1
.quadhd_io_num = -1, // 非QSPI模式,设为-1
.max_transfer_sz = 128 * 160 * 2 + 8, // 单次传输最大字节数,略大于一帧缓冲区
};
// 初始化SPI总线
ESP_ERROR_CHECK(spi_bus_initialize(LCD_HOST, &buscfg, SPI_DMA_CH_AUTO));
这里有几个参数值得
1042



被折叠的 条评论
为什么被折叠?



