• sales

    +86-0755-88291180

ESP32-S3-Touch-LCD-2.1 User Guide

Overview

Parameters

ItemsParameters
InterfaceUSB Type-C/UART Type-C
ControllerESP32-S3
LCD TypeTFT
LCD ControllerDisplay: ST7701
Touch: CST820
Onboard DevicesAttitude sensor: QMI8658
RTC clock: PCF85063
Micro SD
Buzzer
Battery Recharging Manager Module
Dimensions75.00±0.1 (R) mm

Onboard Interface

  • 12PIN connector
PIN NO.PINFUNCDescription
1GNDGNDGround
2VBus5VUSB Power Supply
3D-USB differential cable(GPIO19)USB differential cable or as GPIO
4D+USB differential cable(GPIO20)USB differential cable or as GPIO
5GNDGNDGround
63V33V33.3V external output
7SCLSCL (GPIO7)I2C clock pin, cannot be used as GPIO
8SDASDA (GPIO15)I2C data pin, cannot be used as GPIO
9TXDTXD (GPIO43)UART transmit data or as GPIO
10RXDRXD (GPIO44)UART receive data or as GPIO
11NCNCNot connected
12IO0GPIO0Spare pinout
  • I2C interface
PINOUTFUNCDescription
GNDGNDGround
3V33V33.3V external output
SCLSCL (GPIO7)I2C clock pin, cannot be used as GPIO
SDASDA (GPIO15)I2C data pin, cannot be used as GPIO
  • UART interface
PINOUTFUNCDescription
GNDGNDGround
3V33V33.3V external outpout
TXDTXD (GPIO43)UART transmit data or used as GPIO
RXDRXD (GPIO44)UART receive data or used as GPIO

Onboard Functions

Internal Hardware Connection

LCD

LCD PINESP32S3
LCD_BLGPIO6
LCD_RSTEXIO1
LCD_SDAGPIO1
LCD_SCLGPIO2
LCD_CSEXIO3
PCLKGPIO41
DEGPIO40
VSYNCGPIO39
HSYNCGPIO38
B0NC
B1GPIO5
B2GPIO45
B3GPIO48
B4GPIO47
B5GPIO21
G0GPIO14
G1GPIO13
G2GPIO12
G3GPIO11
G4GPIO10
G5GPIO9
R0NC
R1GPIO46
R2GPIO3
R3GPIO8
R4GPIO18
R5GPIO17
TP_SDAGPIO15
TP_SCLGPIO7
TP_INTGPIO16
TP_RSTEXIO2

SD Card

SD CardESP32S3
SD_D0/MISOGPIO42
SD_CMD/MOSIGPIO1
SD_SCK/SCLKGPIO2
SD_D3/CSEXIO4
SD_D1NC
SD_D2NC

QMI

QMI8658CESP32S3
IMU_SCLGPIO7
IMU_SDAGPIO15
IMU_INT1GPIO6
IMU_INT2GPIO5

RTC

PCF85063ATLESP32S3
RTC_SCLGPIO7
RTC_SDAGPIO15
RTC_INTGPIO7

Speaker

BuzzerESP32S3
Buzzer_ControlEXIO8

Working with Arduino

  • Please note that the ESP32 3.0.2 on Arduino is based on ESP-IDF v5.1, which is quite different from the previous ESP-IDF V4.X. After the following operations, the original demo may need to be adjusted for normal operation.
  • Please note that the computer user name must be English, the user name in Chinese will lead to compilation errors.

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 Environment and Install Library Files

Modify Environment

  • Enter the path "C:\Users\Waveshare\AppData\Local\Arduino15\packages\esp32\tools\esp32-arduino-libs\idf-release_v5.1-bd2b9390ef" (Waveshare is the computer username).


  • Save the esp32s3 folder in the current folder.
  • Please save the original esp32s3 folder used for subsequent restoration!!!! (You can compress the file directly and make a copy to another location, currently the original file is compressed to esp32s3 - Original file.zip)


  • Delete the original file (Please save the original esp32s3 folder used for subsequent restoration!!!!)


  • Copy the provided esp32s3 file to the current directory:



  • Complete the modification of ESP32S3 configuration.


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.1\LVGL_Arduino", double-click on LVGL_Arduino.ino to open it.
  • Search for the 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 exists, you can skip this step.)



  • Enter "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" (Waveshare is the computer username).


  • 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, 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.
  • 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.
ParametersFunctionDescription
SD CardDisplay SD card sizePlease note that only SD cards with below 16GB are supported
Flash SizeDisplay Flash sizeThe current onboard 16MB Flash
Angular deflectionDisplay the angular deflection of the boardDisplay the deflection of threen orientations
RTC TimeDisplay RTC timeDisplay 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 numberDisplay the scanned WiFi and Bluetooth numbersWhen 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.