ESP32-S3-Touch-LCD-3.5

320 × 480, USB/UART/GPIO

Overview

Introduction

This product is a high-performance, highly integrated microcontroller development board designed by Waveshare. It is equipped with a 3.5inch capacitive high-definition IPS screen, a highly integrated power management chip, a 6-axis sensor (3-axis accelerometer and 3-axis gyroscope), RTC, low-power audio codec chip and other peripherals, which are convenient for development and embedding into the product. No assembly or wiring is required, so it's easy to play with Xiaozhi AI.

Features

Equipped with ESP32-S3R8 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 512 KB SRAM and 384 KB ROM, with onboard 8 MB PSRAM and an external 16 MB Flash
Adopts Type-C interface to improve user convenience and device compatibility
Built-in 3.5inch capacitive touch high-definition IPS display with a resolution of 320×480, 262K colors for clear color pictures
Embedded with ST7796 driver chip and FT6336 capacitive touch control chip, using SPI and I2C communication respectively, minimizes required IO pins
Onboard QMI8658 6-axis IMU (3-axis accelerometer and 3-axis gyroscope) for detecting motion gesture, step counting, etc.
Onboard PCF85063 RTC chip connected to the battery via the AXP2101 for uninterrupted power supply, and a backup battery pad is reserved to ensure that the RTC function continues to work during main battery replacement
Onboard PWR and BOOT two side buttons with customizable functions, allowing for custom function development
Onboard 3.7V MX1.25 lithium battery recharge/discharge header
Lead out I2C, UART, USB and multiple GPIOs, which can be used for external devices and debugging, and flexibly configure peripheral functions
Onboard TF card slot for extended storage and fast data transfer, flexible for data recording and media playback, simplifying circuit design
Onboard camera interface, support mainstream cameras such as OV5640 and OV2640
The benefits of using AXP2101 include efficient power management, support for multiple output voltages, charging and battery management functions, and optimization for battery life

Hardware Description

1. ESP32-S3R8
WiFi and Bluetooth SoC, up to 240MHz operating frequency, with onboard 8MB PSRAM

2. Onboard SMD antenna

3. W25Q128JVSIQ
16MB NOR-Flash

4. Camera interface
Supports cameras such as OV5640/OV2640

5. TF card slot

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

7. MX1.25 Speaker interface

8. BOOT button

9. RESET button

10. PWR button
Audio capturing

11. AXP2101
Highly integrated power management chip

12. Charge indicator

13. Type-C interface

14. ES8311
Low power audio codec chip

15. Power indicator

16. Microphone

17. SH1.0 RTC battery interface
Connecting the rechargeable RTC battery

18. MX1.25 Lithium battery interface
MX1.25 2PIN connector, for 3.7V Lithium battery, supports charging and discharging

19. 2.54mm socket interface
Leads out available IO function pins for easy expansion

20. PCF85063
RTC clock chip

21. QMI8658
6-axis IMU includes a 3-axis gyroscope and a 3-axis accelerometer

Pinout Definition

Dimensions

Usage Instructions

ESP32-S3-Touch-LCD-3.5 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

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.

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-Touch-LCD-3.5 x1
TF card x 1
OV5460 x1
USB cable (Type A male to Type C male) 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.

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

Install ESP32 Development Board

Before using ESP32-related motherboards with the Arduino IDE, you must first install the software package for the esp32 by Espressif Systems development board
According to board installation requirement, it is generally recommended to use Install Online. If online installation fails, use Install Offline.
For the installation tutorial, please refer to Arduino board manager tutorial

ESP32-S3-Touch-LCD-3.5 required development board installation description
Board name	Board installation requirement	Version number requirement
esp32 by Espressif Systems	"Install Offline" / "Install Online"	≥3.0.6

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.
ESP32-S3-Touch-LCD-3.5 library file is stored in the sample program, click here to jump:ESP32-S3-Touch-LCD-3.5 Demo
For library installation tutorial, please refer to Arduino library manager tutorial

ESP32-S3-Touch-LCD-3.5 Library file instructions
Library Name	Description	Version	Library Installation Requirement
lvgl	LVGL graphical library	v8.4.0	"Install Online" requires copying the demos folder to src after installation. "Install Offline" is recommended
GFX_Library_for_Arduino	GFX graphics library	v1.5.5	"Install Online"
JPEGDEC	JPG decoding library	v1.7.0	"Install Online"
PNGdec	PNG decoding library	v1.1.0	"Install Online"
XPowersLib	PNG decoding library	v0.2.7	"Install Online"
SensorLib	PNG decoding library	v0.2.6	"Install Online"
ESP32-audioI2S-master	Audio processing library	v3.0.13	"Install Online"
ESP32_IO_Expander	Expand IO driver library	v8.4.0	"Install Online"
esp-lib-utils	ESP32_IO_Expander dependency libraries	v8.4.0	"Install Online"
esp_lcd_touch_ft6336	Touch driver	---	"Install Offline"
es8311	es8311 driver library	---	"Install Offline"

