TFT_eSPI 库使用中遇到的坑

最新推荐文章于 2025-04-17 05:39:24 发布
最新推荐文章于 2025-04-17 05:39:24 发布
阅读量3.2k 收藏 14
点赞数 2
分类专栏： Arduino ESP32 文章标签： 物联网 单片机
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/SpringDeng2021/article/details/127200854
版权

介绍

本文主要是记录学习使用 ESP32 驱动3.5寸屏I(驱动芯片LI9488)时 遇到的问题和解决方法。

问题1

使用arduino 编译带触摸函数的例子总报错，找不到相应的函数。经过研究TFT_eSPI 的文件包含结构才发现设置自己设置错了。

程序结构入下：

1，arduino.ino 程序中 会 #include <TFT_eSPI.h> ，这样编译的时候，编译软件会去对用的库中找到TFT_eSPI.h 并将整个文件copy  并合并到 arduino.ino 原程序中。

2，打开 TFT_eSPI.h 文件，发现 #include <User_Setup_Select.h> ， 表示  TFT_eSPI.h 中把

 User_Setup_Select.h 这个文件包含进来。为此，我们进入User_Setup_Select.h 查看

3，打开 User_Setup_Select.h 文件，这个文件是让你选择使用哪个文件进行tft 显示屏的驱动配置

文件进行设置。如果 要 使用 User_Setup.h 进行通用设置，那就需要将 // #include <User_Setup.h>  前面的两个取消掉，并到 User_Setup.h 进行设置对应的管脚等。

如果你 取消了#include <User_Setups/Setup21_ILI9488.h>  的注释， 则需要到文件夹 User_Setups 下面的 Setup21_ILI9488.h 中进行设置相关的配置。

我这里选择了

#include <User_Setups/Setup21_ILI9488.h> ，由于 User_Setups/Setup21_ILI9488.h 中 没有以下语句  “”#define TOUCH_CS 21“”     // Chip select pin (T_CS) of touch screen

我犯的低级错误就是#include <User_Setups/Setup21_ILI9488.h> ，但包含的库中没有#define TOUCH_CS 21， 我想当然的去 User_Setup.h 中设置触摸的 片选管脚 

#define TOUCH_CS 21     // Chip select pin (T_CS) of touch screen

导致带有触摸的例子报错无法编译通过（因为User_Setup_Select.h 根本没有#include <User_Setup.h>）。为此，只要在 Setup21_ILI9488.h 加入以下宏定义并设置相应管脚即可

TOUCH_CS 21， 我想当然的去 User_Setup.h 中设置触摸的 片选管脚 

///
//   User configuration selection lines are below    //
///

// Only ONE line below should be uncommented to define your setup.  Add extra lines and files as needed.

//#include <User_Setup.h>           // Default setup is root library folder

//#include <User_Setups/Setup1_ILI9341.h>  // Setup file for ESP8266 configured for my ILI9341
//#include <User_Setups/Setup2_ST7735.h>   // Setup file for ESP8266 configured for my ST7735
//#include <User_Setups/Setup3_ILI9163.h>  // Setup file for ESP8266 configured for my ILI9163
//#include <User_Setups/Setup4_S6D02A1.h>  // Setup file for ESP8266 configured for my S6D02A1
//#include <User_Setups/Setup5_RPi_ILI9486.h>        // Setup file for ESP8266 configured for my stock RPi TFT
//#include <User_Setups/Setup6_RPi_Wr_ILI9486.h>     // Setup file for ESP8266 configured for my modified RPi TFT
//#include <User_Setups/Setup7_ST7735_128x128.h>     // Setup file for ESP8266 configured for my ST7735 128x128 display
//#include <User_Setups/Setup8_ILI9163_128x128.h>    // Setup file for ESP8266 configured for my ILI9163 128x128 display
//#include <User_Setups/Setup9_ST7735_Overlap.h>     // Setup file for ESP8266 configured for my ST7735
//#include <User_Setups/Setup10_RPi_touch_ILI9486.h> // Setup file for ESP8266 configured for ESP8266 and RPi TFT with touch

