1. 课程导入
各位做嵌入式UI的同行，大家好。我是老张，在嵌入式图形领域摸爬滚打了十多年。今天咱们开始《TouchGFX驱动适配实战》的第一章，先聊聊TouchGFX这个框架到底长什么样。
说实话，我第一次接触TouchGFX是在一个工业手持设备项目上。当时客户要求界面流畅得像手机一样，MCU资源又有限。我试过几个轻量级GUI，最后发现TouchGFX在STM32平台上的表现确实有两把刷子。嗯，咱们今天就把它拆开看看。
1.1 TouchGFX的整体架构
TouchGFX的架构，说白了就是三层结构：应用层、框架核心层和硬件抽象层。我习惯把它想象成一个汉堡——上面是UI逻辑，中间是酱料（核心算法），下面是面包底（驱动）。
核心观点：驱动层是TouchGFX和硬件之间的唯一桥梁。没有它，再漂亮的界面也出不来。
咱们用一张图来直观感受一下：
你看，最底下的红色层就是咱们驱动适配的主战场。我当年刚接触这个框架时，总觉得应用层写起来爽，驱动层又烦又绕。后来踩了几个坑才明白——驱动层稳了，整个项目就稳了八成。
1.2 渲染管线：像素是怎么跑到屏幕上的？
TouchGFX的渲染管线，说白了就是一条流水线。从你手指点击屏幕，到画面刷新出来，中间经过了好几个环节。我把它总结成五个步骤：
- 事件触发——触摸、定时器、回调等
- UI逻辑处理——Presenter/View更新状态
- 绘制指令生成——框架计算出哪些区域需要重绘
- 像素渲染——CPU或DMA2D把像素数据写入帧缓冲
- 屏幕刷新——帧缓冲内容通过LTDC/SPI/并行接口送到LCD
个人经验：我在一个项目里发现界面卡顿，查了半天，原来是第4步和第5步之间没做好双缓冲同步。你想想看，一边写一边读，画面不撕裂才怪。
咱们再用一张流程图把渲染管线串起来：
看到左侧的黄色说明框了吗？驱动适配主要卡在最后两个环节——像素渲染和屏幕刷新。我曾经在一个项目里，因为LTDC的时序参数配错了，屏幕一直闪。查了两天才发现是HBP和HFP算反了。嗯，这种坑踩一次就记住了。
1.3 驱动层在整个框架中的位置
驱动层在TouchGFX里叫HAL（硬件抽象层）。它不是一个文件，而是一组接口。我列个表，大家看得更清楚：
| 驱动模块 | 接口/文件 | 职责 | 适配难度 |
|---|---|---|---|
| LCD驱动 | HAL::LCD() / touchgfx::LCD | 像素写入、帧缓冲管理、颜色格式转换 | ⭐⭐⭐ |
| 触摸驱动 | HAL::touch() / touchgfx::TouchController | 触摸坐标采集、上报 | ⭐⭐ |
| DMA2D驱动 | HAL::DMA() / touchgfx::DMA_Interface | 硬件加速拷贝、填充、混合 | ⭐⭐⭐⭐ |
| 帧缓冲管理 | HAL::getFrameBuffer() / setFrameBuffer() | 多缓冲切换、地址配置 | ⭐⭐⭐ |
| 时钟与定时器 | HAL::getTick() / touchgfx::OSWrappers | 帧同步、定时器回调 | ⭐⭐ |
避坑指南：我曾经在一个项目里，DMA2D驱动没配好，结果界面刷新时出现残影。后来发现是DMA2D的FIFO阈值设得太低，导致传输中断。记住：DMA2D的配置一定要参考芯片参考手册，别想当然。
1.4 驱动适配到底要做什么？
说白了，驱动适配就是让TouchGFX的HAL层能正确调用你的硬件。具体来说，你需要做这几件事：
- 实现LCD接口——告诉框架怎么往屏幕上写像素
- 实现触摸接口——告诉框架触摸点在哪儿
- 配置帧缓冲——分配内存、设置地址、管理双缓冲
- 配置DMA2D——如果MCU支持，开启硬件加速
- 配置时钟与中断——保证帧同步和定时器正常工作
我个人的习惯是，拿到一个新板子，先写一个最简单的LCD驱动——只实现画点函数。能点亮屏幕了，再一步步加功能。你想想看，如果连一个像素都点不亮，后面那些花里胡哨的优化都是白搭。
核心原则：驱动适配不是一蹴而就的。先跑通，再优化。先稳定，再加速。
1.5 本章小结
咱们这一章把TouchGFX的架构、渲染管线和驱动层定位都捋了一遍。记住三个要点：
- TouchGFX是三层架构，驱动层在最底层
- 渲染管线有五个环节，驱动适配集中在后两个
- 驱动适配的核心是实现HAL接口，让框架能操控硬件