使用esp32在arduino中驱动tft

在复刻嘉立创的一个电子负载仪的项目的时候,遇到了些问题,所以记录一下。

项目只给出了一个esp32的bin文件和源代码,这一个bin文件没有办法刷到esp32中,所以使用源码编译一下。

但是源代码也只有一个ino文件。前期复刻别的项目的时候,都是刷别人编译好的固件。以为tft屏的针脚连接在ino中定义。所以编译后,一直没有点亮屏幕。因此,特记录下整个过程。

要配置TFT_eSPI库来驱动ST7735 0.96寸TFT屏幕,你需要按照以下步骤操作:

一:安装TFT_eSPI库

驱动tft屏用到的库是TFT_eSPI。项目地址:Bodmer/TFT_eSPI: Arduino and PlatformIO IDE compatible TFT library optimised for the Raspberry Pi Pico (RP2040), STM32, ESP8266 and ESP32 that supports different driver chips

二:配置文件

该库有User_Setup.h和 User_Setup_Select.h两个配置文件,支持 ①自定义参数或 ②使用已有配置 驱动TFT屏幕。

TFT_eSPI 的编译逻辑是这样的:如果 User_Setup.h 里定义了 USER_SETUP_LOADED ,库就只采用你手写的配置;否则它会跑去 User_Setup_Select.h ,按你的开发板型号套用某个默认配置。理解了这一点,后面所有配置问题就都有了排查方向。

找到TFT_eSPI库文件夹中的User_Setup.h文件(通常位于Arduino/libraries/TFT_eSPI目录下),并进行如下修改:

// 选择你的驱动芯片
#define ST7735_DRIVER
 
// 设置屏幕分辨率
#define TFT_WIDTH  80
#define TFT_HEIGHT 160
 
// 对于0.96寸ST7735屏幕通常使用以下设置
#define ST7735_GREENTAB160x80 // 对于160x80像素的屏幕
//修改偏移,如果边缘出现花屏需要修改这个位置,并且需要到对应的驱动里面修改偏移值,例如我这里修改的位置是在\TFT_Drivers\ST7735_Rotation.文件里面的case 0(0 1 2 3对应屏幕旋转0 90 180 270)下的INITR_GREENTAB128中的两个偏移值
 
 
 
// 设置引脚(根据你的实际连接修改)
#define TFT_CS   10  // 芯片选择引脚
#define TFT_DC   9   // 数据/命令选择引脚
#define TFT_RST  8   // 复位引脚(可接Arduino RESET或单独控制)
 
// 如果你使用硬件SPI(推荐)
#define TFT_SPI_PORT 1 // 使用SPI1,对于大多数Arduino是默认SPI
 
// 可选:如果使用软件SPI(不推荐,速度慢)
// #define TFT_MOSI 11
// #define TFT_SCLK 13
// #define TFT_CS   10
// #define TFT_DC   9
// #define TFT_RST  8
// #define TFT_MISO 12
 
// 字体设置(可选)
#define LOAD_GLCD   // 默认字体
#define LOAD_FONT2  // 小号字体
#define LOAD_FONT4  // 中号字体
#define LOAD_FONT6  // 大号字体
#define LOAD_FONT7  // 7段显示字体
#define LOAD_FONT8  // 大号数字字体
#define LOAD_GFXFF  // 平滑字体
 
// 其他设置
#define SPI_FREQUENCY  27000000 // 最大27MHz
#define SPI_READ_FREQUENCY  20000000
#define SPI_TOUCH_FREQUENCY  2500000

User_Setup_Select.h 决定实际使用哪一份设置。可以直接编辑默认的 User_Setup.h,也可以建立自己的 setup 文件并在选择文件中启用它。确保最终只启用一份与当前屏幕相符的 setup;修改后重新编译,并从编译输出确认 Arduino 使用的是你修改的那份 TFT_eSPI 库。电脑上安装了多个同名库时,Arduino 可能选中另一份。

库升级可能覆盖库目录中的自定义设置。升级前请备份;更稳妥的做法是保留单独的自定义 setup 文件,并在 User_Setup_Select.h 中明确选择它。

TFT_eSPI 配屏二选一:要么选现成 SetupXX 配置文件,要么手动改 User_Setup.h;配置文件都在库根目录。

Important

Then you have to select your hardware configuration, either by setting the right “SetupXX” config file, either by setting all the right parameters in the User_Setup.h file. Both files are located in C:\Users\__user__\Documents\Arduino\libraries\TFT_eSPI\ for my Windows 10 PC.

Warning

An update of the TFT_eSPI library’s version might replace all your local modifications by installing new files.

三:连接硬件

典型的ST7735 0.96寸TFT引脚连接:

TFT引脚  -> Arduino引脚
----------------------
VCC     -> 3.3V或5V(取决于模块)
GND     -> GND
SCL/SCK -> 13 (SPI时钟)
SDA/MOSI-> 11 (SPI数据输入)
RES/RST -> 8 (或接Arduino RESET)
DC/RS   -> 9 
CS      -> 10
BLK     -> 3.3V或通过PWM控制背光

四:测试代码

#include <TFT_eSPI.h>
 
TFT_eSPI tft = TFT_eSPI();
 
void setup() {
  tft.init();
  tft.setRotation(1); // 根据需要调整旋转方向(0-3)
  tft.fillScreen(TFT_BLACK);
  tft.setTextColor(TFT_WHITE, TFT_BLACK);
  tft.drawString("Hello World!", 10, 10, 2);
}
 
void loop() {
  // 测试颜色显示
  tft.fillScreen(TFT_RED);
  delay(500);
  tft.fillScreen(TFT_GREEN);
  delay(500);
  tft.fillScreen(TFT_BLUE);
  delay(500);
}

五:常见问题

  1. 屏幕显示不正常:

    • 检查引脚连接是否正确

    • 确认选择了正确的驱动芯片定义

    • 尝试调整SPI频率(降低到20000000或更低)

  2. 颜色不正确:

    • 尝试不同的初始化设置(如ST7735_GREENTAB160x80改为ST7735_BLACKTAB)

    • 检查setRotation()参数是否正确

  3. 屏幕方向不对:

    • 调整tft.setRotation(0-3)参数

    • 可能需要修改TFT_WIDTH和TFT_HEIGHT定义

发表评论