Run the First Arduino Demo

If you are just getting started with ESP32 and Arduino, and you don't know how to create, compile, flash, and run Arduino ESP32 programs, then please expand and take a look. Hope it can help you!

New Project

Run the Arduino IDE and select File -> New Sketch
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, click Save

Compile and Flash Demos

Select the corresponding development board, take the ESP32S3 motherboard as an example:

①. Click to select the dropdown menu option Select Other Board and Port;
②. Search for the required development board model esp32s3 dev module and select;
③. Select COM Port;
④. Save the selection.

Some development boards with specified version numbers support direct model selection, for example, "Waveshare ESP32-S3-LCD-1.69":

If the ESP32S3 mainboard only has a USB port, you need to enable USB CDC, as shown in the following diagram:

Compile and upload the program:

①. Compile the program; ②. Compile and download the program; ③. Download successful.

Open the Serial Monitor window, and the demo will print "Hello World!" every 2 seconds, and the operation is as follows:

Demo

ESP32-S3-Touch-LCD-3.5 Demo
Demo	Basic Description	Dependency Library
01_audio_out	Read the audio file from the TF card and play it	ESP32-audioI2S-master
02_axp2101_example	Print the data of the power management chip	XPowersLib
03_camera_web_server	Display the camera images on the web page	XPowersLib
04_es8311_example	Record for a while and play	es8311
05_pcf85063_time	Print the data acquired by the RTC	SensorLib
06_qmi8658_getdata	Print the IMU data	SensorLib
07_sd_card_test	Test the read and write of the TF card	--
08_gfx_helloworld	Display HelloWorld on the screen	GFX_Library_for_Arduino, ESP32_IO_Expander
09_gfx_jpeg	Decode the JPG file and display it on the screen	GFX_Library_for_Arduino, ESP32_IO_Expander, JPEGDEC
10_gfx_png	Decode the PNG file and display it on the screen	GFX_Library_for_Arduino, ESP32_IO_Expander, PNGdec
11_lvgl_example	lvgl demo	GFX_Library_for_Arduino, ESP32_IO_Expander, lvgl
12_lvgl_pcf85063	LVGL displays the time and date	GFX_Library_for_Arduino, ESP32_IO_Expander, lvgl, SensorLib
13_lvgl_qmi8658	LVGL displays the IMU data	GFX_Library_for_Arduino, ESP32_IO_Expander, lvgl, SensorLib
14_lvgl_image	LVGL shows pictures	GFX_Library_for_Arduino, ESP32_IO_Expander, lvgl

ESP32-S3-Touch-LCD-3.5 Arduino Project Parameter Setting

01_audio_out

【Demo description】

This demo demonstrates how ESP32-S3-Touch-LCD-3.5 reads audio files from a TF card and plays them using a speaker, supporting formats such as MP3, AAC, WAV, etc.

【Preparation】

Insert the TF card into the computer
Create a folder named music in the root directory of the TF card
Copy the 1.mp3 file from the data folder of this project to the music folder on the TF card
Insert the TF card into ESP32-S3-Touch-LCD-3.5

【Code analysis】

Initialize

  Wire.begin(I2C_SDA, I2C_SCL);
  es8311_codec_init();
  SD_MMC.setPins(SD_MMC_CLK, SD_MMC_CMD, SD_MMC_D0);
  if (!SD_MMC.begin("/sdmmc", true, false, 20000))
  {
    esp_rom_printf("Card Mount Failed\n");
    while (1)
    {
    };
  }
  audio.setPinout(I2S_BCLK, I2S_LRCK, I2S_SDOUT, I2S_MCLK);
  audio.setVolume(21);  // 0...21

Set the audio file to play

  audio.connecttoFS(SD_MMC, "music/1.mp3");

【Result demonstration】

Nothing will be shown on the screen if you play the audio file

02_axp2101_example

【Demo description】

This demo demonstrates using XPowers to drive AXP2101 and print data via serial port

【Code analysis】

Initialize

  bool result = power.begin(Wire, AXP2101_SLAVE_ADDRESS, i2c_sda, i2c_scl);

  if (result == false) {
    Serial.println("power is not online...");
    while (1) delay(50);
  }

【Result demonstration】

Nothing will be shown on the screen
Open the serial port monitor

03_camera_web_server

【Demo description】