//#include <User_Setups/Setup11_RPi_touch_ILI9486.h> // Setup file configured for ESP32 and RPi TFT with touch
//#include <User_Setups/Setup12_M5Stack_Basic_Core.h>// Setup file for the ESP32 based M5Stack (Basic Core only)
//#include <User_Setups/Setup13_ILI9481_Parallel.h>  // Setup file for the ESP32 with parallel bus TFT
//#include <User_Setups/Setup14_ILI9341_Parallel.h>  // Setup file for the ESP32 with parallel bus TFT
//#include <User_Setups/Setup15_HX8357D.h>           // Setup file for ESP8266 configured for HX8357D
//#include <User_Setups/Setup16_ILI9488_Parallel.h>  // Setup file for the ESP32 with parallel bus TFT
//#include <User_Setups/Setup17_ePaper.h>            // Setup file for ESP8266 and any Waveshare ePaper display
//#include <User_Setups/Setup18_ST7789.h>            // Setup file for ESP8266 configured for ST7789

//#include <User_Setups/Setup19_RM68140_Parallel.h>	 // Setup file configured for RM68140 with parallel bus

//#include <User_Setups/Setup20_ILI9488.h>           // Setup file for ESP8266 and ILI9488 SPI bus TFT
#include <User_Setups/Setup21_ILI9488.h>           // Setup file for ESP32 and ILI9488 SPI bus TFT

//#include <User_Setups/Setup22_TTGO_T4.h>           // Setup file for ESP32 and TTGO T4 version 1.2
//#include <User_Setups/Setup22_TTGO_T4_v1.3.h>      // Setup file for ESP32 and TTGO T4 version 1.3
//#include <User_Setups/Setup23_TTGO_TM.h>           // Setup file for ESP32 and TTGO TM ST7789 SPI bus TFT
//#include <User_Setups/Setup24_ST7789.h>            // Setup file for DSTIKE/ESP32/ESP8266 configured for ST7789 240 x 240
//#include <User_Setups/Setup25_TTGO_T_Display.h>    // Setup file for ESP32 and TTGO T-Display ST7789V SPI bus TFT
//#include <User_Setups/Setup26_TTGO_T_Wristband.h>  // Setup file for ESP32 and TTGO T-Wristband ST7735 SPI bus TFT

问题2

触屏功能无法使用。

User_Setups/Setup21_ILI9488.h 中 明显标注，如果多个设备使用MISO,(显示和触摸都使用了)，

需要将显示的MISO 断开

#define TFT_MISO 19 // (leave TFT SDO disconnected if other SPI devices share MISO)

