ESP32-S3-Touch-LCD-2.8

ESP32-S3-Touch-LCD-2.8 2.8inch 240×320 I2C, SPI

{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

Primary Attribute Category: {{{userDefinedInfo}}}: {{{userdefinedvalue}}} Brand: Waveshare

Website International: Website Chinese: [1]

Onboard Interfaces

Related Products

Overview

Parameters

Items	Parameters
Interface	USB Type-C
Controller	ESP32-S3
LCD Type	TFT
LCD Controller	Display: ST7789
	Touch: CST328
Onboard Devices	Positure Sensor: QMI8658
	RTC CLock: PCF85063
	PCM Audio Decoder: PCM5101
	Micro SD
	Battery Charging Manage Module
Dimensions	73.06 (H) x 50.54 (V) mm

Onboard Interface

• 12PIN connector

PIN	FUNC	Description
GND	GND	Ground
VBus	5V	USB Power Supply
D-	USB differential cable (GPIO19)	USB differential cable or as GPIO
D+	USB differential cable (GPIO20)	USB differential cable or as GPIO
GND	GND	Ground
3V3	3V3	3.3V external output
SCL	SCL (GPIO10)	I2C clock pin, cannot be used as GPIO
SDA	SDA (GPIO11)	I2C data pin, cannot be used as GPIO
TXD	TXD (GPIO43)	UART transmit data or as GPIO
RXD	RXD (GPIO44)	UART receive data or as GPIO
IO18	GPIO18	Spare pinout
IO15	GPIO15	Spare pinout

• I2C interface

PINOUT	FUNC	Description
GND	GND	Ground
3V3	3V3	3.3V external output
SCL	SCL (GPIO10)	I2C clock pin, cannot be used as GPIO
SDA	SDA (GPIO11)	I2C data pin, cannot be used as GPIO

• UART interface

PINOUT	FUNC	Description
GND	GND	Ground
3V3	3V3	3.3V external outpout
TXD	TXD (GPIO43)	UART transmit data or used as GPIO
RXD	RXD (GPIO44)	UART receive data or used as GPIO

Onboard Interface

Onboard Functions

Internal Hardware COnnection

LCD

LCD pin	ESP32S3
VCC	3.3V
GND	GND
MISO	NC
MOSI	GPIO45
SCLK	GPIO40
LCD_CS	GPIO42
LCD_DC	GPIO41
LCD_RST	GPIO39
LCD_BL	GPIO5
TP_SDA	GPIO1
TP_SCL	GPIO3
TP_INT	GPIO4
TP_RST	GPIO2

SD Card

SD Card	ESP32S3
SD_D0/MISO	GPIO16
SD_CMD/MOSI	GPIO17
SD_SCK/SCLK	GPIO40
SD_D3/CS	GPIO21
SD_D1	NC (GPIO18)
SD_D2	NC (GPIO15)

QMI

QMI8658C	ESP32S3
IMU_SCL	GPIO10
IMU_SDA	GPIO11
IMU_INT1	GPIO13
IMU_INT2	GPIO12

RTC

PCF85063ATL	ESP32S3
RTC_SCL	GPIO10
RTC_SDA	GPIO11
RTC_INT	GPIO9

Speaker

PCM5101APWR	ESP32S3
I2S_LRCK	GPIO38
I2S_DIN	GPIO47
I2S_BCK	GPIO48

Working with Arduino

Environment Set-up

• Install Arduino IDE.

• Enter Arduino IDE after installation.

• Go to the board manager, search for esp32, select the latest version of esp32 by Espressif Systems at the bottom, and click install (if it doesn't install correctly, you can try using a phone hotspot).

• Restart the Arduino IDE after installation, and then you can use it.

• Modify the location of the above project file folder as c:\Users\Waveshare\AppData\Local\Arduino15\packages (Waveshare is the computer username).

• Restart Arduino IDE

If the installation fails

• Failed to install 2.0.11 version:

• Download the resource file:

• Click on the path from the resource manager "c:\Users\Waveshare\AppData\Local\Arduino15\staging\packages" (Waveshare is the user name of the computer, and you need to turn on Show Hidden Files).

• Unzip the downloaded files to the packages file folder:

• Install it again:

• Restart the Arduino IDE after installation and you're ready to go!

• Change the above project file folder as c:\Users\Waveshare\AppData\Local\Arduino15\packages(Waveshare is the PC username).

• Restart the Arduino IDE.

Install Libraries

• Please note if this library has already been installed previously. If it has, please save the existing library to prevent errors or failures when running other demos.
• Enter the sample demo file "ESP32_S3_Touch_LCD_2.8\LVGL_Arduino", double-click on LVGL_Arduino.ino to open it.
• Search for lvgl library and install it (this step is for creating the library file folder in Arduino environment, if you have installed other libraries before and the following file folder exist, you can skip this step.)

• Enter "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" (Waveshare is the computer username). This is done by going to libraries in the project folder directory, if you are not sure which folder it is in please go to Preferences to check.

• Delete the lvgl library downloaded before (skip this step if you do not install this library before).

• Please install the three libraries from the example file and create a new "Lib" folder in the example path.

• Download and unzip the following libraries:（lvgl library, TFT_eSPIlibrary and audioI2S library), and then store them in the newly created "Lib" folder in the specified path.
• Copy the above libraries in "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" (Waveshare is the computer username)

• Next, install NTPClient library:

• Install SensorLib library:

• Finish.

Sample Demo

• Reopen the example, and follow the steps below to display. The example demonstrates the functionalities of SD Card, Flash, QMI8658, RTC, WIFI, Bluetooth, and audio playback.
• Select the model ESP32S3 Dev Module and port:

• Set the board parameters:

• Compile and upload the example:

• Upon successful upload, you will observe two operational pages.
• Page 1 displays the following parameters separately.

Parameters	Function	Description
SD Card	Display SD card size	Please note that only SD cards with below 16GB are supported
Flash Size	Display Flash size	The current onboard 16MB Flash
Angular deflection	Display the angular deflection of the board	Display the deflection of threen orientations
RTC Time	Display RTC time	Display the current RTC time If the RTC time is not consistent with the current time, it is because the power-down state does not retain data, if you need to keep the RTC time normal, you need to connect the RTC battery and update the RTC time.
Wireless number	Display the scanned WiFi and Bluetooth numbers	When it finishes, display "Scan Finish" at the end.

• Page 2 is the UI page for playing mp3 audio from the root directory of the SD card.

Project Reference

Products using the ESP32 in the Arduino IDE playability is relatively high, can be in the framework of the existing program can simply modify the UI interface to achieve cool operation. In some open-source platform resources can also be used directly with minor modifications, the more classic ones are as follows:

Github

• Partial simulation mini-games

Resource

Document

Schematic

• Schematic

ESP32-S3

• ESP32-S3 Series Datasheet
• ESP32-S3 Technical Reference Manual

LCD

• ST7789T3 Datasheet

Program

Library Files

• lvgl library
• TFT_eSPIlibrary
• audioI2S library

Sample Demo

• Demo

FAQ

Question:The module appears to be reset all the time, and the recognition status will be flashing when viewed from the device manager?

 Answer:

This situation may be due to Flash blank USB port instability, you can long press the BOOT button, while pressing RESET, and then release RESET, and then release the BOOT button, at this time, the module can enter the download mode to burn the firmware (program) can be resolved to solve the situation.

{{{5}}}

Question:After the module downloads the program and re-downloads it, sometimes it can't connect to the serial port or the burning fails?

 Answer:

You can long press the BOOT button, press RESET at the same time, then release RESET, then release the BOOT button, at this time the module can enter the download mode, which can solve most of the problems that can not be downloaded.

{{{5}}}

Support

Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)

Submit Now