| Account | My Orders
Cart(0)
Spotpear
  • sales

    +86-0755-88291180

ESP32-S3-LCD-1.47 User Guide

Overview

Introduction

ESP32-S3-LCD-1.47 is a microcontroller development board that supports 2.4GHz WiFi and BLE 5. It integrates large capacity Flash and PSRAM and has onboard 1.47inch LCD 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 1.47inch LCD display, 172×320 resolution, 262K color
  • Adapting most GPIOs, integrates full-speed USB serial port
  • Onboard TF card slot, supporting external TF card storage for pictures or files
  • Supports accurate control such as flexible clock and multiple power modes to realize low power consumption in different scenarios
  • Onboard RGB color light beads, paired with transparent acrylic interlayer for cool lighting effects

Onboard Resources

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

2. 16MB Flash

3. TF card slot

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

5. Patch ceramic antenna

6. BOOT button
   Compatible with cameras such as OV2640/OV5640

7. RESET button
   Reserved interface, it can only be enabled by re-soldering the resistor


Interfaces

LCD

LCD PinESP32S3
MOSIGPIO45
SCLKGPIO40
LCD_CSGPIO42
LCD_DCGPIO41
LCD_RSTGPIO39
LCD_BLGPIO48

RGB light bead

RGB light beadESP32S3
RGB_ControlGPIO38

TF Card

TF CardESP32S3
SD_CMDGPIO15
SD_SCKGPIO14
SD_D0GPIO16
SD_D1GPIO18
SD_D2GPIO17
SD_D3GPIO21

Dimensions

Specifications

ItemParameter
InterfaceUSB Type-A
Controller chipESP32-S3
LCD TypeTFT
LCD Controller chipDisplay: ST7789
Onboard DevicesTF

Usage Instructions

ESP32-S3-LCD-1.47 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 tools, 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.


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-1.47 x1
  • TF card x 1
  • Card reader x1
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 official website, select the corresponding system and system bit to download.
  • Run the installer and install all by default.

Install ESP32 development board

  • In order to use the ESP32-related motherboard in the Arduino IDE, the software package of the esp32 by Espressif Systems board must be installed
  • According to Board installation requirement, it is generally recommended to use Install Online. If online installation fails, use Install Offline
  • For the installation tutorial

Install Online

The following is an example of installing ESP32-3.0.2, if you install other boards or version numbers, the operation steps are similar.
  • The board management URL is used to index the development board information of a specified platform. SelectFile -->Preferences from the Arduino IDE menu bar
  • Add the corresponding board management link, click the button
  • In the first blank space, add the following
https://espressif.github.io/arduino-esp32/package_esp32_index.json

  • Save settings
  • Install development board

①. Select BOARDS MANAGER in the sidebar;
②. Enter the name of the board you want to install ESP32 in the search box;
③. Select Version Number in the box;
④. Click INSTALL.

  • Wait for download
  • Arduino-esp32 download completed
  • ESP32-S3-LCD-1.47 required development board installation instructions
Board nameBoard installation requirementVersion number requirement
esp32 by Espressif Systems"Install Offline" / "Install Online"≥3.0.2

Install libraries

  • 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

Install Offline

The following is an example of installing the library required by "ESP32-S3-ETH-Demo", if you install other library, the operation steps are similar.
  • Copy the library files provided by Waveshare to the libraries folder in the project folder
  • Where waveshrare is the user name, the user name varies from person to person
  • If there is no "libraries" folder in the project folder directory, you need to create this folder and make sure the name is correct, and the subsequent library files will be stored here
  • When copying the library, be sure to clean or migrate any other libraries in the directory first to avoid replacement or library conflicts

ESP32-S3-AMOLED-1.91-Ar-lib-08.png
ESP32-S3-AMOLED-1.91-Ar-lib-05.png

  • The project folder path can be viewed underFile->preferences->Sketchbook location

ESP32-S3-AMOLED-1.91-Ar-lib-06.png


  • ESP32-S3-LCD-1.47 library installation description
Library NameDescriptionVersionLibrary Installation Requirements
LVGLGraphical libraryv8.3.10"Install Offline”
PNGdecDecode PNG image formatsv1.0.2"Install Offline”
For more learning and use of LVGL, please refer to LVGL official documentation

Demos

Demo-flow-01.png

  • ESP32-S3-LCD-1.47 demos