This demo demonstrates how to drive the camera. After connecting to WiFi, the program will create a web server, and users can access it by entering the device's IP address in the browser. Web pages can display images from cameras and support settings such as resolution and mirroring

【Preparation】

Connect the board to the computer
Plug the OV5640 camera into the 24Pin socket on the board (Version with casing does not require this operation)
Set Parttion to Custom

【Code analysis】

Define the pins related to the camera

#define PWDN_GPIO_NUM -1
#define RESET_GPIO_NUM -1
#define XCLK_GPIO_NUM 38
#define SIOD_GPIO_NUM 8
#define SIOC_GPIO_NUM 7

#define Y9_GPIO_NUM 21
#define Y8_GPIO_NUM 39
#define Y7_GPIO_NUM 40
#define Y6_GPIO_NUM 42
#define Y5_GPIO_NUM 46
#define Y4_GPIO_NUM 48
#define Y3_GPIO_NUM 47
#define Y2_GPIO_NUM 45
#define VSYNC_GPIO_NUM 17
#define HREF_GPIO_NUM 18
#define PCLK_GPIO_NUM 41

The name and password of the wifi to be connected

const char *ssid = "waveshare";
const char *password = "12345678";

Start the server and start providing HTTP video streaming services

startCameraServer();

Serial.print("Camera Ready! Use 'http://");
Serial.print(WiFi.localIP());
Serial.println("' to connect");

【Result demonstration】

Open the serial port terminal after connecting to WiFi to see the IP address

Use the browser (the device with hotspot enabled) to open the IP address for serial port printing
Click Start Stream to see the image of the camera

04_es8311_example

【Demo description】

This demo demonstrates using the ESP32-S3-Touch-LCD-3.5 to drive the ES8311 audio codec to achieve audio recording and playback functions.

【Code analysis】

Initialize

  Wire.begin(I2C_SDA, I2C_SCL);
  es8311_codec_init();
  setupI2S();

Record audio for 5s and play back the recorded content

  wav_buffer = i2s.recordWAV(5, &wav_size);
  delay(1000);
  Serial.println("I2S playWAV");
  i2s.playWAV(wav_buffer, wav_size);

【Result demonstration】

Nothing will be shown on the screen
Press the RST button on the ESP32-S3-Touch-LCD-3.5 to enter audio recording mode, and 5 seconds later, it will play back the recorded content.

05_pcf85063_time

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 driving the PCF85063, setting time and date, and getting time.

【Code analysis】

Initialize

    if (!rtc.begin(Wire, PCF85063_SLAVE_ADDRESS, SENSOR_SDA, SENSOR_SCL)) {
        Serial.println("Failed to find PCF8563 - check your wiring!");
        while (1) {
            delay(1000);
        }
    }

Set the time and date

    rtc.setDateTime(year, month, day, hour, minute, second);

Get the time and date

    RTC_DateTime datetime = rtc.getDateTime();

【Result demonstration】

Nothing will be shown on the screen
Open the serial port monitor

06_qmi8658_getdata

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 driving QMI8658 to obtain and print the temperatures of Accel, Gyro, and IMU.

【Code analysis】

Initialize

  if (!qmi.begin(Wire, QMI8658_L_SLAVE_ADDRESS, SENSOR_SDA, SENSOR_SCL)) {
    Serial.println("Failed to find QMI8658 - check your wiring!");
    while (1) {
      delay(1000);
    }
  }

Get data

  if (qmi.getDataReady()) {
    if (qmi.getAccelerometer(acc.x, acc.y, acc.z)) {
    }
    if (qmi.getGyroscope(gyr.x, gyr.y, gyr.z)) {
    }
  }

【Result demonstration】

Nothing will be shown on the screen
Open the serial port monitor

07_sd_card_test

【Demo description】

This demo demonstrates how to use ESP32-S3-Touch-LCD-3.5 to test the read and write functions of the TF card

【Hardware connection】

Connect the board to the computer
Insert the TF card into the card slot (TF card needs to be formatted as FAT32)

【Code analysis】

Initialize

  if(!SD_MMC.setPins(clk, cmd, d0)){
    Serial.println("Pin change failed!");
    return;
  }

  if (!SD_MMC.begin( "/sdcard", true)) {
    Serial.println("Card Mount Failed");
    return;
  }

【Result demonstration】

Insert the TF card into the computer, and you can find two more files: test.txt and foo.test. The content of the foo.txt is Hello World!, and the content of the test.txt is empty

08_gfx_helloworld

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 using the GFX_Library_for_Arduino library to drive the screen and display HelloWorld on the screen.

【Code analysis】

Configure the screen interface and screen resolution, etc.

