在复刻嘉立创的一个电子负载仪的项目的时候,遇到了些问题,所以记录一下。
项目只给出了一个esp32的bin文件和源代码,这一个bin文件没有办法刷到esp32中,所以使用源码编译一下。
但是源代码也只有一个ino文件。前期复刻别的项目的时候,都是刷别人编译好的固件。以为tft屏的针脚连接在ino中定义。所以编译后,一直没有点亮屏幕。因此,特记录下整个过程。
要配置TFT_eSPI库来驱动ST7735 0.96寸TFT屏幕,你需要按照以下步骤操作:
一:安装TFT_eSPI库
-
通过Arduino IDE的库管理器搜索并安装”TFT_eSPI”
-
或者从GitHub下载:https://github.com/Bodmer/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.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);
}
五:常见问题
-
屏幕显示不正常:
-
检查引脚连接是否正确
-
确认选择了正确的驱动芯片定义
-
尝试调整SPI频率(降低到20000000或更低)
-
-
颜色不正确:
-
尝试不同的初始化设置(如ST7735_GREENTAB160x80改为ST7735_BLACKTAB)
-
检查
setRotation()参数是否正确
-
-
屏幕方向不对:
-
调整
tft.setRotation(0-3)参数 -
可能需要修改
TFT_WIDTH和TFT_HEIGHT定义
-