# art_pi_project

**Repository Path**: metaphor0406/art_pi_project

## Basic Information

- **Project Name**: art_pi_project
- **Description**: No description available
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-03-02
- **Last Updated**: 2022-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

<img src="./figures/01.png" alt="TouchGFX与操作系统" style="zoom: 50%;" />

  

2. 在rtthread中添加touchgfx需要的驱动

​       根据touchgfx需要的组件构成，只需要在rtthread中实现相应的驱动即可。
  <img src="./figures/02.png" alt="组件构成" style="zoom: 80%;" />

## 在ART-PI中使用TouchGFX
为了方便广大ART-PI的用户使用TouchGFX，免去移植的烦恼，官方已经在ART-PI的SDK中集成了TouchGFX软件库，只需要简单的配置，便可以轻松使用TouchGFX。
### 使用RT-Thread Studio 开发
1. 打开 RT-Thread Studio 的包管理器,安装 ART-PI SDK 资源包

<img src="./figures/03.png" alt="安装资源包" style="zoom: 50%;" />

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

     <img src="./figures/04.png" alt="安装资源包" style="zoom: 50%;" />

  

3. 打开TouchGFX Library
   
    <img src="./figures/05.png" alt="安装资源包" style="zoom: 60%;" />

  

4. 打开DMA2D和CRC外设
   
    1.0.1版本请通过CUBEMX打开DMA2D和CRC外设
    
    <img src="./figures/07.png" alt="配置外设" style="zoom: 60%;" />

  

5. 配置C++编译规则
   
    <img src="./figures/08.png" alt="" style="zoom: 60%;" />

  

6. 添加GT9174触摸软件包
   

<img src="./figures/09.png" alt="" style="zoom: 60%;" />

<img src="./figures/10.png" alt="" style="zoom: 60%;" />

7. 编译下载


### 使用 MDK 开发
1. 在 [ART-Pi SDK仓库](https://github.com/RT-Thread-Studio/sdk-bsp-stm32h750-realthread-artpi) 下载 SDK
2. 进入工程目录。如：sdk-bsp-stm32h750-realthread-artpi\projects\art_pi_blink_led
3. 以管理员权限打开 windows 命令行 ，执行 mklink 命令，分别为 `rt-thread` 及 `libraries` 文件创建符号链接
```c
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>
```
4. 打开TouchGFX Library
   

<img src="./figures/11.png" alt="" style="zoom: 60%;" />
    

5. 添加GT9174触摸软件包

     <img src="./figures/12.png" alt="" style="zoom: 60%;" />

6. 使用 [ENV](https://club.rt-thread.org/ask/question/5699.html) 工具执行 scons --target=mdk5 

7. 打开DMA2D和CRC外设

     1.0.1版本请通过CUBEMX打开DMA2D和CRC外设

  <img src="./figures/13.png" alt="" style="zoom: 60%;" />

8. 配置MDK

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

 <img src="./figures/14.png" alt="" style="zoom: 60%;" />

  

  不使用Micro LIB库。

<img src="./figures/15.png" alt="" style="zoom: 60%;" />

9. 编译下载
### UI开发及仿真
**使用TouchGFX 4.15.0 Designer 仿真**

在libraries文件夹下找到TouchGFX，打开art_pi.touchgfx

<img src="./figures/16.png" alt="" style="zoom: 60%;" />

![](.\figures\17.gif)



**使用Visual Studio 仿真**

在TouchGFX文件夹下找到simulator，打开Application.sln
<img src="./figures/18.png" alt="" style="zoom: 60%;" />

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

### 注意事项
**1. 如何更换屏幕**

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

<img src="./figures/19.png" alt="" style="zoom: 60%;" />

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

<img src="./figures/20.png" alt="" style="zoom: 60%;" />

修改好，双击打开，重新生成UI工程。

**2. 如何更改色深**

默认支持RGB888 24位色深和RGB565 16位色深，只需要修改LCD_BITS_PER_PIXEL和LCD_PIXEL_FORMAT这两个宏，
<img src="./figures/21.png" alt="" style="zoom: 60%;" />

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

<img src="./figures/22.png" alt="" style="zoom: 60%;" />
<img src="./figures/23.png" alt="" style="zoom: 60%;" />



修改好，双击打开，重新生成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语言的方式去编译它

```c
extern "C"
{
	uint32_t LCD_GetXSize();
	uint32_t LCD_GetYSize();
}
```
C的头文件要使用宏定义包含函数接口。

```c
#ifdef __cplusplus
 extern "C" {
#endif
.
.
.
#ifdef __cplusplus
}
#endif
```
**C语言调用C++文件中的函数:**

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

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

}
void touchgfx_taskEntry()
{

}
```
xx.c

```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，与硬件解耦，采用前后端分离的开发方式，可以提高开发效率。
代码中可以使用宏来规避开发环境不同导致的错误：

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

详细教程：[在ART-Pi H750上移植TouchGFX（三）——如何在ART-PI上创建TouchGFX工程](https://blog.csdn.net/sinat_31039061/article/details/108638097)



关注公众号，后续有精彩教程会第一时间发送给您！

![在这里插入图片描述](https://img-blog.csdnimg.cn/20200506150500150.jpg)