之前在 STM32 上进行 UI 开发相信很多朋友和我一样在 LVGL 8.x 时代已经积累了一套熟悉的移植流程。但当 LVGL 9.0 正式发布之后显示驱动接口、缓冲区配置方式、对象模型都有不小变化直接把旧代码搬过去往往会出现编译报错或者显示异常。本文基于 STM32F746G-DISCO 开发板完整记录 LVGL 9.0 的移植过程并通过自带的 Benchmark Demo 做一轮性能基准测试最后给出针对性的优化建议。无论是刚接触 LVGL 的新手还是准备从 8.x 升级的老手都可以参考这套流程。1. 背景与核心概念1.1 LVGL 9.0 是什么LVGLLight and Versatile Graphics Library是一款开源嵌入式图形库专门为资源受限的 MCU 设备设计。它提供了一套接近桌面 GUI 框架的控件库、事件系统、动画框架和布局引擎开发者可以在只有几百 KB 内存的单片机上实现比较复杂的交互界面。LVGL 9.0 是继 8.3 之后的一个重要大版本。在 9.0 中官方对内部架构进行了重构比较明显的改动包括显示设备驱动接口从lv_disp_drv_t调整为lv_display_t注册函数也发生了变化。缓冲区管理方式改变不再直接注册一个lv_disp_draw_buf_t结构体而是通过lv_display_set_buffers接口关联绘制缓冲区。输入设备驱动同步调整触摸、鼠标、键盘等设备的注册方式更统一。移除了部分旧 API配置项lv_conf.h的内容也做了精简和重命名。对于使用 STM32 这类 MCU 的开发者来说LVGL 9.0 带来的最大感知是 API 不再兼容 8.x因此网上很多基于 8.3 的教程不能直接照搬。1.2 STM32F746G-DISCO 为什么适合跑 LVGLSTM32F746G-DISCO 是 ST 官方推出的评估板核心芯片是 STM32F746NGH6Cortex-M7 内核主频可以跑到 216MHz。板载资源对 GUI 开发非常友好4.3 寸 TFT LCD分辨率 480x272带电容触摸屏。内部 RAM 320KB外部 SDRAM 16MB。板载 ST-LINK 调试器USB 接口可以直接供电和下载程序。MCU 自带 LTDC LCD 控制器和 DMA2D 图形加速器。LTDC 的作用是把显存中的图像数据持续刷新到 LCD 上不需要 CPU 逐像素搬运DMA2D 则可以做颜色格式转换、图像复制、混合等操作。当 LVGL 渲染完一帧画面后DMA2D 可以代替 CPU 快速把数据刷到显存这对 FPS 的影响非常明显。所以这块开发板本身就是 ST 官方用来演示 GUI 和图形加速能力的平台用来做 LVGL 9.0 移植和性能基准测试非常合适。1.3 性能基准测试要解决的问题嵌入式 GUI 开发中经常遇到几个问题界面滑动卡顿、掉帧。动画效果不流畅看起来一卡一卡的。控件复杂之后屏幕刷新时间明显变长。代码写完了才发现在低端 MCU 上跑不动需要推翻重来。性能基准测试就是通过固定场景的渲染任务测量 LVGL 在一秒内能渲染多少帧画面以及每帧平均耗时和最大耗时。LVGL 官方提供了 Benchmark Demo里面包含多种典型绘制任务例如矩形、边框、阴影、文字、圆弧、图片等测试结果可以量化图形库在当前硬件上的真实表现。通过基准测试可以判断当前硬件平台是否满足产品需求也可以在同一次测试中对不同优化方案进行对比避免凭感觉调优。2. 环境准备与版本说明2.1 硬件环境本文使用的硬件是 STM32F746G-DISCO 开发板主要参数如下表所示硬件资源参数主控芯片STM32F746NGH6Cortex-M7216MHz内部 Flash1MB内部 RAM320KB外部 SDRAM16MBLCD 分辨率480x272LCD 接口RGB888LTDC 驱动触摸屏电容触摸I2C 接口需要注意的是LVGL 移植逻辑与具体屏幕尺寸强相关但整体流程在所有带 LTDC 的 STM32 平台上是通用的。2.2 软件工具链本文的软件环境如下集成开发环境STM32CubeIDE 1.15.0 或更新版本。固件包STM32CubeF7 Firmware Package V1.17.0 或接近版本。图形库LVGL 9.0 正式发布版本通过 GitHub Release 页面下载源码。调试方式ST-LINK 在线调试或者通过串口打印日志。基准测试输出LVGL Benchmark 结果通过串口打印波特率建议 115200。如果你的工程不是使用 STM32CubeIDE 创建的而是使用 Keil MDK 或 IAR移植思路是一样的只需要把源码文件正确加入工程并调整编译器优化等级即可。本文示例代码基于 HAL 库编写重点演示配置思路具体寄存器配置需要结合你的实际工程调整。2.3 版本对齐策略LVGL 9.x 还在快速迭代中不同小版本之间的 API 可能又有微调。建议在项目开始时就固定一个具体小版本例如 9.0.0 或 9.1.0不要在开发过程中频繁升级。对于已经开始使用 LVGL 8.3 的项目升级到 9.0 之前做好以下准备工作备份当前工程。梳理代码中使用了哪些 LVGL API。查阅官方 migration guide了解 API 变更点。先在一个最小工程上验证移植方案再迁移完整业务代码。这样可以把升级风险控制在可接受范围内。3. LVGL 9.0 与 8.3 的关键差异3.1 显示驱动接口变化在 LVGL 8.3 中注册显示设备通常这样写static lv_disp_draw_buf_t draw_buf; static lv_color_t buf1[LV_HOR_RES_MAX * 40]; static lv_color_t buf2[LV_HOR_RES_MAX * 40]; lv_disp_draw_buf_init(draw_buf, buf1, buf2, LV_HOR_RES_MAX * 40); lv_disp_drv_t disp_drv; lv_disp_drv_init(disp_drv); disp_drv.flush_cb my_flush_cb; disp_drv.draw_buf draw_buf; disp_drv.hor_res 480; disp_drv.ver_res 272; lv_disp_drv_register(disp_drv);在 LVGL 9.0 中整个接口被重构为static lv_color_t buf1[480 * 40]; static lv_color_t buf2[480 * 40]; lv_display_t *disp lv_display_create(480, 272); lv_display_set_flush_cb(disp, my_flush_cb); lv_display_set_buffers(disp, buf1, buf2, sizeof(buf1), LV_DISPLAY_RENDER_MODE_PARTIAL);可以看到lv_disp_drv_register被lv_display_create替代绘制缓冲区也不再是单独的结构体而是直接通过lv_display_set_buffers传入。3.2 颜色格式与渲染模式LVGL 9.0 中颜色格式的定义也发生变化LV_COLOR_DEPTH仍然是配置文件中的关键项但底层颜色通道宏定义有调整。如果你的屏幕是 RGB565配置LV_COLOR_DEPTH 16即可如果屏幕是 RGB888则设置为 32并注意缓存大小需要同步变化。渲染模式LV_DISPLAY_RENDER_MODE_PARTIAL和LV_DISPLAY_RENDER_MODE_FULL可以指定 LVGL 使用局部刷新还是全屏刷新。局部刷新模式下LVGL 只渲染脏矩形区域适合内存较小的 MCU全屏刷新模式下LVGL 会直接操作整个屏幕缓冲区速度更快但内存开销更大。3.3 输入设备接口变化LVGL 8.3 中注册触摸设备使用lv_indev_drv_t而 9.0 改为lv_indev_create和lv_indev_set_read_cb。核心代码差异如下lv_indev_t *indev lv_indev_create(); lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER); lv_indev_set_read_cb(indev, my_touchpad_read);对于 STM32F746G-DISCO 板载的电容触摸屏我们需要在my_touchpad_read回调中通过 I2C 读取触摸控制器寄存器并把坐标写入 LVGL 传入的lv_indev_data_t结构体。4. 从零移植 LVGL 9.0 到 STM32F746G-DISCO4.1 获取 LVGL 9.0 源码LVGL 9.0 源码可以从 GitHub 官方仓库获取。建议不要直接下载 master 分支而是选择某个明确的 release tag这样版本行为确定遇到问题也容易搜索。源码目录结构如下lvgl/ ├── examples/ │ ├── assets/ │ ├── demos/ │ │ ├── benchmark/ │ │ ├── music/ │ │ ├── widgets/ │ │ └── ... │ └── ... ├── src/ │ ├── core/ │ ├── draw/ │ ├── fonts/ │ ├── layouts/ │ ├── libs/ │ ├── misc/ │ ├── themes/ │ └── ... ├── lv_conf.h ├── lvgl.h ├── lv_version.h └── ...移植时需要把src目录加入编译并把lv_conf.h复制到你的工程中。4.2 将源码加入工程以 STM32CubeIDE 为例操作步骤如下在工程根目录下新建Middlewares目录把lvgl源码整体放进去。在工程属性中添加上级头文件搜索路径。将lvgl源码按子目录分组加入工程编译。设置 C 语言标准为 C99 或更高。开启编译器优化建议 O2 或 OfastDebug 模式下性能差距非常大。需要注意LVGL 9.0 源码中包含examples和demos目录如果不是全部需要可以只编译用到的部分。例如本文只需要 Benchmark Demo那么只需要把demos/benchmark相关文件加入工程。4.3 修改 lv_conf.hlv_conf.h是 LVGL 的全局配置头文件。在 LVGL 9.0 中首先要确认文件开关已经打开#define LV_CONF_SKIP 0如果LV_CONF_SKIP被定义为 1LVGL 会使用默认配置等于忽略了你的lv_conf.h。这个配置项在 9.0 中比较容易踩坑。本文使用到的核心配置如下/* 颜色深度RGB565 为 16RGB888 为 32 */ #define LV_COLOR_DEPTH 16 /* 默认字体 */ #define LV_FONT_MONTSERRAT_14 1 #define LV_FONT_MONTSERRAT_16 1 /* 开启内置内存分配 */ #define LV_MEM_CUSTOM 0 #define LV_MEM_SIZE (96 * 1024) /* 开启日志 */ #define LV_USE_LOG 1 #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN /* 开启 Benchmark Demo */ #define LV_USE_DEMO_BENCHMARK 1 /* 显示刷新周期单位毫秒 */ #define LV_DEF_REFR_PERIOD 16这里特别说明一下LV_MEM_SIZE。LVGL 可以自己管理内存池也可以使用标准库的malloc。在裸机工程中使用 LVGL 自带的内存池更可控。但在 STM32F746G-DISCO 上如果只依靠内部 RAM内存池设置在 96KB 到 128KB 比较稳妥因为还要叠加触摸驱动、缓冲区等内存占用。如果后续要做复杂界面建议把 LVGL 内存池放到外部 SDRAM。4.4 编写显示驱动显示驱动是移植的核心。STM32F746G-DISCO 的 LCD 通过 LTDC 驱动LVGL 渲染完成后我们需要把 LVGL 的绘制缓冲区拷贝到 LTDC 对应的显存区域。先定义双缓冲区/* 文件路径app/lvgl_port.c */ #define LCD_WIDTH 480 #define LCD_HEIGHT 272 #define BUFFER_LINE 40 static lv_color_t buf1[LCD_WIDTH * BUFFER_LINE]; static lv_color_t buf2[LCD_WIDTH * BUFFER_LINE];注意buf1和buf2最好按 32 字节对齐这样后续可以使用 DMA 或 DMA2D 搬运否则可能无法触发硬件加速。代码中可以通过__attribute__((aligned(32)))指定对齐属性或者通过内存分配接口动态获取对齐内存。显示刷新回调函数static void lvgl_flush_cb(lv_display_t *disp, const lv_area_t *area, uint8_t *pixel_data) { uint32_t width lv_area_get_width(area); uint32_t height lv_area_get_height(area); uint32_t x area-x1; uint32_t y area-y1; uint32_t framebuffer_width LCD_WIDTH; /* 将 LVGL 渲染好的 RGB565 数据写入 LTDC 显存 */ lcd_draw_pixel_rgb565(x, y, width, height, (uint16_t *)pixel_data, framebuffer_width); /* 关键步骤通知 LVGL 刷新完成 */ lv_display_flush_ready(disp); }lcd_draw_pixel_rgb565是应用层的 LCD 输出函数它的实现方式取决于显存映射。在 STM32F746G-DISCO 上SDRAM 中会划分一块区域作为 LTDC 的 framebuffer我们只需要把对应区域的像素数据拷贝过去即可。如果开启了 DMA2D可以用 DMA2D 加速这个拷贝过程避免 CPU 逐行搬运。这样 CPU 可以被 LVGL 继续用来渲染下一帧。这一块的优化效果非常明显后续章节会单独说明。4.5 编写触摸驱动STM32F746G-DISCO 板载电容触摸屏使用 I2C 接口触摸控制器型号是 FT5336。FT5336 支持多点触摸但 LVGL 的基础场景使用单点即可。初始化触摸控制器的步骤初始化 I2C 外设。通过 I2C 读取触摸控制器的厂商 ID确认设备存在。配置触摸控制器的工作模式。触摸读取回调函数static void lvgl_touchpad_read(lv_indev_t *indev, lv_indev_data_t *data) { static int16_t last_x 0; static int16_t last_y 0; uint8_t status 0; uint8_t touch_data[4] {0}; /* 读取 FT5336 触摸状态寄存器 */ i2c_read_reg(FT5336_I2C_ADDR, 0x02, status, 1); if (status 0x01) { /* 读取第一个触摸点的坐标 */ uint8_t reg[4]; i2c_read_reg(FT5336_I2C_ADDR, 0x03, reg, 4); last_x ((reg[0] 0x0F) 8) | reg[1]; last_y ((reg[2] 0x0F) 8) | reg[3]; >#define LV_TICK_CUSTOM 1 uint32_t custom_tick_get(void) { return HAL_GetTick(); } #define LV_TICK_CUSTOM_INCLUDE main.h #define LV_TICK_CUSTOM_SYS_TIME_EXPR (custom_tick_get())注意HAL_GetTick默认使用 SysTick 作为时基如果你的工程把 SysTick 用作其他任务需要改用其他定时器。4.7 main 函数初始化流程初始化顺序很有讲究。LCD、触摸、SDRAM、DMA2D 都必须先于 LVGL 初始化否则 LVGL 在创建显示设备时拿不到可用的底层硬件。官方推荐顺序如下/* 文件路径app/main.c */ #include lvgl.h #include lv_port.h #include demos/benchmark/lv_demo_benchmark.h int main(void) { HAL_Init(); SystemClock_Config(); /* 1. 初始化底层硬件 */ lcd_init(); touch_init(); sdram_init(); dma2d_init(); /* 2. 初始化 LVGL */ lv_init(); /* 3. 注册显示设备和输入设备 */ lv_port_display_init(); lv_port_indev_init(); /* 4. 运行 Benchmark Demo */ lv_demo_benchmark(); /* 5. 主循环 */ while (1) { lv_timer_handler(); delay(1); } }lv_timer_handler是 LVGL 的心跳处理函数它负责处理定时任务、动画、控件重绘和刷新。这个函数的调用频率越高界面响应越及时但也会占用更多 CPU。常见做法是把主循环周期控制在 2ms 到 5ms。注意lv_demo_benchmark并不是简单执行一次就结束的它会在测试过程中不断切换渲染场景。在lv_demo_benchmark运行时主循环依然需要持续调用lv_timer_handler。5. 性能基准测试实战5.1 LVGL 内置 Benchmark DemoLVGL 官方提供了多个 demo其中lv_demo_benchmark专用于性能测试。测试内容包括填充纯色矩形。绘制带边框的矩形。绘制圆角矩形。绘制不同半径的圆弧。绘制阴影效果。绘制不同字号和字体的文字。绘制图片和动画。每个场景都会运行一段时间统计渲染的平均耗时、最大耗时、最小耗时最后把结果整理成一份报告通过 LVGL 的日志系统输出到串口。在lv_conf.h中需要确保开启以下配置#define LV_USE_DEMO_BENCHMARK 1同时在主程序中调用lv_demo_benchmark()。在 LVGL 9.0 中部分 demo 参数有调整如果你的工程编译时报参数不匹配需要查看当前版本lv_demo_benchmark.h的具体函数签名。5.2 测试流程与预期输出测试流程如下将程序下载到 STM32F746G-DISCO。打开串口调试助手波特率 115200。复位开发板观察屏幕画面变化。等待 Benchmark 跑完所有场景。在串口日志中查看性能统计结果。默认情况下Benchmark 结束后会把测试报告写入一个字符串缓冲区然后通过LV_LOG输出。如果屏幕显示正常但串口没有输出请检查LV_USE_LOG和LV_LOG_LEVEL配置。在 LVGL 9.0 中Benchmark 报告的部分输出形式是Perf. result (FPS): 0, (CPU): 0%因为性能数据与屏幕分辨率、颜色格式、编译器优化等级、是否开启 DMA2D、是否使用外部 SDRAM 都有关系任何两个工程跑出来的数据都不完全一致。请以你的实际运行环境为准不要轻信网上所谓的固定跑分。本文也不会给出编造的 FPS 数值而是告诉你如何读取报告并进行对比。5.3 帧耗时与 FPS 换算LVGL 的 Benchmark 报告会给出每个渲染场景的耗时统计常用的指标有三个avg平均每帧渲染耗时反映整体性能水平。max最大单帧渲染耗时反映最差情况比如卡顿峰值。min最小单帧渲染耗时反映最好情况。FPS 可以从平均耗时换算FPS 1000 / avg_time_ms例如如果某个场景平均耗时是 16ms那么 FPS 大约是 62。如果某个场景平均耗时只有 5ms那么 FPS 可以到 200。但 FPS 并不是唯一的性能指标。在嵌入式 GUI 产品中更关键的是最大耗时是否超过显示刷新周期。假设屏幕刷新率是 60Hz那么每帧预算大约是 16.67ms。只要某帧渲染耗时超过这个值就会出现掉帧现象。因此优化目标不仅是提高平均 FPS更重要的是把最大耗时压到刷新周期以内。5.4 结果解读思路拿到 Benchmark 报告后建议按以下顺序分析看哪些场景的 FPS 最低。低 FPS 场景往往意味着图形库的某个特性在你的硬件上开销很大。看阴影和透明度场景的耗时。在未开启 DMA2D 的平台上这两类效果通常非常耗 CPU。看文字渲染耗时。如果你的产品界面包含大量动态数字或文本文字渲染性能很关键。对比不同颜色深度下的性能。RGB565 相比 RGB888 内存占用更小渲染速度通常也更快。例如如果你发现阴影场景的 FPS 显著低于矩形场景说明当前平台不支持硬件的抗锯齿和阴影混合LVGL 只能通过软件算法逐像素模拟。此时如果产品对性能要求高可以关闭阴影效果或者改用简化样式。6. 性能优化手段6.1 开启 DMA2D 加速STM32F746 自带 DMA2D可以完成图形数据拷贝、颜色格式转换、混合等操作。LVGL 本身支持通过draw buffer的拷贝回调来触发 DMA2D但更常见的做法是把显存拷贝函数从 memcpy 换成 DMA2D。实现时要注意 DMA2D 的配置。例如把 RGB565 数据从内部 SRAM 拷贝到外部 SDRAM需要配置源地址、目标地址、颜色格式、像素宽度和高度。如果源地址和目的地址的字节对齐不满足要求DMA2D 可能无法工作。此外DMA2D 是异步外设启动一次传输后 CPU 可以继续渲染下一帧但需要在传输完成中断中调用lv_display_flush_ready。如果直接在flush_cb中忙等待 DMA2D 完成收益会大打折扣。6.2 使用多缓冲LVGL 支持多缓冲机制。简单来说LVGL 在渲染当前帧时底层显示正在刷新上一帧的数据。如果只有一块缓冲LVGL 必须等上一帧完全刷新完才能开始渲染下一帧造成空转等待。使用双缓冲或三缓冲之后渲染和刷新可以流水线执行有效提高 FPS。本文的显示驱动示例已经定义了两块缓冲区static lv_color_t buf1[LCD_WIDTH * BUFFER_LINE]; static lv_color_t buf2[LCD_WIDTH * BUFFER_LINE];如果外部 SDRAM 空间充足可以尝试把缓冲区扩大例如从 40 行扩展到 136 行或整个屏幕 272 行。缓冲区越大LVGL 一次可以处理的渲染区域越大CPU 的调度开销越低。需要注意的是双缓冲并不能直接提升单帧渲染速度它提升的是整体吞吐量因为你消除了刷新等待时间。6.3 使用外部 SDRAMSTM32F746G-DISCO 的 320KB 内部 RAM 看起来不小但 LVGL 的动态内存池、显存、缓冲区、动画对象叠加起来之后空间很快就会紧张。外部 SDRAM 有 16MB可以直接把 LVGL 的内存池放到 SDRAM 中。有两种做法把 LVGL 的LV_MEM_CUSTOM打开通过lv_malloc对应的内存分配函数指向 SDRAM 堆。在链接脚本中把.lvl_mem段定位到 SDRAM 地址空间。第二种做法更彻底但涉及启动代码和链接脚本修改。第一种做法更灵活适合通过内存池管理工具分配 SDRAM。需要注意SDRAM 的访问速度通常比内部 SRAM 慢也存在刷新延迟。如果所有 LVGL 动态内存都在 SDRAM 中频繁分配和释放对象时可能感觉到卡顿。稳妥的做法是关键对象的静态分配放在内部 RAM。图片资源、字体数据、大块内存池放在外部 SDRAM。用时间换空间优先保证功能稳定。6.4 局部刷新脏矩形机制LVGL 有脏矩形机制不会每次都渲染整个屏幕而是只重绘发生变化的区域。因此界面上一个按钮的颜色变化并不会导致整个屏幕重新渲染一遍。在性能优化时可以利用这一机制避免频繁刷新大面积区域例如满屏视频播放就不适合 LVGL。动画尽量使用较小控件减小脏矩形面积。尽量减少全屏透明度变化效果透明度变化会扩大脏矩形范围。合理使用lv_obj_invalidate不要手动让整个界面强制刷新。如果你的界面中有实时数据波形图可以考虑把波形区域限制在固定小窗口内而不是让波形占满整个屏幕。6.5 关闭不必要的特效和阴影LVGL 9.0 对阴影、圆角、透明度等效果支持得很好但这些效果的计算开销不容忽视。在 Cortex-M7 平台上软件渲染这些特效会占用大量 CPU 时间。可以通过以下手段降低开销尽量使用矩形背景减少圆角。不使用阴影或者只在小范围内使用阴影。避免大量控件同时使用透明度动画。减少抗锯齿范围例如不启用字体的抗锯齿。在lv_conf.h中关闭不需要的绘制特性。这些优化看似简单但在性能基准测试中往往能带来数倍差距。7. 常见问题与排查思路LVGL 9.0 移植过程中常见的问题集中在编译、显示、触摸、内存四类。下面整理了一份排查表格。问题现象常见原因解决思路编译报错找不到lv_disp_drv_tLVGL 9.0 已移除该接口改用lv_display_t参考官方 migration guide编译报错lv_disp_draw_buf_t未定义缓冲区接口变更改用lv_display_set_buffers程序运行后白屏LTDC 未初始化或显存地址错误检查 LTDC 配置、SDRAM 初始化顺序、framebuffer 地址白屏且串口无日志LV_CONF_SKIP为 1确保lv_conf.h中LV_CONF_SKIP为 0花屏颜色格式不一致或缓冲区过小确认 LVGLLV_COLOR_DEPTH与 LCD 像素格式一致花屏且画面闪烁缓冲区和 LTDC 帧率不匹配检查 DMA2D 传输完成标志确认刷新回调时机触摸无反应I2C 初始化失败或中断缺失先读取触摸控制器 ID确认 I2C 通信正常触摸坐标反向LCD 坐标系与触摸坐标系不一致做坐标映射转换必要时测试四个角的坐标点击位置偏移触摸数据需要坐标转换根据屏幕尺寸和方向调整x LCD_WIDTH - x - 1运行一段时间后卡死内存不足或内存碎片增大LV_MEM_SIZE检查外部 SDRAM 是否稳定界面卡顿未开启编译器优化将优化等级设置为 O2 或 Ofast界面卡顿未使用 DMA2D开启 DMA2D 硬件加速Benchmark 串口无输出LV_USE_LOG未开启在lv_conf.h中设置LV_USE_LOG 1内存不足缓冲区过大减小缓冲区行数改用局部刷新模式排查时建议从现象入手先确认底层硬件是否正常再排查 LVGL 层的问题。例如屏幕花屏先绕过 LVGL直接向显存填充纯色确认 LCD 驱动没有问题再回头检查 LVGL 的缓冲区和刷新回调。8. 最佳实践与工程建议8.1 配置分层管理LVGL 9.0 的lv_conf.h有几百个配置项建议不要直接修改官方原始文件而是复制一份到自己的工程目录中并在文件开头加注释说明修改日期和用途。这样升级 LVGL 版本时可以快速比对配置差异。如果项目中有多个显示设备或多种屏幕规格可以考虑把显示相关配置提取到单独的头文件中例如ui_board_config.h按需求切换分辨率、颜色深度和缓冲区大小。8.2 内存规划要提前做内存问题在 GUI 项目中非常突出。建议在项目启动阶段就做一个粗略的内存预算表LCD framebuffer 占用多少。LVGL 绘制缓冲区占用多少。LVGL 内存池分配多少。触摸驱动、文件系统、通信协议各占用多少。任务栈如果使用 RTOS占用多少。STM32F746G-DISCO 的内部 RAM 只有 320KB如果所有模块都挤在内部 RAM 中很快就会耗尽。合理的方式是把 framebuffer 和图片素材放到外部 SDRAM把 LVGL 的内存池也放到 SDRAM内部 RAM 主要留给中断、DMA 缓冲和实时性要求高的任务。8.3 用性能测试数据驱动优化在优化界面时不要凭感觉判断卡不卡建议把性能基准测试作为优化前后的对比工具。每次修改硬件配置或软件实现后重新跑一次 Benchmark记录变化。我比较推荐的做法是第一次跑 Benchmark记录基线数据。开启 DMA2D记录第二次数据。调整缓冲区大小记录第三次数据。把代码从 Debug 改成 Release 编译记录第四次数据。最后根据每组数据的平均耗时和最大耗时综合评估。这样得出的优化结论更有说服力也方便在团队内分享技术方案。8.4 需要注意的安全与稳定性边界在真实产品中LVGL 界面的稳定性往往比炫酷更重要。以下几点需要重视不要在定时器中断或高优先级中断中直接调用 LVGL API。LVGL 内部不是线程安全的如果使用 RTOS需要为 LVGL 加锁或者在主线程中统一调用lv_timer_handler。访问外部 SDRAM 时注意 MCU 的时序配置SDRAM 初始化失败会导致随机崩溃。操作显存或缓冲区时务必检查地址边界防止越界写坏其他内存区域。在修改 LTDC、DMA2D 等底层硬件时先在测试板上验证不要直接在量产机器上操作。8.5 工程代码的可维护性移植 LVGL 9.0 不是一次性工作后续还会涉及升级、适配新屏幕、增加新功能。建议把底层硬件操作和 LVGL 逻辑解耦例如把显示驱动、触摸驱动、DMA2D 封装为独立模块LVGL 部分只关心接口回调不关心具体硬件细节。这样做的好处是更换屏幕时只需要修改硬件驱动模块。升级 LVGL 版本时可以复用底层硬件模块。代码在团队内更容易多人协作。9. 总结本文从 STM32F746G-DISCO 开发板出发完成了 LVGL 9.0 的完整移植覆盖了显示驱动、触摸驱动、tick 心跳、主循环初始化等核心步骤并且利用 LVGL 官方 Benchmark Demo 对平台进行了性能基准测试。移植过程中最大的变化是 LVGL 9.0 不再兼容 8.3 的显示设备和输入设备接口需要理解lv_display_t、lv_indev_t以及lv_display_set_buffers这一套新 API。性能基准测试不仅仅是测一个 FPS 数字更重要的是通过平均耗时和最大耗时找到性能瓶颈然后结合 DMA2D、双缓冲、外部 SDRAM、局部刷新等手段做针对性优化。如果你手头正好有 STM32F746G-DISCO建议按照本文流程亲手移植一遍再跑一次 Benchmark记录自己板子上的真实数据。后续如果继续学习可以研究 LVGL 9.0 的样式系统、动画框架和渲染流水线或者结合 FreeRTOS 把 LVGL 放到多任务环境中运行。
之前在 STM32 上进行 UI 开发相信很多朋友和我一样在 LVGL 8.x 时代已经积累了一套熟悉的移植流程。但当 LVGL 9.0 正式发布之后显示驱动接口、缓冲区配置方式、对象模型都有不小变化直接把旧代码搬过去往往会出现编译报错或者显示异常。本文基于 STM32F746G-DISCO 开发板完整记录 LVGL 9.0 的移植过程并通过自带的 Benchmark Demo 做一轮性能基准测试最后给出针对性的优化建议。无论是刚接触 LVGL 的新手还是准备从 8.x 升级的老手都可以参考这套流程。1. 背景与核心概念1.1 LVGL 9.0 是什么LVGLLight and Versatile Graphics Library是一款开源嵌入式图形库专门为资源受限的 MCU 设备设计。它提供了一套接近桌面 GUI 框架的控件库、事件系统、动画框架和布局引擎开发者可以在只有几百 KB 内存的单片机上实现比较复杂的交互界面。LVGL 9.0 是继 8.3 之后的一个重要大版本。在 9.0 中官方对内部架构进行了重构比较明显的改动包括显示设备驱动接口从lv_disp_drv_t调整为lv_display_t注册函数也发生了变化。缓冲区管理方式改变不再直接注册一个lv_disp_draw_buf_t结构体而是通过lv_display_set_buffers接口关联绘制缓冲区。输入设备驱动同步调整触摸、鼠标、键盘等设备的注册方式更统一。移除了部分旧 API配置项lv_conf.h的内容也做了精简和重命名。对于使用 STM32 这类 MCU 的开发者来说LVGL 9.0 带来的最大感知是 API 不再兼容 8.x因此网上很多基于 8.3 的教程不能直接照搬。1.2 STM32F746G-DISCO 为什么适合跑 LVGLSTM32F746G-DISCO 是 ST 官方推出的评估板核心芯片是 STM32F746NGH6Cortex-M7 内核主频可以跑到 216MHz。板载资源对 GUI 开发非常友好4.3 寸 TFT LCD分辨率 480x272带电容触摸屏。内部 RAM 320KB外部 SDRAM 16MB。板载 ST-LINK 调试器USB 接口可以直接供电和下载程序。MCU 自带 LTDC LCD 控制器和 DMA2D 图形加速器。LTDC 的作用是把显存中的图像数据持续刷新到 LCD 上不需要 CPU 逐像素搬运DMA2D 则可以做颜色格式转换、图像复制、混合等操作。当 LVGL 渲染完一帧画面后DMA2D 可以代替 CPU 快速把数据刷到显存这对 FPS 的影响非常明显。所以这块开发板本身就是 ST 官方用来演示 GUI 和图形加速能力的平台用来做 LVGL 9.0 移植和性能基准测试非常合适。1.3 性能基准测试要解决的问题嵌入式 GUI 开发中经常遇到几个问题界面滑动卡顿、掉帧。动画效果不流畅看起来一卡一卡的。控件复杂之后屏幕刷新时间明显变长。代码写完了才发现在低端 MCU 上跑不动需要推翻重来。性能基准测试就是通过固定场景的渲染任务测量 LVGL 在一秒内能渲染多少帧画面以及每帧平均耗时和最大耗时。LVGL 官方提供了 Benchmark Demo里面包含多种典型绘制任务例如矩形、边框、阴影、文字、圆弧、图片等测试结果可以量化图形库在当前硬件上的真实表现。通过基准测试可以判断当前硬件平台是否满足产品需求也可以在同一次测试中对不同优化方案进行对比避免凭感觉调优。2. 环境准备与版本说明2.1 硬件环境本文使用的硬件是 STM32F746G-DISCO 开发板主要参数如下表所示硬件资源参数主控芯片STM32F746NGH6Cortex-M7216MHz内部 Flash1MB内部 RAM320KB外部 SDRAM16MBLCD 分辨率480x272LCD 接口RGB888LTDC 驱动触摸屏电容触摸I2C 接口需要注意的是LVGL 移植逻辑与具体屏幕尺寸强相关但整体流程在所有带 LTDC 的 STM32 平台上是通用的。2.2 软件工具链本文的软件环境如下集成开发环境STM32CubeIDE 1.15.0 或更新版本。固件包STM32CubeF7 Firmware Package V1.17.0 或接近版本。图形库LVGL 9.0 正式发布版本通过 GitHub Release 页面下载源码。调试方式ST-LINK 在线调试或者通过串口打印日志。基准测试输出LVGL Benchmark 结果通过串口打印波特率建议 115200。如果你的工程不是使用 STM32CubeIDE 创建的而是使用 Keil MDK 或 IAR移植思路是一样的只需要把源码文件正确加入工程并调整编译器优化等级即可。本文示例代码基于 HAL 库编写重点演示配置思路具体寄存器配置需要结合你的实际工程调整。2.3 版本对齐策略LVGL 9.x 还在快速迭代中不同小版本之间的 API 可能又有微调。建议在项目开始时就固定一个具体小版本例如 9.0.0 或 9.1.0不要在开发过程中频繁升级。对于已经开始使用 LVGL 8.3 的项目升级到 9.0 之前做好以下准备工作备份当前工程。梳理代码中使用了哪些 LVGL API。查阅官方 migration guide了解 API 变更点。先在一个最小工程上验证移植方案再迁移完整业务代码。这样可以把升级风险控制在可接受范围内。3. LVGL 9.0 与 8.3 的关键差异3.1 显示驱动接口变化在 LVGL 8.3 中注册显示设备通常这样写static lv_disp_draw_buf_t draw_buf; static lv_color_t buf1[LV_HOR_RES_MAX * 40]; static lv_color_t buf2[LV_HOR_RES_MAX * 40]; lv_disp_draw_buf_init(draw_buf, buf1, buf2, LV_HOR_RES_MAX * 40); lv_disp_drv_t disp_drv; lv_disp_drv_init(disp_drv); disp_drv.flush_cb my_flush_cb; disp_drv.draw_buf draw_buf; disp_drv.hor_res 480; disp_drv.ver_res 272; lv_disp_drv_register(disp_drv);在 LVGL 9.0 中整个接口被重构为static lv_color_t buf1[480 * 40]; static lv_color_t buf2[480 * 40]; lv_display_t *disp lv_display_create(480, 272); lv_display_set_flush_cb(disp, my_flush_cb); lv_display_set_buffers(disp, buf1, buf2, sizeof(buf1), LV_DISPLAY_RENDER_MODE_PARTIAL);可以看到lv_disp_drv_register被lv_display_create替代绘制缓冲区也不再是单独的结构体而是直接通过lv_display_set_buffers传入。3.2 颜色格式与渲染模式LVGL 9.0 中颜色格式的定义也发生变化LV_COLOR_DEPTH仍然是配置文件中的关键项但底层颜色通道宏定义有调整。如果你的屏幕是 RGB565配置LV_COLOR_DEPTH 16即可如果屏幕是 RGB888则设置为 32并注意缓存大小需要同步变化。渲染模式LV_DISPLAY_RENDER_MODE_PARTIAL和LV_DISPLAY_RENDER_MODE_FULL可以指定 LVGL 使用局部刷新还是全屏刷新。局部刷新模式下LVGL 只渲染脏矩形区域适合内存较小的 MCU全屏刷新模式下LVGL 会直接操作整个屏幕缓冲区速度更快但内存开销更大。3.3 输入设备接口变化LVGL 8.3 中注册触摸设备使用lv_indev_drv_t而 9.0 改为lv_indev_create和lv_indev_set_read_cb。核心代码差异如下lv_indev_t *indev lv_indev_create(); lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER); lv_indev_set_read_cb(indev, my_touchpad_read);对于 STM32F746G-DISCO 板载的电容触摸屏我们需要在my_touchpad_read回调中通过 I2C 读取触摸控制器寄存器并把坐标写入 LVGL 传入的lv_indev_data_t结构体。4. 从零移植 LVGL 9.0 到 STM32F746G-DISCO4.1 获取 LVGL 9.0 源码LVGL 9.0 源码可以从 GitHub 官方仓库获取。建议不要直接下载 master 分支而是选择某个明确的 release tag这样版本行为确定遇到问题也容易搜索。源码目录结构如下lvgl/ ├── examples/ │ ├── assets/ │ ├── demos/ │ │ ├── benchmark/ │ │ ├── music/ │ │ ├── widgets/ │ │ └── ... │ └── ... ├── src/ │ ├── core/ │ ├── draw/ │ ├── fonts/ │ ├── layouts/ │ ├── libs/ │ ├── misc/ │ ├── themes/ │ └── ... ├── lv_conf.h ├── lvgl.h ├── lv_version.h └── ...移植时需要把src目录加入编译并把lv_conf.h复制到你的工程中。4.2 将源码加入工程以 STM32CubeIDE 为例操作步骤如下在工程根目录下新建Middlewares目录把lvgl源码整体放进去。在工程属性中添加上级头文件搜索路径。将lvgl源码按子目录分组加入工程编译。设置 C 语言标准为 C99 或更高。开启编译器优化建议 O2 或 OfastDebug 模式下性能差距非常大。需要注意LVGL 9.0 源码中包含examples和demos目录如果不是全部需要可以只编译用到的部分。例如本文只需要 Benchmark Demo那么只需要把demos/benchmark相关文件加入工程。4.3 修改 lv_conf.hlv_conf.h是 LVGL 的全局配置头文件。在 LVGL 9.0 中首先要确认文件开关已经打开#define LV_CONF_SKIP 0如果LV_CONF_SKIP被定义为 1LVGL 会使用默认配置等于忽略了你的lv_conf.h。这个配置项在 9.0 中比较容易踩坑。本文使用到的核心配置如下/* 颜色深度RGB565 为 16RGB888 为 32 */ #define LV_COLOR_DEPTH 16 /* 默认字体 */ #define LV_FONT_MONTSERRAT_14 1 #define LV_FONT_MONTSERRAT_16 1 /* 开启内置内存分配 */ #define LV_MEM_CUSTOM 0 #define LV_MEM_SIZE (96 * 1024) /* 开启日志 */ #define LV_USE_LOG 1 #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN /* 开启 Benchmark Demo */ #define LV_USE_DEMO_BENCHMARK 1 /* 显示刷新周期单位毫秒 */ #define LV_DEF_REFR_PERIOD 16这里特别说明一下LV_MEM_SIZE。LVGL 可以自己管理内存池也可以使用标准库的malloc。在裸机工程中使用 LVGL 自带的内存池更可控。但在 STM32F746G-DISCO 上如果只依靠内部 RAM内存池设置在 96KB 到 128KB 比较稳妥因为还要叠加触摸驱动、缓冲区等内存占用。如果后续要做复杂界面建议把 LVGL 内存池放到外部 SDRAM。4.4 编写显示驱动显示驱动是移植的核心。STM32F746G-DISCO 的 LCD 通过 LTDC 驱动LVGL 渲染完成后我们需要把 LVGL 的绘制缓冲区拷贝到 LTDC 对应的显存区域。先定义双缓冲区/* 文件路径app/lvgl_port.c */ #define LCD_WIDTH 480 #define LCD_HEIGHT 272 #define BUFFER_LINE 40 static lv_color_t buf1[LCD_WIDTH * BUFFER_LINE]; static lv_color_t buf2[LCD_WIDTH * BUFFER_LINE];注意buf1和buf2最好按 32 字节对齐这样后续可以使用 DMA 或 DMA2D 搬运否则可能无法触发硬件加速。代码中可以通过__attribute__((aligned(32)))指定对齐属性或者通过内存分配接口动态获取对齐内存。显示刷新回调函数static void lvgl_flush_cb(lv_display_t *disp, const lv_area_t *area, uint8_t *pixel_data) { uint32_t width lv_area_get_width(area); uint32_t height lv_area_get_height(area); uint32_t x area-x1; uint32_t y area-y1; uint32_t framebuffer_width LCD_WIDTH; /* 将 LVGL 渲染好的 RGB565 数据写入 LTDC 显存 */ lcd_draw_pixel_rgb565(x, y, width, height, (uint16_t *)pixel_data, framebuffer_width); /* 关键步骤通知 LVGL 刷新完成 */ lv_display_flush_ready(disp); }lcd_draw_pixel_rgb565是应用层的 LCD 输出函数它的实现方式取决于显存映射。在 STM32F746G-DISCO 上SDRAM 中会划分一块区域作为 LTDC 的 framebuffer我们只需要把对应区域的像素数据拷贝过去即可。如果开启了 DMA2D可以用 DMA2D 加速这个拷贝过程避免 CPU 逐行搬运。这样 CPU 可以被 LVGL 继续用来渲染下一帧。这一块的优化效果非常明显后续章节会单独说明。4.5 编写触摸驱动STM32F746G-DISCO 板载电容触摸屏使用 I2C 接口触摸控制器型号是 FT5336。FT5336 支持多点触摸但 LVGL 的基础场景使用单点即可。初始化触摸控制器的步骤初始化 I2C 外设。通过 I2C 读取触摸控制器的厂商 ID确认设备存在。配置触摸控制器的工作模式。触摸读取回调函数static void lvgl_touchpad_read(lv_indev_t *indev, lv_indev_data_t *data) { static int16_t last_x 0; static int16_t last_y 0; uint8_t status 0; uint8_t touch_data[4] {0}; /* 读取 FT5336 触摸状态寄存器 */ i2c_read_reg(FT5336_I2C_ADDR, 0x02, status, 1); if (status 0x01) { /* 读取第一个触摸点的坐标 */ uint8_t reg[4]; i2c_read_reg(FT5336_I2C_ADDR, 0x03, reg, 4); last_x ((reg[0] 0x0F) 8) | reg[1]; last_y ((reg[2] 0x0F) 8) | reg[3]; >#define LV_TICK_CUSTOM 1 uint32_t custom_tick_get(void) { return HAL_GetTick(); } #define LV_TICK_CUSTOM_INCLUDE main.h #define LV_TICK_CUSTOM_SYS_TIME_EXPR (custom_tick_get())注意HAL_GetTick默认使用 SysTick 作为时基如果你的工程把 SysTick 用作其他任务需要改用其他定时器。4.7 main 函数初始化流程初始化顺序很有讲究。LCD、触摸、SDRAM、DMA2D 都必须先于 LVGL 初始化否则 LVGL 在创建显示设备时拿不到可用的底层硬件。官方推荐顺序如下/* 文件路径app/main.c */ #include lvgl.h #include lv_port.h #include demos/benchmark/lv_demo_benchmark.h int main(void) { HAL_Init(); SystemClock_Config(); /* 1. 初始化底层硬件 */ lcd_init(); touch_init(); sdram_init(); dma2d_init(); /* 2. 初始化 LVGL */ lv_init(); /* 3. 注册显示设备和输入设备 */ lv_port_display_init(); lv_port_indev_init(); /* 4. 运行 Benchmark Demo */ lv_demo_benchmark(); /* 5. 主循环 */ while (1) { lv_timer_handler(); delay(1); } }lv_timer_handler是 LVGL 的心跳处理函数它负责处理定时任务、动画、控件重绘和刷新。这个函数的调用频率越高界面响应越及时但也会占用更多 CPU。常见做法是把主循环周期控制在 2ms 到 5ms。注意lv_demo_benchmark并不是简单执行一次就结束的它会在测试过程中不断切换渲染场景。在lv_demo_benchmark运行时主循环依然需要持续调用lv_timer_handler。5. 性能基准测试实战5.1 LVGL 内置 Benchmark DemoLVGL 官方提供了多个 demo其中lv_demo_benchmark专用于性能测试。测试内容包括填充纯色矩形。绘制带边框的矩形。绘制圆角矩形。绘制不同半径的圆弧。绘制阴影效果。绘制不同字号和字体的文字。绘制图片和动画。每个场景都会运行一段时间统计渲染的平均耗时、最大耗时、最小耗时最后把结果整理成一份报告通过 LVGL 的日志系统输出到串口。在lv_conf.h中需要确保开启以下配置#define LV_USE_DEMO_BENCHMARK 1同时在主程序中调用lv_demo_benchmark()。在 LVGL 9.0 中部分 demo 参数有调整如果你的工程编译时报参数不匹配需要查看当前版本lv_demo_benchmark.h的具体函数签名。5.2 测试流程与预期输出测试流程如下将程序下载到 STM32F746G-DISCO。打开串口调试助手波特率 115200。复位开发板观察屏幕画面变化。等待 Benchmark 跑完所有场景。在串口日志中查看性能统计结果。默认情况下Benchmark 结束后会把测试报告写入一个字符串缓冲区然后通过LV_LOG输出。如果屏幕显示正常但串口没有输出请检查LV_USE_LOG和LV_LOG_LEVEL配置。在 LVGL 9.0 中Benchmark 报告的部分输出形式是Perf. result (FPS): 0, (CPU): 0%因为性能数据与屏幕分辨率、颜色格式、编译器优化等级、是否开启 DMA2D、是否使用外部 SDRAM 都有关系任何两个工程跑出来的数据都不完全一致。请以你的实际运行环境为准不要轻信网上所谓的固定跑分。本文也不会给出编造的 FPS 数值而是告诉你如何读取报告并进行对比。5.3 帧耗时与 FPS 换算LVGL 的 Benchmark 报告会给出每个渲染场景的耗时统计常用的指标有三个avg平均每帧渲染耗时反映整体性能水平。max最大单帧渲染耗时反映最差情况比如卡顿峰值。min最小单帧渲染耗时反映最好情况。FPS 可以从平均耗时换算FPS 1000 / avg_time_ms例如如果某个场景平均耗时是 16ms那么 FPS 大约是 62。如果某个场景平均耗时只有 5ms那么 FPS 可以到 200。但 FPS 并不是唯一的性能指标。在嵌入式 GUI 产品中更关键的是最大耗时是否超过显示刷新周期。假设屏幕刷新率是 60Hz那么每帧预算大约是 16.67ms。只要某帧渲染耗时超过这个值就会出现掉帧现象。因此优化目标不仅是提高平均 FPS更重要的是把最大耗时压到刷新周期以内。5.4 结果解读思路拿到 Benchmark 报告后建议按以下顺序分析看哪些场景的 FPS 最低。低 FPS 场景往往意味着图形库的某个特性在你的硬件上开销很大。看阴影和透明度场景的耗时。在未开启 DMA2D 的平台上这两类效果通常非常耗 CPU。看文字渲染耗时。如果你的产品界面包含大量动态数字或文本文字渲染性能很关键。对比不同颜色深度下的性能。RGB565 相比 RGB888 内存占用更小渲染速度通常也更快。例如如果你发现阴影场景的 FPS 显著低于矩形场景说明当前平台不支持硬件的抗锯齿和阴影混合LVGL 只能通过软件算法逐像素模拟。此时如果产品对性能要求高可以关闭阴影效果或者改用简化样式。6. 性能优化手段6.1 开启 DMA2D 加速STM32F746 自带 DMA2D可以完成图形数据拷贝、颜色格式转换、混合等操作。LVGL 本身支持通过draw buffer的拷贝回调来触发 DMA2D但更常见的做法是把显存拷贝函数从 memcpy 换成 DMA2D。实现时要注意 DMA2D 的配置。例如把 RGB565 数据从内部 SRAM 拷贝到外部 SDRAM需要配置源地址、目标地址、颜色格式、像素宽度和高度。如果源地址和目的地址的字节对齐不满足要求DMA2D 可能无法工作。此外DMA2D 是异步外设启动一次传输后 CPU 可以继续渲染下一帧但需要在传输完成中断中调用lv_display_flush_ready。如果直接在flush_cb中忙等待 DMA2D 完成收益会大打折扣。6.2 使用多缓冲LVGL 支持多缓冲机制。简单来说LVGL 在渲染当前帧时底层显示正在刷新上一帧的数据。如果只有一块缓冲LVGL 必须等上一帧完全刷新完才能开始渲染下一帧造成空转等待。使用双缓冲或三缓冲之后渲染和刷新可以流水线执行有效提高 FPS。本文的显示驱动示例已经定义了两块缓冲区static lv_color_t buf1[LCD_WIDTH * BUFFER_LINE]; static lv_color_t buf2[LCD_WIDTH * BUFFER_LINE];如果外部 SDRAM 空间充足可以尝试把缓冲区扩大例如从 40 行扩展到 136 行或整个屏幕 272 行。缓冲区越大LVGL 一次可以处理的渲染区域越大CPU 的调度开销越低。需要注意的是双缓冲并不能直接提升单帧渲染速度它提升的是整体吞吐量因为你消除了刷新等待时间。6.3 使用外部 SDRAMSTM32F746G-DISCO 的 320KB 内部 RAM 看起来不小但 LVGL 的动态内存池、显存、缓冲区、动画对象叠加起来之后空间很快就会紧张。外部 SDRAM 有 16MB可以直接把 LVGL 的内存池放到 SDRAM 中。有两种做法把 LVGL 的LV_MEM_CUSTOM打开通过lv_malloc对应的内存分配函数指向 SDRAM 堆。在链接脚本中把.lvl_mem段定位到 SDRAM 地址空间。第二种做法更彻底但涉及启动代码和链接脚本修改。第一种做法更灵活适合通过内存池管理工具分配 SDRAM。需要注意SDRAM 的访问速度通常比内部 SRAM 慢也存在刷新延迟。如果所有 LVGL 动态内存都在 SDRAM 中频繁分配和释放对象时可能感觉到卡顿。稳妥的做法是关键对象的静态分配放在内部 RAM。图片资源、字体数据、大块内存池放在外部 SDRAM。用时间换空间优先保证功能稳定。6.4 局部刷新脏矩形机制LVGL 有脏矩形机制不会每次都渲染整个屏幕而是只重绘发生变化的区域。因此界面上一个按钮的颜色变化并不会导致整个屏幕重新渲染一遍。在性能优化时可以利用这一机制避免频繁刷新大面积区域例如满屏视频播放就不适合 LVGL。动画尽量使用较小控件减小脏矩形面积。尽量减少全屏透明度变化效果透明度变化会扩大脏矩形范围。合理使用lv_obj_invalidate不要手动让整个界面强制刷新。如果你的界面中有实时数据波形图可以考虑把波形区域限制在固定小窗口内而不是让波形占满整个屏幕。6.5 关闭不必要的特效和阴影LVGL 9.0 对阴影、圆角、透明度等效果支持得很好但这些效果的计算开销不容忽视。在 Cortex-M7 平台上软件渲染这些特效会占用大量 CPU 时间。可以通过以下手段降低开销尽量使用矩形背景减少圆角。不使用阴影或者只在小范围内使用阴影。避免大量控件同时使用透明度动画。减少抗锯齿范围例如不启用字体的抗锯齿。在lv_conf.h中关闭不需要的绘制特性。这些优化看似简单但在性能基准测试中往往能带来数倍差距。7. 常见问题与排查思路LVGL 9.0 移植过程中常见的问题集中在编译、显示、触摸、内存四类。下面整理了一份排查表格。问题现象常见原因解决思路编译报错找不到lv_disp_drv_tLVGL 9.0 已移除该接口改用lv_display_t参考官方 migration guide编译报错lv_disp_draw_buf_t未定义缓冲区接口变更改用lv_display_set_buffers程序运行后白屏LTDC 未初始化或显存地址错误检查 LTDC 配置、SDRAM 初始化顺序、framebuffer 地址白屏且串口无日志LV_CONF_SKIP为 1确保lv_conf.h中LV_CONF_SKIP为 0花屏颜色格式不一致或缓冲区过小确认 LVGLLV_COLOR_DEPTH与 LCD 像素格式一致花屏且画面闪烁缓冲区和 LTDC 帧率不匹配检查 DMA2D 传输完成标志确认刷新回调时机触摸无反应I2C 初始化失败或中断缺失先读取触摸控制器 ID确认 I2C 通信正常触摸坐标反向LCD 坐标系与触摸坐标系不一致做坐标映射转换必要时测试四个角的坐标点击位置偏移触摸数据需要坐标转换根据屏幕尺寸和方向调整x LCD_WIDTH - x - 1运行一段时间后卡死内存不足或内存碎片增大LV_MEM_SIZE检查外部 SDRAM 是否稳定界面卡顿未开启编译器优化将优化等级设置为 O2 或 Ofast界面卡顿未使用 DMA2D开启 DMA2D 硬件加速Benchmark 串口无输出LV_USE_LOG未开启在lv_conf.h中设置LV_USE_LOG 1内存不足缓冲区过大减小缓冲区行数改用局部刷新模式排查时建议从现象入手先确认底层硬件是否正常再排查 LVGL 层的问题。例如屏幕花屏先绕过 LVGL直接向显存填充纯色确认 LCD 驱动没有问题再回头检查 LVGL 的缓冲区和刷新回调。8. 最佳实践与工程建议8.1 配置分层管理LVGL 9.0 的lv_conf.h有几百个配置项建议不要直接修改官方原始文件而是复制一份到自己的工程目录中并在文件开头加注释说明修改日期和用途。这样升级 LVGL 版本时可以快速比对配置差异。如果项目中有多个显示设备或多种屏幕规格可以考虑把显示相关配置提取到单独的头文件中例如ui_board_config.h按需求切换分辨率、颜色深度和缓冲区大小。8.2 内存规划要提前做内存问题在 GUI 项目中非常突出。建议在项目启动阶段就做一个粗略的内存预算表LCD framebuffer 占用多少。LVGL 绘制缓冲区占用多少。LVGL 内存池分配多少。触摸驱动、文件系统、通信协议各占用多少。任务栈如果使用 RTOS占用多少。STM32F746G-DISCO 的内部 RAM 只有 320KB如果所有模块都挤在内部 RAM 中很快就会耗尽。合理的方式是把 framebuffer 和图片素材放到外部 SDRAM把 LVGL 的内存池也放到 SDRAM内部 RAM 主要留给中断、DMA 缓冲和实时性要求高的任务。8.3 用性能测试数据驱动优化在优化界面时不要凭感觉判断卡不卡建议把性能基准测试作为优化前后的对比工具。每次修改硬件配置或软件实现后重新跑一次 Benchmark记录变化。我比较推荐的做法是第一次跑 Benchmark记录基线数据。开启 DMA2D记录第二次数据。调整缓冲区大小记录第三次数据。把代码从 Debug 改成 Release 编译记录第四次数据。最后根据每组数据的平均耗时和最大耗时综合评估。这样得出的优化结论更有说服力也方便在团队内分享技术方案。8.4 需要注意的安全与稳定性边界在真实产品中LVGL 界面的稳定性往往比炫酷更重要。以下几点需要重视不要在定时器中断或高优先级中断中直接调用 LVGL API。LVGL 内部不是线程安全的如果使用 RTOS需要为 LVGL 加锁或者在主线程中统一调用lv_timer_handler。访问外部 SDRAM 时注意 MCU 的时序配置SDRAM 初始化失败会导致随机崩溃。操作显存或缓冲区时务必检查地址边界防止越界写坏其他内存区域。在修改 LTDC、DMA2D 等底层硬件时先在测试板上验证不要直接在量产机器上操作。8.5 工程代码的可维护性移植 LVGL 9.0 不是一次性工作后续还会涉及升级、适配新屏幕、增加新功能。建议把底层硬件操作和 LVGL 逻辑解耦例如把显示驱动、触摸驱动、DMA2D 封装为独立模块LVGL 部分只关心接口回调不关心具体硬件细节。这样做的好处是更换屏幕时只需要修改硬件驱动模块。升级 LVGL 版本时可以复用底层硬件模块。代码在团队内更容易多人协作。9. 总结本文从 STM32F746G-DISCO 开发板出发完成了 LVGL 9.0 的完整移植覆盖了显示驱动、触摸驱动、tick 心跳、主循环初始化等核心步骤并且利用 LVGL 官方 Benchmark Demo 对平台进行了性能基准测试。移植过程中最大的变化是 LVGL 9.0 不再兼容 8.3 的显示设备和输入设备接口需要理解lv_display_t、lv_indev_t以及lv_display_set_buffers这一套新 API。性能基准测试不仅仅是测一个 FPS 数字更重要的是通过平均耗时和最大耗时找到性能瓶颈然后结合 DMA2D、双缓冲、外部 SDRAM、局部刷新等手段做针对性优化。如果你手头正好有 STM32F746G-DISCO建议按照本文流程亲手移植一遍再跑一次 Benchmark记录自己板子上的真实数据。后续如果继续学习可以研究 LVGL 9.0 的样式系统、动画框架和渲染流水线或者结合 FreeRTOS 把 LVGL 放到多任务环境中运行。
