TFT_eSPI项目：Heltec T190 SPI显示屏配置指南

概述

本文将详细介绍如何在TFT_eSPI项目中配置Heltec T190 1.9英寸320x170 IPS TFT显示屏。该显示屏采用ST7789驱动芯片，通过SPI接口与主控板通信。

硬件连接

Heltec T190显示屏需要以下引脚连接：

• MOSI: 48
• SCLK: 38
• CS: 39
• DC: 47
• RST: 40
• 背光控制: 17
• 电源控制: 7

配置参数

在TFT_eSPI库中需要进行以下配置：

#define USER_SETUP_ID 190
#define ST7789_DRIVER
#define USE_HSPI_PORT
#define TFT_RGB_ORDER TFT_BGR
#define TFT_WIDTH 170
#define TFT_HEIGHT 320
#define TFT_BL 17
#define TFT_BACKLIGHT_ON HIGH
#define TFT_MOSI 48
#define TFT_SCLK 38
#define TFT_CS 39
#define TFT_DC 47
#define TFT_RST 40
#define SPI_FREQUENCY 27000000

初始化设置

在项目初始化阶段需要添加以下代码：

pinMode(7, OUTPUT);  // 设置TFT显示屏电源控制
digitalWrite(7, LOW);  // 开启显示屏电源

pinMode(17, OUTPUT);  // 设置背光PWM控制
digitalWrite(17, HIGH);  // 开启背光

字体配置

TFT_eSPI支持多种字体，可以根据需求选择加载：

#define LOAD_GLCD   // 原始Adafruit 8像素字体
#define LOAD_FONT2  // 小型16像素字体
#define LOAD_FONT4  // 中型26像素字体
#define LOAD_FONT6  // 大型48像素字体
#define LOAD_FONT7  // 7段48像素字体
#define LOAD_FONT8  // 大型75像素字体
#define LOAD_GFXFF  // 包含48种Adafruit_GFX免费字体
#define SMOOTH_FONT // 平滑字体支持

性能优化

• 设置SPI频率为27MHz以获得最佳性能
• 使用HSPI端口可提高通信效率
• 正确的色彩顺序(TFT_BGR)确保显示色彩准确

常见问题

1. 显示屏无反应：检查电源控制引脚是否正确初始化
2. 显示色彩异常：确认TFT_RGB_ORDER设置是否正确
3. 通信不稳定：降低SPI频率测试

通过以上配置，Heltec T190显示屏可以在TFT_eSPI项目中正常工作，为开发者提供高质量的显示效果。