ESP32+LVGL实战：手把手教你搞定ST7789屏幕镜像显示（附完整代码）

ESP32+LVGL实战：从寄存器到工程化配置，彻底解决ST7789屏幕镜像显示问题

当你用ESP32驱动ST7789屏幕时，是否遇到过图像上下左右颠倒的困扰？这个问题看似简单，但网上的零散教程往往只告诉你改某个寄存器值，却忽略了背后的硬件原理和工程化配置方法。作为一位在嵌入式显示领域踩过无数坑的老手，今天我将带你从芯片寄存器开始，一路打通LVGL配置，最终给出一个既快速解决当前问题又保持工程可维护性的完整方案。

1. 理解ST7789的显示方向控制机制

ST7789液晶控制器通过0x36寄存器控制显示方向，这个8位寄存器的每个bit都有特定含义：

常见的镜像显示问题通常需要修改bit5和bit4。比如：

• 0x00：正常显示
• 0x50：水平+垂直镜像（即中心对称翻转）
• 0xA0：仅水平镜像
• 0x10：仅垂直镜像

重要提示：不同厂商的ST7789模块可能有细微差异，建议先查阅你的屏幕规格书确认寄存器定义。我在某次项目中就遇到过某款屏幕需要设置0xC0才能达到预期效果。

2. 修改LVGL驱动层代码的正确姿势

找到components/lvgl_esp32_driver/lvgl_tft/st7789.c文件，我们需要修改两个关键函数：

// 原始代码片段 static void st7789_set_orientation(uint8_t orientation) { static const uint8_t data[] = { 0x36, 1, 0x00, // 默认值 0x36, 1, 0xA0, // 旋转90° 0x36, 1, 0xC0, // 旋转180° 0x36, 1, 0x60 // 旋转270° }; // ...发送命令的代码... }

修改为包含镜像模式的版本：

static void st7789_set_orientation(uint8_t orientation) { static const char *orientation_str[] = { "Portrait", "Landscape", "Portrait inverted", "Landscape inverted", "Mirror portrait", // 新增 "Mirror landscape" // 新增 }; static const uint8_t data[] = { 0x36, 1, 0x00, // 0:正常 0x36, 1, 0xA0, // 1:90° 0x36, 1, 0xC0, // 2:180° 0x36, 1, 0x60, // 3:270° 0x36, 1, 0x50, // 4:镜像(新增) 0x36, 1, 0xF0 // 5:镜像+90°(新增) }; ESP_LOGI(TAG, "Display orientation: %s", orientation_str[orientation]); st7789_send_cmd(data + orientation * 3, 3); }

然后在初始化函数中调用：

void st7789_init(void) { // ...其他初始化代码... st7789_set_orientation(4); // 直接使用数字4表示镜像模式 }

注意：这种硬编码方式虽然能快速解决问题，但破坏了Kconfig配置系统的灵活性。接下来我们会解决这个问题。

3. 工程化配置：让镜像模式融入Kconfig系统

在components/lvgl_esp32_driver目录下找到Kconfig.projbuild文件，添加新的配置选项：

choice LV_DISPLAY_ORIENTATION prompt "Display orientation" default LV_DISPLAY_ORIENTATION_LANDSCAPE help Select display orientation. config LV_DISPLAY_ORIENTATION_PORTRAIT bool "Portrait (0°)" config LV_DISPLAY_ORIENTATION_LANDSCAPE bool "Landscape (90°)" config LV_DISPLAY_ORIENTATION_PORTRAIT_INVERTED bool "Inverted portrait (180°)" config LV_DISPLAY_ORIENTATION_LANDSCAPE_INVERTED bool "Inverted landscape (270°)" config LV_DISPLAY_ORIENTATION_MIRROR_PORTRAIT bool "Mirror portrait" config LV_DISPLAY_ORIENTATION_MIRROR_LANDSCAPE bool "Mirror landscape" endchoice

修改st7789.c中的初始化代码：

void st7789_init(void) { // ...其他初始化代码... st7789_set_orientation(CONFIG_LV_DISPLAY_ORIENTATION); }

现在你可以通过idf.py menuconfig在图形界面中选择显示方向了：

Component config → LVGL ESP32 Drivers → Display orientation

4. 调试技巧与常见问题排查

当修改后显示仍不正常时，建议按以下步骤排查：

1. 确认硬件连接：

   • 用万用表检查SPI时钟线是否正常
   • 确保RESET和DC引脚电平正确

2. 寄存器级调试：

   // 临时添加寄存器读取代码 uint8_t read_reg(uint8_t reg) { uint8_t val; st7789_send_cmd(&reg, 1); st7789_receive_data(&val, 1); return val; } ESP_LOGI(TAG, "MADCTL register: 0x%02X", read_reg(0x36));

3. LVGL显示缓存检查：

   // 在lvgl初始化后添加测试图案 lv_obj_t * img = lv_img_create(lv_scr_act()); LV_IMG_DECLARE(test_pattern); lv_img_set_src(img, &test_pattern);

常见问题解决方案：

5. 进阶：动态切换显示方向

在某些应用中，可能需要运行时切换显示方向。这里给出一个安全实现的示例：

void set_display_orientation(uint8_t orientation) { static uint8_t current_orient = 0xFF; if(orientation == current_orient) return; lv_disp_t *disp = lv_disp_get_default(); lv_disp_rotation_t rot = LV_DISP_ROT_NONE; switch(orientation) { case 0: rot = LV_DISP_ROT_NONE; break; case 1: rot = LV_DISP_ROT_90; break; case 2: rot = LV_DISP_ROT_180; break; case 3: rot = LV_DISP_ROT_270; break; default: break; } st7789_set_orientation(orientation); lv_disp_set_rotation(disp, rot); current_orient = orientation; }

调用示例：

// 通过按钮切换方向 lv_obj_add_event_cb(btn, [](lv_event_t * e) { static uint8_t orient = 0; set_display_orientation(++orient % 4); }, LV_EVENT_CLICKED, NULL);

6. 性能优化与最佳实践

1. 双缓冲配置：

   // 在lvgl_conf.h中增加 #define LV_DISP_DEF_REFR_PERIOD 30 #define LV_DISP_DEF_DOUBLE_BUFFER 1

2. SPI时钟优化：

   // 在st7789_init()中设置SPI时钟 spi_device_interface_config_t devcfg = { .clock_speed_hz = 40*1000*1000, // 可提升至40MHz // ...其他配置... };

3. 内存优化技巧：

   • 使用lv_mem_monitor_t mon; lv_mem_monitor(&mon);监控内存使用
   • 启用LV_USE_GPU_STM32_DMA2D加速（如果硬件支持）

显示方向设置看似简单，但要做到工程化、可维护需要全面考虑硬件寄存器、驱动层实现和配置系统。我在一个商业项目中就曾因为忽略Kconfig配置，导致后续团队成员无法通过标准方式修改显示方向，不得不花费额外时间重构代码。