Component guide · Intermediate · 5 min read
LilyGO Display Boards

T-Display, T-Display-S3, AMOLED and Long, T4-S3, T-Deck, T-Embed, T-Track, T-Circle, T-RGB, T-HMI, T-Panel, T-QT, T-Dongle and T-Keyboard
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
LilyGO makes compact ESP32 boards with built-in screens. The T-Display (1.14 inch) and T-Display-S3 (1.9 inch) are the classics for small dashboards; AMOLED, Long (3.4 inch) and T4-S3 versions give sharper or bigger screens; the T-Deck is a pocket computer with a keyboard and LoRa option; T-Embed adds a rotary knob and speaker; and T-Dongle boards are USB-stick gadgets.
Key specs at a glance
- Chips
- ESP32, ESP32-S2, ESP32-S3, ESP32-C6
- Screens
- 0.85 to 4 inch LCD, AMOLED or round RGB
- Input
- Buttons, touch, rotary encoder, trackball or keyboard
- Memory
- Up to 16 MB flash and 8 MB PSRAM on S3 boards
- Power
- USB-C, LiPo charging on most
- Software
- Arduino (TFT_eSPI, LVGL), ESP-IDF, MicroPython
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
Option 1LilyGO T-DISPLAY ESP32 Development Board w/ 1.14-Inch IPS Display₹1,279
Option 2LilyGO T-Display ESP32 WiFi Bluetooth Dev Board w/ 1.14-Inch LCD₹1,469
Option 3LilyGO T-Display-S3 ESP32 1.9-Inch Touch Display Dev Board₹3,169
Option 4LilyGO T-Display-S3 AMOLED ESP32-S3 1.91-Inch RM67162 Display Board₹3,709
Option 5LilyGO T-Display-S3 AMOLED ESP32-S3R8 Dev Board₹4,199
Option 6LilyGO T-Display S3 Long ESP32-S3 Dev Board w/ 3.4-Inch Touch TFT₹3,829
What the LilyGO T-Display, T-Deck, T-Embed and other display boards is
LILYGO ESP32 display boards such as the T-Display, T-Display S3 and T-Deck combine an ESP32 with a colour TFT or AMOLED screen, buttons and a battery charger.
Install LilyGO's GitHub examples for each board: they include the correct TFT_eSPI setup file and pin map. The T-Display-S3 uses an 8-bit parallel screen, so generic SPI examples will not work without the setup file.
T-Panel-Lite has a second ESP32 for RS485 and Wi-Fi tasks; the T-Encoder shield adds macro keys to the T-Dongle.
LilyGO T-Display, T-Deck, T-Embed and other display boards pinout
The pins on the LilyGO T-Display, T-Deck, T-Embed and other display boards and what each one does.
| Pin | Function |
|---|---|
| USB-C | Power, flashing and serial |
| Built-in screen | SPI, QSPI, 8080 parallel or RGB, already wired |
| Touch / buttons | Capacitive touch, buttons, encoder or keyboard depending on the board |
| Expansion | Qwiic/Grove, header pins or microSD |
| Battery | LiPo connector and charger on most |
- USB-C
- Power, flashing and serial
- Built-in screen
- SPI, QSPI, 8080 parallel or RGB, already wired
- Touch / buttons
- Capacitive touch, buttons, encoder or keyboard depending on the board
- Expansion
- Qwiic/Grove, header pins or microSD
- Battery
- LiPo connector and charger on most
Wiring the LilyGO T-Display, T-Deck, T-Embed and other display boards
These boards are complete; use the maker's pin definitions for the screen and touch. Never connect a 5V signal to the 3.3V GPIO.
| LilyGO T-Display, T-Deck, T-Embed and other display boards pin | Connection | Note |
|---|---|---|
| USB-C | To a PC to flash | Hold BOOT if not detected |
| Battery | JST LiPo connector | Single cell 3.7V |
| Sensors | I2C or Grove port | 3.3V logic |
- USB-C
- Connection:
- To a PC to flash
- Note:
- Hold BOOT if not detected
- Battery
- Connection:
- JST LiPo connector
- Note:
- Single cell 3.7V
- Sensors
- Connection:
- I2C or Grove port
- Note:
- 3.3V logic
Example code
Copy the board's User_Setup from LilyGO's repository into TFT_eSPI, or use their bundled library version. Enable PSRAM for S3 boards.
#include <TFT_eSPI.h> // use the board's User_Setup file from the maker
TFT_eSPI tft;
int n = 0;
void setup() {
tft.init();
tft.setRotation(1);
tft.fillScreen(TFT_BLACK);
tft.setTextColor(TFT_GREEN, TFT_BLACK);
tft.setTextSize(3);
}
void loop() {
tft.setCursor(20, 50);
tft.printf("Count: %d ", n++);
delay(500);
}Setup and tuning
install the ESP32 core and pick the exact LILYGO board.
use TFT_eSPI or LovyanGFX with the setup file from the LILYGO GitHub.
on battery, turn on the display power pin (such as GPIO15 on the T-Display S3).
plug in a 3.7 V LiPo with the right JST polarity.
hold BOOT and tap RST if the port does not appear.
What you need
Shop this list20 of 20 found in our store · ₹76,220
LilyGO T-DISPLAY ESP32 Development Board w/ 1.14-Inch IPS Display: the part this guide coversLilyGO T-DISPLAY ESP32 Development Board w/ 1.14-Inch IPS Display₹1,279
LilyGO T-Display ESP32 WiFi Bluetooth Dev Board w/ 1.14-Inch LCD: another version this guide coversLilyGO T-Display ESP32 WiFi Bluetooth Dev Board w/ 1.14-Inch LCD₹1,469
LilyGO T-Display-S3 ESP32 1.9-Inch Touch Display Dev Board: another version this guide coversLilyGO T-Display-S3 ESP32 1.9-Inch Touch Display Dev Board₹3,169
LilyGO T-Display-S3 AMOLED ESP32-S3 1.91-Inch RM67162 Display Board: another version this guide coversLilyGO T-Display-S3 AMOLED ESP32-S3 1.91-Inch RM67162 Display Board₹3,709
LilyGO T-Display-S3 AMOLED ESP32-S3R8 Dev Board: another version this guide coversLilyGO T-Display-S3 AMOLED ESP32-S3R8 Dev Board₹4,199
LilyGO T-Display S3 Long ESP32-S3 Dev Board w/ 3.4-Inch Touch TFT: another version this guide coversLilyGO T-Display S3 Long ESP32-S3 Dev Board w/ 3.4-Inch Touch TFT₹3,829
LilyGO T4-S3 ESP32-S3 2.41-Inch AMOLED Touch Display Development Board: another version this guide coversLilyGO T4-S3 ESP32-S3 2.41-Inch AMOLED Touch Display Development Board₹8,709
LilyGO T-Deck ESP32-S3 Dev Board 2.8-Inch IPS w/ Keyboard & Trackball: another version this guide coversLilyGO T-Deck ESP32-S3 Dev Board 2.8-Inch IPS w/ Keyboard & Trackball₹7,349
LilyGO T-Embed Black IoT Panel w/ ESP32-S3 & 1.9-Inch LCD: another version this guide coversLilyGO T-Embed Black IoT Panel w/ ESP32-S3 & 1.9-Inch LCD₹5,249
LilyGO T-Track ESP32-S3 Wireless Display Dev Board w/ Trackball: another version this guide coversLilyGO T-Track ESP32-S3 Wireless Display Dev Board w/ Trackball₹2,939
LilyGO T-Circle ESP32-S3 Dev Board w/ 1.28-Inch Round Touchscreen: another version this guide coversLilyGO T-Circle ESP32-S3 Dev Board w/ 1.28-Inch Round Touchscreen₹2,689
LilyGO T-RGB 2.1-Inch Round Touch Display ESP32-S3 Board: another version this guide coversLilyGO T-RGB 2.1-Inch Round Touch Display ESP32-S3 Board₹5,249
LilyGO T-HMI ESP32-S3 2.8-Inch Touch Display Module: another version this guide coversLilyGO T-HMI ESP32-S3 2.8-Inch Touch Display Module₹3,149
LilyGO T-Panel-Lite S3 4.0-inch LCD ESP32-S3 Dual MCU Dev Board: another version this guide coversLilyGO T-Panel-Lite S3 4.0-inch LCD ESP32-S3 Dual MCU Dev Board₹4,929
LilyGO T-Touch Bar ESP32-S3 Touch Display Bar Development Board: another version this guide coversLilyGO T-Touch Bar ESP32-S3 Touch Display Bar Development Board₹3,059
LilyGO T-QT Pro ESP32-S3FN4R2 Wi-Fi & BLE Touchscreen Dev Board: another version this guide coversLilyGO T-QT Pro ESP32-S3FN4R2 Wi-Fi & BLE Touchscreen Dev Board₹1,679
LilyGO T-QT C6 Mini Dev Board w/ ESP32-C6, 0.85-Inch Touch TFT: another version this guide coversLilyGO T-QT C6 Mini Dev Board w/ ESP32-C6, 0.85-Inch Touch TFT₹2,129
LilyGO T-Dongle ESP32-S2 Dev Board w/ 1.14″ LCD & OTG: another version this guide coversLilyGO T-Dongle ESP32-S2 Dev Board w/ 1.14″ LCD & OTG₹2,099
LilyGO T-Dongle-S3 ESP32-S3 Dev Board w/ 0.96-Inch ST7735 LCD: another version this guide coversLilyGO T-Dongle-S3 ESP32-S3 Dev Board w/ 0.96-Inch ST7735 LCD₹2,099
LilyGO T-Keyboard S3 Pro ESP32-S3 Modular Dev Board w/ TFT Screens: another version this guide coversLilyGO T-Keyboard S3 Pro ESP32-S3 Modular Dev Board w/ TFT Screens₹7,239
Alternatives and when to choose them
- Waveshare small ESP32-S3 boards: similar sizes.
- ESP32 HMI panels: bigger touch panels.
- LilyGO T-Beam: LoRa and GPS.
Common mistakes to avoid
- Using a TFT_eSPI setup for another board.
- Not enabling display power on battery.
- Plugging a LiPo with reversed polarity.
- Choosing generic ESP32 instead of the exact board.
Frequently asked questions
Why is my T-Display screen black on battery?
On battery the screen supply is switched; set the display power pin HIGH in setup().
Which display library should I use?
TFT_eSPI with the setup file from LILYGO's GitHub, or LovyanGFX with the board config.
Can I run LVGL on these boards?
Yes. LILYGO publishes LVGL examples for most boards, which are the easiest starting point.
Why does upload fail?
Hold BOOT, tap RST, release BOOT, then upload again; S3 boards may need USB CDC on boot enabled.
Can I read the battery voltage?
Yes. Read the battery ADC pin listed in the board docs and multiply by the divider ratio.
Parts for this guide
Keep learning
Sources
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.