Arduino_DataBus* bus = new Arduino_ESP32SPI(LCD_DC /* DC */, LCD_CS /* CS */, SPI_SCLK /* SCK */, SPI_MOSI /* MOSI */, SPI_MISO /* MISO */);
Arduino_GFX* gfx = new Arduino_ST7796(
  bus, LCD_RST /* RST */, 0 /* rotation */, true, LCD_HOR_RES, LCD_VER_RES);

【Result demonstration】

09_gfx_jpeg

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 using the JPEGDEC library to decode JPEG files from a TF card and displaying the content on the screen through the GFX_Library_for_Arduino.

【Preparation】

Insert the TF card into the computer
Create a folder named images in the root directory of the TF card
Copy the octocat.jpg file from the data folder of this project to the images folder on the TF card
Insert the TF card into ESP32-S3-Touch-LCD-3.5

【Code analysis】

Decode jpg file and display

jpegDraw(JPEG_FILENAME, jpegDrawCallback, true /* useBigEndian */,
             0 /* x */, 0 /* y */, gfx->width() /* widthLimit */, gfx->height() /* heightLimit */);

【Result demonstration】

10_gfx_png

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 using the PNGdec library to decode png files from a TF card, and displaying the png content on the screen through the GFX_Library_for_Arduino.

【Preparation】

Insert the TF card into the computer
Create a folder named images in the root directory of the TF card
Copy the octocat.png and octocat-4bpp.png files from the data folder of this project to the images folder on the TF card
Insert the TF card into ESP32-S3-Touch-LCD-3.5

【Code analysis】

Decode jpg file and display

    rc = png.open(PNG_FILENAME, myOpen, myClose, myRead, mySeek, PNGDraw);
    if (rc == PNG_SUCCESS)
    {
      int16_t pw = png.getWidth();
      int16_t ph = png.getHeight();

      xOffset = (w - pw) / 2;
      yOffset = (h - ph) / 2;

      rc = png.decode(NULL, 0);

      Serial.printf("Draw offset: (%d, %d), time used: %lu\n", xOffset, yOffset, millis() - start);
      Serial.printf("image specs: (%d x %d), %d bpp, pixel type: %d\n", png.getWidth(), png.getHeight(), png.getBpp(), png.getPixelType());
      png.close();
    }

【Result demonstration】

11_lvgl_example

【Demo description】

This demo demonstrates how to use ESP32-S3-Touch-LCD-3.5 to run the lvgl demos

【Precautions】

If the lvgl library is installed online, you need to copy the demos folder to src

【Code analysis】

Select the lvgl demos to run

lv_demo_widgets();
// lv_demo_benchmark();
// lv_demo_keypad_encoder();
// lv_demo_music();
// lv_demo_stress();

【Result demonstration】

It can be operated by touch

12_lvgl_pcf85063

【Demo description】

This demo demonstrates how to use ESP32-S3-Touch-LCD-3.5 to obtain PCF85063 time and date data and display it using the lvgl library.

【Code analysis】

UI initialize

void lvgl_pcf85063_ui_init(lv_obj_t *parent) {
  lv_obj_t *list = lv_list_create(parent);
  lv_obj_set_size(list, lv_pct(100), lv_pct(100));

  lv_obj_t *list_item = lv_list_add_btn(list, NULL, "data");
  label_data = lv_label_create(list_item);
  lv_label_set_text(label_data, "2025-01-01");

  list_item = lv_list_add_btn(list, NULL, "time");
  label_time = lv_label_create(list_item);
  lv_label_set_text(label_time, "00:00:00");

  pcf85063_timer = lv_timer_create(pcf85063_callback, 100, NULL);
}

【Result demonstration】

13_lvgl_qmi8658

【Demo description】

This demo demonstrates how to use ESP32-S3-Touch-LCD-3.5 to obtain qmi8658 data and display it using the lvgl library.

【Code analysis】

Initialize UI

