工程模板创建：从CubeMX到TouchGFX Designer的双工程合并
做嵌入式界面移植，第一步就是搭工程模板。这一步要是没走稳，后面全是坑。我见过太多人卡在编译报错上，折腾半天发现是路径没配好，或者文件重复引用了。
今天咱们就聊聊，怎么从CubeMX生成初始工程，再用TouchGFX Designer生成UI代码，最后把两个工程合并到一起。这里面有几个坑，我当年都踩过。
第一步：CubeMX生成基础工程
先打开CubeMX，选好你的芯片型号。我个人习惯用STM32F429或H743，性能够用，生态也成熟。
配置要点：
- 时钟树：确保LTDC时钟和DMA2D时钟都打开了。我遇到过有人忘了开DMA2D时钟，结果界面卡成PPT。
- FMC/SDRAM：如果要用外部显存，这里必须配好。时序参数别乱填，看数据手册。
- LTDC：配置图层、分辨率、像素格式。RGB565还是RGB888？看你屏支持什么。
- DMA2D：图形加速全靠它，记得使能中断。
生成代码后，先编译一次，确保基础工程没问题。这一步别跳过，我见过有人直接跳到后面，结果基础工程就有语法错误，排查了半天。
第二步：TouchGFX Designer生成UI代码
打开TouchGFX Designer，新建一个项目。屏幕参数要和CubeMX里配的一致，分辨率、像素格式、旋转方向，一个都不能错。
设计好界面后，点击生成代码。这时候你会得到一个独立的TouchGFX工程，里面包含了UI相关的所有文件。
嗯，这里要注意：TouchGFX Designer生成的代码，默认是独立工程的。它有自己的main.cpp，有自己的FreeRTOS配置。你不能直接把它扔进CubeMX工程里用。
第三步：双工程合并——真正的坑来了
合并两个工程，说白了就是把TouchGFX的UI代码，塞进CubeMX生成的硬件工程里。听起来简单，做起来全是细节。
我总结了一个合并流程：
- 复制目录：把TouchGFX工程里的
TouchGFX文件夹，整个复制到CubeMX工程根目录下。 - 保留关键文件：CubeMX的
main.c、stm32xx_it.c、stm32xx_hal_msp.c这些硬件初始化文件，必须保留。TouchGFX的main.cpp不要直接覆盖。 - 合并main函数：在CubeMX的main.c里，调用TouchGFX的初始化函数。具体来说，就是调用
touchgfx_init()和touchgfx_taskEntry()。
第四步：手动添加源文件路径
文件复制完了，但编译器还不知道这些文件在哪。你得手动告诉IDE，这些头文件和源文件在哪个目录。
以STM32CubeIDE为例：
- 右键工程 → Properties → C/C++ Build → Settings
- 在 Include paths 里，添加TouchGFX的头文件路径。通常包括：
TouchGFX/App、TouchGFX/target/generated、TouchGFX/generated/gui_generated/include等。 - 在 Source paths 里，添加TouchGFX的源文件路径。注意，不要重复添加CubeMX已经有的文件。
这里有个容易忽略的点：TouchGFX的 board 目录下，有LCD和触摸屏的驱动文件。这些文件可能和CubeMX生成的驱动冲突。我建议把TouchGFX的驱动文件删掉，用CubeMX生成的。因为CubeMX的驱动更贴近你的硬件配置。
| 文件/目录 | 来源 | 处理方式 |
|---|---|---|
| main.c | CubeMX | 保留，添加TouchGFX初始化调用 |
| main.cpp | TouchGFX | 只保留UI初始化部分，硬件初始化删除 |
| stm32xx_it.c | CubeMX | 保留，添加TouchGFX的中断处理 |
| TouchGFX/target | TouchGFX | 保留，但删除board目录下的LCD驱动 |
| TouchGFX/generated | TouchGFX | 保留，这是UI代码的核心 |
第五步：验证编译
所有路径配好后，先clean再rebuild。第一次编译大概率会报错，别慌。
常见错误：
- 头文件找不到：检查include paths有没有配全。TouchGFX的目录层级比较深，漏一个就报错。
- 函数重复定义：多半是驱动文件冲突了。检查board目录和CubeMX的驱动目录，删掉重复的。
- 链接错误：检查链接脚本。TouchGFX可能需要更大的堆栈空间，调整
Heap_Size和Stack_Size。
核心流程总结
说了这么多，其实核心就三步：生成、复制、配路径。但每一步都有细节，忽略一个就翻车。
下面这张图，是我自己总结的工程模板创建流程，你可以参考一下：
你看，流程不复杂，但每一步都有讲究。尤其是路径配置，我建议你配完后，用文本编辑器打开 .project 和 .cproject 文件，确认路径确实写进去了。有时候IDE界面点了保存，但实际没写进去，这种玄学问题我也遇到过。
好了，工程模板创建就聊到这。记住，基础打牢了，后面移植UI才顺。别急着调界面，先把工程结构理清楚。