Skip to main content
Version: 2.8

LILYGO® T-Deck

The T-Deck series is a family of compact handheld keyboard devices that pair a physical keyboard with different touchscreen displays. Variants include the original LCD T-Deck (and Plus) with support for MUI, and the new T-Deck Pro e-ink model for low-power, sunlight-readable operation.

T-Deck and T-Deck Plus

LILYGO T-Deck

The T-Deck is a compact device featuring a 2.8-inch IPS LCD touch screen with a resolution of 320x240 pixels, integrated with a small keyboard, trackball, microphone and speaker running on an ESP32-S3 dual-core processor. A secondary ESP32-C3 MCU is used to manage the keyboard.

T-Deck Plus variant also comes with a GPS module and a 2000 mAh battery

Specifications

  • MCU
    • ESP32-S3FN16R8 (Wi-Fi & Bluetooth 5 LE)
    • ESP32-C3 (For keyboard only)
  • LoRa Transceiver
    • Semtech SX1262
  • Frequency options
    • 915 MHz
    • 868 MHz
    • 433 MHz
  • Antenna
    • U.FL/IPEX antenna connector for LoRa
  • Connectors
    • USB-C

Features

  • LILYGO® backlit T-Keyboard
  • Trackball
  • 2.8 inch ST7789 SPI Interface IPS LCD (Resolution: 320 x 240)
  • I2S Speaker/Microphone

Keyboard Shortcuts

These shortcuts belong to Base UI. Selecting MUI replaces the input path, so none of the modifier shortcuts are available there.

ShortcutBase UIMUI
alt & bToggle keyboard backlight on/off.Toggle keyboard backlight on/off.
alt & cToggle the modifier function.Not available.
alt & c + mDisable/Enable notifications.Not available.
alt & c + qQuit/Cancel (message, canned message, etc.)Not available.
alt & c + tTab Key (once for dm recipient, twice for channel)Not available.
alt & c + gToggle GPS.Not available.

alt & b works under both because the keyboard's own controller handles it. The Meshtastic firmware never sees that combination.

To enable the function key, press alt and c together. Then press the key for the function to run. For example, to disable or enable notifications, press alt and c followed by m.

Flashing

To flash ESP32-S3 devices like the T-Deck, you typically need to place them in Espressif's firmware download mode. Use the "1200bps reset" button in the web flasher to do this. If this method does not work for any reason, you can follow the manual process below.

warning

Do not proceed unless an antenna is connected to avoid possible damage to the device's radio.

The following process will manually place the device into the Espressif Firmware Download mode:

  1. Ensure the device's power switch is toggled OFF.
  2. Press and hold the TRACKBALL.
  3. Toggle device's power switch ON.
  4. After 2-3 seconds, release the TRACKBALL button.
  5. If the device screen is black and the backlight is off, the device is in the Firmware Download mode. If the backlight is on, repeat these steps.

With the device now in the Espressif Firmware Download mode, you can proceed with flashing using one of the supported flashing methods. It's generally recommended to use the Web Flasher. You can select "T Deck" from the device drop-down.

Resources

T-Deck