void lvgl_qmi8658_ui_init(lv_obj_t *parent) {
  lv_obj_t *list = lv_list_create(parent);
  lv_obj_set_size(list, lv_pct(100), lv_pct(100));

  lv_obj_t *list_item = lv_list_add_btn(list, NULL, "accel_x");
  label_accel_x = lv_label_create(list_item);
  lv_label_set_text(label_accel_x, "0.00");

  list_item = lv_list_add_btn(list, NULL, "accel_y");
  label_accel_y = lv_label_create(list_item);
  lv_label_set_text(label_accel_y, "0.00");

  list_item = lv_list_add_btn(list, NULL, "accel_z");
  label_accel_z = lv_label_create(list_item);
  lv_label_set_text(label_accel_z, "0.00");

  list_item = lv_list_add_btn(list, NULL, "gyro_x");
  label_gyro_x = lv_label_create(list_item);
  lv_label_set_text(label_gyro_x, "0.00");

  list_item = lv_list_add_btn(list, NULL, "gyro_y");
  label_gyro_y = lv_label_create(list_item);
  lv_label_set_text(label_gyro_y, "0.00");

  list_item = lv_list_add_btn(list, NULL, "gyro_z");
  label_gyro_z = lv_label_create(list_item);
  lv_label_set_text(label_gyro_z, "0.00");

  list_item = lv_list_add_btn(list, NULL, "temp");
  label_temp = lv_label_create(list_item);
  lv_label_set_text(label_temp, "0.00C");

  qmi8658_timer = lv_timer_create(qmi8658_callback, 100, NULL);
}

【Result demonstration】

14_lvgl_image

【Demo description】

This demo demonstrates how ESP32-S3-Touch-LCD-3.5 uses lvgl to display images from a TF card, supporting formats such as jpg, bmp, png, bin, etc.

【Preparation】

Insert the TF card into the computer
Create a folder named images in the root directory of the TF card
Copy all the files from the data folder of this project to the images folder on the TF card
Insert the TF card into ESP32-S3-Touch-LCD-3.5

【Code analysis】

Set the displayed image

  lv_obj_t *img = lv_img_create(lv_scr_act());
  lv_obj_align(img, LV_ALIGN_CENTER, 0, 0);
  // lv_img_set_src(img, "S:images/octocat.jpg");
  lv_img_set_src(img, "S:images/octocat.png");

【Result demonstration】

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.

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 Offline.
For more information about how to install the Espressif IDF plugin, see Install Espressif IDF Plugin

Run the First ESP-IDF Demo

If you are just getting started with ESP32 and ESP-IDF, and you don't know how to create, compile, flash, and run ESP-IDF ESP32 programs, then please expand and take a look. Hope it can help you!

New Project

Create Demo

Using the shortcut F1, enter esp-idf:show examples projects

Select your current IDF version

Take the Hello world demo as an example

①Select the corresponding demo
②Its readme will state what chip the demo applies to (how to use the demo and the file structure are described below, omitted here)
③Click to create the demo

Select the path to save the demo, and require that the demos cannot use folders with the same name

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

Modify Driver Object

Select the object we need to drive, which is our main chip ESP32S3

Choose the path to openocd, it doesn't affect us here, so let's just choose one

Other Status Bar Functions

①.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
②.Device flashing COM port, select to flash the compiled program into the chip
③.Select set-target chip model, select the corresponding chip model, for example, ESP32-P4-NANO needs to choose esp32p4 as the target chip
④.menuconfig, click it to Modify sdkconfig configuration file Project configuration details
⑤.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
⑥.Build project, when a project satisfies the build, click this button to compile
⑦.Current download mode, the default is UART
⑧.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
⑨.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
⑩.Debug
⑪.Build Flash Monitor one-click button, which is used to continuously execute Build --> Flash --> Monitor, often referred to as "little flame"

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

It may take a long time to compile especially for the first time

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

This can also be changed later in the Download methods section (click on it to pop up the options)

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

Use the IDF Demos

The following takes ESP32-S3-LCD-1.47-Demo as an example to introduce the two opening methods of the project and the general steps of use, and the detailed explanation of the ESP-IDF project. If you use other projects, the operation steps can be applied similarly.

Open In the Software

Open VScode software and select the folder to open the demo

Select the provided ESP-IDF example and click to select the file (located in the /Demo/ESP-IDF path under demo)

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

After connecting the device, select the COM port and model, click below to compile and flash to achieve program control

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 CMake first reads the content of the top-level CMakeLists.txt in the project directory to read the build rules and identify the content to be compiled. When the required components and demos are imported into the CMakeLists.txt, the compilation tool CMake will import each content that needs to be compiled according to the index. The compilation process is as follows:

Demo

ESP32-S3-Touch-LCD-3.5 Demo
Demo	Basic Description
01_factory	Comprehensive demo
02_lvgl_example	Run the official Demo UI of LVGL
03_lvgl_system	Use LVGL to display system parameters, test ES8311, and control screen brightness
04_lvgl_qmi8658	Use LVGL to display the data obtained by qmi8658
05_lvgl_axp2101	Use LVGL to display various data of the power management chip AXP2101
06_lvgl_camera	Use LVGL to display the image captured by the camera
07_lvgl_wifi	Use LVGL to display the ssid and signal strength scanned by WiFi
08_lvgl_image	Use LVGL to display images from the TF card

01_factory

【Demo description】

