如何在ART-PI上创建TouchGFX工程

实验平台：

硬件：RT-Thread官方ART-PI H750开发版，正点原子4.3寸RGBLCD屏（800*480） 软件：开发环境 MDK 或 RT-Thread Studio 1.1.5，TouchGFXDesigner v4.15 和 STM32CubeMX V6.0.1，env工具

移植TouchGFX到其他操作系统的原理

1. TouchGFX可以运行在带操作系统和不带操作系统的应用中，默认支持的操作系统为FreeRTOS，用户想要更换操作系统，只需要重新实现OSWrappers类，便可以切换不同的RTOS。

1. 根据touchgfx需要的组件构成，在rtthread中添加touchgfx需要的外设。

在ART-PI中使用TouchGFX

为了方便广大ART-PI的用户使用TouchGFX，免去移植的烦恼，官方已经在ART-PI的SDK中集成了TouchGFX软件库，只需要简单的配置，便可以轻松使用TouchGFX。

使用RT-Thread Studio 开发

1. 打开 RT-Thread Studio 的包管理器,安装 ART-PI SDK 资源包

1. 安装完成后 选择基于 开发板 创建工程

1. 打开TouchGFX Library

1. 打开DMA2D和CRC外设 （或者通过CUBEMX打开DMA2D和CRC外设）

1. 配置C++编译规则

1. 添加GT9174触摸软件包

1. 编译下载

使用 MDK 开发

1. 在 ART-Pi SDK仓库 下载 SDK
2. 进入工程目录。如：sdk-bsp-stm32h750-realthread-artpi\projects\art_pi_blink_led
3. 以管理员权限打开 windows 命令行 ，执行 mklink 命令，分别为 rt-thread 及 libraries 文件创建符号链接

E:\project\sdk-bsp-stm32h750-realthread-artpi\projects\art_pi_blink_led>mklink /D rt-thread ..\..\rt-thread
为 rt-thread <<===>> ..\..\rt-thread 创建的符号链接

E:\project\sdk-bsp-stm32h750-realthread-artpi\projects>mklink /D libraries ..\..\libraries
为 libraries <<===>> ..\..\libraries 创建的符号链接

E:\project\sdk-bsp-stm32h750-realthread-artpi\projects>

1. 打开TouchGFX Library

1. 添加GT9174触摸软件包

1. 使用 ENV 工具执行 scons --target=mdk5
2. 打开DMA2D和CRC外设 （或者通过CUBEMX打开DMA2D和CRC外设）

1. 配置MDK 将SDK中ART-Pi_W25Q64.FLM复制到MDK安装目录的Keil_v5\ARM\Flash下。复制后会自动识别出下载算法。

不使用Micro LIB库。

1. 编译下载

UI开发及仿真

使用TouchGFX 4.15.0 Designer 仿真 在libraries文件夹下找到TouchGFX，打开art_pi.touchgfx。

使用Visual Studio 仿真 在TouchGFX文件夹下找到simulator，打开Application.sln。

在TouchGFX Designer设计完UI，刷新工程，即可将UI更新到项目中。

注意事项

1. 如何更换屏幕 ART-PI的LCD驱动默认支持RGB接口，更好屏幕后，只需要修改对应的参数即可。

用文本文档打开ApplicationTemplate.touchgfx.part，调整分辨率

修改好，双击打开，重新生成UI工程。 2. 如何更改色深 默认支持RGB888 24位色深和RGB565 16位色深，只需要修改LCD_BITS_PER_PIXEL和LCD_PIXEL_FORMAT这两个宏，

用文本文档打开ApplicationTemplate.touchgfx.part，调整色深

修改好，双击打开，重新生成UI工程。 3. C语言和C++如何互相调用 c方式编译和c++方式编译，其差异就在于符号表标识符。同一个函数名，在c方式编译的其函数名跟编译前的函数一致，c++方式编译的则是以函数名结合参数作为编译后的函数名。cpp编译器是兼容c语言的编译方式的，所以在编译cpp文件的时候，调用到.c文件的函数的地方时，需要用extern “C”指定用c语言的方式去编译它，extern “C”是c++方式编译才认识的关键字，在c++编译的方式会定义__cplusplus宏，c语言编译器没有__cplusplus宏和extern “C”关键字。 C++语言调用C文件中的函数: 在编译cpp文件的时候，调用到.c文件的函数的地方时，需要用extern “C”指定用c语言的方式去编译它

extern "C"
{
    uint32_t LCD_GetXSize();
    uint32_t LCD_GetYSize();
}

C语言的头文件要使用宏定义包含函数接口。

#ifdef __cplusplus
 extern "C" {
#endif
.
.
.
#ifdef __cplusplus
}
#endif

C语言调用C++文件中的函数: 对于C++文件中的普通函数，可以直接用extern "C" 对函数进行修饰，对于c++的重载函数或成员函数，需要进行二次封装后，再使用extern "C"对函数修饰，函数内部的代码依然是使用c++的编译器编译。 例如在xx.cpp中对函数进行声明，在xx.c中进行调用：

xx.cpp

extern "C" void touchgfx_init();
extern "C" void touchgfx_taskEntry();
void touchgfx_init()
{

}
void touchgfx_taskEntry()
{

}

xx.c

void touchgfx_init(void);
void touchgfx_taskEntry(void);

void MX_TouchGFX_Init(void)
{

  touchgfx_init();
}

void MX_TouchGFX_Process(void)
{
  touchgfx_taskEntry();
}

4. 建议的开发方式 建议使用touchGFX Designer配合Visual Stdudio来开发UI，与硬件解耦，采用前后端分离的开发方式，可以提高开发效率。 代码中可以使用宏来规避开发环境不同导致的错误：

/*例如通过宏：*/
#ifdef SIMULATOR
/*使用VS仿真的代码*/
#else
/*使用HAL库的代码*/
#endif