ESP32-C6-LCD-1.47

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

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

{{{name3}}}

{{{name4}}}

{{{name5}}}

{{{name6}}}


Overview

Introduction

ESP32-C6-LCD-1.47 is a microcontroller development board that supports 2.4GHz Wi-Fi 6 and BLE 5. It integrates 4MB Flash 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-C6 applications.

Features

  • Equipped with a high-performance 32-bit RISC-V processor with clock speed up to 160 MHz, and a low-power 32-bit RISC-V processor with clock speed as low as 20MHz
  • Supports 2.4 GHz Wi-Fi 6 (802.11 ax/b/g/n) and Bluetooth 5 (BLE), with onboard antenna
  • Built-in 320KB ROM, 512KB HP SRAM, 16KB LP SRAM, and 4MB 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

ESP32-C6-LCD-1.47-introduction-01.jpg

1. ESP32-C6FH4

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

3. TF card slot

4. Patch ceramic antenna

5. BOOT button

6. RESET button


Interfaces

ESP32-C6-LCD-1.47-introduction-02.jpg

  • LCD
LCD Pin ESP32C6
MOSI GPIO6
SCLK GPIO7
LCD_CS GPIO14
LCD_DC GPIO15
LCD_RST GPIO21
LCD_BL GPIO22
  • RGB light beads
RGB light beads ESP32C6
RGB_Control GPIO8
  • TF Card
TF Card ESP32C6
MISO GPIO5
MOSI GPIO6
SCLK GPIO7
CS GPIO4
SD_D1 NC
SD_D2 NC

Dimensions

ESP32-C6-LCD-1.47-introduction-03.jpg

Specifications

Parameter Name Parameter
Interface USB Type-C
Controller chip ESP32-C6
LCD type TFT
LCD controller chip Display: ST7789
Onboard devices TF

Usage Instructions

ESP32-C6-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-C6-LCD-1.47 x1
  • TF card x 1
  • USB cable (Type-A to Type-C) x 1
  • Card reader x1

450px-ESP32-C6-LCD-1.47-uesnotes-01.png


Before operating, it is recommended to browse the table of contents to quickly understand the document structure. For smooth operation, please read the FAQ carefully to understand possible problems in advance. All resources in the document are provided with hyperlinks for easy download.

Working with Arduino

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

Environment Setup

Download and install Arduino IDE

  • Click to visit the Arduino official website, select the corresponding system and system bit to download
    ESP32-S3-AMOLED-1.91-Ar-software-01.png
  • Run the installer and install all by default

Install ESP32 development board

  • Regarding ESP32-related motherboards used with the Arduino IDE, the esp32 by Espressif Systems library must be installed first.
  • 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 by Espressif Systems development board comes with an offline package. Click here to download: esp32_package_3.0.2_arduino offline package
  • ESP32-C6-LCD-1.47 required development board installation description
Board name Board installation requirement Version number requirement
esp32 by Espressif Systems "Install Offline" / "Install Online" ≥3.0.0

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-C6-LCD-1.47 library file is stored in the sample program, click here to jump: ESP32-C6-LCD-1.47 Demo
  • ESP32-C6-LCD-1.47 library file installation description
Library Name Description Version Library Installation Requirement
LVGL Graphical library v8.3.10 "Install Offline"
PNGdec Decode PNG image formats v1.0.2 "Install Offline"
For more learning and use of LVGL, please refer to LVGL official documentation

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
    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, click Save

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:

①. 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.
ESP32-S3-AMOLED-1.91-Ar-study-03.png

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

ESP32-S3-AMOLED-1.91-Ar-study-07.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:

①. Compile the program; ②. Compile and download the program; ③. 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:

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

Demo

Demo-flow-01.png

  • ESP32-C6-LCD-1.47 demos
Demo Basic Description Dependency Library
LVGL_Arduino Test onboard device functionality LVGL
LCD_Image Display TF card root directory PNG file at intervals PNGdec

Arduino project parameter setting