This demo is a comprehensive demo of ESP32-S3-Touch-LCD-3.5, which is also the default demo flashed at factory

【Code analysis】

Initialize

    i2c_bus_init();
    io_expander_init();
    esp_3inch5_display_port_init(&io_handle, &panel_handle, LCD_BUFFER_SIZE);
    esp_3inch5_touch_port_init(&touch_handle, i2c_bus_handle, EXAMPLE_LCD_H_RES, EXAMPLE_LCD_V_RES, EXAMPLE_DISPLAY_ROTATION);
    esp_axp2101_port_init(i2c_bus_handle);
    vTaskDelay(pdMS_TO_TICKS(100));
    esp_es8311_port_init(i2c_bus_handle);
    esp_qmi8658_port_init(i2c_bus_handle);
    esp_pcf85063_port_init(i2c_bus_handle);
    esp_sdcard_port_init();
    esp_camera_port_init(I2C_PORT_NUM);
    esp_wifi_port_init("WSTEST", "waveshare0755");

    esp_3inch5_brightness_port_init();
    esp_3inch5_brightness_port_set(80);
    lv_port_init();

【Result demonstration】

Touch test, swipe your finger on the screen to display its trajectory, short press the BOOT button to exit the touch test

Switch between interfaces by swiping left and right.

02_lvgl_example

【Demo description】

This demo demonstrates how to use ESP32-S3-Touch-LCD-3.5 to run the lvgl demos

【Result demonstration】

It can be operated by touch.

03_lvgl_system

【Demo description】

This demo demonstrates the ESP32-S3-Touch-LCD-3.5 using lvgl to display system information, as well as testing es8311 and controlling the screen brightness

【Code analysis】

Get the size of Flash, Psram, and TF card and the frequency of the system operation

    esp_flash_get_size(NULL, &flash_size);
    lv_label_set_text_fmt(label_flash, "%d MB", (int)(flash_size / 1024 / 1024));

    psram_size = (uint32_t)esp_psram_get_size();
    lv_label_set_text_fmt(label_psram, "%d MB", (int)(psram_size / 1024 / 1024));

    cpu_freq = esp_clk_cpu_freq();
    lv_label_set_text_fmt(label_chip_freq, "%d MHz", (int)(cpu_freq / 1000 / 1000));

    sdcard_size = esp_sdcard_port_get_size();
    lv_label_set_text_fmt(label_sd, "%d MB", (int)(sdcard_size / 1024 / 1024));

【Result demonstration】

04_lvgl_qmi8658

【Demo description】

This demo demonstrates that ESP32-S3-Touch-LCD-3.5 uses lvgl to display qmi8658 data

【Result demonstration】

05_lvgl_axp2101

【Demo description】

This demo demonstrates that how to use ESP32-S3-Touch-LCD-3.5 to display axp2101 data using lvgl

【Result demonstration】

06_lvgl_camera

【Demo description】

This demo demonstrates that ESP32-S3-Touch-LCD-3.5 uses lvgl to display images captured by the camera

【Code analysis】

Get the images from the camera and update to LVGL

void camera_task(void *arg)
{
    camera_fb_t *pic;
    lv_img_dsc_t img_dsc;
    img_dsc.header.always_zero = 0;
    img_dsc.header.w = 320;
    img_dsc.header.h = 480;
    img_dsc.data_size = 320 * 480 * 2;
    img_dsc.header.cf = LV_IMG_CF_TRUE_COLOR;
    img_dsc.data = NULL;
    while (1)
    {
        pic = esp_camera_fb_get();

        if (NULL != pic)
        {
            // printf("pic->len = %d\n", pic->len);
            img_dsc.data = pic->buf;
            if (lvgl_port_lock(0))
            {
                lv_img_set_src(cam_ing, &img_dsc);
                lvgl_port_unlock();
            }
        }
        esp_camera_fb_return(pic);

        vTaskDelay(pdMS_TO_TICKS(1));
    }
}

【Result demonstration】

07_lvgl_wifi

【Demo description】

This demo demonstrates ESP32-S3-Touch-LCD-3.5 WiFi scanning and uses lvgl to display the names and signal strength of the scanned WiFi networks.

【Code analysis】

Scan WiFi and update to lvgl

