ESP32-S3-LCD-1.47

From Waveshare Wiki
Jump to: navigation, search
ESP32-S3-LCD-1.47
ESP32-S3-LCD-1.47.jpg

1.47 inch, I2C SPI
172×320
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

{{{name6}}}

Overview

Parameters

Items Parameters
Connector USB Type-A
Controller ESP32-S3
Screen TFT
Display Controller Display: ST7789
Onboard Device Micro SD


Onboard Function

Internal Hardware Connection

LCD

LCD PIN ESP32S3
MOSI GPIO45
SCLK GPIO40
LCD_CS GPIO42
LCD_DC GPIO41
LCD_RST GPIO39
LCD_BL GPIO48

RGB Beads

RGB Beads ESP32S3
SD_D0 / MISO GPIO38

SD Card

SD Card ESP32S3
SD_D0 / MISO GPIO16
SD_CMD / MOSI GPIO15
SD_SCK / SCLK GPIO14
SD_D3 / CS GPIO21
SD_D1 GPIO18
SD_D2 GPIO17

Working with ESP-IDF

The following development system is Windows by default, and it is recommended to use the VSCode plug-in for development.

Develop with VSCode Plug-in

Install VSCode

1. Open the download page of the official VSCode website, and select the corresponding system and system bit to download.
ESP32-S3-Pico 05.jpg
2. 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.
ESP32-S3-Pico 06.jpg

Install Espressif IDF Plug-in

  • Note: Currently the latest version of the plugin is V1.6.4, users can choose the same version as us for a consistent experience!
  • Open VSCode, use Shift+Ctrl+X to enter the plug-in manager.

ESP32-C6-DEV-KIT-N8-03.png

  • In the search bar, enter Espressif IDF to select the corresponding plug-in and click "Install".

ESP32-C6-DEV-KIT-N8-04.png

ESP32-C6-DEV-KIT-N8-05.png

  • Press F1 to input:
esp-idf: configure esp-idf extension

ESP32-C6-DEV-KIT-N8-06.png

  • Select express (This tutorial is intended for first-time installation users, so only the first general installation tutorial is covered).

ESP32-C6-DEV-KIT-N8-07.png

  • Select download sever.

ESP32-C6-DEV-KIT-N8-08.png

  • Select the version of ESP-IDF you want to use now, we choose the latest V5.1.1.

ESP32-C6-DEV-KIT-N8-09.png

  • The following two are the installation paths respectively for the ESP-IDF container directory and the ESP-IDF Tools directory.

ESP32-C6-DEV-KIT-N8-10.png

  • Note: If you have installed ESP-IDF before, or failed to do so, please be sure to delete the file completely or create a new path without Chinese.
  • After configuring, click "Install" to download:

ESP32-C6-DEV-KIT-N8-19.png

  • Enter the download interface, and then it will automatically install the corresponding tools and environment, just wait for a second.

ESP32-C6-DEV-KIT-N8-11.png

  • After the installation is complete, you will enter the following interface, indicating that the installation is finished.

ESP32-C6-DEV-KIT-N8-12.png

ESP Demo Usage Guide

Create Demo

  • Press F1 to enter:
esp-idf:show examples projects

ESP32-C6-DEV-KIT-N8-13.png

  • Select your current IDF version:

ESP32-C6-DEV-KIT-N8-14.png

  • Take the Hello World demo as an example:
    • ①Select the corresponding demo.
    • ②Its readme will state what chip the demo applies to (how the demo is used and the file structure are described below, omitted here).
    • ③Click to create the demo.

ESP32-C6-DEV-KIT-N8-15.png
Select the path to place the demo, no folder with the same name as the demo is required:
ESP32-C6-DEV-KIT-N8-16.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.

SP32-S3 TO Program Add 1.png

  • Select the project or demo to use:

ESP32-C6-DEV-KIT-N8-18.png

  • Then we finish the modification of the COM ports.

Modify the Driver Object

  • The driver object is displayed here, and you can modify it by clicking on it.
  • Select the project or demo to use.

ESP32-C6-DEV-KIT-N8-20.png

  • Wait for a minute after clicking.

ESP32-C6-DEV-KIT-N8-21.png

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

ESP32-S3-DEV-KIT-22.png

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

ESP32-S3-DEV-KIT-23.png

The Rest of the Status Bar

  • ①SDK configuration editor, supports modifying many features and configurations of ESP-IDF.
  • ②All cleanup, and clear all compiled files.
  • ③Compile.
  • ④Current download mode, default is UART.
  • ⑤Burn the current firmware, please do it after compiling.
  • ⑥Open the serial port monitor, used to view the serial port information.
  • ⑦Compile, burn, open the serial monitor all-in-one button, (most commonly used for debugging).
ESP32-C6-DEV-KIT-N8-24.png

Compile, Program, Serial Port Monitoring

  • Click on the all-in-one button we described before to compile, burn, and open the serial port monitor.
ESP32-C6-DEV-KIT-N8-25.png
  • It may take a long time to compile especially for the first time.
ESP32-C6-DEV-KIT-N8-26.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 burn the program for a new project, you will need to select the download method, and select UART.
ESP32-C6-DEV-KIT-N8-27.png
  • This can also be changed later in the Download Methods section (click on it to bring up the options).
ESP32-C6-DEV-KIT-N8-28.png
  • As it comes with the onboard automatic download circuit, there is no need for manual operation to download automatically.
ESP32-C6-DEV-KIT-N8-29.png
  • After successful download, automatically enter the serial monitor, you can see the chip output the corresponding information and be prompted to restart after 10S.
ESP32-C6-DEV-KIT-N8-30.png

Sample Demo

  • Open VScode software and select the file folder to open the example.

