UEDX24240013-MD50ESP32_1.3inch-Knob-Display

English | 中文

Introduction to the Repository Directory

├── Libraries                 Library files required for the Arduino example  
├── Schematic                 The circuit schematic of the product   
├── examples                  Sample files, including the IDF framework and the Arduino framework
├── image                     Product or sample project related images
├── information               Product specifications, including the IC or peripherals involved
├── tools                     Burn tool and image conversion tool
└── README.md                 This is the file you are currently reading,Give a brief introduction to the product

Version iteration:

Development board Version	Screen size	Resolution	Update date	Update description
UEDX24240013-MD50E	1.3-inch	240*240	2024-07-23	Original version

PurchaseLink

Product	SOC	FLASH	RAM	Link
UEDX24240013-MD50E	ESP32c3	4M	400KB	VIEWE Mall

Directory

• Module
• PinOverview
• FPC PIN
• QuickStart
• FAQ
• Schematic
• Information

Module

1.MCU

• Chip: ESP32-C3
• FLASH: 4M
• For more details, please visitEspressif ESP32-C3 Datashee

2. Screen

• Size: 1.3-inch IPS screen
• Resolution: 240x240px
• Screen type: IPS
• Driver chip: GC9A01
• Compatibility library: ESP32_Display_Panel
• Bus communication protocol: 4 Wire SPI

3. Touch

• Chip: No touch

PinOverview

IPS Screen Pin	ESP32C3 Pin
SPI-CS	IO10
SPI-SCK	IO1
SPI-SDA	IO0
SPI-DC	IO4
LCD-TE	IO5
BACKLIGHT	IO8

button Pin	ESP32C3 Pin
boot	IO9

Encoder Pin	ESP32C3 Pin
PHA	IO7
PHB	IO6

USB	ESP32C3 Pin
USB-DN	IO18
USB-DP	IO19

UART Pin	ESP32C3 Pin
UART0RXD	IO20
UART0TXD	IO21

FPC PIN

FPC number	Adapter Pin	ESP32C3 Pin
1	5V	5V
2	PB7	GPIO3
3	GND	GND
4	RX2	NC
5	TX2	NC
6	RX1	UART0RXD/IO20
7	TX1	UART0TXD/IO21
8	NC	CHIP-EN
9	SK & D+	USB-DP/ IO19
10	SD & D-	USB-DN/ IO18

QuickStart

Software Framework Configuration

Support IDE	Version
[ESP-IDF]	[V5.1/5.2/5.3]
[Arduino IDE]	[esp32 >=v3.1.0]
[Platformio IDE]

ESP-IDF Framework (Novice tutorial)

• Supported Versions: v5.1/5.2/5.3
• Download the example code from the repository and compile/run it directly.
• Repository Address: examples

