📚 课程目录第1章课程导入

1. 课程导入

在嵌入式图形界面开发中，把界面“画出来”只是第一步，真正决定产品能否交付的，是量产部署与现场调试。TouchGFX 作为 STM32 生态中广泛使用的 GUI 框架，提供了从 Designer 可视化设计、代码生成、渲染引擎到硬件加速的完整链路。本课程围绕“从可运行 Demo 到可量产固件”的工程化过程展开，帮助你把界面工程、资源管理、性能优化、烧录产线与故障排查串成一条可落地的技术路径。

本课程的核心目标不是教会你拖拽控件，而是让你具备三项能力：第一，能独立完成 TouchGFX 工程的量产化配置与构建；第二，能定位并解决渲染、内存、刷新率、触摸响应等典型问题；第三，能建立可复用的调试方法与产线部署流程。

一、学习目标：从“能显示”到“可量产”

TouchGFX 的量产部署与调试，本质上是在资源受限的 MCU 上，平衡视觉体验、内存占用、CPU 负载、刷新帧率与生产成本。学习目标可以拆解为四个层次：

工程构建层：掌握 TouchGFX Designer 与 STM32CubeMX、CubeIDE、Makefile 工程的协同关系，理解生成代码与用户代码的边界。
资源与内存层：理解位图、字体、动画、外部 Flash、SDRAM 的存储与加载策略，能根据屏幕分辨率和色深估算显存与帧缓存需求。
性能与渲染层：掌握部分帧缓冲、双缓冲、DMA2D、LTDC、GPU 加速的启用条件与性能差异，能通过帧率、CPU 占用和撕裂现象判断瓶颈。
量产与调试层：熟悉烧录、校准、老化测试、日志输出、断言处理、看门狗与现场升级方案，能建立从实验室到产线的完整闭环。

二、核心概念：先建立一张“系统地图”

TouchGFX 应用并不是单一程序，而是由多个层次协作构成的图形系统。最上层是 Model-View-Presenter 架构，负责业务逻辑与界面交互；中间是 TouchGFX Engine，负责事件分发、动画调度与绘制指令生成；底层是 HAL 与硬件加速单元，包括 LTDC、DMA2D、CRC、GPU 以及外部存储器控制器。量产部署时，任何一层配置不当，都会表现为黑屏、花屏、卡顿、触摸漂移或随机死机。

因此，本课程会反复强调三个核心概念：帧缓冲策略、资源生命周期和可观测性。帧缓冲决定画面如何被扫描输出；资源生命周期决定图片和字体何时加载、何时释放；可观测性决定你能否在量产现场快速定位问题，而不是靠“重启试试”。

三、整体框架：五层协作与两条主线

上图给出了本课程的整体框架。纵向看，TouchGFX 应用分为应用层、引擎层、HAL 与硬件加速层；横向看，量产部署与调试可观测性贯穿始终。理解这张图的关键，是抓住两条主线：

数据主线：资源从外部 Flash 或内部 Flash 读出，经解码或直接搬运到帧缓冲，再由 LTDC 扫描输出到屏幕。任何一环带宽不足，都会导致刷新率下降或画面撕裂。
控制主线：触摸事件由 Presenter 处理，触发 View 更新，Engine 计算无效区域并生成绘制任务，最终由 DMA2D 或 CPU 完成像素填充。

在量产阶段，这两条主线还必须叠加产线约束：烧录时间、镜像大小、校准数据写入、老化测试时长、不良品判定阈值。很多实验室里运行良好的工程，到了产线会因为 Flash 擦写速度、SDRAM 初始化时序或触摸屏批次差异而暴露问题。

四、方法流程：一个可复用的量产化推进顺序

建议按照以下顺序推进，避免“先优化后功能”造成的返工：

阶段	关键任务	典型输出	常见风险
1. 工程基线	CubeMX 配置 LTDC、DMA2D、FMC、时钟树	可编译、可烧录的最小工程	时钟或 SDRAM 时序错误导致花屏
2. 资源规划	确定色深、分辨率、字体与图片存放位置	内存映射表与分区表	帧缓冲溢出、外部 Flash 带宽不足
3. 渲染调优	启用部分帧缓冲、DMA2D、双缓冲	帧率与 CPU 占用报告	撕裂、闪烁、动画掉帧
4. 量产部署	烧录脚本、校准、老化、版本追溯	产线工装与作业指导书	校准漂移、镜像版本混乱
5. 现场调试	日志、断言、看门狗、故障复现	问题定位报告与修复版本	随机死机难以复现

五、案例场景：从“演示正常”到“产线异常”

某工业 HMI 项目在实验室使用 800×480 RGB565 屏幕运行流畅，但产线抽检时出现约 3% 的设备开机后触摸无响应。排查发现，触摸控制器复位时序依赖上电斜率，而产线电源模块批次不同导致复位释放时间偏移。最终在 MX_TouchGFX_Init() 之前增加了固定延时和复位重试逻辑，问题收敛。这个案例说明：量产调试的对象不只是代码，还包括电源、时序、器件批次和工装环境。

/* 触摸控制器复位与重试示例 */
HAL_GPIO_WritePin(TP_RST_GPIO_Port, TP_RST_Pin, GPIO_PIN_RESET);
HAL_Delay(20);
HAL_GPIO_WritePin(TP_RST_GPIO_Port, TP_RST_Pin, GPIO_PIN_SET);
HAL_Delay(120);

for (int retry = 0; retry < 3; retry++) {
    if (TP_Init() == TP_OK) {
        break;
    }
    HAL_Delay(50);
}

六、误区与复盘：新手最容易踩的五个坑

只关注 UI 效果，不关注帧缓冲：分辨率提高后，单帧缓冲可能超过内部 SRAM，必须提前规划 SDRAM 或外部 Flash。
把 Designer 生成代码当作用户代码修改：重新生成后修改会被覆盖，用户逻辑应放在 User 目录或自定义类中。
忽略外部存储带宽：QSPI Flash 随机读取性能有限，大图频繁切换会导致明显卡顿。
没有版本追溯：产线混烧不同版本固件，现场问题无法复现，必须记录 Git 提交号与构建时间。
调试手段单一：只靠串口打印，遇到 HardFault 或死锁时信息不足，应结合断言、看门狗和内存水位统计。

建议在学习本课程时，准备一块带 SDRAM 和 RGB 屏幕的 STM32 开发板，并同步建立三个记录：内存映射表、帧率测试记录、产线问题清单。每学完一个模块，就把对应参数填进去，最终形成自己的量产检查表。

本课程后续将沿着“工程构建—资源与内存—渲染性能—量产部署—现场调试”的路径逐步展开。你需要始终带着一个判断标准：这个配置在实验室能跑，在产线和现场是否仍然稳定？只有把这个问题回答清楚，TouchGFX 才算真正从演示走向量产。