static void lvgl_wifi_task(void *arg)
{
    char str[50] = {0};
    char str_wifi_ip[32] = {0};
    lv_obj_t *label;
    wifi_ap_record_t ap_info[LIST_BTN_LEN_MAX];

    while (1)
    {
        if (xSemaphoreTake(wifi_scanf_semaphore, pdMS_TO_TICKS(1000)) == pdTRUE)
        {
            printf("wifi_scanf!!\r\n");
            memset(ap_info, 0, sizeof(ap_info));
            if (esp_wifi_port_scan(ap_info, &list_item_count, LIST_BTN_LEN_MAX))
            {
                lv_obj_del(list_btns[0]);
                if (lvgl_port_lock(0))
                {
                    for (int i = 0; i < list_item_count && i < LIST_BTN_LEN_MAX; i++)
                    {
                        list_btns[i] = lv_list_add_btn(list, NULL, (char *)ap_info[i].ssid);
                        label = lv_label_create(list_btns[i]);
                        lv_label_set_text_fmt(label, "%d db", ap_info[i].rssi);
                    }
                    lvgl_port_unlock();
                }
            }
        }

        esp_wifi_port_get_ip(str_wifi_ip);
        sprintf(str, "IP: %s", str_wifi_ip);

        if (lvgl_port_lock(0))
        {
            lv_label_set_text(lable_wifi_ip, str);
            lvgl_port_unlock();
        }
    }
}

【Result demonstration】

08_lvgl_image

【Demo description】

This demo demonstrates how ESP32-S3-Touch-LCD-3.5 uses lvgl to display images from a TF card, supporting formats such as jpg, bmp, png, bin, etc.

【Preparation】

Insert the TF card into the computer
Create a folder named images in the root directory of the TF card
Copy all the files from the data folder of this project to the images folder on the TF card
Insert the TF card into ESP32-S3-Touch-LCD-3.5

【Code analysis】

Read all images in the S:images directory and print the file names

    read_image_files("S:images");
    print_image_filenames();

Initialize the ui and add left and right swipe to switch images

        img = lv_img_create(lv_scr_act());
        lv_obj_set_size(img, 320, 480);
        lv_obj_align(img, LV_ALIGN_CENTER, 0, 0);
        snprintf(str_buf, sizeof(str_buf), "S:images/%s", image_filenames[0]);
        printf("img_set_src: %s\r\n", str_buf);
        lv_img_set_src(img, str_buf);
        lv_obj_clear_flag(img, LV_OBJ_FLAG_SCROLLABLE);
        lv_obj_add_flag(img, LV_OBJ_FLAG_GESTURE_BUBBLE);
        lv_obj_add_event_cb(lv_scr_act(), img_gesture_event_cb, LV_EVENT_GESTURE, NULL);

