LILYGO T-Encoder Pro

Version History:

Purchase Links

Table of Contents

• Description
• Preview
• Modules
• Quick Start
• Pin Overview
• FAQ
• Projects
• Resources
• Dependent Libraries

Description

The LILYGO T-Encoder-Pro is a smart control knob development board equipped with an AMOLED touchscreen. Its core is based on the high-performance ESP32-S3 R8 Wi-Fi/Bluetooth dual-mode chip, integrated with a 2.04-inch SH8601A touch AMOLED display (resolution 390×390) supporting capacitive touch interaction. It features rich hardware functionality including a rotary encoder (supporting left/right rotation and press operation), buzzer, vibration motor, 8MB PSRAM, and 16MB Flash storage, and comes with dual Qwiic 4-Pin interfaces for quick expansion of sensors or modules. Designed with a focus on high integration and interactivity, it is suitable for embedded UI development, smart home control panels, audio mixers, portable device prototypes, or IoT endpoints, balancing low power consumption with high performance requirements.

Preview

Physical Image

Pinout Diagram

Modules

MCU

• Chip: ESP32-S3-R8
• PSRAM: 8M (Octal SPI)
• FLASH: 16M
• Other Notes: For more information, please visit the Espressif Official ESP32-S3 Datasheet

Display

• Size: 2.04-inch AMOLED
• Resolution: 390×390px
• Display Type: AMOLED
• Driver IC: SH8601A-W14-T06
• Compatible Library: Arduino_GFX
• Bus Communication Protocol: SPI/QSPI

Touch

• Chip: CHSC5816
• Bus Communication Protocol: I2C

Encoder

• Type: Rotary Encoder
• Function: Supports left/right rotation and press operation

Feedback Devices

• Buzzer: Audio feedback
• Vibration Motor: Haptic feedback

Overview

Quick Start

Example Support

PlatformIO

1. Install VisualStudioCode, choose the version for your system.
2. Open the "Extensions" in the sidebar of Visual Studio Code (or use Ctrl+Shift+X), search for the "PlatformIO IDE" extension and install it.
3. While the extension is installing, you can go to GitHub to download the program. You can download the main branch code by clicking the green "<> Code" button, or download the "Releases" version from the sidebar.
4. After the extension is installed, open the sidebar's Explorer (or use Ctrl+Shift+E), click "Open Folder", find the project code you just downloaded (the entire folder), click "Add", and the project files will be added to your workspace.
5. Open the "platformio.ini" file in the project folder (PlatformIO will automatically open the "platformio.ini" of the corresponding folder after adding it). Under the "[platformio]" section, uncomment to select the example program you want to upload (marked by "default_envs = xxx"). Then click the "√" at the bottom left to compile. If the compilation is successful, connect the microcontroller to your computer and click "→" at the bottom left to upload.

Arduino

1. Install Arduino IDE, choose the version for your system.

2. Open the "example" directory in 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 in the top bar -> Select "Board" -> "Boards Manager", find or search for "esp32", and install the board files by "Espressif Systems". Then return to the "Board" menu and select the board type under "ESP32 Arduino". The board type to select is determined by the "board = xxx" header under the [env] section in the "platformio.ini" file. If the corresponding board is not available, you need to manually add the board from the "board" directory in the project folder.

4. Open the menu bar "File" -> "Preferences", find the "Sketchbook location" field, and copy all the library files along with their folders from the "libraries" folder in the project directory to the "libraries" folder in this location.

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

6. Select the correct port.

7. Click the "[√]" in the top right corner to compile. If the compilation is successful, connect the microcontroller to your computer and click "[→]" in the top right corner to upload.

Development Platforms

1. Micropython
2. Arduino IDE
3. Platform IO

Pin Overview

For detailed pin definitions, please refer to the schematic diagram.

Related Tests

(Encoder accuracy, touch response, power consumption test data to be added)

FAQ

• Q. What are the main application scenarios for the T-Encoder Pro?
  A. The T-Encoder Pro is suitable for smart home control panels, audio equipment mixers, industrial HMI interfaces, multimedia controllers, and other scenarios requiring precise knob control and graphical display.

• Q. What operations does the encoder support?
  A. The encoder supports left/right rotation (for value adjustment, menu selection, etc.) and press operation (for confirmation, selection, etc.).

• Q. How to connect external sensors?
  A. You can quickly connect compatible sensor modules via the two onboard QWIIC 4-pin interfaces, supporting plug-and-play.

• Q. How is haptic feedback achieved?
  A. Haptic feedback is provided by the vibration motor, which can offer physical feedback during rotary encoder operation or specific events, enhancing the user experience.

• Q. What is the display quality like?
  A. It uses a 2.04-inch AMOLED screen with a resolution of 390×390, providing clear and vibrant display effects and supporting touch operation.

Projects

• SCH_T-Encoder-Pro_V1.0
• SCH_T-Encoder-Pro_V1.0_TFT_FPC

Resources

• ESP32-S3 Datasheet
• CHSC5816 Datasheet
• CHSC5816 Application Note
• DXQ120MYB2416A Datasheet

Dependent Libraries

• Arduino_GFX-1.3.7
• lvgl-8.3.5
• SensorLib-0.1.4