UEDX46460015-MD50ESP32-1.5inch-Touch-Knob-Display

• 中文

• UEDX46460015-MD50ET

  The Smart Knob Display powered by ESP32-S3.
  Featuring a 1.5-inch 466x466 AMOLED Display (QSPI), capacitive touch, rotary encoder and button.
  Ideal for IoT control panels, smart home devices and industrial HMI.

The UEDX46460015-MD50ET is a compact smart display module designed for knob‑style HMI applications.
It combines a 1.5‑inch AMOLED display (466×466 pixels) with a capacitive touch panel, a rotary encoder and a hardware button.

Powered by the ESP32‑S3‑R8 (16 MB Flash, 8 MB Octal PSRAM), it provides Wi‑Fi and Bluetooth 5 (LE) connectivity, and supports development with Arduino, ESP‑IDF and PlatformIO.

• Processor:
  • ESP32-S3: Xtensa® Dual‑Core 32‑bit LX7 MCU @ 240 MHz.
  • Integrated 2.4 GHz Wi‑Fi (802.11 b/g/n) & Bluetooth 5 (LE).
• Memory:
  • 16 MB Quad SPI Flash.
  • 8 MB Octal SPI PSRAM.
• Display & Touch:
  • Screen: 1.5‑inch IPS AMOLED (466×466 Resolution).
  • Interface: QSPI.
  • Driver IC: CO5300AF‑42.
  • Touch: Capacitive Multi‑Touch (CST820) via I²C.
• Peripherals:
  • Encoder: Rotary encoder (PHA/PHB) for precise knob input.
  • Button: Hardware button (shared with BOOT).
  • Connectivity: USB‑C (USB/UART for programming and debugging), UART expansion (FPC).
  • Expansion FPC: Extra GPIO, 5V, GND, UART0.

• Smart Home Control Knobs
• Industrial Knob‑based HMI
• IoT Device Dials
• Wearable / Compact User Interfaces

The main functional blocks of the board are:

Refer to the product specification sheet for detailed dimensions.

We provide comprehensive support for Arduino, PlatformIO, and ESP‑IDF frameworks, with pre‑ported LVGL examples.

Examples are available in the GitHub Repository (examples folder).

• Hardware: UEDX46460015‑MD50ET Board, USB‑C Cable.
• Software: VS Code (ESP‑IDF v5.3+) or Arduino IDE (v2.0+) or VS Code (PlatformIO).
• Libraries: The following libraries are required for Arduino IDE and PlatformIO.

For detailed procedures, please refer to the esp-idf example folder at README.md or README_CN.md. The general steps are as follows:

1. Open the example

   • Download the repository from GitHub (click the green "Code" button and select "Download ZIP", or clone it).
   • Open the example folder (e.g., examples/esp_idf) using VS Code with the ESP‑IDF extension.

2. Compile and upload

   • Click the build icon to compile the project.
   • Connect the board via USB‑C.
   • Click the upload icon to flash the firmware.

1. Install Arduino IDE

   • Download and install the Arduino IDE (v2.0+ recommended).

2. Install ESP32 Board Package

   • Open Arduino IDE and go to File > Preferences.
   • Add the following URL in “Additional boards manager URLs”:
     https://espressif.github.io/arduino-esp32/package_esp32_index.json
   • Go to Tools > Board > Boards Manager, search for esp32 by Espressif and install version 3.0.0+.

3. Install Libraries

   • Go to Sketch > Include Library > Library Manager.
   • Search for ESP32_Display_Panel by Espressif and install version 1.0.3+. When prompted, click INSTALL ALL to install the dependencies.
   • Install lvgl (version 8.4.0).

4. Open Example

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

5. Select Board

   • Target: ESP32S3 Dev Module.
   • Configure the following settings:
     • Flash Size: 16MB (128Mb)
     • Partition Scheme: 16M Flash (3MB APP/9.9MB FATFS)
     • PSRAM: OPI PSRAM (this is critical)

6. Configure the Supported Board

   • In the example, open the file esp_panel_board_supported_conf.h.
   • Set the macro ESP_PANEL_BOARD_DEFAULT_USE_SUPPORTED to 1.
   • Locate the line // #define BOARD_VIEWE_UEDX46460015_MD50ET and uncomment it by removing the //.
   • Ensure no other board definition is enabled at the same time.

7. Interface‑Specific Configuration

   • Since the board uses a QSPI interface, open lv_conf.h (or the example’s lv_conf.h equivalent) and set LV_COLOR_16_SWAP to 1.
   • Do not modify LVGL_PORT_AVOID_TEARING_MODE or LVGL_PORT_ROTATION_DEGREE (they are only relevant for RGB/MIPI displays).

8. Select Port and Upload

   • Connect the board, then go to Tools > Port and select the correct COM port.
   • Click the Verify (✓) button to compile.
   • Click the Upload (→) button to flash.

1. Open the example

   • Download the repository and open the examples/platformio/lvgl_v8_port folder in VS Code with the PlatformIO extension.

2. Select the Board Environment

   • Open the platformio.ini file.
   • Change the default_envs line to BOARD_VIEWE_UEDX46460015_MD50ET.

3. Configure the Example

   • (QSPI interface) In lv_conf.h, set LV_COLOR_16_SWAP to 1.
   • Leave LVGL_PORT_AVOID_TEARING_MODE and LVGL_PORT_ROTATION_DEGREE untouched.

4. Compile and Upload

   • Click the ✓ (Compile) button.
   • Connect the board, then click the → (Upload) button.

If you need to flash a pre‑compiled binary manually:

1. Open the “Flash Download Tool” (available in the tools folder or from Espressif’s website).
2. Select the chip type (ESP32‑S3) and the correct download method.
3. Load the firmware files from the firmware folder and configure the offsets as described in the firmware readme.
4. Connect the board and start the download.
   If flashing fails, hold down the BOOT button while powering on, then retry.

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

products specification

Display Datasheet

button

Encoder

schematic