【Result demonstration】

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-Touch-LCD-3.5-Demo\Firmware
```

Flash firmware flashing and erasing for reference

Resources

Schematic Diagram

ESP32-S3-Touch-LCD-3.5 Schematic diagram

Project Diagram

ESP32-S3-Touch-LCD-3.5 2D & 3D diagram

Demo

ESP32-S3-Touch-LCD-3.5 Demo

Datasheets

ESP32-S3

Other Components

Softwares

FAQ

Question: What platforms does the AI large model example of speech dialog support?

Answer:

The product is equipped with ES8311 audio codec chip, onboard speaker, and SMD microphone. And it can achieve voice dialogue function;
At present, the access to various platforms has been verified, and mainstream platforms such as Doubao, ERNIE Bot , and ChatGPT are supported. The demos will gradually be opened up to ESP32-AIChats

Question: Why did the compilation fail?

Answer:

When the project fails to be compiled, check the development environment.

Arduino IDE compiling the project shows the situation in the image, you need to modify Partition Scheme->16M Flash(3MB APP/9.9MB FATFS)。
When the ESP-IDF project compilation fails, delete the build, managed_components, and dependencies.lock, and then compile again. If the error persists, check whether the ESP-IDF version and the CMakeList.txt in the project directory are correctly recognized

Question: Why does the module keep resetting?

Answer:

In this case, due to the crash of the program, the USB cannot work normally, you can press and hold the BOOT button and then power on, at this time, the module can enter the download mode to flash the firmware (program) to solve the situation.

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

Answer:

In the Arduino IDE, the first compilation loads and compiles all the dependencies, so it's normal for the first compilation task to be time-consuming. Just wait patiently

Question: How to handle the display "waiting for download..." on the serial port after successfully ESP-IDF flashing?

Answer:

Power it on again

Question: How to measure the battery voltage of this product?

Answer:

This product has an on-board AXP2101, which can measure all kinds of battery data, such as: chip temperature, whether it is charged, whether it is connected to the power supply, charging status, battery voltage, charging voltage, battery power, etc.

Question: This product measures the percentage of battery remaining capacity. Why does the result fluctuate greatly?

Answer:

The battery capacity measurement of the AXP2101 is based on battery voltage, but battery capacity does not vary linearly, so large percentage fluctuations may occur during measurement. Especially in the case of plugging and unplugging chargers, load changes, or battery aging, the fluctuations become more noticeable. The measured percentages are for reference only, and the actual voltage is used as a measure of capacity.

Question: Can you provide the 3D file for the casing?

Answer:

It is not provided.

Question: Can both buttons of this product be programmed for use?

Answer:

Yes, the two buttons of this product are BOOT and PWR. The functions are as follows:
1. BOOT: Press and then power on, and the development board enters download mode (commonly used when the program freezes or the USB GPIO is occupied); under normal working conditions, the GPIO0 can detect the high and low level of the button to determine the action, and the low level is pressed, which can recognize click, double-click, multi-click, and long-press actions.
2.PWR: In the power-on state, press and hold for 6s to power off, in the power-off state (power off to charge the battery), click to power on; Under normal working conditions, the action can be judged by the high and low levels of the EXIO6 detection buttons of the extended IO, and the high level is pressed, which can identify the actions of single click, double click, multiple click and long press (long press should not exceed 6s, otherwise the power will be turned off).

Question: Does this product support Bluetooth?

Answer:

The core chip of this product is ESP32-S3R8, which supports wireless communication functions such as 2.4GHz WiFi and Bluetooth LE 5, and has an onboard SMD antenna, and the antenna gain has been adjusted to the optimum, which can support the use of Bluetooth and WiFi. For details, please refer to ESP32-S3 datasheet

Question: Does this product support Chinese display?

Answer:

This product uses ESP32-S3R8 as the core, connects the screen via SPI protocol, fully supports Chinese display, but requires meeting the following conditions:
1. Character encoding support is required, and strings that support UNICODE-8 encoding can be rendered to the screen
2. Font library support
3. Display library support, LVGL or Arduino_GFX are supported

Question: What chip is used for the screen of this product?

Answer:

Screen display chip: ST7796
Screen touch chip: FT6336

Question: Is this product waterproof?

Answer:

It is not waterproof and should be kept dry when used

Question: How to 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 Device Manager; Expand the "Port (COM and LPT)" section, here it will list all the COM ports and their current status.
②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 is there no output from the monitor after running the code, even though the code is correct and successfully flashed?

Answer:

The Type-C flashing and debugging port of ESP32-S3-Touch-LCD-3.5 is directly output from ESP32-S3 USB. In the Arduino IDE development environment, it supports printf function for printing and output. If you want to support Serial function for printing and output, you need to enable USB CDC On Boot function or HWCDC declaration. For this, please refer to the demonstration in the demo. ESP-IDF usually uses ESP_LOGD and ESP-ERROR_CECK for printing output.

Question: Can you help me with the code? Can you help me modify the code?

Answer:

This product is positioned as a development board and is not a finished product. Regarding the product ecosystem, ESP32 is a core product with a mature ecosystem and a friendly development environment. We do not assist in modifying the code. As creators and geeks, please use your DIY abilities. If you have any questions, please feel free to ask our engineers for answers.
If you think our products are good, and you want to customize hardware, casings, software, etc. in batches, please contact business sales team

Question: How to use SquareLine Studio to design interfaces?

Answer:

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)

Submit Now

ESP32-S3-Touch-LCD-3.5

Overview

Introduction

Features

Hardware Description

Pinout Definition

Dimensions

Usage Instructions

Development Tools

Arduino IDE

ESP-IDF

Components Preparation

Working with Arduino

Environment Setup

Download and Install Arduino IDE

Install ESP32 Development Board

Install Library

Run the First Arduino Demo

New Project

Compile and Flash Demos

Demo

01_audio_out

02_axp2101_example

03_camera_web_server

04_es8311_example

05_pcf85063_time

06_qmi8658_getdata

07_sd_card_test

08_gfx_helloworld

09_gfx_jpeg

10_gfx_png

11_lvgl_example

12_lvgl_pcf85063

13_lvgl_qmi8658

14_lvgl_image

Working with ESP-IDF

Environment Setup

Download and Install Visual Studio

Install Espressif IDF Plugin

Run the First ESP-IDF Demo

New Project

Create Demo

Modify COM Port

Modify Driver Object

Other Status Bar Functions

Compile, Flash and Serial Port Monitor

Use the IDF Demos

Open In the Software

Open from Outside the Software

ESP-IDF Project Details

Demo

01_factory

02_lvgl_example

03_lvgl_system

04_lvgl_qmi8658

05_lvgl_axp2101

06_lvgl_camera

07_lvgl_wifi

08_lvgl_image

Flash Firmware Flashing and Erasing

Resources

Schematic Diagram

Project Diagram

Demo

Datasheets

ESP32-S3

Other Components

Softwares

Other Resource Links

FAQ

Support