T-Deck get it now

Overview

LILYGO T-Deck is a highly integrated multi-functional embedded development platform based on the ESP32-S3 main control chip. It integrates a 2.8-inch ST7789 LCD (320 × 240), trackball navigation module, physical keyboard (I²C), TF card storage, LoRa SX1262 wireless module, and ES7210 microphone array. Suitable for IoT terminals, portable interactive devices, and low-power wireless communication projects.

Notes:

1. T-Deck-Plus has allocated the Grove interface pins for GPS module use — the Grove interface on T-Deck-Plus cannot be used as a general-purpose interface.
2. T-Deck updated the TFT_eSPI ST7789 initialization sequence on 2024-07-26. If you encounter incorrect screen display, check that the initialization sequence in the repo matches.

Quick Start

Example Support

Example	PlatformIO/Arduino	ESP-IDF	Description
T-Deck Examples	✓		Keyboard, Microphone, GPS, Touchpad, Unit Test

Available examples:

├─Keyboard_ESP32C3       # ESP32C3 keyboard I2C slave
├─Keyboard_T_Deck_Master # T-Deck read from keyboard
├─Microphone             # Noise detection
├─Touchpad               # Read touch coordinates
├─GPSShield              # GPS Shield example
└─UnitTest               # Factory hardware unit testing

If microphone is enabled, the middle trackball button (GPIO0) is not available.

PlatformIO

1. Install Visual Studio Code and Python
2. Search for and install the PlatformIO IDE extension in VS Code
3. After restarting VS Code, click File → Open Folder → select the T-Deck directory
4. Open platformio.ini, uncomment the example you want to use (only one active at a time)
5. Click ✓ to compile, connect via USB, click → to upload

Arduino

1. Install Arduino IDE
2. Copy all folders from T-Deck/lib to your Arduino libraries folder
3. In Tools → Board, configure:

Arduino IDE Setting	Value
Board	ESP32S3 Dev Module
USB CDC On Boot	Enable
CPU Frequency	240 MHz
USB DFU On Boot	Disable
Flash Mode	QIO 80 MHz
Flash Size	16MB(128Mb)
USB Firmware MSC On Boot	Disable
PSRAM	OPI PSRAM
Partition Scheme	16M Flash(3MB APP/9.9MB FATFS)
USB Mode	Hardware CDC and JTAG
Upload Mode	UART0/Hardware CDC
Upload Speed	921600

4. Click Upload. If upload fails, hold the BOOT button (trackball center), insert USB, then click Upload. After upload, click RST to exit download mode.

The ESP32C3 programming interface is the 6-pin header near the RST button (top to bottom: 3V3, GND, RST, BOOT, RX, TX).

Development Platforms

1. Visual Studio Code
2. Arduino IDE
3. PlatformIO
4. MicroPython

Video

Key Features

• ESP32-S3FN16R8 dual-core LX7 @ 240 MHz, Wi-Fi + Bluetooth 5.0 LE
• SX1262 LoRa (433–915 MHz, optional)
• MIA-M10Q GNSS module
• 2.8-inch ST7789 LCD (320 × 240), no touch — trackball navigation
• Physical keyboard (I²C communication)
• ES7210 audio codec + MSM381A3729H9CP microphone array
• 2000 mAh lithium polymer battery
• 16 MB Flash + 8 MB PSRAM + TF card slot

Product Parameters

Feature	Specification
MCU	ESP32-S3FN16R8 @ Dual-core LX7, 240 MHz
Flash	16 MB
PSRAM	8 MB
Wi-Fi	2.4 GHz 802.11 b/g/n
Bluetooth	Bluetooth 5.0 LE
LoRa	SX1262, 433–915 MHz (optional)
GPS	MIA-M10Q GNSS
Display	2.8-inch ST7789 LCD, 320 × 240
Input	Trackball + physical keyboard (I²C)
Audio	ES7210 codec + microphone array
Battery	2000 mAh lithium polymer
Storage	TF card expansion
USB	1 × Type-C
Dimensions	100 × 68 × 11 mm

Pin Diagram

Pin Mapping

Signal	GPIO
Power Enable	10
I2S WS	5
I2S BCK	7
I2S DOUT	6
I2C SDA	18
I2C SCL	8
Battery ADC	4
Touch INT	16
Keyboard INT	46
SD CS	39
TFT CS	12
LoRa CS	9
TFT DC	11
TFT Backlight	42
SPI MOSI	41
SPI MISO	38
SPI SCK	40
Trackball G01	3
Trackball G02	2
Trackball G03	15
Trackball G04	1
ES7210 MCLK	48
ES7210 LRCK	21
ES7210 SCK	47
ES7210 DIN	14
LoRa BUSY	13
LoRa RST	17
LoRa DIO1	45
BOOT	0
GPS TX	43
GPS RX	44

Dimension Diagram

Schematic

• T-Deck Schematic PDF

Datasheet

• ESP32-S3 Datasheet
• T-Deck ANT 868–915 MHz
• T-Deck ANT 433 MHz

Software Development

• T-Deck GitHub Repository

Dependent Libraries

• AceButton
• Arduino_GFX
• ESP32-audioI2S
• RadioLib
• SensorsLib
• TFT_eSPI
• TinyGPSPlus
• TouchLib
• LVGL v8.4.0

FAQ

• Q. Still don't know how to set up the programming environment? A. Refer to the LilyGo-Document for additional setup instructions.

• Q. Arduino IDE prompts to upgrade library files — should I? A. Do not upgrade. Different library versions may be incompatible; stay with the versions in the lib directory.

• Q. Does T-Deck have a touch screen? A. No. T-Deck uses a trackball navigation module instead of a touch screen.

• Q. Upload keeps failing? A. Hold the trackball center button (BOOT), then insert USB, then click Upload. After completion, press RST to exit download mode.

Version History

Version	Release Date	Update Description
V1.0	—	Initial release