显示接口基础：LTDC控制器原理、RGB接口、DPI接口、LTDC初始化流程

各位好，我是老赵。今天咱们聊聊显示接口的基础——LTDC控制器。说实话，很多做TouchGFX的朋友一开始都卡在这一块。为什么？因为显示接口的配置一旦出错，整个屏幕就是黑的，连个调试信息都看不到。

我刚开始做嵌入式UI那会儿，就吃过这个亏。板子焊好了，代码写完了，上电一看——黑屏。查了三天，最后发现是LTDC的时序参数配错了。嗯，从那以后，我对LTDC的初始化流程就格外上心。

这一章，咱们就把LTDC的原理、RGB接口、DPI接口，还有初始化流程，掰开了揉碎了讲清楚。

LTDC控制器是什么？

LTDC，全称是Liquid Crystal Display Controller。说白了，就是一个专门负责把显存里的图像数据，按照固定的时序，推送到LCD面板上的硬件模块。

你想想看，CPU要处理那么多任务，如果每刷一帧画面都要CPU亲自去操作像素点，那系统就别干别的了。LTDC的作用就是——把CPU解放出来。

它的工作流程大致是这样的：

• 从指定的显存地址读取像素数据
• 按照RGB格式解析这些数据
• 生成LCD面板需要的同步信号（VSYNC、HSYNC、DE等）
• 通过RGB或DPI接口把数据发送出去

整个过程是DMA（直接内存访问）方式，不占用CPU。这也是TouchGFX能跑出60帧流畅动画的基础。

RGB接口 vs DPI接口

这两个概念，我见过很多人搞混。其实很简单：

特性	RGB接口	DPI接口
全称	RGB Parallel Interface	Display Pixel Interface
信号线	RGB数据线 + 同步信号	与RGB接口相同，但包含更多控制信号
典型应用	小尺寸TFT屏（3.5寸以下）	大尺寸LCD屏（7寸以上）
是否需要显存	通常需要外部显存	需要外部显存
驱动方式	直接驱动	通过DPI协议驱动

我个人习惯把DPI接口看作是RGB接口的"升级版"。DPI接口在RGB接口的基础上，增加了更多的标准化协议支持，比如I2C配置通道、触摸屏数据通道等。但本质上，它们传输像素数据的方式是一样的——都是并行RGB数据。

LTDC的初始化流程

这部分是重点。我把它拆成几个步骤，每一步都有坑。

第一步：时钟配置

LTDC需要两个时钟：

• 像素时钟（PCLK）：决定刷新率。比如1024x600@60Hz，PCLK大约需要51.2MHz。
• LTDC时钟：用于内部逻辑，通常比PCLK高。

计算公式：

PCLK = (H_Total) × (V_Total) × Refresh_Rate

其中H_Total = H_Active + H_Front_Porch + H_Sync_Width + H_Back_Porch，V_Total同理。

第二步：GPIO复用配置

LTDC的引脚通常和普通GPIO复用。你需要把对应的引脚配置为LTDC功能。

以STM32H7为例：

// 配置LTDC引脚复用
GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2; // R0-R2
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOI, &GPIO_InitStruct);

这里要注意：不同型号的MCU，复用功能号不一样。H7系列是AF14，F4系列可能是AF9。一定要查数据手册。

第三步：LTDC层配置

LTDC支持2层（Layer0和Layer1）。每一层都可以独立配置：

• 窗口位置和大小
• 像素格式（RGB565、RGB888、ARGB8888等）
• 帧缓冲区地址
• Alpha混合值
• 颜色查找表（CLUT）

TouchGFX通常只用一层，但如果你要做画中画或硬件光标，可以用两层。

// 配置Layer0
hltdc_LayerCfg.WindowX0 = 0;
hltdc_LayerCfg.WindowY0 = 0;
hltdc_LayerCfg.WindowX1 = 1024;
hltdc_LayerCfg.WindowY1 = 600;
hltdc_LayerCfg.PixelFormat = LTDC_PIXEL_FORMAT_RGB565;
hltdc_LayerCfg.FBStartAdress = (uint32_t)frameBuffer;
hltdc_LayerCfg.Alpha = 255;
hltdc_LayerCfg.Alpha0 = 0;
hltdc_LayerCfg.BlendingFactor1 = LTDC_BLENDING_FACTOR1_PAxCA;
hltdc_LayerCfg.BlendingFactor2 = LTDC_BLENDING_FACTOR2_PAxCA;
HAL_LTDC_ConfigLayer(&hltdc, &hltdc_LayerCfg, 0);

第四步：时序参数配置

这是最容易出错的地方。每个LCD面板都有自己的时序要求，必须严格按照数据手册来配。

关键参数：

参数	说明	常见值（1024x600）
H_Sync	行同步脉冲宽度	10-30个PCLK
H_Back_Porch	行同步后肩	20-80个PCLK
H_Front_Porch	行同步前肩	10-40个PCLK
V_Sync	帧同步脉冲宽度	1-5行
V_Back_Porch	帧同步后肩	5-20行
V_Front_Porch	帧同步前肩	5-10行

// 时序配置示例
hltdc.Init.HorizontalSync = 30;
hltdc.Init.VerticalSync = 10;
hltdc.Init.AccumulatedHBP = 30 + 46;  // H_Sync + H_Back_Porch
hltdc.Init.AccumulatedVBP = 10 + 23;  // V_Sync + V_Back_Porch
hltdc.Init.AccumulatedActiveW = 1024 + 30 + 46;
hltdc.Init.AccumulatedActiveH = 600 + 10 + 23;
hltdc.Init.TotalWidth = 1024 + 30 + 46 + 10;  // H_Total
hltdc.Init.TotalHeigh = 600 + 10 + 23 + 10;   // V_Total

第五步：中断和DMA配置

LTDC可以产生多种中断：

• Line中断：到达指定行时触发，用于撕裂效应（Tearing Effect）控制
• FIFO中断：FIFO溢出或下溢时触发
• 传输完成中断：一帧传输完成时触发

TouchGFX通常使用Line中断来实现双缓冲切换。具体做法是：在V_Back_Porch结束后的第一行触发中断，此时屏幕正在刷新，但还没到有效显示区域，可以安全地切换帧缓冲区指针。

// 配置Line中断，在VBP结束后触发
HAL_LTDC_ProgramLineEvent(&hltdc, hltdc.Init.AccumulatedVBP);
__HAL_LTDC_ENABLE_IT(&hltdc, LTDC_IT_LI);

SVG：LTDC初始化流程图

下面这张图是我自己画的，把整个初始化流程串起来了。你保存下来，以后配LTDC的时候对着看，能少走很多弯路。

初始化完成后，怎么验证？

配完了别急着跑TouchGFX。先做一件事——刷纯色。

我习惯在初始化完成后，直接往帧缓冲区写一个纯红色（0xF800），然后看屏幕是不是全红。如果是，说明LTDC基本工作正常。然后再试绿色、蓝色、白色、黑色。

// 验证：刷纯红色（RGB565格式）
uint16_t *fb = (uint16_t *)frameBuffer;
for (int i = 0; i < 1024 * 600; i++) {
    fb[i] = 0xF800;  // 红色
}

如果颜色不对，可能是像素格式配错了。如果屏幕有噪点，可能是时钟有问题。如果画面偏移，那就是时序参数的问题。