• sales

    +86-0755-88291180

ESP32-S3-LCD-2.8C User Guide

Overview

Introduction

ESP32-S3-LCD-2.8C is a microcontroller development board that supports 2.4GHz WiFi and BLE 5. It integrates large capacity Flash and PSRAM and has onboard 2.8inch round screen, can smoothly run GUI programs such as LVGL. Combined with various peripheral interfaces, it is suitable for the quick development of the HMI and other ESP32-S3 applications.

Features

  • Equipped with high-performance Xtensa 32-bit LX7 dual-core processor, up to 240MHz main frequency
  • Supports 2.4GHz Wi-Fi (802.11 b/g/n) and Bluetooth 5 (BLE), with onboard antenna
  • Built in 512KB SRAM, 384KB ROM, 8MB PSRAM, and 16MB Flash
  • Onboard 2.8inch round screen with 480×480 resolution
  • Adapting UART, I2C and some IO interfaces, integrates full-speed USB port
  • Onboard QMI8658 6-axis sensor, RTC clock sensor, TF card slot and battery charging management module, etc.
  • Supports accurate control such as flexible clock and multiple power modes to realize low power consumption in different scenarios

Specifications

ItemParameter
InterfaceUSB Type-C / UART Type-C
Controller chipESP32-S3
LCD typeTFT
LCD controller chipDisplay: ST7701
Touch: GT911
Onboard devicesAttitude sensor: QMI8658
RTC clock: PCF85063
TF
Buzzer
Battery recharging manager module
Dimensions95.86±0.1 (R) mm

Onboard Resources


1. ESP32-S3R8
   Dual-core processor, up to 240MHz operating frequency

2. QST attitude sensor
   QMI8658 (six-axis gyro accelerometer)

3. TCA9554PWR
   GPIO expansion chip, fully used, not led out

4. FSUSB42UMX
   UART selection chip:  4PIN UART is disabled when connected to    UART Type-C, 4PIN UART is enabled when not connected to UART    Type-C

5. CH343P
   USB to UART with onboard automatic download circuit,
   enabling program flashing without additional operations

6. 16MB Flash

7. RTC clock chip
   PCF85063 RTC clock

8. Battery recharge manager Chip

9. ME6217C33M5G
   Low dropout regulator, 800mA output (Max.)

10. USB Type-C interface

11. Battery header
   MX1.25 2PIN connector, for 3.7V Lithium battery, supports    charging and discharging

12. 12PIN multi-functional pin header

13. IPEX Gen 1 connector
   Switches to use external antenna via resoldering the    resistor

14. TF card slot

15. RTC battery header
   Connecting the rechargeable RTC battery

16. I2C interface
   Connecting with internal chip, only supports the I2C    peripherals and cannot be mapped to other functions

17. UART interface
   Only available when the USB to UART Type-C port is not    connected

18. USB TO UART Type-C port
   Used for power supply, program download and debugging

19. Buzzer

20. Charge indicator
   When connecting the system battery, lights up when    charging, off when fully charged (the light status
   is uncertain when the battery is not connected)

21. Power indicator

22. Battery power supply control button

23. RESET button

24. BOOT button

Interfaces


  • 12PIN connector
No.PinFunctionDescription
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
63V33V3External output 3.3V
7SCLSCL (GPIO7)I2C clock pin, cannot be used as regular GPIO
8SDASDA (GPIO15)I2C data pin, cannot be used as regular GPIO
9TXDTXD (GPIO43)UART transmit data or as regular GPIO
10RXDRXD (GPIO44)UART receive data or as regular GPIO
11NCNCNot connected
12IO0GPIO0Spare pinout
  • I2C interface
PinFunctionDescription
GNDGNDGround
3V33V3External output 3.3V
SCLSCL (GPIO7)I2C clock pin, cannot be used as regular GPIO
SDASDA (GPIO15)I2C data pin, cannot be used as regular GPIO
  • UART interface
PinFunctionDescription
GNDGNDGround
3V33V3External output 3.3V
TXDTXD (GPIO43)UART transmit data or as regular GPIO
RXDRXD (GPIO44)UART receive data or as regular GPIO

Dimensions

800px-ESP32-S3-LCD-2.8C-intrduction-02.png

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

TF Card

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

QMI

QMI8658ESP32S3
IMU_SCLGPIO7
IMU_SDAGPIO15
IMU_INT1EXIO6
IMU_INT2EXIO5

RTC

