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

• Describe
• Module
• PinOverview
• QuickStart
• FAQ
• Schematic
• Information
• DependentLibraries

Describe

UEDX24240013-MD50ESP32_1.3inch-Knob-Display is a development board with square 1.3-inch 240 * 240 resolution display, based on ESP32C3, suitable for the development of microcontroller projects with display.

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/UART Pin	ESP32C3 Pin
USB-DN	IO18
USB-DP	IO19

QuickStart

Examples Support

Example	Support IDE And Version	Description	Picture
ESP-IDF	[ESP-IDF V5.1/5.2/5.3]	idf driver example code
SquareLinePorting	[Arduino IDE][>= esp32_v3.0.7]	SquareLine porting example for Arduino

Firmware	Description	Picture
ESP-IDF	Original

PlatformIO

1. InstallVisualStudioCode,Choose installation based on your system type.

2. Open the "Extension" section of the Visual Studio Code software sidebar(Alternatively, use "Ctrl+Shift+X" to open the extension),Search for the "PlatformIO IDE" extension and download it.

3. During the installation of the extension, you can go to GitHub to download the program. You can download the main branch by clicking on the "<> Code" with green text.

4. After the installation of the extension is completed, open the Explorer in the sidebar(Alternatively, use "Ctrl+Shift+E" go open it),Click "Open Folder", find the project code you just downloaded (the entire folder), then find the PlatformIO folder and click "Add". At this point, the project file will be added to your workspace.

5. Open the "platformio.ini" file in the project folder (PlatformIO will automatically open the "platformio.ini" file corresponding to the added folder). Under the "[platformio]" section, uncomment and select the example program you want to burn (it should start with "default_envs = xxx") Then click "√" in the bottom left corner to compile,If the compilation is correct, connect the microcontroller to the computer and click "→" in the bottom left corner to download the program.

Arduino

1. InstallArduino,Choose installation based on your system type.

2. Open the "example" directory within the project folder, select the example project folder, and open the file ending with ".ino" to open the Arduino IDE project workspace.

3. Open the "Tools" menu at the top right -> Select "Board" -> "Board Manager." Find or search for "esp32" and download the board files from the author named "Espressif Systems." Then, go back to the "Board" menu and select the development board type under "ESP32 Arduino." The selected development board type should match the one specified in the "platformio.ini" file under the [env] section with the header "board = xxx." If there is no corresponding development board, you may need to manually add the development board from the "board" directory within your project folder.

4. Open menu bar "File" -> "Preferences" ,Find "Sketchbook location" here,copy and paste all library files and folders from the "libraries" folder in the project directory into the "libraries" folder in this directory.

5. Select the correct settings in the Tools menu, as shown in the table below.

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	Huge APP
Upload Speed	921600

6. Select the correct port.

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

firmware download

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

DependentLibraries

• ESP32_Display_Panel>0.2.1 (Please download the library first as the latest version has not been released yet)
• ESP32_IO_Expander (Please download the library first as the latest version has not been released yet)
• ESP32_Button
• ESP32_Knob
• lvgl-8.4.0