T-Encoder Quick Start

Required Libraries

Library	Version	Source
LovyanGFX	Latest	GitHub
LilyGo-display-library	Latest	Xinyuan-LilyGO/LilyGo-display-library
LVGL	8.x	GitHub

---

Arduino

PlatformIO (Recommended)

1. Install VS Code and the PlatformIO IDE extension
2. Clone the repository:

   git clone https://github.com/Xinyuan-LilyGO/T-Encoder.git

3. Open platformio.ini and select the target example
4. Click Build to build, connect via USB-C, click Upload to upload

---

Arduino IDE

1. Install ESP32 Board Support

1. Open Arduino IDE -> File -> Preferences
2. Add to "Additional Board Manager URLs":

   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

3. Go to Tools -> Board -> Boards Manager, search esp32, install esp32 by Espressif Systems

2. Board Settings

Setting	Value
Board	ESP32S3 Dev Module
Upload Speed	921600
USB CDC On Boot	Enable
CPU Frequency	240 MHz (WiFi)
Flash Mode	QIO 80 MHz
Flash Size	16 MB (128Mb)
Partition Scheme	16M Flash (3MB APP/9.9MB FATFS)
PSRAM	OPI PSRAM

3. Upload

Connect via USB-C and click Upload.

---

Peripheral Examples

Encoder + GC9A01 Round Display

#define LILYGO_LGFX_USE_T_ENCODER
#include <LilyGo_LovyanGFX.h>

#define ENC_A   4
#define ENC_B   5
#define ENC_BTN 0

LilyGo_T_Encoder display;
int encoderPos = 0;
int lastA = HIGH;

void setup() {
    pinMode(ENC_A, INPUT_PULLUP);
    pinMode(ENC_B, INPUT_PULLUP);
    pinMode(ENC_BTN, INPUT_PULLUP);
    display.begin(0);
    display.setTextColor(TFT_WHITE, TFT_BLACK);
    display.setTextSize(3);
    display.setCursor(80, 110);
    display.println("0");
}

void loop() {
    int currentA = digitalRead(ENC_A);
    if (currentA != lastA && currentA == LOW) {
        encoderPos += (digitalRead(ENC_B) == LOW) ? 1 : -1;
        display.fillScreen(TFT_BLACK);
        display.setCursor(80, 110);
        display.println(encoderPos);
    }
    lastA = currentA;
}

---

FAQ

Q: Upload keeps failing?
A: Hold BOOT, press and release RST, then release BOOT to enter download mode.

Q: Encoder direction is reversed?
A: Swap ENC_A and ENC_B pin assignments in code, or physically reverse the encoder rotation logic.