简介：STM32H743裸机环境下移植LVGL 8.2图形库的完整工程资源包，面向需要直接操作HAL库进行嵌入式GUI开发的工程师与电子爱好者，也适用于物联网终端、消费电子产品等对显示交互有要求的项目场景。整套方案不依赖RTOS，运行在裸机环境中，重点演示GPIO引脚初始化、LCD控制线连接、模拟SPI/I2C/并行接口读写函数的编写，以及定时器中断触发刷新、屏幕分辨率与颜色深度设置、LVGL内存管理和显示驱动注册等底层细节。资源内附可直接运行的示例Demo，包含音乐播放器、基础控件演示等界面，并集成字体、图片等素材，方便开发者一边对照代码一边理解移植流程，缩短上手周期。压缩包共1112个文件，核心为343个C源码和278个H头文件，其余包括编译过程产生的o/d文件、PNG/GIF图片素材、TTF字体、Keil工程配置（uvprojx）以及Markdown说明文档等，包体约13.78MB。目前已有1117人学习下载，对于想在STM32H743上快速落地LVGL界面的开发者而言，是一份有参考价值的完整模板。
1. 为什么H743跑LVGL8.2不用上系统也够用
很多人拿到一块STM32H743开发板，第一件事就是想把LVGL8.2点亮到一块RGB屏幕上看效果。这颗芯片的定位很特别：Cortex-M7内核，内部Flash和RAM给得都比较大方，常见型号是2MB Flash加1MB RAM，不做操作系统跑LVGL8.2，资源完全够用，甚至可以省掉外部SDRAM。但问题往往不在资源，而在于“没有操作系统”这件事本身——你要自己管理屏幕的像素时钟、帧缓冲、触摸采样和心跳计时，任何一环断了，画面就是黑屏或者无限闪。
这篇笔记只讲一件事：在无操作系统的裸机工程里，把LVGL8.2移植到STM32H743上，从点亮屏幕到控件点击跟手，完整跑通。读者如果手头有H743核心板、一块RGB接口屏幕，又不想为了显示功能去引入整套RTOS，那么这里给出的是一个可以直接照着做的方案，以及一堆我踩过才知道的参数边界。
2. 先把屏幕点亮：LTDC与帧缓冲的最小组合
2.1 为什么先不谈LVGL：先确认LTDC能出图
LVGL8.2本身不负责把像素送到屏幕，它只是维护一套控件树、绘制缓存和事件分发。真正让RGB屏幕显示内容的，是STM32H743内部的LTDC控制器。LTDC的工作方式很直接：CPU或者DMA2D把像素写到内存的某个连续区域，LTDC按设定的像素时钟、行场同步参数和窗口位置，不停地从这块内存读出像素并发送到屏幕。换句话说，帧缓冲是LTDC的唯一“食材”，LVGL8.2绘制的每一步，最终都要落到这块内存里。
所以我把裸机移植拆成两步：先让LTDC显示一块纯色，确认时序和帧缓冲地址没问题，再让LVGL往同一块缓冲里画控件。如果跳过第一步直接用LVGL的flush回调，出了问题你会分不清是时序配错、颜色格式不对，还是帧缓冲地址越界。
下面是我在裸机工程里常用的一套LTDC最小初始化，以480x272分辨率、RGB565为例。注意这些参数必须在你的板子上按屏幕手册替换，不能照抄。
void ltdc_init(uint32_t fb_addr, uint16_t hactive, uint16_t vactive) { // 打开LTDC外设时钟 RCC->AHB1ENR |= RCC_AHB1ENR_LTDCEN; // 用PLL2的Q输出做像素时钟，频率按屏幕手册计算，例如9MHz左右 RCC->CR |= RCC_CR_PLL2ON; while (!(RCC->CR & RCC_CR_PLL2RDY)); // 同步时序：HSYNC宽度、VSYNC宽度、后沿、前沿 LTDC->SSCR = LCD_HSYNC | (LCD_VSYNC << 16); LTDC->BPCR = LCD_VBP | (LCD_HBP << 16); LTDC->AWCR = (vactive + LCD_VFP + LCD_VBP + LCD_VSYNC - 1) | ((hactive + LCD_HFP + LCD_HBP + LCD_HSYNC - 1) << 16); LTDC->TWCR = (vactive + LCD_VFP + LCD_VBP + LCD_VSYNC - 1) | ((hactive + LCD_HFP + LCD_HBP + LCD_HSYNC - 1) << 16); // 背景色设为黑色 LTDC->BCCR = 0x00000000; // 层1铺满全屏，像素格式RGB565 LTDC_Layer1->WHPCR = (LCD_HBP + LCD_HSYNC) | (((LCD_HBP + LCD_HSYNC + hactive - 1)) << 16); LTDC_Layer1->WVPCR = (LCD_VBP + LCD_VSYNC) | (((LCD_VBP + LCD_VSYNC + vactive - 1)) << 16); LTDC_Layer1->PFCR = LTDC_PFCR_PF_ARGB565; LTDC_Layer1->CFBAR = fb_addr; LTDC_Layer1->CFBLR = (hactive * 2) | (((hactive * 2) + 3) << 16); LTDC_Layer1->CFBLNR = vactive; LTDC_Layer1->CR = 1; // 立即重载并打开LTDC LTDC->SRCR = LTDC_SRCR_IMR; LTDC->GCR |= LTDC_GCR_LTDCEN | LTDC_GCR_DEN; }这段代码的关键点有三个：像素时钟来源、时序参数、层配置。像素时钟由PLL2的Q输出提供，具体频率要按屏幕的手册计算，常见的小尺寸RGB屏在5MHz到15MHz之间。SSCR、BPCR、AWCR里的HSYNC、HBP、VBP这些值，每家屏厂给的参数不同，配错最典型的结果是画面偏移、滚动或者完全黑屏，但这个容易被忽略，因为代码本身不报错。
层配置里必须注意CFBAR和CFBLR的配合。CFBAR指向帧缓冲首地址，CFBLR的低16位写每行字节数，高16位写行距。RGB565每像素2字节，行距一般比每行字节数多3，用来做64字节对齐。窗口起点要放在非显示区之外，否则画面会往左上角偏。写完这几行，如果屏幕上出现了纯色背景或者花屏，都算好事——至少LTDC在动了。
2.2 帧缓冲放内部RAM还是外部SDRAM
STM32H743内部有大概1MB的RAM，分布在不同区域，这对显示系统来说是个好消息。内部RAM的带宽比外部SDRAM高，延迟低，裸机访问简单，不用配置FMC控制器。很多中小尺寸屏幕完全可以在内部RAM里跑。帧缓冲大小的计算公式是：宽乘高乘每像素字节数。RGB565每像素2字节，RGB888每像素4字节。
我做过的几个尺寸对比如下：
| 屏幕分辨率 | RGB565大小 | RGB888大小 | 内部RAM结果 |
|---|---|---|---|
| 480x272 | 约261KB | 约522KB | RGB565和RGB888都能放 |
| 800x480 | 约768KB | 约1.5MB | RGB565勉强放，RGB888放不下 |
| 1024x600 | 约1.2MB | 约2.4MB | 都必须上SDRAM |
所以选型逻辑很直接：如果需要800x480以上的分辨率，或者必须用RGB888显示更丰富的色彩，老老实实接一片SDRAM，用FMC外设驱动；如果只是做480x272、RGB565的界面，内部RAM完全够用，还能省掉SDRAM的初始化、刷新和布线成本。
内部RAM还有一个隐藏好处：不需要配置MPU的Cache策略来保证DMA2D和CPU看到的数据一致。SDRAM方案中，如果开了D-Cache，必须先配置MPU的Region为Write-Through或Non-Cacheable，否则会出现画面更新错乱、文字残影这类难以排查的毛病。这块我在第4章的避坑部分会再细说。
3. 让LVGL8.2裸机跑起来：flush与心跳的三处接线
3.1 lv_conf.h里和裸机强相关的开关
LVGL8.2移植到裸机平台，本质上是把显示输出、时钟源、输入设备三个接口接到STM32H743的硬件上。这三个接口在工程里分别对应显示驱动、tick源、触摸驱动。很多第一次移植的人会直接去改lv_port_disp.c，但真正的坑往往在lv_conf.h里，这个文件控制着LVGL的编译行为，配置错了后面全错。
裸机环境下最重要的几个宏是这样设的。LV_COLOR_DEPTH要定义成和屏幕一致，屏幕是RGB565就设16，是RGB888就设32。LV_COLOR_16_SWAP这个宏要特别注意，当你的RGB面板字节顺序和LVGL内部不一致时，画面会出现明显的颜色错乱，红色变蓝色，此时打开这个宏通常能解决。还有LV_TICK_CUSTOM，裸机下我建议直接设为0，自己提供tick源，可控性更好。LV_MEM_SIZE是LVGL自己的内存池大小，裸机工程如果不用动态分配控件，建议给到64KB以上，否则复杂界面下内存碎片会让你时不时白屏。
// lv_conf.h 中与裸机移植强相关的配置 #define LV_COLOR_DEPTH 16 #define LV_COLOR_16_SWAP 0 #define LV_MEM_SIZE (64U * 1024U) #define LV_TICK_CUSTOM 0 #define LV_USE_LOG 1 #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN这里把LV_TICK_CUSTOM设为0的意思是：不让LVGL自己偷偷找时钟源，而是由外部代码周期性调用lv_tick_inc来提供时间基准。这个方法在裸机下最直观，不清楚底部时钟时也不会出现界面卡死。日志功能先打开，把日志等级设成WARN，出问题时不至于完全黑盒子，量产后再把日志关掉节约Flash。
3.2 显示驱动的flush回调写法
LVGL8.2的显示驱动核心是一个回调函数：disp_flush。LVGL内部每画完一块区域，就把这块区域的像素数据和坐标交给这个回调，回调的职责是把它放进LTDC的帧缓冲。如果你跑的是单缓冲模式，这里要特别小心，不能在flush还没完成时让LVGL继续画同一块区域。
最简单的flush实现就是memcpy，把LVGL给出的颜色数组直接拷贝到帧缓冲对应位置。
static void disp_flush(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_p) { uint32_t w = lv_area_get_width(area); uint32_t h = lv_area_get_height(area); uint32_t fb = (uint32_t)display_buf; // LTDC帧缓冲首地址 uint32_t dst = fb + (area->y1 * 480 + area->x1) * 2; // RGB565每像素2字节 // 最简单可靠的方案：CPU直接拷贝 memcpy((void *)dst, color_p, w * h * sizeof(lv_color_t)); // 告诉LVGL这帧数据已经处理完 lv_disp_flush_ready(drv); }这段代码大家都能看懂，但实际跑起来会有问题：一是memcpy会阻塞CPU，大区域更新时帧率会明显下降；二是如果LTDC正在读取这块区域，拷贝过程中会出现画面上下撕裂。想要速度快，推荐用DMA2D来搬数据，并对齐到64字节地址。DMA2D是STM32内部的2D DMA控制器，可以直接做拷贝、填充、甚至像素格式转换。
static void disp_flush_dma2d(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_p) { uint32_t w = lv_area_get_width(area); uint32_t h = lv_area_get_height(area); uint32_t dst = (uint32_t)display_buf + (area->y1 * 480 + area->x1) * 2; uint32_t src = (uint32_t)color_p; // DMA2D寄存器配置：内存到内存，RGB565拷贝 DMA2D->CR = 0; DMA2D->FGMAR = src; // 前景内存地址，即LVGL绘图缓冲区 DMA2D->FGOR = 0; DMA2D->BGMAR = dst; // 目标地址 DMA2D->BGOR = 0; DMA2D->FGPFCCR = DMA2D_FGPFCCR_PF_ARGB565; // 源像素格式 DMA2D->BGPFCCR = DMA2D_BGPFCCR_PF_ARGB565; // 目标像素格式 DMA2D->NLR = (h << 16) | w; // 行数和列数 DMA2D->OMAR = dst; DMA2D->OPFCCR = DMA2D_OPFCCR_PF_ARGB565; }DMA2D之所以比memcpy强，是因为它可以把“读源地址、写目标地址”交给硬件流水线，CPU在等待传输时可以去做别的事。但这里有一个前提：传输必须完成后才能调用lv_disp_flush_ready。很多翻车现场就是在DMA2D还没传完时就调用了ready，LVGL立刻重写源缓冲，目标画面出现半截更新或者颜色错位。
最稳妥的做法是：开启DMA2D传输，然后死等传输完成标志位，或者用中断标志来做同步。裸机下没有操作系统信号量，最简单是在flush函数末尾轮询等待，这样代码简单、行为确定。代价是主循环在拷贝期间会卡住，但这个代价在小尺寸屏幕上完全可接受。
3.3 心跳从哪里来：tick源接线
LVGL8.2的动画、触摸长按、控件闪烁都依赖内部的时间基准。在裸机下必须有人周期性调用lv_tick_inc传入毫秒数，LVGL才能推进时间。最标准的做法是用SysTick，它本身就是一个精确的毫秒定时器，而且不会影响LTDC和DMA2D。
// stm32h7xx_it.c 里累加SysTick中断 volatile uint32_t systick_count = 0; void SysTick_Handler(void) { systick_count++; } // 主循环里这样喂给LVGL uint32_t last_ticks = 0; while (1) { uint32_t now = systick_count; lv_tick_inc(now - last_ticks); last_ticks = now; lv_task_handler(); }sysTick的中断频率通常配置为1ms一次，也就是1000Hz。这组代码里最重要的细节是：lv_tick_inc传入的是两次调用的时间差，而不是绝对时间。如果你用HAL库自带的HAL_GetTick，效果也一样，但别在SysTick_Handler里直接调用lv_tick_inc，除非你确定每次中断间隔就是1ms。喂tick的代码没有放在中断里，而是放在主循环里读取计数差，这样可以避免中断里做耗时的函数调用。
3.4 触摸输入：坐标归一化是最容易忽略的一步
LVGL的输入设备驱动核心是一个回调，每次被调用时要返回当前触摸状态、坐标值和按下状态。裸机下常见的做法是在主循环里轮询触摸芯片的I2C或SPI，把原始坐标转换成屏幕坐标，再报告给LVGL。
static void touchpad_read(lv_indev_drv_t *drv, lv_indev_data_t *data) { int16_t x_raw, y_raw; uint8_t pressed; touch_panel_read(&x_raw, &y_raw, &pressed); // 从触摸控制器读原始ADC值 // 关键：原始坐标映射到屏幕分辨率 >static lv_color_t buf1[480 * 272 / 4]; static lv_color_t buf2[480 * 272 / 4]; lv_disp_drv_init(&disp_drv); disp_drv.buffer_count = 2; disp_drv.bufs[0] = buf1; disp_drv.bufs[1] = buf2;缓冲区大小我习惯取屏幕像素数的四分之一，也就是每次绘制屏幕四分之一的区域。这个数字不是固定的，越小LVGL会切分成更多小块绘制，越大则一次能处理的绘制任务越多、效率越高，但内存成本也更高。双缓冲模式下，DMA2D的flush回调里最好等待传输完成，但不能像单缓冲那样整个阻塞，否则重叠效果就没了。
另外要留意DMA2D的传输方向。LVGL绘制缓冲区到LTDC帧缓冲，本质是内存到内存的拷贝，不需要启用DMA2D的图层混合功能。有些刚接触的人会把前景色和背景色都配上，导致传输结果多了一次Alpha混合，颜色变淡。正确做法是只配FGMAR和OMAR，不使能混合。
在裸机移植后的性能验证上，我有一个比较土但很有效的办法：在LVGL里创建几个大弧形控件做旋转动画，然后用示波器或者逻辑分析仪抓DMA2D的TCIF中断频率，统计每秒完成了多少次完整帧传输。也可以用LVGL自带的内存监控接口分配一块区域打印内存使用率，来判断复杂界面的内存余量。
这轮移植里我最想跟你强调的一点是：LVGL在STM32H743上的瓶颈很少在CPU算力上，而往往在数据搬运和Cache策略上。我最初也犯了先优化LVGL配置、后检查DMA2D传输的错误，结果折腾了几天才发现是DMA2D没做传输完成同步，属于典型的“改了一堆参数、不如修一个标志位”的翻车经历。希望这篇笔记能帮你少走这段弯路，也让你的屏幕更早亮起来、动起来。
本文还有配套的精品资源，点击获取