PCF85063ATLESP32S3
RTC_SCLGPIO7
RTC_SDAGPIO15
RTC_INTEXIO7

Buzzer

BuzzerESP32S3
Buzzer_ControlEXIO8

BAT

BATESP32S3
BAT_ADCGPIO4

Version Description

This development board includes both touch and non touch versions. Please click on the corresponding product to view the usage instructions.

Usage Instructions

ESP32-S3-LCD-2.8C currently provides two development tools and frameworks, Arduino IDE and ESP-IDF, providing flexible development options, you can choose the right development tool according to your project needs and personal habits.

Development Tools

180px-Arduino-IDE-logo.jpg

Arduino IDE

Arduino IDE is an open source electronic prototyping platform, convenient and flexible, easy to get started. After a simple learning, you can start to develop quickly. At the same time, Arduino has a large global user community, providing an abundance of open source code, project examples and tutorials, as well as rich library resources, encapsulating complex functions, allowing developers to quickly implement various functions.

180px-ESP-IDF-logo.jpg

ESP-IDF

ESP-IDF, or full name Espressif IDE, is a professional development framework introduced by Espressif Technology for the ESP series chips. It is developed using the C language, including a compiler, debugger, and flashing tool, etc., and can be developed via the command lines or through an integrated development environment (such as Visual Studio Code with the Espressif IDF plugin). The plugin offers features such as code navigation, project management, and debugging, etc..


Each of these two development approaches has its own advantages, and developers can choose according to their needs and skill levels. Arduino are suitable for beginners and non-professionals because they are easy to learn and quick to get started. ESP-IDF is a better choice for developers with a professional background or high performance requirements, as it provides more advanced development tools and greater control capabilities for the development of complex projects.

Components Preparation

  • ESP32-S3-LCD-2.8C x 1
  • TF card x 1 (Please use a blank card with a size of 32GB or less to avoid loss or damage of files in the SD card during operation)
  • USB cable (Type-A to Type-C) x 1
Before operating, it is recommended to browse the table of contents to quickly understand the document structure. For smooth operation, please read the FAQ carefully to understand possible problems in advance. All resources in the document are provided with hyperlinks for easy download.

Working with Arduino

This chapter introduces setting up the Arduino environment, including the Arduino IDE, management of ESP32 boards, installation of related libraries, program compilation and downloading, as well as testing demos. It aims to help users master the development board and facilitate secondary development. Arduino-flow-04.png

Environment Setup

Download and Install Arduino IDE

  • Click to visit the Arduino official website, select the corresponding system and system bit to download
  • Run the installer and install all by default
The environment setup is carried out on the Windows 10 system, Linux and Mac users can access Arduino-esp32 environment setup for reference. (To use on Mac, you need to install the MAC driver.)

Install ESP32 Development Board

  • ESP32-S3-LCD-2.8C required development board installation description
Board nameBoard installation requirementInstruction
esp32-XIP-3.0.2"Install Offline"The "esp32-XIP-3.0.2" board must be installed according to the installation tutorial

Install Library

  • When installing Arduino libraries, there are usually two ways to choose from: Install online and Install offline. If the library installation requires offline installation, you must use the provided library file
    For most libraries, users can easily search and install them through the online library manager of the Arduino software. However, some open-source libraries or custom libraries are not synchronized to the Arduino Library Manager, so they cannot be acquired through online searches. In this case, users can only manually install these libraries offline.
  • For library installation tutorial, please refer to Arduino library manager tutorial
  • ESP32-S3-LCD-2.8C library file path:
    ..\ESP32-S3-LCD-2.8C-Demo\Arduino\libraries
  • ESP32-S3-LCD-2.8C library file installation description
Library NameDescriptionVersionLibrary Installation Requirement
LVGLGraphical libraryv8.3.10"Install Offline"
OneButtonButton libraryv2.6.1"Install Offline"
For more learning and use of LVGL, please refer to LVGL official documentation

Demo

Demo-flow-01.png

  • ESP32-S3-LCD-2.8C demos
DemoBasic DescriptionDependency Library
LVGL_ArduinoTest onboard device functionalityLVGL

LVGL_Arduino

Hardware connection


  • Insert the TF card into the development board
  • Connect the development board to the computer