ESP32-S3-LCD-1.47 VScode example 1.png

  • Select the provided ESP-IDF example and click to select the file:

ESP32-S3-LCD-1.47 VScode example 2.png

  • After connecting the device, select the COM port and type, click to compile and run the demo:

ESP32-S3-LCD-1.47 VScode example 3.png

Working with Arduino

  • Please note that ESP32 3.0.2 on Arduino is based on ESP-IDF v5.1, which is quite different from the previous one based on ESP-IDF V4.X. After the following operations, the original program which can be run normally may need to be adjusted a little bit before it can be used.
  • Please note that the computer user name must be English, the user name in Chinese will lead to compilation errors!

Environment Set-up

ESP32-C6-DEV-KIT-N8-Arduino01.png

  • Enter Arduino IDE after installation.

ESP32-C6-DEV-KIT-N8-Arduino02.png

  • Enter preferences:

ESP32-Arduino-3.0.2 3.png

  • Add JSON link:
https://espressif.github.io/arduino-esp32/package_esp32_index.json

ESP32-Arduino-3.0.2 4.png
ESP32-Arduino-3.0.2 5.png

  • Modify the project file folder as C:\Users\Waveshare\AppData\Local\Arduino15\packages (Waveshare is the computer username).

ESP32-Arduino-3.0.2 6.png

  • Go to the board manager, search for esp32, select the latest version of esp32 by Espressif Systems at the bottom, and click install (if it doesn't install correctly, you can try using a phone hotspot).

ESP32-Arduino-3.0.2 7.png
ESP32-Arduino-3.0.2 8.png

  • Restart the Arduino IDE after installation, and then you can use it.

ESP32-S3-DEV-KIT-N8-Arduino09.png

If the installation fails

  • Failed to install 3.0.2 version:

ESP32-Arduino-3.0.2 Fail 1.png

ESP32-S3-DEV-KIT-N8-install02.png

  • Click on the path from the resource manager "c:\Users\Waveshare\AppData\Local\Arduino15\staging\packages" (Waveshare is the user name of the computer, and you need to turn on Show Hidden Files).

ESP32-S3-DEV-KIT-N8-install03.png

  • Unzip the downloaded files to the packages file folder:

ESP32-S3-DEV-KIT-N8-install04.png

  • Install it again:

ESP32-S3-DEV-KIT-N8-Arduino07.png

  • Restart the Arduino IDE after installation and you're ready to go!

ESP32-S3-DEV-KIT-N8-Arduino09.png

Install Library File

  • Please note whether the library has been previously installed, if so, please store the original library to prevent errors and failures when running other programs.
  • Open Arduino IDE and search the library.
  • Search for the lvgl library and install it (this is to set up the library folder in the Arduino environment, if you have already installed other libraries, i.e. the folder below exists, you don't need to do this step).

ESP32-S3-LCD-1.47 Lib 1.png

ESP32-S3-LCD-1.47 Lib 2.png

  • Enter the path of storing library file: c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries. (Waveshare is the computer username). This step is for entering libraries under the project file folder. If you are not ensure which file folder is, you can check it after entering Preferences.

ESP32-S3-LCD-1.47 Lib 3.png

  • Check it if the path is not clear:

ESP32-S3-LCD-1.47 Lib 4.png
ESP32-S3-LCD-1.47 Lib 5.png

  • Delete the downloaded lvgl library (skip this step if it is not installed):

ESP32-S3-LCD-1.47 Lib 6.png

  • Install the two provided libraries and create a new Lib folder in the example path.

ESP32-S3-LCD-1.47 Lib 7.png

  • Download and unzip the library file (lvgl library), and store it at the new lib path.
  • Copy the provided library to "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" (Waveshare is the computer username). Check it after entering Preferences.

ESP32-S3-LCD-1.47 Lib 8.png

  • Continue to install PNGdec library:

ESP32-S3-LCD-1.47 Lib 9.png

  • Finish.

Sample Demo

  • Open the LVGL_Arduino example, according to the following operation to realize the display, sample LCD display function.
  • Select ESP32S3 Dev Module and COM port.

ESP32-S3-LCD-1.47 Demo 1.png

  • Set the board parameters:

ESP32-S3-LCD-1.47 Demo 2.png

  • Compile and upload the demo:

ESP32-S3-LCD-1.47 Demo 3.png

  • The LVGL page can be observed after programming.
  • Example LCD_Imege can realize to display the PNG files in the root directory of the SD card at certain intervals, please note that the PNG files provided must be normal, and you can't directly modify the suffix to realize.
  • Products using the ESP32 in the Arduino IDE playability is relatively high, can be in the framework of the existing program simple UI interface modification can be realized cool operation, in some open source platforms on the resources can also be used directly under minor modifications.

Erase Device Flash

  • Unpack the software resource package (Flash debugging software).
  • Open flash_download_tool_3.9.5.exe software, select ESP32-S3 and USB.

ESP32-S3-Relay-6CH TO MicroPython Firmware 1.png

  • Select the UART port number, and click START (not select any bin file).

ESP32-S3-DEV-KIT-N8-84.png

  • After programming, click on "ERASE".

ESP32-S3-DEV-KIT-N8-85.png

  • Waiting for Erase to Finish.

ESP32-S3-DEV-KIT-N8-86.png

Resource

Document

ESP32-S3 Datasheet

Demo

FAQ

Question:Why does the module keep resetting and blinking its status on the Device Manager interface?

 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 burn the firmware (program) to solve the situation.

{{{5}}}


Question:After the module downloads the program and re-downloads it, sometimes it can't connect to the serial port or the burn-in 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.

{{{5}}}


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)

Retrieved from "https://www.waveshare.com/w/index.php?title=ESP32-S3-LCD-1.47&oldid=91048"