ardunio TFT_eSPI库与Audio库冲突解决
hollwork的博客
03-07 756
TFT_eSPI库与Audio库发生冲突，原因是TFT_eSPI库引用了FS.h，其中命名空间为fs,定义了FS类，Audio.h开启sdFat库后，也有一个fs命名空间，然后在sdFat类基础上又定义了一个FS类。解决办法，修改audio.h命名空间，并修改audio.cpp文件即可。修改audio.h文件部分。修改后audio.h如下。
PlatformIO下ESP32使用TFT_eSPI库无限重启，报StoreProhibited错误详细解决方案
qq_42757207的博客
05-20 3299
这两天开始使用ESP32-S3-DevKitC-1开发板，N16R8的型号移植完LVGL和TFT_eSPI库后无限重启，同样的移植方式，在esp32-wroom上是无问题的，排查一天，并上网翻查资料，最终解决。
esp32使用TFT_eSPI库，系统双闪，指针溢出的问题
qinggang15的博客
06-29 690
使用TFT_eSPI烧录进esp32c3之后，开发板灯双闪，串口输出指针越界的错误。
【花雕学编程】Arduino TFT 之TFT_eSPI库+GC9A01屏组合几个经典应用场景
雕爷学编程
04-17 829
例如，在环境监测系统中，显示温度、湿度、空气质量等数据；借助相应的库函数和代码，能够轻松实现图像绘制、文字显示、触摸交互等功能，降低了开发难度，即使对于没有深厚显示技术背景的开发者也较为友好。通过绘制不同颜色的图标和文字，直观地展示各个设备的工作状态，用户可以通过触摸屏幕上的图形按钮来控制设备的开关、调节亮度等。1、人机交互界面：在各种电子设备中，如智能仪器仪表、智能家居控制系统、工业自动化控制面板等，作为人机交互的窗口，用于显示菜单、参数设置界面、实时数据监测以及操作提示等信息，方便用户与设备进行交互。
ESP32S3 中景园1.69液晶屏ST7789V LVGL 坑记录
zerg_or的博客
07-31 3221
中景园 1.96寸液晶屏 （ST7789V）移植LVGL 异常定位处理
ESP8266之TFT_eSPI库的自定义字体
guguda1111的博客
04-14 7859
目录 一、引言 二、字体生成 1、字体下载 2、字体转换 3、字体编码 三、字体使用 一、引言 说明：博主在进行TFT显示时需要显示中文字体，但是TFT库中不带有中文显示，或者显示不全，于是开展了自定义字体，最后得到字体.h文件，引用到项目中供TFT——eSPI库使用。其中一部分脚本放进我的仓库，需要的自行下载。 TFT_eSPI-master-Create_font: 为TFT_eSPI库创建自定义字体https://gitee.com/upperair0128/...
Arduino之TFT_eSPI驱动彩色LCD屏
保持热爱，奔赴山海。
08-15 6418
1.先下载processing软件，进行解压2.使用UTF8字体生成软件进行取模之后点击生成.h即可。
TFT_eSPI-master.zip
12-02
《TFT_eSPI库详解与应用实践》 在嵌入式开发领域，尤其是在Arduino和ESP32等微控制器平台中，TFT_eSPI库...通过熟练掌握TFT_eSPI库的使用，开发者可以充分发挥TFT屏幕的潜能，为创新应用带来生动、直观的视觉体验。
支持ESP8266的TFT_eSPI库，可驱动各类液晶屏
12-07
标题中的“支持ESP8266的TFT_eSPI库”指的是一个专为ESP8266微控制器设计的图形库，用于驱动各种类型的TFT（Thin Film Transistor）液晶显示屏。ESP8266是一款广泛应用的Wi-Fi模块，常用于物联网(IoT)项目，因其强大...
TFT_eSPI.zip
11-08
TFT_eSPI库是Arduino生态系统中的一个重要组成部分，它是基于原始的Adafruit GFX库优化而来，旨在提高性能并简化编程接口。该库主要包含了以下核心知识点： 1. **硬件兼容性**：TFT_eSPI库设计灵活，能够适应多种...
TFT_eSPI.zip_ARDUINO esp32_ESP8266 TFT_S6D02A1_esp32_esp32 spi
09-24
An Arduino IDE compatible graphics and fonts library for ESP8266 and ESP32 processors with a driver for ILI9341, ILI9163, ST7735 and S6D02A1 based TFT displays that support SPI.
TFT_eFEX:TFT_eSPI的支持库，其中添加了常用的额外功能
05-27
一个Arduino IDE库，为TFT_eSPI库提供了额外的功能。 额外的功能是： // Draw a bezier curve of a defined colour between specified points void drawBezier（int32_t x0，int32_t y0，int32_t x1，int32_t y1...
LittleVGL踩坑指南03：Arduino下显示和触摸驱动配置(TFT_eSPI)
weixin_44007534的博客
02-26 1万+
前言 第一篇里只讲了lvgl的安装配置和显示驱动的安装，没有介绍驱动配置也没有提到输入设备驱动，本篇填个坑 一、显示驱动TFT_eSPI TFT_eSPI的安装在第一篇讲过了，这里就不再重复 二、触摸驱动 LVGL支持多种输入设备，包括鼠标、键盘、编码器等，我只实际使用过触摸屏，就只能介绍触摸驱动啦 1.引入库 代码如下（示例）： import numpy as np import pandas as pd import matplotlib.pyplot as plt import seaborn a.
ESP32：使用TFT_eSPI库驱动TFT串口屏
热门推荐
LiHaotian917的博客
03-17 1万+
本文使用esp32结合TFT_eSPI库点亮了一块ILI9341驱动的2.4寸串口屏，并运行了例程。
PlatformIO平台使用TFT_eSPI库驱动IC为ST7789的TFT屏幕（TFT_eSPI详解）
weixin_64459427的博客
08-24 6065
TFT_eSPI库的配置
Arduino TFT_eSPI库来驱动SPI接口的LCD显示文字详解
perseverance51博客
11-29 7773
Arduino TFT_eSPI库来驱动SPI接口的LCD显示详解 文字显示过程详解 TFT eSPI显示文字的方式比较有意思，通过创建一个画布，然后将文字在画布中显示，最后将画布推送到屏幕的指定位置，具体步骤如下： 导入相关函数，并创建实例. 最后一行就是创建“画布”实例 . 3.屏幕初始化 4.文字真正的部分。 流程梳理 创建指定大小的画布（需小于屏幕的最大尺寸） 设置画布的填充颜色 加载显示的字体（自制的字库） 设置文本位置参考基准 设置字体显示区域的颜色，含背景颜色和字体颜色（背景颜色请
解决platformio添加库报错问题
gxt_kt的博客
01-08 5277
解决platformio添加库报错问题 问题现状：添加TFT_eSPI库提示找不到SPI.h In file included from .pio\libdeps\esp32dev\TFT_eSPI\TFT_eSPI.cpp:17:0: .pio\libdeps\esp32dev\TFT_eSPI\TFT_eSPI.h:32:17: fatal error: SPI.h: No such file or directory 解决方法：在platformio.ini文件中添加一句话 lib_ldf_mode
TFT_eSPI 项目使用教程
gitblog_00630的博客
10-11 686
TFT_eSPI 项目使用教程 项目地址:https://gitcode.com/gh_mirrors/tf/TFT_eSPI 1. 项目目录结构及介绍 TFT_eSPI 是一个针对 Arduino 和 PlatformIO IDE 优化的 TFT 库，支持 Raspberry Pi Pico (RP2040)、STM32、ESP8266 和 ESP32 等处理器。项目的目录结构如下： TFT_e...
Arduino开发-TFT_eSPI库学习
u014421313的博客
07-26 4774
tft
TFT_eSPI库
最新发布
05-22
### 关于TFT_eSPI库的使用指南 #### 安装方法 为了正确安装并配置TFT_eSPI库，需按照以下方式操作。首先，在Arduino IDE中通过“工具”->“管理库”来搜索并安装TFT_eSPI库[^2]。完成安装后，需要根据具体的硬件环境调整库中的配置文件。 #### 文件目录结构 TFT_eSPI库的主要配置文件包括以下几个部分： - **User_Setup_Select.h**: 此文件用于指定特定屏幕类型的配置头文件[^3]。 - **User_Setup_.h**: 这是一个模板文件，开发者可以根据自己的显示屏参数修改此文件的内容以适配具体设备[^1]。 - **Rotation.h**: 提供旋转和镜像功能的支持，允许用户自定义显示方向[^1]。 #### 常见初始化函数 对于TFT_eSPI库而言，其核心类`eSPI`提供了丰富的接口以便实现各种图形绘制需求。以下是几个常用的初始化及相关函数： ```cpp #include <TFT_eSPI.h> // 创建TFT对象实例 TFT_eSPI tft = TFT_eSPI(); void setup() { // 初始化TFT屏幕 tft.begin(); // 设置背景颜色 tft.fillScreen(TFT_BLACK); } void loop() {} ``` 以上代码展示了如何创建一个基于TFT_eSPI的对象`tft`并通过调用`begin()`方法启动屏幕服务[^1]。 #### 示例代码：文字与图像绘制 下面提供一段简单的示例程序展示基本的文字和简单形状绘制能力： ```cpp #include <TFT_eSPI.h> TFT_eSPI tft = TFT_eSPI(); void setup(void) { tft.init(); // Initialize the screen tft.setRotation(1); // Set rotation to landscape mode tft.fillScreen(TFT_BLUE); // Fill background color as blue tft.setTextColor(TFT_WHITE, TFT_BLUE); // Define text and background colors tft.setTextSize(2); // Set font size multiplier (default=1) tft.drawString("Hello World!", 50, 50); // Draw string at position X,Y coordinates } void loop(){} ``` 这段代码实现了在一个蓝色背景下打印白色字体“Hello World!”的功能，并设置了屏幕的方向为横向模式[^1]。 #### Sprite 类 API 示例 除了基础绘图外，Sprite类可以用来处理复杂的位图数据或者动画效果。这里给出一个简单的例子说明它的用途： ```cpp #include <TFT_eSPI.h> TFT_eSPI tft; TFT_eSPISprite mySprite = TFT_eSPISprite(&tft); void setup(){ tft.begin(); mySprite.createSprite(80, 60); // Create a new sprite of width x height pixels. mySprite.fillSprite(TFT_RED); // Fill it with red colour. mySprite.pushSprite(10, 10); // Push this sprite onto main canvas starting from point(x,y). } void loop(){} ``` 在此案例里我们先建立了一个红色的小精灵区域再将其渲染至主画布上[^1]。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值