简介：面向嵌入式开发者的STM32H750 LTDC驱动工程，支持7英寸1024×600 RGB LCD屏，基于HAL库实现，并附带触摸屏驱动。工程覆盖LTDC控制器初始化、GPIO/时钟/DMA配置、触摸坐标解析等关键模块，源码结构清晰，便于开发者快速理解STM32H7系列图形显示方案。压缩包共201个文件，以104个.h头文件与91个.c源文件为主，另含Keil工程文件、hex固件及启动汇编文件，整体仅1.61MB，轻量紧凑。已有993人学习下载，具备较高实战参考价值。代码中封装了LTDC时序与色彩格式配置、分屏与多层显示切换等核心函数，并给出常见显示异常及触摸校准的调试思路，可作为产品原型或学习模板直接移植，帮助深入掌握STM32H750在RGB LCD驱动中的高级应用。
1. 先别急着抄代码，搞清楚“RGB 并口屏”和“MCU 屏”是两种物种
拿到“STM32H750 驱动 LTDC LCD RGB屏（7寸，1024X600分辨率）”这个工程，多数人第一反应是直接打开 CubeMX 把 LTDC 勾上、生成代码、下载到板子，然后发现屏要么白屏要么花屏。问题往往出在把这块 RGB 并口屏当成常见的 SPI 屏来理解：SPI 屏内部带控制 IC，MCU 发送一串初始化寄存器就能点亮；RGB 屏没有控制器，MCU 要做的是按照面板规定的 HSYNC/VSYNC/DE/DOTCLK 时序，把显存里的数据持续推给屏。LTDC 外设其实就是为这个场景设计的 DMA 引擎加时序发生器。H750 的特殊性又让这件事多了一个坑：片内 Flash 只有 128KB，帧缓冲还得放到外部 SDRAM。这篇文章按照我实际调这类 7 寸 1024×600 屏的路径，把 LTDC 的时序参数、HAL 库初始化顺序、SDRAM 显存分配和刷屏优化一次说清。
2. 理解 STM32H750 的 LTDC 数据通路与 RGB 屏时序参数
2.1 LTDC 在 H7 内部怎么把显存变成 RGB 信号
LTDC 全称是 LCD-TFT Display Controller，它在 H750 内部的工作链路大致是：DMA 从系统总线（AXI）读取帧缓冲地址里的像素数据，进入内部 FIFO，再经过像素格式转换、Alpha 混合、颜色查找表，最后由时序发生器按照你配置的行场参数输出到外部引脚。开发者要关心的其实是三段：数据从哪来、怎么变、什么时候送出去。
第一段决定显存放在哪。H750 片内 RAM 虽然有 1MB 左右可用，但 1024×600 用 RGB888 格式一帧要 1024×600×4 ≈ 2.46MB，RGB565 也要约 1.23MB，片内必然放不下。因此 7 寸屏工程里 SDRAM 不是可选项，而是刚需。LTDC 的 DMA 会持续读取这个地址，所以帧缓冲地址必须落在 SDRAM 的映射区间。
第二段是像素格式转换。HAL 库里对应LTDC_LayerCfgTypeDef的PixelFormat字段，常见的是LTDC_PIXEL_FORMAT_RGB565和LTDC_PIXEL_FORMAT_RGB888。RGB565 省带宽和内存，但颜色精度低；RGB888 颜色准，但同样帧率下总线带宽高出 33%。7 寸屏做产品原型时我一般先上 RGB565，等 UI 色调校正阶段再换 RGB888。
第三段是时序发生器，这也是新手最容易栽跟头的地方。LTDC 不关心你接的屏是什么牌子，它只按你给的 HorizontalSync、AccumulatedHBP、AccumulatedHActive 等寄存器值去拉信号。这些值和屏厂规格书里的 HBP、HFP、HSYNC 直接对应，填错一个字画面就会移位、抖动甚至完全不亮。
2.2 RGB 屏与 MCU 屏的时序差异为什么决定了驱动写法
RGB 屏和 MCU 屏（SPI 屏、8080 并口屏）的本质差别在于有没有控制器。SPI 屏内部有 ILI9341 之类控制 IC，MCU 通过 SPI 写初始化寄存器，之后屏自己完成刷新；RGB 屏就一块纯玻璃加驱动电路，没有寄存器可写，背光一开、时序对、数据稳定就出画面。
这也带来两个直接后果。第一，工程里不会出现“初始化代码”，只有“配置代码”。RGB 屏驱动程序的核心是把 LTDC 和 DMA2D 配好，然后把像素数据丢进帧缓冲。第二，RGB 屏调试更依赖示波器或者逻辑分析仪，因为屏不会给你任何 ACK。你说屏没亮，它到底是没时序还是没数据和背光，只能靠量测。很多从 STM32F103 HAL 库 SPI 屏项目转过来的人，习惯找“驱动”“初始化序列”，这个思路要改过来。
2.3 1024X600 屏的时序参数和 LTDC 时钟计算
7 寸 1024×600 屏，市面上常见面板的时序参数大致如下表，但一定以你手里那块屏的规格书为准：
| 参数 | 典型值 | 含义 |
|---|---|---|
| Horizontal Sync | 1 | 行同步脉冲宽度（像素时钟） |
| HBP | 160 | 行同步后肩 |
| HFP | 160 | 行同步前肩 |
| Vertical Sync | 1 | 帧同步脉冲宽度（行数） |
| VBP | 23 | 帧同步后肩 |
| VFP | 12 | 帧同步前肩 |
| Active Width | 1024 | 有效像素宽度 |
| Active Height | 600 | 有效像素高度 |
| Pixel Clock | 50~55MHz | 像素时钟频率 |
像素时钟的计算公式是：
PCLK = (ActiveWidth + HBP + HSYNC + HFP) × (ActiveHeight + VBP + VSYNC + VFP) × 刷新率用上表参数和 60Hz 刷新率代入：
H_total = 1024 + 160 + 1 + 160 = 1345 V_total = 600 + 23 + 1 + 12 = 636 PCLK = 1345 × 636 × 60 ≈ 51.3MHz所以 LTDC 的像素时钟取 51.2MHz 到 52MHz 之间都合理。这个频率并不是随便定的，它决定了显示是否闪烁、SDRAM 带宽是否够用。帧率高视觉流畅，但 1024×600 RGB565 下 60Hz 的瞬时带宽约 73MB/s，加上刷新时的总线竞争，已经把 H750 的 AXI 总线吃掉不少，超频到 75Hz 以上容易触发 FIFO 欠载。
2.4 HAL 库 LTDC_Init 结构体怎么对应这些参数
CubeMX 图形界面填的是同步周期、后肩、前肩、有效宽度这些直观数字，生成的 HAL 代码里结构体字段却是“累积值”，这是初学者最容易困惑的地方。LTDC 硬件要求的是信号边沿出现的绝对位置，不是宽度。以行方向为例，AccumulatedHBP表示从 HSYNC 开始到后肩结束的总位置，AccumulatedHActive表示到有效数据结束的总位置。用上表的参数，生成出来的核心代码风格如下：
hltdc.Init.HorizontalSync = 1 - 1; // HSYNC 脉冲宽度减 1 hltdc.Init.AccumulatedHBP = 1 + 160 - 1; // HSYNC + HBP 减 1 hltdc.Init.AccumulatedHActive = 1 + 160 + 1024 - 1; // 有效行结束位置 hltdc.Init.AccumulatedHFP = 1 + 160 + 1024 + 160 - 1; // 整行结束位置 hltdc.Init.VerticalSync = 1 - 1; hltdc.Init.AccumulatedVBP = 1 + 23 - 1; hltdc.Init.AccumulatedVActive = 1 + 23 + 600 - 1; hltdc.Init.AccumulatedVFP = 1 + 23 + 600 + 12 - 1; hltdc.Init.TotalWidth = 1 + 160 + 1024 + 160; // 总宽度 hltdc.Init.TotalHeigh = 1 + 23 + 600 + 12; // 总高度 hltdc.Init.BackColor.Blue = 0; hltdc.Init.BackColor.Green = 0; hltdc.Init.BackColor.Red = 0; hltdc.Init.PixelClockDivider = 1; // LTDC 时钟分频这套逻辑里最反直觉的是“减 1”。ST 硬件寄存器里计数从 0 开始，所以宽度为 1 的同步脉冲寄存器里要写 0。如果你直接用规格书参数填HorizontalSync = 1而不减，整个时序右移一个像素时钟，虽然肉眼未必看得出，但帧边缘会有一条竖线或者轻微偏色。PixelClockDivider一般保持 1，它是在 LTDC 内部再次分频，只在像素时钟太高、示波器测出过冲时才需要调大。
提示：不同厂家 7 寸裸屏的 HBP/HFP 差异很大，有的甚至 HBP 给到 210。改屏第一件事不是改代码，而是拿规格书的 Timing Characteristics 表逐项对照。
3. 用 STM32CubeMX 把 HAL 库工程骨架搭起来
3.1 CubeMX 中 LTDC 窗口和像素格式也影响地址计算
在 STM32CubeMX 里使能 LTDC 后，图形界面会让填 Horizontal Sync、HBP、Active Width 这些值。这里强调一点：界面填的是“周期数”，不是减一后的值，减一由 HAL 在生成代码时完成。所以 CubeMX 里直接按上表填 1、160、1024、600、160、12 就行，生成的代码已经是减一后的形式。
LTDC 配置页的 “Layer” 选项卡需要单独设置。7 寸屏单层 UI 用 Layer0 足够，设置时注意 Window X0/Y0 填 0，Window X1/Y1 填 1023/599，这两个值是像素坐标，不是宽高，填 1024/600 会让层窗口越界。像素格式选 RGB565 时，ImageWidth和ImageHeight必须跟层窗口尺寸一致，否则 LTDC 从显存取数的步长会算错，表现出来是图像左右错位。
另一点常被忽略：CubeMX 生成的MX_LTDC_Init()里只初始化了时序和 Layer0，但LTDC_LayerCfgTypeDef里的StartAddress默认是 0，必须手动改成 SDRAM 帧缓冲地址，例如0xC0000000，否则 LTDC 会从随机地址取数，屏上全是噪点。这个地址是由 FMC SDRAM 的 Bank 映射决定的，H750 上 SDRAM Bank1 区域基址为0xC0000000，Bank2 为0xD0000000，绝大多数板子走 Bank1。
3.2 帧缓冲必须落在 SDRAM，FMC 控制器配置是另一半关键
LTDC 本身不关心数据在 DDR 还是 SRAM，它在总线上按地址读。帧缓冲放外置 SDRAM 时，FMC 的刷新率、CAS Latency、突发长度会直接影响 LTDC 读取效率。CubeMX 中 FMC 页的 SDRAM 配置，以常见 W9825G6KH 16bit SDRAM 为例，典型参数如下：
| 参数 | 典型值 | 说明 |
|---|---|---|
| Column bits | 9 | 列地址位宽 |
| Row bits | 13 | 行地址位宽 |
| CAS Latency | 3 | 读潜伏期 |
| Write Recovery Time | 2 | 写恢复时间 |
| Row Cycle Delay | 7 | 行周期延迟 |
| Row Refresh Cycle | 7 | 刷新周期 |
SDRAM 初始化在代码里走HAL_SDRAM_Init，它需要传入FMC_SDRAM_TimingTypeDef。CubeMX 生成后，初始化顺序是 FMC GPIO、SDRAM 控制器、时序参数，最后做一次模式寄存器写入。MX_FMC_Init()里生成的SDRAM_Timing结构体一般够用，但有两个参数值得手动确认：
FMC_SDRAM_TimingTypeDef SDRAM_Timing = {0}; SDRAM_Timing.LoadToActiveDelay = 2; // tRSC，命令到命令延迟 SDRAM_Timing.ExitSelfRefreshDelay = 7; // 退出自刷新时间 SDRAM_Timing.SelfRefreshTime = 4; // 自刷新时间 SDRAM_Timing.RowCycleDelay = 7; // tRC 行周期 SDRAM_Timing.WriteRecoveryTime = 2; // tWR 写恢复 SDRAM_Timing.RP = 2; // 预充电时间 SDRAM_Timing.RCD = 3; // RAS 到 CAS 延迟这些值直接抄 CubeMX 默认通常能跑，但 LTDC 高分辨率刷新时 SDRAM 处于连续读状态，RowCycleDelay如果偏小会出现偶发数据缺失，表现是屏上随机位置闪细线。调试时把这个值从 7 加到 8~10，如果闪线消失，就是 SDRAM 时序余量不足。H750 的 FMC 时钟通常设为 HCLK/2，约 120MHz，LoadToActiveDelay取 2 实际上是很紧的，保守的人会取 3。
3.3 生成代码后手动补的 GPIO、背光和供电部分
CubeMX 不会帮你处理三件事：LTDC 引脚的电气速度、背光引脚的 PWM、屏的供电时序。LTDC 的 RGB 数据线在 H750 上是高速信号，GPIO 输出速度必须配到 Very High，CubeMX 生成的引脚初始化有时是 Medium，这在 51MHz 像素时钟下会导致波形边沿变缓，长时间跑会出现温度升高后花屏。可以在MX_GPIO_Init()生成后追加设置：
GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2; // 按实际引脚 GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; GPIO_InitStruct.Alternate = GPIO_AF14_LTDC; HAL_GPIO_Init(GPIOI, &GPIO_InitStruct);背光一般不直接接 VCC，而是接一个 PWM 引脚，用定时器输出可调亮度。H750 的 TIM1 或 TIM8 通道都可以，频率设到 1kHz 以上，占空比初始化为 0，等 LTDC 层配置完成后再拉高，避免上电瞬间出现半屏白线。供电时序上，背光电源和逻辑电源要共地，先开逻辑电、再开背光，这个顺序在硬件上就要保证，否则屏会有概率性点不亮。
另外 H750 片内 Flash 只有 128KB，很多 7 寸屏工程会把程序放在片外 QSPI Flash 里运行。片外 app 加载的卡死现象经常被误判成 LTDC 驱动问题，其实是在 SDRAM 初始化之前就访问了 SDRAM 里的全局变量。项目如果启用了片外 app 启动方式，main里第一件事必须是把 SDRAM 和 MPU 配置好，再进行 LTDC 的初始化，顺序反了会偶发性 HardFault。
4. HAL 库驱动 LTDC 的初始化序列与 Layer 层配置
4.1 从 MX_LTDC_Init 到你自己的显示驱动结构
CubeMX 生成的MX_LTDC_Init()只负责寄存器层面，它不会主动清屏，也不会把第一帧推上屏。我的做法是再封装一个ltdc_display_init()，把显存地址、背景色、清屏动作都归拢到一处，这样换屏时只需要改一个文件。整体初始化顺序是：
MX_FMC_Init()初始化 SDRAMMX_LTDC_Init()初始化 LTDC 时序和层HAL_SDRAM_Init()确认 SDRAM 控制器 ready（CubeMX 已包含在 FMC 流程里）- 手动调用
HAL_LTDC_ConfigLayer()重新配置层属性 - 用 DMA2D 或循环把帧缓冲清成黑色
- 拉高背光 PWM
顺序不能乱。先拉背光再清屏，开机瞬间会看到随机色块；先配层再补 SDRAM 时序，LTDC 的 DMA 可能在 SDRAM 未就绪时就访问显存，轻则噪点重则总线挂死。HAL 库在HAL_LTDC_Init()内部已经把层配置应用了，所以第 4 步的HAL_LTDC_ConfigLayer()不是必须，但我会再调用一次，因为 CubeMX 生成代码后手动改StartAddress更直观，而且可以在不改 CubeMX 工程的情况下动态切换显存。
4.2 HAL_LTDC_ConfigLayer 参数逐项拆解
层配置是显示驱动里参数最密集的部分，每一个字段都影响最终画面。拆开看这段：
LTDC_LayerCfgTypeDef layer_cfg = {0}; layer_cfg.WindowX0 = 0; layer_cfg.WindowY0 = 0; layer_cfg.WindowX1 = 1023; // 有效窗口右边界，注意是坐标 layer_cfg.WindowY1 = 599; // 有效窗口下边界 layer_cfg.PixelFormat = LTDC_PIXEL_FORMAT_RGB565; layer_cfg.Alpha = 255; // 层整体透明度，255 不透明 layer_cfg.Alpha0 = 0; layer_cfg.BlendingFactor1 = LTDC_BLENDING_FACTOR1_PAxCA; layer_cfg.BlendingFactor2 = LTDC_BLENDING_FACTOR2_PAxCA; layer_cfg.FBStartAddress = 0xC0000000; // SDRAM 帧缓冲地址 layer_cfg.ImageWidth = 1024; layer_cfg.ImageHeight = 600; layer_cfg.Backcolor.Blue = 0; layer_cfg.Backcolor.Green = 0; layer_cfg.Backcolor.Red = 0; HAL_LTDC_ConfigLayer(&hltdc, &layer_cfg, 0); // 最后一个 0 是层编号这里WindowX1/Y1最容易错。它表示像素坐标，取值是宽高减一，1024×600 的屏左上角（0,0），右下角（1023,599）。填 1024 会多出屏幕外的窗口，LTDC 依然会对这部分区域取数，虽然不见得显示出来，但会白占带宽，帧率反而下降。
BlendingFactor1/2在单层显示时不起作用，但如果你后续要叠加图层做 UI，这里必须配成标准 alpha 混合模式。Alpha字段是层整体的全局透明系数，255 表示完全不透明；Alpha0是每个像素 alpha 通道为 0 时用的默认值，它跟 PixelFormat 相关，RGB565 没有 alpha 通道，所以Alpha0填 0 即可，RGB888 也不含 alpha，只有 ARGB8888 格式才需要关心这个字段。
配置完成后要调用重载函数，否则层参数不会生效。HAL 里有两种：
HAL_LTDC_Reload(&hltdc, LTDC_RELOAD_IMMEDIATE); // 立即重载，可能产生撕裂 HAL_LTDC_Reload(&hltdc, LTDC_RELOAD_VERTICAL_BLANKING); // 等垂直消隐再重载HAL_LTDC_Reload(&hltdc, LTDC_RELOAD_VERTICAL_BLANKING);这里有一个容易忽略的坑：立即重载的LTDC_RELOAD_IMMEDIATE在画面刷新途中切换帧缓冲地址，屏幕中间会出现一条横线，就是撕裂。产品代码里我一般都用垂直消隐重载，只有调试时为了看效果才用立即模式。HAL_LTDC_ConfigLayer 内部其实已经触发了一次 shadow reload，但后续搬图后更新地址还需要手动调。
4.3 首次点亮时怎么确认 LTDC 在工作
RGB 屏没有任何握手信号，第一次上电不亮时，先用排除法把链路拆开。第一个要量的是像素时钟 DOTCLK，示波器探头点到屏接口的 PCLK 引脚，正常能看到 51MHz 左右的方波，没有这个时钟说明 LTDC 没启动或者时钟树配置不对，问题在MX_LTDC_Init之前的 PLL2。
第二个量 HSYNC 和 DE。这两根线是判断时序是否生效的关键，DE 应该是占空比很宽的脉冲，高电平宽度约 1024 个像素时钟，低电平出现位置和 HFP/HBP 对应。如果 DE 常高或常低，说明时序参数减一逻辑出错，回到 2.4 节的字段逐项查。
第三个最简单的自检方法是把背景色改成一个亮色。配置里的BackColor在没有任何层数据时也会输出，如果背景是黑色，不好判断信号是否有效：
hltdc.Init.BackColor.Red = 0xFF; hltdc.Init.BackColor.Green = 0x00; hltdc.Init.BackColor.Blue = 0x00; HAL_LTDC_Init(&hltdc);上电后屏若呈现纯红色，说明时序和像素时钟都对，问题只剩层配置和显存地址；如果仍是花屏或者暗屏，先查背光和 DE。这个技巧比直接查代码高效得多，因为它把 LTDC 外设本身和外部的层配置隔离了。
5. 刷图与验证：DMA2D 加速、FIFO 欠载检查、撕裂规避
5.1 用 DMA2D 把图像搬运到帧缓冲，CPU 完全放行
LTDC 只负责读显存，往显存写数据靠的是软件循环或者 DMA2D。1024×600 RGB565 一帧约 1.23MB，用 for 循环搬图会占用大量 CPU 时间，做视觉驱动这类场景还要留算力给处理算法，所以搬图必须交给 DMA2D。
DMA2D 的寄存器模式比 HAL 封装更直观，搬图命令是内存到内存（M2M），源地址指向图像数组，目标地址指向 SDRAM 帧缓冲：
DMA2D_HandleTypeDef hdma2d = {0}; hdma2d.Init.Mode = DMA2D_M2M; hdma2d.Init.ColorMode = DMA2D_OUTPUT_RGB565; hdma2d.Init.OutputOffset = 0; hdma2d.Init.AlphaInverted = DMA2D_REGULAR_ALPHA; HAL_DMA2D_Init(&hdma2d);如果图像不需要缩放旋转，直接用寄存器方式最快：
DMA2D->CR = 0; DMA2D->FGMAR = (uint32_t)image_buffer; // 源图像地址 DMA2D->BGMAR = 0xC0000000; // 目标帧缓冲，BG 模式当目标 DMA2D->OMAR = 0xC0000000; DMA2D->FGOR = 0; DMA2D->BGOR = 0; DMA2D->OOR = 0; DMA2D->FGPFCCR = LTDC_PIXEL_FORMAT_RGB565; // 注意这里是 DMA2D 的格式枚举 DMA2D->BGPFCCR = LTDC_PIXEL_FORMAT_RGB565; DMA2D->OPFCCR = LTDC_PIXEL_FORMAT_RGB565; DMA2D->NLR = (600 << 16) | 1024; // 高 16 位行数，低 16 位列数 DMA2D->CR = DMA2D_CR_START | (0x3 << 16); // M2M 模式 while (DMA2D->CR & DMA2D_CR_START);这段代码关键在NLR寄存器是行列合并的，很多人只写宽高不左移，导致 DMA2D 每次只传输一行。FGPFCCR和BGPFCCR的格式必须与图像源实际格式一致，源是 RGB565 但配成 RGB888，搬上去的颜色会错位。
5.2 用 LTDC 中断检测 FIFO 欠载，反过来调整配置
屏花不花，很大程度上取决于总线带宽。LTDC 内部 FIFO 如果没来得及被总线填满，就会发生 underrun，反应到画面上是一条水平花带或者闪烁。H750 的 LTDC 有一个专门的 FIFO underrun 中断标志，把它开起来，比肉眼看屏可靠得多：
void LTDC_IRQHandler(void) { if (LTDC->ISR & LTDC_ISR_FUIF) { LTDC->ICR = LTDC_ICR_CFUIF; // 清除欠载中断 fault_counter++; } HAL_LTDC_IRQHandler(&hltdc); }fault_counter在调试器里观察，如果持续增长，说明带宽确实不够。常见调整优先级如下：先查 SDRAM 时序是否太保守，再把像素格式从 RGB888 降到 RGB565，这两步能释放约 30% 带宽。如果还没改善，把 LTDC 的 PixelClockDivider 从 1 调到 2，像素时钟降一半，屏会变暗但不会丢数据，适合定位是不是时钟频率过高。
这个中断不需要在最终产品里长期开启，但调屏阶段必须开。我调过的板子里，有快一半的“花屏”问题靠看 FUIF 找到的，而不是靠反复改时序参数。
5.3 重载与背光时序，最后收尾的加载顺序
RGB 屏显示还有一个常被忽略的细节：第一次搬图和背光拉高的顺序。如果背光先亮，LTDC 还没有数据推出来，屏显示的是显存随机值或者全白，视觉上就是开机闪白屏。建议的收尾顺序是先把帧缓冲清成黑色，再用垂直消隐模式配置层，最后才把背光 PWM 占空比缓慢拉高到目标值。这个顺序尤其适合做产品开机画面的场景，至少保证开机瞬间是干净的黑色。如果用了双缓冲做防撕裂，切换帧缓冲地址后记得触发一次HAL_LTDC_Reload，并把下次搬图安排到垂直消隐中断里，这样既能避免撕裂，又不会浪费带宽。
本文还有配套的精品资源，点击获取
