ESP32-S3-LCD-2.8B
| Primary Attribute | |||||
|---|---|---|---|---|---|
| Category: | |||||
| {{{userDefinedInfo}}}: | {{{userdefinedvalue}}} | ||||
| Brand: Waveshare | |||||
| Website | |||||
|---|---|---|---|---|---|
| International: {{{website_en}}} | |||||
| Chinese: {{{website_cn}}} | |||||
| Onboard Interfaces | |||||
|---|---|---|---|---|---|
| Related Products | |
|---|---|
Overview
Introduction
ESP32-S3-LCD-2.8B 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 RGB 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 RGB screen with ×ばつ640 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
47.9 mm * 66.7 mm (Without touch control)
52.9 mm * 71.3 mm (With touch control)
LCD Screen Parameters
ESP32-S3-LCD-2.8B-introduction-06.jpg
Onboard Resources
ESP32-S3-LCD-2.8B-introduction-02.png
1. ESP32-S3R8
Dual-core processor, up to 240MHz operating frequency
2. 16MB Flash
3. QST attitude sensor
QMI8658 (six-axis gyro accelerometer)
4. SMD antenna
5. TCA9554PWR
GPIO expansion chip, fully used, not led out
6. RTC clock chip
PCF85063 RTC clock
7. MP1605GTF-Z
Power module with current 2A (MAX)
8. Battery recharge manager Chip
9. Buzzer
10. TF card slot (back)
11. BOOT button
12. RESET button
13. IPEX Gen 1 connector
Switches to use external antenna via resoldering the resistor
14. 2*12PIN 2.54mm header
15. RTC battery header
Connecting the rechargeable RTC battery
16. Battery header
MX1.25 2PIN connector, for 3.7V Lithium battery, supports charging and discharging
17. UART interface
18. Charge indicator
19. USB Type-C interface
Used for power supply, program download and debugging
20. Power indicator
21. I2C interface
Connecting with internal chip, only supports the I2C peripherals and cannot be mapped to other functions
22. Battery power supply control button
Interfaces
600px-ESP32-S3-LCD-2.8B-introduction-05.jpg
- 12*2PIN 2.54mm header
- UART interface
- I2C interface
Dimensions
Without Touch Control
ESP32-S3-LCD-2.8B-introduction-03.jpg
With Touch Control
ESP32-S3-LCD-2.8B-introduction-04.jpg
Internal Hardware Connection
LCD
TF Card
QMI
RTC
Buzzer
BAT
Version Description
Usage Instructions
ESP32-S3-LCD-2.8B 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 IDEArduino 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-IDFESP-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.8B x1
- TF card x 1
- USB cable (Type-A to Type-C) x 1
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
ESP32-S3-AMOLED-1.91-Ar-software-01.png - Run the installer and install all by default
Install ESP32 Development Board
- Must first install the development board esp32-XIP-3.0.2.
- Only supports Install Offline.
- For installation tutorials, please refer to esp32-XIP-3.0.2 Development board installation.
| Board name | Board installation requirement | Instruction |
|---|---|---|
| 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.8B library file path:
..\ESP32-S3-LCD-2.8B-Demo\Arduino\libraries
| Library Name | Description | Version | Library Installation Requirement |
|---|---|---|---|
| LVGL | Graphical library | v8.3.10 | "Install Offline" |
| OneButton | Button library | v2.6.1 | "Install Offline" |
Run the First Arduino Demo
New Project
- Run the Arduino IDE and select
File->New Sketch
ESP32-S3-AMOLED-1.91-Ar-study-01.png - Enter the code:
void setup() {
// put your setup code here, to run once:
Serial.begin(115200);
}
void loop() {
// put your main code here, to run repeatedly:
Serial.println("Hello, World!");
delay(2000);
}
- Save the project and select
File->Save As.... In the pop-up menu, select the path to save the project, and enter a project name, such as Hello_World, clickSave
ESP32-S3-AMOLED-1.91-Ar-study-02.png
Compile and Flash Demos
- Select the corresponding development board, take the ESP32S3 motherboard as an example:
1. Click to select the dropdown menu option Select Other Board and Port;
2. Search for the required development board model esp32s3 dev module and select;
3. Select COM Port;
4. Save the selection.
ESP32-S3-AMOLED-1.91-Ar-study-03.png
- If the ESP32S3 mainboard only has a USB port, you need to enable USB CDC, as shown in the following diagram:
ESP32-S3-AMOLED-1.91-Ar-study-04.png
- Compile and upload the program:
1. Compile the program; 2. Compile and download the program; 3. Download successful.
ESP32-S3-AMOLED-1.91-Ar-study-05.png
- Open the Serial Monitor window, and the demo will print "Hello World!" every 2 seconds, and the operation is as follows:
Demo
| Demo | Basic Description | Dependency Library |
|---|---|---|
| LVGL_Arduino | Test onboard device functionality | LVGL |
LVGL_Arduino
Hardware connection
- Insert the TF card into the development board (can be used without a TF card)
- 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
ESP32-S3-Touch-LCD-2.8C example 1.png
- Set development board parameters
ESP32-S3-Touch-LCD-2.8C-demo-01.png
- Flash the demo
Result demonstration
- LCD screen display
- After the program is successfully flashed, 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
- Parameter description
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
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
ESP32-S3-AMOLED-1.91-VScode-01.png - 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
ESP32-S3-AMOLED-1.91-VScode-02.png- 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.
Install Espressif IDF Plugin
- It is generally recommended to use Install Online. If online installation fails due to network factor, use Install Offline
- For more information about how to install the Espressif IDF plugin, see Install Espressif IDF Plugin
| Plugin name | Plugin installation requirement | Version number requirement |
|---|---|---|
| Espressif IDF | "Install Offline" / "Install Online" | ≥5.3.1 |
Run the First ESP-IDF Demo
New Project
ESP32-S3-AMOLED-1.91-study-01.png
ESP32-S3-AMOLED-1.91-study-02.png
Create Demo
- Using the shortcut F1, enter esp-idf:show examples projects
ESP32-S3-AMOLED-1.91-study-03.png
- Select your current IDF version
ESP32-S3-AMOLED-1.91-study-04.png
- Take the Hello world demo as an example
1Select the corresponding demo
2Its readme will state what chip the demo applies to (how to use the demo and the file structure are described below, omitted here)
3Click to create the demo
ESP32-S3-AMOLED-1.91-study-05.png
- Select the path to save the demo, and require that the demos cannot use folders with the same name
ESP32-S3-AMOLED-1.91-study-06.png
Modify COM Port
- The corresponding COM ports are shown here, click to modify them
- Please select the COM ports according to your device (You can view it from the device manager)
- In case of a download failure, please press the Reset button for more than 1 second or enter download mode, and wait for the PC to recognize the device again before downloading once more
ESP32-S3-AMOLED-1.91-study-07.png
Modify Driver Object
- Select the object we need to drive, which is our main chip ESP32S3
ESP32-S3-AMOLED-1.91-study-08.png
- Choose the openocd path, it doesn't affect us here, so let's just choose one
ESP32-S3-AMOLED-1.91-study-09.png
Other Status Bar Functions
1.ESP-IDF Development Environment Version Manager, when our project requires differentiation of development environment versions, it can be managed by installing different versions of ESP-IDF. When the project uses a specific version, it can be switched to by utilizing it
2.Device flashing COM port, select to flash the compiled program into the chip
3.Select set-target chip model, select the corresponding chip model, for example, ESP32-P4-NANO needs to choose esp32p4 as the target chip
4.menuconfig, click it to modify sdkconfig configuration file, please refer to project configuration details
5.fullclean button, when the project compilation error or other operations pollute the compiled content, you can clean up all the compiled content by clicking it
6.Build project, when a project satisfies the build, click this button to compile
7.Current download mode, the default is UART
8.flash button, when a project build is completed, select the COM port of the corresponding development board, and click this button to flash the compiled firmware to the chip
9.monitor enable flashing port monitoring, when a project passes through Build --> Flash, click this button to view the log of output from flashing port and debugging port, so as to observe whether the application works normally
10.Debug
11.Build Flash Monitor one-click button, which is used to continuously execute Build --> Flash --> Monitor, often referred to as "little flame"
ESP32-S3-AMOLED-1.91-study-10.png
Compile, Flash and Serial Port Monitor
- Click on the all-in-one button we described before to compile, flash and open the serial port monitor
ESP32-S3-AMOLED-1.91-study-11.png
- It may take a long time to compile especially for the first time
ESP32-S3-AMOLED-1.91-study-12.png
- During this process, the ESP-IDF may take up a lot of CPU resources, so it may cause the system to lag
- If it is the first time to flash the program for a new project, you will need to select the download method, and select UART
ESP32-S3-AMOLED-1.91-study-13.png
- This can also be changed later in the Download methods section (click on it to pop up the options)
ESP32-S3-AMOLED-1.91-study-14.png
- As it comes with the onboard automatic download circuit, it can be downloaded automatically without manual operation
- After successful download, it will automatically enter the serial monitor, you can see the chip output the corresponding information and be prompted to restart after 10S
ESP32-S3-AMOLED-1.91-study-15.png
Use the IDF Demos
Open In the Software
- Open VScode software and select the folder to open the demo
ESP32-S3-AMOLED-1.91-study-16.png
- Select the provided ESP-IDF example and click to select the file (located in the /Demo/ESP-IDF path under demo)
ESP32-S3-AMOLED-1.91-study-17.png
Open from Outside the Software
- Select the project directory correctly and open the project, otherwise it will affect the compilation and flashing of subsequent programs
ESP32-S3-AMOLED-1.91-study-18.png
- After connecting the device, select the COM port and model, click below to compile and flash to achieve program control
ESP32-S3-AMOLED-1.91-study-19.png
ESP-IDF Project Details
- Component: The components in ESP-IDF are the basic modules for building applications, each component is usually a relatively independent code base or library, which can implement specific functions or services, and can be reused by applications or other components, similar to the definition of libraries in Python development.
- Component reference: The import of libraries in the Python development environment only requires to "import library name or path", while ESP-IDF is based on the C language, and the importing of libraries is configured and defined through
CMakeLists.txt. - The purpose of CmakeLists.txt: When compiling ESP-IDF, the build tool
CMakefirst reads the content of the top-levelCMakeLists.txtin the project directory to read the build rules and identify the content to be compiled. When the required components and demos are imported into theCMakeLists.txt, the compilation toolCMakewill import each content that needs to be compiled according to the index. The compilation process is as follows:
- Component reference: The import of libraries in the Python development environment only requires to "import library name or path", while ESP-IDF is based on the C language, and the importing of libraries is configured and defined through
Demo
| Demo | Basic Description |
|---|---|
| ESP32-S3-LCD-2.8B-Test | Test onboard device functionality |
ESP32-S3-LCD-2.8B-Test
Hardware connection
- Insert the TF card into the development board (can be used without a TF card)
- 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, the battery, the I2C bus, the real-time clock, the gyroscope, and external IO. Then create a task
Driver_Loopthat continuously processes the gyroscope, the real-time clock, and gets the battery voltage, executing a loop operation every 100 milliseconds.
- This function performs hardware initialization and creates a task. It initializes the flash memory, the battery, the I2C bus, the real-time clock, the gyroscope, and external IO. Then create a task
- 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_Initfor hardware initialization. Next, initialize the LCD display, TF card, LVGL graphics library and analog touch input in sequence. Calling the example functionLvgl_Example1of LVGL demonstrates specific graphical interface effects. In the main loop, it delays once every 10 milliseconds and callslv_timer_handlerto handle LVGL's timer events, ensuring the normal operation and updates of the graphical interface.
- This is the main entry function of the program. First initialize the wireless module, and then call
Result demonstration
- LCD screen display
- After the program is successfully flashed, 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
- Parameter description
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
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.8B-Demo\Firmware
Resources
Schematic Diagram
Demo
Driver
Datasheets
ESP32-S3
Display
Other Components
Software Tools
Arduino
- Arduino IDE Official download link
- ESP32-Arduino official documentation
- Arduino-ESP32 offline component package
VScode
Firmware Flashing Tool
Other Resource Links
FAQ
- 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.
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.
- It's normal for the first compilation to be slow, just be patient
- 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"
- Windows system:
1View 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.
2Use the command prompt to view: Open the Command Prompt (CMD), enter the "mode" command, which will display status information for all COM ports.
3Check 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:
1Use the dmesg command to view: Open the terminal.
1Use the ls command to view: Enter ls /dev/ttyS* or ls /dev/ttyUSB* to list all serial port devices.
3Use the setserial command to view: Enter setserial -g /dev/ttyS* to view the configuration information of all serial port devices.
- 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
- Install MAC Driver and flash again.
- 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.
- The screen supports 262k color, but due to ESP limitations, RGB565 is used, and it is actually 65k
- Please refer to SquareLine Studio tutorial
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)