通过阅读本教程，你将可以快速上手创建你的第一个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软件包（2步）
通过此章节，我们会将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