ESP32-C6-LCD-1.47 Demo 3.png

LVGL_Arduino

Demo description

  • This example demonstrates the functions of each device on the board, LCD page displays SD Card, Flash Size, Wireless scan and other parameters

Hardware connection

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

300px-ESP32-C6-LCD-1.47-demo-03.png

Code analysis

  • setup()
    • Flash_test(): Tests and prints the flash memory size information of the device
    • LCD_Init(): Initializes the display
    • Lvgl_Init(): Initializes the LVGL graphics library
    • SD_Init(): Initializes the TF card
    • Lvgl_Example1(): Calls the specific LVGL example function
    • Wireless_Test2(): Calls the test function for wireless communication
  • loop()
    • Timer_Loop(): Functions that handle timer-related tasks

Demo flashing

  • Select the development board ESP32S3 Dev Module and port
  • Flash the demo

Result demonstration

  • LCD screen display

300px-ESP32-C6-LCD-1.47-demo-01.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, and you can also add your own images (pixel ≤ 172×320)

ESP32-S3-LCD-1.47-Ar-demo-04.png
ESP32-S3-LCD-1.47-Ar-demo-05.png

Hardware connection

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

Code analysis

  • void Display_Image(const char* directory, const char* fileExtension, uint16_t ID)
    • First, call Search_Image(directory, fileExtension) search for image files with the specified extension in a given directory, and store the count of found images in the global variable Image_CNT
    • If Image_CNT is not zero, one or more images have been found. Construct the full path of the image file based on whether the directory is a root directory, convert it to a C-style string for debugging purposes, and finally call the Show_Image function to display the image
    • If no image is found (Image_CNT is zero), an error message is printed indicating that a file with the specified extension was not found in the given directory

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
    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.
The environment setup is carried out on the Windows 10 system, Linux and Mac users can access ESP-IDF environment setup for reference

Install Espressif IDF Plugin

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

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

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

①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
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 path to openocd, it doesn't affect us here, so let's just choose one

ESP32-S3-AMOLED-1.91-study-09.png

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"

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

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

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 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:

ESP32-P4 VSCode ESP-IDF GettingStart 240906 02.png

Demo

Demo-flow-01.png

  • ESP32-C6-LCD-1.47 demos
Demo Basic Description Dependency Library
ESP32-C6-LCD-1.47-Test Test onboard device functionality LVGL

ESP32-C6-LCD-1.47-Test

Demo description

  • This example demonstrates the functions of each device on the board, LCD page displays SD Card, Flash Size, Wireless scan parameters and CPU utilization

Hardware connection

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

300px-ESP32-C6-LCD-1.47-demo-03.png

Code analysis

  • setup()
    • Wireless_Init(): Initializes the wireless communication module
    • Flash_Searching(): Tests and prints the flash memory size information of the device
    • RGB_Init(): Initializes RGB-related functions
    • RGB_Example(): Displays example functions of RGB
    • SD_Init(): Initializes the TF card
    • LCD_Init(): Initializes the display
    • BK_Light(50): Sets the backlight brightness to 50
    • LVGL_Init(): Initializes the LVGL graphics library
    • Lvgl_Example1(): Calls the specific LVGL example function
  • 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

Demo flashing

  • Select the development board model ESP32C6 and port
  • UART download
  • Flash the demo

Result demonstration

  • LCD displays onboard parameters:

300px-ESP32-C6-LCD-1.47-demo-02.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-C6-LCD-1.47-Demo\Firmware
Flash firmware flashing and erasing for reference

Resources

Schematic diagram

Demo

Project Diagram

Application Examples

Datasheets

ESP32-C6

Other components

Software tools

Arduino

VScode

Debugging tool

Other resource link

Project Resources

This section features third - party project resources. We merely provide links and bear no responsibility for content updates or maintenance. Thank you for your understanding.
Volos Projects-How to Interact with Your UI - LVGL and Squareline Studio

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



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-C6-LCD-1.47&oldid=98366"