DemoBasic DescriptionDependency Library
LVGL_ArduinoTest onboard device functionalityLVGL
LCD_ImageDisplay TF card root directory PNG file at intervalsPNGdec

Arduino project parameter settings


LVGL_Arduino

Hardware connection

  • Connect the development board to the computer

Code analysis

1. setup()

  • Flash_test(): Test and print the flash memory size information of the device
  • SD_Init(): Initialize the TF card
  • LCD_Init(): Initialize the display
  • Set_Backlight(90): Set the backlight brightness to 90
  • Lvgl_Init(): Initialize the LVGL graphics library
  • Lvgl_Example1(): Calls the specific LVGL example function
  • Wireless_Test2(): Call the test function for wireless communication

2. loop()

  • Timer_Loop(): Functions that handle timer-related tasks
  • RGB_Lamp_Loop(2): Update the RGB light color at regular intervals

Result demonstration

  • LCD screen display

600px-ESP32-S3-LCD-1.47-Ar-demo-02.png

For more learning and use of LVGL, please refer to LVGL official documentation

LCD_Image

TF card preparation

  • Add the image examples provided by Waveshare into the TF card

Hardware connection

  • Insert the TF card containing example images into the device
  • Connect the development board to the computer

Code analysis

1. setup()

  • Flash_test(): Test and print the flash memory size information of the device
  • SD_Init(): Initialize the TF card
  • LCD_Init(): Initialize the display
  • Set_Backlight(90): Set the backlight brightness to 90

2. loop()

  • Image_Next_Loop("/", ".png", 300): Display PNG files in the TF card root directory in sequence at regular time intervals
  • RGB_Lamp_Loop(2): Update the RGB light color at regular intervals

Result demonstration

  • The LCD displays PNG files in the root directory of the TF card in sequence at regular intervals

300px-ESP32-S3-LCD-1.47-Ar-demo-06.png300px-ESP32-S3-LCD-1.47-Ar-demo-07.png300px-ESP32-S3-LCD-1.47-Ar-demo-08.png

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

Demos

Demo-flow-01.png

  • ESP32-S3-LCD-1.47 demos
DemoBasic DescriptionDependency Library
ESP32-S3-LCD-1.47-TestTest onboard device functionalityLVGL

ESP32-S3-LCD-1.47-Test

Hardware connection

  • Connect the development board to the computer

Code analysis

1. setup()

  • Wireless_Init(): Initialize the wireless communication module
  • Flash_Searching(): Test and print the flash memory size information of the device
  • RGB_Init(): Initialize RGB-related functions
  • RGB_Example(): Display example functions of RGB
  • SD_Init(): Initialize the TF card
  • LCD_Init(): Initialize the display
  • BK_Light(50): Set the backlight brightness to 50
  • LVGL_Init(): Initialize the LVGL graphics library
  • Lvgl_Example1(): Calls the specific LVGL example function

2. while(1)

  • vTaskDelay(pdMS_TO_TICKS(10)): Short delay, every 10 milliseconds
  • lv_timer_handler(): Timer handling function for LVGL, used to handle events and animations related to time

Result demonstration

  • LCD displays onboard parameters:

600px-ESP32-S3-LCD-1.47-Ar-demo-03.png


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-SS-LCD-1.47-Demo\Firmware
Flash firmware flashing and erasing for reference

Resources

Schematic diagram

Demo

Application Example

Project Diagram

Datasheets

ESP32-S3

Other components

Software tools

Arduino

VScode

Flash Download 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:
  • 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: How to handle the display "waiting for download..." on the serial port after successfully ESP-IDF flashing?

 Answer:
  • If there is a reset button on the development board, press the reset button; if there is no reset button, please power it on again


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 the program flashing fail when using a MAC device?

 Answer:


Question: Why is there no output after successfully burning 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: 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

Price：
$12.31
Model：
ESP32-S3-LCD-1.47
Brand：
SpotPear
SKU：
0208034

ESP32-S3 Development Board 1.47 inch LCD Screen Display 172x320 SD-Port LVGL USB

[Tutorial Navigation]

©Copyright 2015 Berlinger Haus | All Rights Reserved
Address：Rm401, building 4, Enlai industrial city, Nankang Road, Danzhutou community, Nanwan street, Longgang District, Shenzhen
Email：services01@spotpear.com (Only tech support .Order see 'CONTACT US' at our web )