Arduino开发-TFT_eSPI库学习

最新推荐文章于 2025-03-03 12:08:40 发布

_墨笺_

最新推荐文章于 2025-03-03 12:08:40 发布

阅读量3.7w

点赞数 43

分类专栏： arduino开发文章标签： arduino 驱动开发物联网嵌入式硬件

本文链接：https://blog.csdn.net/weixin_51037539/article/details/120453447

版权

本文详细介绍TFT_eSPI库的安装配置及常用API。包括配置文件详解、SPI驱动介绍、初始化过程、文字图片绘制方法及Sprite类使用技巧。适合初学者快速掌握TFT_eSPI库。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

TFT_eSPI库学习

文章目录

TFT_eSPI库学习

TFT_eSPI库是通过SPI方式驱动LCD屏幕的一个Arduino库，并且支持PlatformIOIDE一键下载使用。对于Arduino模式开发的屏幕开发既便捷又稳定。
同时LVGLGUI开发的底层驱动接口也是使用TFT_eSPI库的API。

TFT_eSPI库安装以及配置

基于PlatformIO IDE 讲解。

在这里插入图片描述

首先在Libraries里面搜索安装TFT_eSPI库到你的工程文件里面。

在这里插入图片描述

TFT_eSPI库文件目录

TFT_eSPI是基于SPI通信的图形驱动库，所以，使用时需要芯片支持SPI通信，并且确保工程中已经引入了Arduino的 SPI.h 等SPI通信的库文件。

在这里插入图片描述

配置文件

有两种方法，一种就是通过User_Setup_.h进行配置，可以配置驱动型号以及所有需要修改的信息。
另一种就是在User_Setup_Select.h中先选择驱动芯片型号，然后在TFT_Driver文件夹中的驱动配置文件中配置各种信息。

1.User_Setup_.h

首先选择驱动型号如：#define ST7789_2_DRIVER ，将注释去掉即可。
配置屏幕大小
设置GBR显示的LCD屏幕的显示转换
配置引脚
文件中已经定义好了可以使用的引脚，如果需要修改的话，取消注释后修改相应引脚的值即可
配置SPI速率
设置SPI的通信速率，根据硬件芯片的性能设置（一般保持默认即可）

2. User_Setup_Select.h

对于学习，小作品开发不推荐，最好在User_Setup.h中进行配置，便于修改和查找。

直接在文件中取消LCD驱动芯片的头文件注释即可。引脚定义按照默认，或者在文件中进行修改（没有使用过）。

3. Rotation.h- 镜像设置

//屏幕选择函数
TFT_eSPI tft = TFT_eSPI();
tft.setRotation(4);//1-3是90度到270度旋转
/*
要实现镜像的话
需要在驱动的Rotation.h里面进行设置
在switch语句中添加case 4选项
代码如下
*/
   case 4: // Inverter portrait & Mirror Y
#ifdef CGRAM_OFFSET
	if (_init_width == 135)
	{
   
		colstart = 53;
		rowstart = 40;
	}
	else
	{
   
		colstart = 0;
		rowstart = 0;
	}
#endif
	writedata(TFT_MAD_MX | TFT_MAD_COLOR_ORDER);

	_width = _init_width;
	_height = _init_height;
	break;
/*
然后使用函数tft.setRotation(4);即可。
*/

TFT_eSPI库常用API

初始化

屏幕对象实例化

TFT_eSPI::TFT_eSPI(int16_t w, int16_t h)
//设定屏幕大小
TFT_eSPI tft = TFT_eSPI(240, 240);

参数：宽度和高度

初始化

tft.init();

设置屏幕方向

tft.serRotation(3);

参数为：0, 1, 2, 3 分别代表 0°、90°、180°、270°，可设置4为镜像。

RGB颜色转GBR565

uint16_t TFT_eSPI::color565(uint8_t r, uint8_t g, uint8_t b)
// 颜色转换
uint16_t yellow = tft.color565(255, 255, 0);
tft.setTextColor(yellow); //

清屏函数

void TFT_eSPI::fillScreen(uint32_t color)
//清理屏幕 默认颜色，可以设置不同的颜色
tft.fillScreen(TFT_BLACK);

常用函数

1. eSPI类

文字

void TFT_eSPI::setTextSize(uint8_t s)
//设置字体大小为2
tft.setTextSize(2);

void TFT_eSPI::setTextColor(uint16_t c)
//字体颜色 绿色
tft.setTextColor(TFT_GREEN);

void TFT_eSPI::setCursor

最低0.47元/天解锁文章