ESP32-TFT_eSPI库中的使用前设置

### 关于ESP32使用TFT_eSPI库的方法 #### 硬件连接 对于采用ST7789驱动器的显示屏，如TTGO 1.14英寸LCD屏，其与ESP32之间的接线方式较为固定。通常情况下，这些屏幕通过SPI接口通信，并且可能已经预焊接好排针以便直接插接到ESP32开发板上[^2]。 | SPI信号 | ESP32引脚 | | --- | --- | | SCK (串行时钟) | GPIO18 或其他指定为SCLK的GPIO | | MOSI (主输出/从输入数据线) | GPIO23 或者MOSI对应的GPIO| | CS (片选) | 可配置, 常见的是GPIO5 | | DC (数据/命令控制)| 可配置, 如GPIO16 | | RST (复位)| 可配置, 比如GPIO27 | 请注意实际产品可能会有所不同，具体应参照所使用的特定模块文档说明。 #### 安装TFT_eSPI库并初始化显示设备 为了使能对上述硬件的支持，在Arduino IDE环境中需安装`TFT_eSPI`库。这可以通过IDE内置的库管理工具完成。一旦安装完毕，则可以在项目源文件夹内找到名为`tft_config.h`的头文件；在此处定义具体的引脚分配以及其他必要的参数设置以匹配个人硬件环境[^1]。 ```cpp #include <TFT_eSPI.h> // Hardware-specific library TFT_eSPI tft = TFT_eSPI(); void setup() { Serial.begin(115200); // Initialize the display using default parameters defined in tft_config.h. tft.init(); } ``` 这段简单的代码展示了如何创建一个基于TFT_eSPI类的对象实例`tft`以及调用成员函数`.init()`来进行基本初始化操作[^4]。 #### 绘制图形和文字到屏幕上 下面给出了一段用于测试目的的小例子——它会在启动之后清空整个画面再画一条彩虹渐变色带作为背景图案，最后居中打印一句问候语句： ```cpp void loop(){ // Fill screen with gradient colors as background uint16_t color; int y; for(y=0; y<TFT_HEIGHT; ++y){ color=tft.color565((uint8_t)(map(y,TFT_HEIGHT>>1,0,0,255)), (uint8_t)(map(y,0,TFT_HEIGHT>>1,0,255)), 0); tft.drawLine(0,y,TFT_WIDTH-1,y,color); } // Print text centered on top of rainbow bar String msg="Hello World!"; int16_t tbx,tby; uint16_t tw,th; tft.getTextBounds(msg.c_str(),0,0,&tbx,&tby,&tw,&th); tft.setTextColor(TFT_WHITE,TFT_BLACK); tft.setCursor((TFT_WIDTH-tw)/2,(TFT_HEIGHT-th)/2); tft.print(msg); while(true){} // Stop here after drawing once } ``` 此部分利用了`tft.draw...()`系列绘图API实现了视觉效果展示功能。