3. 帧缓冲(FrameBuffer)管理：单缓冲、双缓冲、局部刷新机制
帧缓冲管理，说白了就是给屏幕准备一块“画布”。你往画布上画什么，屏幕就显示什么。这块画布怎么分配、怎么刷新，直接决定了你的UI流畅度和内存开销。我在做第一个TouchGFX项目时，就在这上面栽过跟头——画面撕裂、闪屏、内存爆掉，问题一个接一个。今天咱们就把这块彻底讲透。
3.1 帧缓冲的核心概念
帧缓冲是一块连续的内存区域，每个像素点对应一个或多个字节。TouchGFX的渲染引擎把所有UI元素（控件、图片、文字）绘制到这块缓冲区，然后由LTDC（LCD控制器）或DMA2D把数据搬运到屏幕。
关键参数：
- 分辨率：比如800×480
- 像素格式：RGB565（2字节/像素）、ARGB8888（4字节/像素）
- 帧缓冲大小 = 宽度 × 高度 × 每像素字节数
举个例子：800×480分辨率，RGB565格式，一帧需要800×480×2 = 768,000字节，约750KB。如果你用ARGB8888，直接翻倍到1.5MB。嗯，这里要注意——很多MCU内部SRAM根本装不下，必须用外部SDRAM。
3.2 单缓冲机制
单缓冲是最简单的模式。整个系统只有一块帧缓冲，CPU往里面画，LTDC同时从里面读并发送给屏幕。
听起来没问题？其实隐患很大。我在项目中遇到过：当CPU正在更新帧缓冲的某个区域，而LTDC刚好读到那个区域时，屏幕上就会出现“撕裂”——上半部分是旧画面，下半部分是新画面，中间一条明显的分界线。
单缓冲的典型问题：
- 画面撕裂（tearing）
- 无法实现平滑动画
- 刷新率受限于绘制速度
单缓冲适合什么场景？静态界面、菜单切换不频繁、对画面质量要求不高的场合。如果你只是做个温湿度显示，单缓冲完全够用。
3.3 双缓冲机制
双缓冲就是准备两块帧缓冲：一块叫“前台缓冲”（Front Buffer），LTDC正在读取并显示；另一块叫“后台缓冲”（Back Buffer），CPU正在往里面绘制。绘制完成后，交换指针，让LTDC读取新的前台缓冲。
这样做的好处很明显：
- 彻底消除画面撕裂
- 动画流畅度大幅提升
- 绘制时间不再受刷新周期限制
代价呢？内存翻倍。800×480 RGB565需要1.5MB，ARGB8888需要3MB。很多MCU内部SRAM只有512KB或1MB，所以必须用外部SDRAM。
我个人的习惯：只要项目中有动画、滑动、过渡效果，一律上双缓冲。单缓冲省下的那点内存，远不够弥补用户体验的损失。
3.4 局部刷新机制
局部刷新，也叫“脏矩形”刷新。TouchGFX不会每次都重绘整个屏幕，而是只更新发生变化的那一小块区域。
举个例子：你点击了一个按钮，按钮变色了。整个屏幕只有按钮那一小块变了，其他区域没动。TouchGFX会计算出“脏矩形”区域，只把这一块重新绘制到帧缓冲中。
这样做的好处：
- 减少CPU计算量
- 降低内存带宽占用
- 提升整体刷新效率
我曾经在一个1280×720的项目中做过测试：全屏刷新需要约12ms，而局部刷新（一个按钮动画）只需要不到1ms。差距非常明显。
局部刷新的触发条件：
- 控件属性变化（颜色、文本、位置）
- 控件可见性变化
- 动画帧更新
- 触摸事件响应
3.5 在外部SDRAM中分配帧缓冲
好了，现在问题来了：双缓冲需要1.5MB甚至更多，内部SRAM不够用，怎么办？答案就是外部SDRAM。
以STM32F429为例，FMC（Flexible Memory Controller）可以挂载SDRAM，地址范围通常从0xC0000000开始。TouchGFX的帧缓冲就放在这个区域。
配置步骤大致如下：
- 初始化FMC和SDRAM控制器
- 配置SDRAM时序参数（刷新周期、CAS延迟等）
- 在链接脚本中定义SDRAM地址段
- 在TouchGFX配置中指定帧缓冲地址
// TouchGFX HAL配置示例
// 在TouchGFXConfiguration.cpp中
#define FRAME_BUFFER_ADDR 0xC0000000 // SDRAM起始地址
#define FRAME_BUFFER_SIZE (800 * 480 * 2) // RGB565格式
// 分配两个帧缓冲
static uint16_t frameBuffer0[FRAME_BUFFER_SIZE / 2] __attribute__((at(FRAME_BUFFER_ADDR)));
static uint16_t frameBuffer1[FRAME_BUFFER_SIZE / 2] __attribute__((at(FRAME_BUFFER_ADDR + FRAME_BUFFER_SIZE)));
void TouchGFXHAL::initialize()
{
// 设置帧缓冲指针
setFrameBufferStartAddresses(
(uint16_t*)frameBuffer0,
(uint16_t*)frameBuffer1,
(uint16_t*)frameBuffer0 // 写入混合缓冲
);
// 启用双缓冲
setFrameBufferStrategy(FRAME_BUFFER_STRATEGY_DOUBLE_BUFFERING);
}注意：SDRAM的访问速度比内部SRAM慢很多。如果帧缓冲放在SDRAM中，建议开启CPU的Cache（如STM32的D-Cache），并配置MPU将SDRAM区域设置为“非缓存”或“写通”模式，避免Cache一致性问题。
3.6 三种机制的对比
| 特性 | 单缓冲 | 双缓冲 | 局部刷新 |
|---|---|---|---|
| 内存占用 | 1倍 | 2倍 | 1倍（配合单/双缓冲） |
| 画面撕裂 | 有 | 无 | 取决于基础缓冲策略 |
| 动画流畅度 | 低 | 高 | 高 |
| CPU负载 | 低 | 中 | 低（仅重绘变化区域） |
| 适用场景 | 静态界面 | 动态动画 | 所有场景（推荐） |
3.7 帧缓冲管理流程图
下面这张图展示了TouchGFX帧缓冲管理的整体流程，从用户操作到屏幕显示的全链路：
3.8 避坑指南
最后，分享几个我踩过的坑：
我曾经犯过的错误：
- SDRAM时序配置不对：屏幕花屏、闪烁。后来用逻辑分析仪抓了波形，发现刷新周期设得太短。建议严格按照SDRAM数据手册配置。
- 忘记对齐地址：帧缓冲地址必须是32字节对齐的，否则DMA2D传输会出问题。我那次排查了整整两天。
- Cache一致性问题：CPU写SDRAM时写入了Cache，但LTDC直接从SDRAM读，读到的还是旧数据。解决方案是配置MPU将SDRAM区域设为“强序”或“设备”类型。