Arduino Framework ([Novice tutorial](Novice tutorial)

1. InstallArduino

• Choose installation based on your system type.
• Newcomers please refer to the beginner's tutorial.

2. Install ESP32 SDK

• Open Arduino IDE

• Go to File > Preferences

• Add to Additional boards manager URLs:

  https://espressif.github.io/arduino-esp32/package_esp32_index.json
  

• Navigate to Tools > Board > Boards Manager

• Search for esp32 by Espressif Systems

• select 3.1.0 and above,click the INSTALL button to install

3. Install Required Libraries

ID	Library	Version
1	ESP32_Display_Panel	The latest version is recommended
2	ESP32_Button	The latest version is recommended
3	ESP32_Knob	The latest version is recommended
4	lvgl-8.4.0	8.4.0（V9 is not supported temporarily）

ESP32_Display_Panel and its dependencies are available in Arduino Library Manager. Install online:

• In Arduino IDE, go to Sketch > Include Library > Manage Libraries....
• Search for the ESP32_Display_Panel library and select 1.0.3 and above, click the Install button to install, you will be prompted whether to install its dependencies, please click INSTALL ALL to install all.
• Install LVGL library (optional), recommended version 8.4.0.

For manual installation, you can download the required version's .zip file from Github or Arduino Library, then in Arduino IDE navigate to Sketch > Include Library > Add .ZIP Library..., select the downloaded .zip file and click Open to install.

Note

• LVGL is only required for GUI examples

4. Select and configure board

• Navigate to Tools > Board > esp32 > ESP32C3 Dev Module

5. Open example

• Navigate to File > Examples > ESP32_Display_Panel
• Select Arduino > gui > lvgl_v8 > simple_port

6. Modify code

• Modify macros definitions in esp_panel_board_supported_conf.h to enable target board.

• Enable file macro definition: #define ESP_PANEL_BOARD_DEFAULT_USE_SUPPORTED (0) ---> #define ESP_PANEL_BOARD_DEFAULT_USE_SUPPORTED (1)

• Cancel the comment of the corresponding board:// #define BOARD_VIEWE_UEDX24240013-MD50E ---> #define BOARD_VIEWE_UEDX24240013-MD50E

• here's part of the modified esp_panel_board_supported_conf.h file:

  ...
  /**
  * @brief Flag to enable supported board configuration (0/1)
  *
  * Set to `1` to enable supported board configuration, `0` to disable
  */
  #define ESP_PANEL_BOARD_DEFAULT_USE_SUPPORTED       (1)
  ...
  // #define BOARD_VIEWE_SMARTRING
  #define BOARD_VIEWE_UEDX24240013_MD50E
  // #define BOARD_VIEWE_UEDX24320024E_WB_A
  // #define BOARD_VIEWE_UEDX24320028E_WB_A
  // #define BOARD_VIEWE_UEDX24320035E_WB_A
  // #define BOARD_VIEWE_UEDX32480035E_WB_A
  // #define BOARD_VIEWE_UEDX46460015_MD50ET
  // #define BOARD_VIEWE_UEDX48270043E_WB_A
  // #define BOARD_VIEWE_UEDX48480021_MD80E_V2
  // #define BOARD_VIEWE_UEDX48480021_MD80E
  // #define BOARD_VIEWE_UEDX48480021_MD80ET
  // #define BOARD_VIEWE_UEDX48480028_MD80ET
  // #define BOARD_VIEWE_UEDX48480040E_WB_A
  // #define BOARD_VIEWE_UEDX80480043E_WB_A
  // #define BOARD_VIEWE_UEDX80480050E_AC_A
  // #define BOARD_VIEWE_UEDX80480050E_WB_A
  // #define BOARD_VIEWE_UEDX80480050E_WB_A_2
  // #define BOARD_VIEWE_UEDX80480070E_WB_A
  ...

Warning

• Do not enable both ESP_PANEL_BOARD_DEFAULT_USE_SUPPORTED and ESP_PANEL_BOARD_DEFAULT_USE_CUSTOM
• You cannot enable multiple boards simultaneously

7. Configure tool options :

   ESP32-C3

   Setting	Value
   Board	ESP32C3 Dev Module
   CPU Frequency	160MHz (WiFi)
   Core Debug Level	None
   USB CDC On Boot	Disabled
   Erase All Flash Before Sketch Upload	Disabled
   Flash Frequency	80MHz
   Flash Mode	QIO
   Flash Size	4MB (32Mb)
   JTAG Adapter	Disabled
   Partition Scheme	Custom
   Upload Speed	921600

8. Select the correct port.

9. Click "√" in the upper right corner to compile,If the compilation is correct, connect the microcontroller to the computer,Click "→" in the upper right corner to download.

Note

LVGL color swap settings,SPI and QSPI screens need to set the macro of lv_conf.h > LV_COLOR_16_SWAP to 1 and the RGB screen to 0, as follows :

```c
/**
 * @file lv_conf.h
 * Configuration file for v8.4.0
 */

/* clang-format off */
#if 1 /*Set it to "1" to enable content*/

#ifndef LV_CONF_H
#define LV_CONF_H

#include <stdint.h>

/*====================
   COLOR SETTINGS
 *====================*/

/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
#define LV_COLOR_DEPTH 16

/*Swap the 2 bytes of RGB565 color. Useful if the display has an 8-bit interface (e.g. SPI)*/
#define LV_COLOR_16_SWAP 1
...
```

firmware download

Firmware	Description	Picture
ESP-IDF	Original

1. Open the project file "tools" and locate the ESP32 burning tool. Open it.

2. Select the correct burning chip and burning method, then click "OK." As shown in the picture, follow steps 1->2->3->4->5 to burn the program. If the burning is not successful, press and hold the "BOOT-0" button and then download and burn again.

3. Burn the file in the root directory of the project file "firmware" file,There is a description of the firmware file version inside, just choose the appropriate version to download.

FAQ

• Q. After reading the above tutorials, I still don't know how to build a programming environment. What should I do?
• A. If you still don't understand how to build an environment after reading the above tutorials, you can refer to the VIEWE-FAQ document instructions to build it.

• Q. Why does Arduino IDE prompt me to update library files when I open it? Should I update them or not?
• A. Choose not to update library files. Different versions of library files may not be mutually compatible, so it is not recommended to update library files.

• Q. Why is there no serial data output on the "Uart" interface on my board? Is it defective and unusable?
• A. The default project configuration uses the USB interface as Uart0 serial output for debugging purposes. The "Uart" interface is connected to Uart0, so it won't output any data without configuration.
  For PlatformIO users, please open the project file "platformio.ini" and modify the option under "build_flags = xxx" from "-D ARDUINO_USB_CDC_ON_BOOT=true" to "-D ARDUINO_USB_CDC_ON_BOOT=false" to enable external "Uart" interface.
  For Arduino users, open the "Tools" menu and select "USB CDC On Boot: Disabled" to enable the external "Uart" interface.

• Q. Why is my board continuously failing to download the program?
• A. Please hold down the "BOOT" button and try downloading the program again.

Schematic

Information

products specification

Display Datasheet

button

Encoder

esp32c3 Datasheet(English)

esp32c3 Datasheet(Chinese)