esp32s3 tft

### ESP32-S3与TFT显示屏使用教程

#### 创建工程
为了使ESP32-S3能够支持图形界面开发，需先建立一个新的Arduino项目。确保已安装最新版本的Arduino IDE以及对应的ESP32板管理器。

#### 下载LVGL依赖库TFT_eSPI
由于LVGL本身并不提供底层硬件抽象层的支持，因此需要额外集成`TFT_eSPI`库来处理具体的显示操作。该库兼容多种型号的TFT屏幕，并简化了初始化过程[^3]。

#include "TFT_eSPI.h"
// 初始化TFT对象
TFT_eSPI tft = TFT_eSPI();

#### 配置显示接口并运行例程
根据所使用的具体显示器规格，在`User_Setup_Select.h`文件内挑选合适的预设配置项；对于采用ST7789驱动IC的1.69英寸电容触控屏而言，则应选择相应的定义语句以匹配实际连接方式[^4]。

#define USER_SETUP_LOADED 1
#include "User_Setup_Select.h"

void setup() {
  Serial.begin(115200);
  
  // 开启背光灯
  pinMode(TFT_BACKLIGHT, OUTPUT);
  digitalWrite(TFT_BACKLIGHT, HIGH);

  // 启动TFT SPI总线
  if (!tft.init()) { 
    Serial.println("Initialization failed!"); 
    while (true); 
  }
}

#### 接入触摸功能
针对CST816这类专用型多点触控感应器，推荐利用官方提供的API完成交互逻辑的设计。下面给出了一段用于检测单指点击动作的基础示范程序片段：

#include <Wire.h>
#include "TouchScreen_CST816S.h"

TouchScreen_CST816S ts;

bool isPressed;
uint16_t x, y;

void loop(){
  delay(100);
  if(ts.isAvailable()){
      ts.readPoint(&x,&y,isPressed);
      
      if(isPressed){
          Serial.printf("X=%d Y=%d\n", x,y);
          
          // 绘制一个小圆圈表示按压位置
          tft.fillCircle(x, y, 5, ILI9341_RED);
      }else{
        // 清除之前画的小红点
        tft.fillRect(0, 0, 240, 240, ILI9341_BLACK);
      }
  }
}

上述代码实现了基本的手势捕捉机制，允许开发者进一步扩展成更复杂的UI组件或应用服务。