LilyGO T-Display S3 Arduino开发板设置与示例教程

项目介绍

LilyGO T-Display S3是一款基于ESP32-S3的开发板，配备1.9英寸TFT触摸显示屏。该项目提供了详细的设置指南和多个经过测试的示例代码，帮助开发者快速上手并进行嵌入式开发。

环境准备与安装

下载项目代码

首先需要下载项目代码到本地：

git clone https://gitcode.com/gh_mirrors/li/LilyGO-T-display-S3-setup-and-examples

Arduino IDE配置

1. 安装最新版本Arduino IDE
2. 在文件->首选项的附加开发板管理器网址中添加：

   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
   

3. 打开工具->开发板->开发板管理器，搜索并安装esp32

开发板设置

在Arduino IDE中按照以下参数配置开发板：

• 开发板：ESP32S3 Dev Module
• USB CDC On Boot：Enable
• CPU频率：240MHz (WiFi)
• Flash大小：16MB (128Mb)
• 分区方案：16M Flash (3M APP/9.9MB FATFS)
• PSRAM：OPI PSRAM
• 上传速度：921600

LilyGO TFT库配置

安装必要的库文件

从LilyGO官方GitHub下载T-Display-S3库文件，将lib文件夹中的内容复制到Arduino的libraries文件夹中。

配置用户设置

编辑TFT_eSPI库中的User_Setup_Select.h文件，取消注释以下行：

#include <User_Setups/Setup206_LilyGo_T_Display_S3.h>

同时注释掉默认设置：

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

常见问题解决方案

LCD不显示问题

在代码声明部分添加：

#define PIN_POWER_ON 15  // LCD和电池电源使能
#define PIN_LCD_BL 38    // 背光使能引脚

在setup函数中添加：

pinMode(PIN_POWER_ON, OUTPUT);
pinMode(PIN_LCD_BL, OUTPUT);
digitalWrite(PIN_POWER_ON, HIGH);
digitalWrite(PIN_LCD_BL, HIGH);

串口监视器无法显示

确保在开发板设置中将USB CDC On Boot设置为Enable。

电池供电问题

添加电源使能引脚配置以启用电池供电功能。

项目示例

HotHead示例

HotHead示例演示了开发板的常见功能，包括显示屏控制、触摸功能和基本交互。

背光调光功能

项目提供了背光调光功能，可以通过PWM控制LCD背光亮度。详细说明见LCD DimmerNEW.txt文件。

ESP-NOW通信

包含ESP-NOW协议的示例代码，实现设备间的无线通信。

开发板引脚图

技术规格

• 主控芯片：ESP32-S3
• 显示屏：1.9英寸TFT触摸屏，170x320分辨率
• 内存：8MB PSRAM
• 存储：16MB Flash
• 通信接口：USB-C, WiFi, Bluetooth
• 电源：USB供电或锂电池供电

应用场景

智能家居控制面板

利用触摸屏显示家庭设备状态并进行控制。

物联网数据监控

实时显示传感器数据，支持ESP-NOW无线通信。

教育开发

丰富的示例代码适合嵌入式系统学习和开发。

最佳实践

1. 在开始新项目前，先运行HotHead示例验证硬件功能
2. 使用提供的User_Setup_Select.h文件确保正确的显示配置
3. 注意电源管理，特别是电池供电时的功耗优化
4. 充分利用ESP32-S3的双核处理能力

通过本教程，您可以快速上手LilyGO T-Display S3开发板，利用其丰富的硬件资源和示例代码进行项目开发。