• sales

    +86-0755-88291180

ESP32-S3-Touch-LCD-2.8 User Guide

Overview

Parameters

ItemsParameters
InterfaceUSB Type-C
ControllerESP32-S3
LCD TypeTFT
LCD ControllerDisplay: ST7789
Touch: CST328
Onboard DevicesPositure Sensor: QMI8658
RTC CLock: PCF85063
PCM Audio Decoder: PCM5101
Micro SD
Battery Charging Manage Module
Dimensions73.06 (H) x 50.54 (V) mm

Onboard Interface


  • 12PIN connector
PINFUNCDescription
GNDGNDGround
VBus5VUSB Power Supply
D-USB differential cable (GPIO19)USB differential cable or as GPIO
D+USB differential cable (GPIO20)USB differential cable or as GPIO
GNDGNDGround
3V33V33.3V external output
SCLSCL (GPIO10)I2C clock pin, cannot be used as GPIO
SDASDA (GPIO11)I2C data pin, cannot be used as GPIO
TXDTXD (GPIO43)UART transmit data or as GPIO
RXDRXD (GPIO44)UART receive data or as GPIO
IO18GPIO18Spare pinout
IO15GPIO15Spare pinout
  • I2C interface
PINOUTFUNCDescription
GNDGNDGround
3V33V33.3V external output
SCLSCL (GPIO10)I2C clock pin, cannot be used as GPIO
SDASDA (GPIO11)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 Interface


Onboard Functions

Internal Hardware COnnection

LCD

LCD pinESP32S3
VCC3.3V
GNDGND
MISONC
MOSIGPIO45
SCLKGPIO40
LCD_CSGPIO42
LCD_DCGPIO41
LCD_RSTGPIO39
LCD_BLGPIO5
TP_SDAGPIO1
TP_SCLGPIO3
TP_INTGPIO4
TP_RSTGPIO2

SD Card

SD CardESP32S3
SD_D0/MISOGPIO16
SD_CMD/MOSIGPIO17
SD_SCK/SCLKGPIO40
SD_D3/CSGPIO21
SD_D1NC (GPIO18)
SD_D2NC (GPIO15)

QMI

QMI8658CESP32S3
IMU_SCLGPIO10
IMU_SDAGPIO11
IMU_INT1GPIO13
IMU_INT2GPIO12

RTC

PCF85063ATLESP32S3
RTC_SCLGPIO10
RTC_SDAGPIO11
RTC_INTGPIO9

Speaker

PCM5101APWRESP32S3
I2S_LRCKGPIO38
I2S_DINGPIO47
I2S_BCKGPIO48

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

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 libraryTFT_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.
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.

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