TouchGFX学习笔记（一）

一，显示配置

1.适当增加堆栈大小

2.适当增大缓冲大小

双重缓冲消除了任何撕裂的风险，无论渲染下一帧需要多长时间，因为TfT控制器，例如，总是可以访问最新的完整帧数据。单个缓冲可以消除对外部存储器的需求（可能会发生撕裂）。部分缓冲消除了对外部内存的需求，同时仍然允许将大部分内部内存用于framebuffer之外的事情。

如果“Number of Blocks”设置为1，这意味着TouchGFX将只分配一个内存块用于帧缓冲区。这通常适用于简单的图形界面或显示需求不高的应用场景。在这种情况下，TouchGFX将使用一个单缓冲区方案来更新和显示图形数据。

然而，如果图形界面较为复杂或需要更高的刷新率，可能需要使用双缓冲或多缓冲方案来减少屏幕撕裂和闪烁现象。在这种情况下，“Number of Blocks”参数的值将相应增加，以允许TouchGFX分配更多的内存块用于帧缓冲区。

二，硬件配置

1.开启I2C1用于连接触摸芯片,（PB6,PB7）

2.开启SPI1（Transmit Only Master）用于LCD 串行数据传输,(PB3,PB5)，开启DMA

开启SPI中断用于屏幕刷新完成时调用函数

3.开启QSPI 4线模式用于读写W25Q64

计算请参考链接：

4.开启tim6 定时器为TouchGFX提供时钟源

三，C/C++ 基础示例

1.在cpp文件中的c函数外部函数声明：

extern "C" int touchgfxDisplayDriverTransmitActive();

2.在c文件中的cpp函数外部函数声明：

extern void touchgfxTickHandler(void);//也可以省略extern

3.使cpp文件中的函数兼容c文件使用：

extern "C"
void DisplayDriver_TransferCompleteCallback()
{
    PartialFrameBufferManager::tryTransmitBlockFromIRQ();
}

要在其他 C 文件中使用在 TouchGFXGeneratedHAL.cpp 中定义的 DisplayDriver_TransferCompleteCallback 函数，你需要确保以下几点：

声明函数原型：在需要使用该函数的 C 文件中声明该函数的原型。确保链接：确保在编译和链接时包含 TouchGFXGeneratedHAL.cpp 文件，以便链接器能够找到该函数的定义。

由于 DisplayDriver_TransferCompleteCallback 函数被声明为 extern "C"，它具有 C 链接约定，因此可以在 C 文件中直接使用。

以下是具体步骤：

步骤 1：声明函数原型

在需要使用 DisplayDriver_TransferCompleteCallback 函数的 C 文件中声明该函数的原型。

你可以通过创建一个头文件来包含这个声明，或者直接在 C 文件中声明。

void touchgfxTickHandler(void);
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
  static int counter=0;
	
  if (htim->Instance == TIM6)
	{
    touchgfxTickHandler();
		if(++counter%200==0)
				toggle_led();
  }
}

4.无论是函数还是全局变量，在一个文件中定义了，在另一个文件中如果要使用只需要extern外部声明一下就行了，其中函数可以省略extern，在.h文件中声明只是为了方便管理而已。

四，无外扩flash代码移植：

TGFX SPI左侧为原始代码，右侧为用户代码。无外部flash移植，仅提供思路：

1，点击TouchGFXGeneratedHAL.cpp，其位于Application/User/ TouchGFX/target/generated一栏中，在该点cpp文件的开头就可以看到四个函数声明，前三个都是需要用户自己提供。

//st7789.c
volatile uint8_t IsTransmittingBlock_=0;
/**
 * Check if a Frame Buffer Block is beeing transmitted.
 */
int touchgfxDisplayDriverTransmitActive(void)
{
	return IsTransmittingBlock_;
}
/**
 * Check if a Frame Buffer Block ending at bottom may be sent.
 */
int touchgfxDisplayDriverShouldTransferBlock(uint16_t bottom)
{
	return 1;
}
/**
 * Transmit a Frame Buffer Block.
 */
void touchgfxDisplayDriverTransmitBlock(const uint8_t* pixels, uint16_t x, uint16_t y, uint16_t w, uint16_t h)
{
	IsTransmittingBlock_=1;
	ST7789_DrawImage(x,y,w,h,(uint16_t*)pixels);
}

2，除了上述三个函数，还需要注意一个函数DisplayDriver_TransferCompleteCallback，用户需要在屏幕刷新完成时调用该函数。

//spi.c
extern volatile uint8_t IsTransmittingBlock_;
extern void DisplayDriver_TransferCompleteCallback(void);
void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)
{
	if (hspi->Instance == SPI1) {
		IsTransmittingBlock_ = 0;
		DisplayDriver_TransferCompleteCallback();
	}
}

3，TouchGFX正常工作的前提条件是需要一个外部的时钟源，由于本例程使用的屏为SPI屏，STM32CubeMX中配置的时钟源选项默认为Custom，即需要用户自己为TouchGFX提供时钟源

//tim.c
extern void touchgfxTickHandler(void);
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
  static int counter=0;
	
  if (htim->Instance == TIM6)
	{
    touchgfxTickHandler();
		if(++counter%200==0)
				HAL_GPIO_TogglePin(LED_GPIO_Port,LED_Pin);
  }
}

//OSWrappers.cpp
extern "C" {
	uint8_t isInited = 0;
	
}
extern "C" 
void touchgfxTickHandler()
{
	static uint8_t ms = 0;
	static uint8_t isHigh = 0;
	
	if(isInited)
	{
		ms++;
		if(ms==20)
		{
			ms = 0;
			isHigh = !isHigh;
			if(isHigh)
			{
				OSWrappers::signalVSync();
			}else
			{
				HAL::getInstance()->frontPorchEntered();
			}	
		}
	}
}

4.使用外部变量 isInited 为 1，表示初始化已经成功完成。

extern uint8_t isInited;

isInited = 1;

5.初始化SPI屏幕，开启定时器中断

ST7789_Init();	
HAL_TIM_Base_Start_IT(&htim6);