Code analysis


  • Driver_Init ()
    • Initializes multiple hardware components, including flash testing, battery initialization, I2C bus initialization, chip-specific initialization, external IO settings, backlight initialization, real-time clock initialization, and gyroscope initialization, etc., to prepare the hardware for the normal operation of the system
  • Driver_Loop ()
    • As a continuous task, it constantly cycles to handle the gyroscope and real-time clock operations, and retrieves the battery voltage. Loops are executed every 100 milliseconds to avoid overusing CPU resources
  • setup ()
    • The setup function for Arduino, performing a series of initialization operations. It includes wireless module testing, hardware initialization, LCD initialization, TF card initialization, LVGL initialization, invoking LVGL's example functions, and creating a task to perform a hardware loop operation
  • loop()
    • The main loop function of Arduino, primarily calls the LVGL loop processing function, and introduces a 5 millisecond delay to ensure that the system's graphical interface can continuously update

Demo flashing


  • Select the Waveshare ESP32S3 XIP model and port


  • Set development board parameters


  • Flash the demo

Result demonstration


  • LCD screen display
  • After the program is successfully burned, you can use the BOOT button to control the interface
    • Click: Select the next control option
    • Double click: Select the previous control option
    • Long Press: Control the selected control option

ESP32-S3-LCD-2.8C-demo-01.png

  • Parameter description
ParameterFunctionDescription
SD CardDisplay TF card sizeConnect the TF card, if the recognition fails, please format the TF card to FAT32 format (please wait for a while to reset and check again if the recognition fails for the first time)
Flash SizeDisplay Flash sizeCurrent onboard 16MB Flash
Battery VoltageBattery voltageThe battery voltage can be detected when the battery is connected
Angular deflectionDisplay the angular deflection of the boardDisplay the offset in three directions
RTC TimeDisplay RTC timeDisplay current RTC time
If the RTC time is not consistent with the current time, because the data cannot be retained in the power-off state, if you need to keep the RTC time normal, you need to connect the RTC battery and update the RTC time
Wireless scanDisplay the number of scanned WiFiWhen it finishes, display Scan Finish at the end
Backlight brightnessBacklight controlControl backlight brightness
The buzzer testBuzzer control pageCan control buzzer switch

Working with ESP-IDF

This chapter introduces setting up the ESP-IDF environment setup, including the installation of Visual Studio and the Espressif IDF plugin, program compilation, downloading, and testing of demos, to assist users in mastering the development board and facilitating secondary development. ESP-IDF-flow-01.png

Environment Setup

Download and Install Visual Studio

  • Open the download page of VScode official website, choose the corresponding system and system bit to download
  • After running the installation package, the rest can be installed by default, but here for the subsequent experience, it is recommended to check boxes 1, 2, and 3

    • After the first two items are enabled, you can open VSCode directly by right-clicking files or directories, which can improve the subsequent user experience.
    • After the third item is enabled, you can select VSCode directly when you choose how to open it
The environment setup is carried out on the Windows 10 system, Linux and Mac users can access ESP-IDF environment setup for reference

Install Espressif IDF Plugin

  • It is generally recommended to use Install Online. If online installation fails due to network factor, use Install OIffline
  • For more information about how to install the Espressif IDF plugin, see Install Espressif IDF Plugin
  • ESP32-S3-LCD-2.8C required Espressif IDF version description
Plugin namePlugin installation requirementVersion number requirement
Espressif IDF"Install Offline" / "Install Online"≥5.3.1

Demo

Demo-flow-01.png

  • ESP32-S3-LCD-2.8C demos
DemoBasic Description
ESP32-S3-LCD-2.8C-TestTest onboard device functionality

ESP32-S3-LCD-2.8C-Test

Hardware connection


  • Insert the TF card into the development board
    • Connect the development board to the computer

Code analysis


  • Driver_Init()
    • This function performs hardware initialization and creates a task. It initializes the flash memory (possibly for checking or preparation), the battery, the I2C bus, the real-time clock, the gyroscope, and external IO. Then create a task Driver_Loop that continuously processes the gyroscope, the real-time clock, and gets the battery voltage, executing a loop operation every 100 milliseconds.
  • Driver_Loop()
    • As a continuous task, it cycles through the gyroscope and real-time clock operations, and retrieves the battery voltage. In this way, the status of these hardware devices is continuously updated.
  • app_main (): Drives the onboard device
    • This is the main entry function of the program. First initialize the wireless module, and then call Driver_Init for hardware initialization. Next, initialize the LCD display, TF card, LVGL graphics library and analog touch input in sequence. Calling the example function Lvgl_Example1 of LVGL demonstrates specific graphical interface effects. In the main loop, it delays once every 10 milliseconds and calls lv_timer_handler to handle LVGL's timer events, ensuring the normal operation and updates of the graphical interface.

