简介：本文面向熟悉STM32但是从未使用过TouchGFX的新手。
通过阅读本教程，你将可以快速上手创建你的第一个TouchGFX项目，并将其移植到你自己的硬件平台上。
说是全网独一份，不过分八[看]
全文导航：（10章）前言、准备工作、软件安装、创建基础项目、为项目添加TouchGFX软件包、设计界面、运行代码、添加触摸支持、移植官方的Demo、结语。
一、前言TouchGFX是专为STM32系列芯片设计的一个现代的、高性能的、强大的嵌入式图形库。
因为以快速为目标。
本文除了关键点外，不会对教程中的步骤进行过多的讲解，所以需要具有一定的STM32开发基础。
这至少需要你做过图形界面的开发或者对无图形库下的，基于RGB显示屏的应用开发有最基本的概念。
并且需要了解相关的外设如FMC(SDRAM)，LTDC，DMA2D的知识。
如果你曾有过LVGL、emWin之类的图形库开发经验，那么在本教程中，这些经验同样会发挥作用。
本教程基于STM32 CubeMX和STM32Cube IDE进行开发，需要对这两个软件有最基本的了解。
如果你习惯使用MDK或IAR，那么也可以使用自己熟悉的IDE来完成本教程。
但是STM32 CubeMX是必须的。
不过，我还是建议使用STM32CubeIDE，毕竟CubeIDE是ST官方的开发环境，拥有最好的兼容性。
二、准备工作此小节说明了移植TouchGFX的准备工作，包括软硬件的准备，和软件环境的搭建。
1.硬件
①基于STM32 MCU的核心板/开发板一块
- 需要带有LTDC功能的型号（常见型号如F429,F746,H743）；
- 核心板需要至少板载1M以上的外部SDRAM（本文中使用基于STM32F429IG核心板，板载SDRAM为IS42S16400QJ-7TLI）。
②RGB接口的显示屏一块
- 推荐分辨率：320x240或480x272；
- 建议选择带触摸的型号（本文使用分辨率为320x240带电阻触摸的LCD屏）。
③ST-Link或者兼容的调试器
- 本文使用ST-Link v2.1。
2.软件
①STM32 CubeIDE（本文中使用的版本：v1.6.1）；
②STM32 CubeMX（本文中使用的版本：v6.2.1）CubeMX请预先安装MCU对应的软件包（本文中使用：STM32Cube_FW_F4 V1.26.1)；
③独立的TouchGFX软件包，下载地址：STM32 Graphical User Interface - STMicroelectronics （本文中使用：TouchGFX v4.16.1）。
三、软件安装（2步）1.TouchGFX Designer的安装
解压下载的TouchGFX软件包。
- 进入目录：\Utilities\PC_Software\TouchGFXDesigner；
- 找到：TouchGFX-4.16.1.msi。
双击运行，保持所有的选项默认直接安装即可。
安装完毕后，桌面上应该出现这两个图标。
2.CubeMX中TouchGFX软件包的安装
运行STM32 CubeMX。
在主界面右侧点击 install/remove。
在打开的对话框中，定位至 STMicroelectronis 选项卡。
滚动条往下拉，找到X-CUBE-TOUCHGFX并展开。
然后选中v4.16.1版本前方的方块，点击下方InstallNow安装。
等待安装结束，则准备工作完成。
四、创建基础项目（3步）1.通过CubeMX创建一个基础项目
通过STM32CubeMX 创建一个可以驱动RGB显示屏的基本工程，配置好必要的外设。
如果可以的话，请顺便添加触摸屏的支持。创建的过程不再赘述。
提示
这一步中请不要为项目添加过多的功能。
只需添加可以驱动你的液晶屏的最少功能即可。
- 一般为RCC,FMC,SDRAM,LTDC和DMA2D；
- 如果有触屏，则可能需要配置SPI或者IIC。
否则出现错误后会增加排查的难度。
切换至Project Mananger，根据下图进心项目配置。
配置完成后，点击右上角“Generate code”生成代码。
等待代码生成完毕，点击关闭对话框。
2.将项目导入至STM32 CubeIDE
启动STM32 CubeIDE。
注意工作空间（Workspace）一定是CubeMX中设置的Project Location。
选择“File” -> "Import"。
选择 “Existing Projects into Workspace”，点击“Next”。
点击Browse，选择刚刚生成的项目。
其他选项保持与下图相同，点击Finish。
3.纠错、测试并运行项目
在左侧Project Explorer中即可看到刚刚导入的项目，展开工程，打开main.c文件。
在User code begin 2区域中，添加SDRAM的初始化代码。
然后编写简单的液晶屏清屏测试代码，用来确认工程配置是否存在错误。
注意！！！
如果生成的代码文件中存在类似XXX CODE BEGIN 和XXX CODE END注释包裹的代码块。
则所有自行编写的代码，都必须放置在这些代码块中。
否则下次点击CubeMX的生成代码按钮时，代码块以外的内容会被删除。
完成后，将开发板通过ST-Link连接至电脑，点击“运行”按钮。
首次运行会弹出运行配置对话框，保持所有选项默认，直接OK确认即可。
- 如果一切配置都正确，则程序会下载至开发板运行，液晶屏此时也应该按照预期显示颜色；
- 如果存在错误，请根据错误提示检查，直至液晶屏可以正常工作。
通过此章节，我们会将TouchGFX软件包添加至我们刚刚创建的项目，并创建一个最基本的用户界面。
1.添加TouchGFX软件包
切换回CubeMX，选择Select Components。
选择TouchGFX，然后点击OK。
在左侧的Software Packs中选择TouchGFX，在右侧勾选Graphics Application启用TouchGFX功能。
2.配置TouchGFX的基本参数
按照图中的说明设置参数，其中的参数的具体功能为：
1、 显示接口的类型，选择LTDC即可；
2、颜色格式，根据实际情况选择，推荐RGB565；
3、TouchGFX的帧缓存策略，此处使用单缓冲即可，暂时不使用双缓冲和部分缓冲；
4、设置缓冲区地址为by address，即固定的缓冲区地址；
5、在SDRAM的LTDC framebuffer之外的空间选择一处空间分配给TouchGFX的帧缓存。需要注意，可用空间必须大于等于LTDC帧缓冲的大小，并且四字节对齐；
6、TouchGFX的时钟源，选择LTDC即可；
7、硬件加速器，如果你选择的MCU有DMA2D，选择即可（如果之前的项目配置中，未启用DMA2D，则需要先配置启用DMA2D）；
8、在本教程中，我们暂时不使用OS。
然后我们还有几个关键的功能需要开启，第一个是硬件CRC校验；
第二个是中断管理中的DMA2D和LTDC中断必须开启。
全部设计完成后，我们再次点击“GENERATE CODE”生成代码，生成代码完成后，选择Open Folder。
进入TouchGFX文件夹，双击运行后缀名为touchgfx.part的文件。
此时，TouchGFX Designer会自动启动。
然后会进入设计器主界面。
我们点击 Add Widgets，随意添加几个控件。
然后点击右上角的 Generate Code，等待代码生成结束。
代码生成完毕后回到STM32CubeIDE，在右边的工程上点击右键，选择刷新。
然后依然点击运行。
一切正常的话，我们应该可以看到液晶屏上出现了我们刚刚放置的小部件。
至此，我们已经成功完成了TouchGFX的移植。
八、添加触摸支持接下来，我们要为TouchGFX添加触摸支持。
触摸“支持”需要通过常规的方法，根据你的“开发板”和“液晶屏”的具体“硬件编写”或者“移植触摸屏”驱动。
编写完成后，我们在左侧项目管理器中打开：STM32TouchController.cpp。
在打开的代码文件的init函数中，添加触屏的初始化代码。
然后在sampleTouch函数中添加读取触屏的代码，典型的代码应该如下。
完成代码的编写后，点击运行。
将程序下载至开发板。
此时点击按钮之类的控件。
如果可以看到按压动画，则标志触摸屏支持移植完成。
九、移植官方的Demo要想学习一个软件库，最好的方法就是参考官方的Demo。
在本章中，我们将移植一个官方的Demo至我们的项目。
导入官方Demo并运行
我们回到TouchGFXDesigner，点击Edit 选择Import。
然后在弹出的对话框中，根据你的液晶屏分辨率，选择一个合适的Example或者Demo。
点击感叹号可以查看此Demo适合的屏幕分辨率：
- 此处选择的是分辨率240x320的Demo。
根据分辨率选择你感兴趣的、合适的Demo。
点击Import，将Demo导入自己的项目中。
注意！！！
请不要选择过于复杂的Demo。
这些Demo通常会因为携带大量的媒体文件，导致片内Flash无法存储，需要外部储存器映射。
此处因为笔者的显示屏分辨率是320x240，而Demo的分辨率是240x320。
所以需要配置一下屏幕旋转。
如果你也需要使用此功能，请在Config中设置。
回到设计器界面，确认配置无误后，依然点击GenerateCode 按钮生成代码。
- 切回STM32CubeIDE；
- 刷新项目后开始运行项目；
- 将代码下载到开发板中。
如果没有错误的话，Demo就可以正常运行了。
至此我们成功地在自己的开发板上运行了TouchGFX，本教程结束。
感谢大家的阅读，如果有什么问题、建议或者发现了教程中的错误，可以直接在评论区提出。
我会尽快响应。
请不要发送私信，因为公开的技术讨论才能帮助所有人。
如果你还想继续深入地研究TouchGFX的运行机理，开发自己的TouchGFX应用，请参考TouchGFX的官方文档：TouchGFX Documentation