Result demonstration


  • LCD screen display
  • After the program is successfully burned, you can use the BOOT button to control the interface
    • Click: Select the next control option
    • Double click: Select the previous control option
    • Long Press: Control the selected control option

ESP32-S3-LCD-2.8C-demo-01.png

  • Parameter description
ParameterFunctionDescription
SD CardDisplay TF card sizeConnect the TF card, if the recognition fails, please format the TF card to FAT32 format (please wait for a while to reset and check again if the recognition fails for the first time)
Flash SizeDisplay Flash sizeCurrent onboard 16MB Flash
Battery VoltageBattery voltageThe battery voltage can be detected when the battery is connected
Angular deflectionDisplay the angular deflection of the boardDisplay the offset in three directions
RTC TimeDisplay RTC timeDisplay current RTC time
If the RTC time is not consistent with the current time, because the data cannot be retained in the power-off state, if you need to keep the RTC time normal, you need to connect the RTC battery and update the RTC time
Wireless scanDisplay the number of scanned WiFiWhen it finishes, display Scan Finish at the end
Backlight brightnessBacklight controlControl backlight brightness
The buzzer testBuzzer control pageCan control buzzer switch

Flash Firmware Flashing and Erasing


  • The current demo provides test firmware, which can be used to test whether the onboard device functions properly by directly flashing the test firmware
  • bin file path:
    ...\ESP32-S3-LCD-2.8C-Demo\Firmware

Resources

Schematic Diagram

Demo

Project Diagram

Driver

Datasheets

ESP32-S3

Display

Other Components

Software Tools

Arduino

VScode

Firmware Flashing Tool

FAQ

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

 Answer:
  • Click the Reset button for more than 1 second, wait for the PC to re-recognize the device and then download again
  • 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.


Question: Why does the module keep resetting and flicker when viewed the recognition status from the device manager?

 Answer:

It may be due to Flash blank and the USB port is not stable, you can long-press the BOOT button, press RESET at the same time, and then release RESET, and then release the BOOT button, at this time the module can enter the download mode to flash the firmware (demo) to solve the situation.


Question: How to deal with the first compilation of the program being extremely slow?

 Answer:
  • It's normal for the first compilation to be slow, just be patient


Question: What should I do if I can't find the AppData folder?

 Answer:
  • Some AppData folders are hidden by default and can be set to show.
  • English system: Explorer->View->Check "Hidden items"
  • Chinese system: File Explorer -> View -> Display -> Check "Hidden Items"


Question: How do I check the COM port I use?

 Answer:
  • Windows system:

①View through Device Manager: Press the Windows + R keys to open the "Run" dialog box; input devmgmt.msc and press Enter to open the Device Manager; expand the "Ports (COM and LPT)" section, where all COM ports and their current statuses will be listed.
②Use the command prompt to view: Open the Command Prompt (CMD), enter the "mode" command, which will display status information for all COM ports.
③Check hardware connections: If you have already connected external devices to the COM port, the device usually occupies a port number, which can be determined by checking the connected hardware.

  • Linux system:

①Use the dmesg command to view: Open the terminal.
①Use the ls command to view: Enter ls /dev/ttyS* or ls /dev/ttyUSB* to list all serial port devices.
③Use the setserial command to view: Enter setserial -g /dev/ttyS* to view the configuration information of all serial port devices.


Question: Why does ESP-IDF report this error?

 Answer:
  • This situation is that the TF card is not installed or the TF card cannot be recognized. If this situation occurs, please wait for a period of time to reset the device. If it still cannot be resolved, please format the TF card to FAT32 format. If it still fails, please try a different TF card


Question: Why does the program flashing fail when using a MAC device?

 Answer:


Question: Why is there no output after successfully flashing the code with no issues?

 Answer:
  • Check the schematic diagram for different development boards with Type-C interfaces, and handle the output accordingly:
    • For development boards with direct USB output, printf function is supported for printing output. If you want to support output via the Serial function, you will need to enable the USB CDC On Boot feature or declare HWCDC.
    • For development boards with UART to USB conversion, both printf and Serial functions are supported for printing output, and there is no need to enable USB CDC On Boot.


Question: RGB screen issues

 Answer:
  • The screen supports 262k color, but due to ESP limitations, RGB565 is used, and it is actually 65k


Question: How to use SquareLine Studio to design interfaces?

 Answer:


Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com


[Tutorial Navigation]