T-Deck

Board
by LILYGOlilygo-t-deck≈ medium (~$15–50)
View 20 firmware recipes · 3 known good
T-Deck board
Board
T-Deck pinout
Pinout

Specifications

Radiosinherited from ESP32-S3

Wi-Fi
Wi-Fi 4 · 2.4 GHz
Bluetooth LE
BLE 5
Bluetooth Classic
no
802.15.4
no

USB

Native USB
yes

Board

Form factor
t-deck

Display & extras

Display
2.8in 320x240 ST7789 SPI IPS
Extras
lorakeyboardtrackballmicrophonespeaker
Built onT-Deck BoardESP32-S3 SoC

ESP32-S3FN16R8 handheld with a 2.8in ST7789 IPS display, onboard keyboard, trackball, mic/speaker, and an optional SX1262 LoRa transceiver.

Firmware for this board

Known good

  • BruceKnown goodpentestweb flasher
    Flash Bruceweb flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'Lilygo T-Deck' in the project's device table.

  • LauncherKnown goodmultirelease .bin
    Flash Launcherin-browserknown-good

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • MeshtasticKnown goodmeshweb flasher
    Flash Meshtasticweb flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Documented device; firmware build target `t-deck` (the T-Deck Pro is a separate target).

Unverified

  • acid-dropUnverifiedmulti
    Flash acid-dropguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Board-specific evidence: acid-drop's platformio.ini defines a dedicated env:t-deck for the original T-Deck, separate from env:t-deck-plus (commit 51a98f1). The default environment is t-deck-plus; select pio run -e t-deck explicitly for this original-board recipe. Not verified: no current successful build confirmed and not tested on hardware for this atlas.

  • AL-ANQA-FIRMWAREUnverifiedmulti
    Flash AL-ANQA-FIRMWAREguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • MicroHydra for CardputerUnverifiedmultirelease .bin
    Flash MicroHydra for Cardputerrelease .binread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: cardputer-microhydra names this board as TDECK in its release (asset TDECK.bin) (release v2.5.1); derived from the repo's own build files, not verified on hardware.

  • GhostESP: Revival - CardputerADVUnverifiedpentest
    Flash GhostESP: Revival - CardputerADVguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: ghostesp names this board as T-Deck in its CI matrix; derived from the repo's own build files, not verified on hardware.

  • IceNav-v3Unverifiedmulti
    Flash IceNav-v3guidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Board-specific evidence: IceNav-v3's README lists the ordinary LilyGO T-Deck as a supported device, separately from the T-Deck Plus, and its platformio.ini defines a dedicated build environment env:TDECK_ESP32S3 (both pinned at commit 69e82f7). Not verified: no current successful T-Deck build was confirmed (the project's Nov 4 scheduled CI run skipped the T-Deck step after another target failed; the last passing TDECK_ESP32S3 job found was Oct 6), and nobody has flashed it on hardware for this atlas. Build it from the TDECK_ESP32S3 environment; this is not a T-Deck Plus recipe.

  • inw-meshUnverifiedmesh
    Flash inw-meshguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • KryonOSUnverifiedmulti
    Flash KryonOSguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: kryonos names this board as esp32-s3-devkitc-1 in its platformio.ini (env lilygo-t-deck); derived from the repo's own build files, not verified on hardware.

  • lilysharkUnverifiedmesh
    Flash lilysharkguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • MCLiteUnverifiedmesh
    Flash MCLiteguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • meshcoretermUnverifiedmesh
    Flash meshcoretermguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • PyxisUnverifiedmulti
    Flash Pyxisguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • T-Deck LXMF MessengerUnverifiedmesh
    Flash T-Deck LXMF Messengerguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Board-specific evidence: the README's Hardware section names 'LilyGO T-Deck v1 (ESP32-S3)' with an SX1262 LoRa radio, and board_id.py ships BOARD = 'tdeck_v1' (the T-Deck Pro gets its own tdeck_pro_firmware.bin). Flash tdeck_firmware.bin at 0x0 or install it from M5Launcher. Not tested on hardware for this atlas.

  • SigurdOSUnverifiedmesh
    Flash SigurdOSguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: sigurdos-tdeck names this board as T-Deck in its repository name/description; named in the repository itself, not verified on hardware.

  • SondeDeckUnverifiedmulti
    Flash SondeDeckguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

  • T-DeckUnverifiedmulti
    Flash T-Deckguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: This is LilyGO's own example repository for the T-Deck and T-Deck Plus, not a single application. Its platformio.ini selects env:T-Deck (board=T-Deck) by default and builds one example at a time through src_dir; the default is examples/UnitTest (commit 9aac147). Pick the example you want in src_dir before building. Not verified: no current successful build confirmed and not tested on hardware for this atlas.

  • trail-mateUnverifiedmulti
    Flash trail-mateguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Board-specific evidence: trail-mate's README support table lists the LILYGO T-Deck as a primary validation target with its own tdeck environment, separate from the T-Deck Pro, and the repository has a dedicated variants/tdeck/envs/tdeck.ini and boards/tdeck (commit 4732374). Build the tdeck environment; the default environment targets the T-LoRa-Pager. This target selects the SX1262 LoRa transceiver; LoRa functionality requires that optional radio hardware. Not verified: no current successful build confirmed and not tested on hardware for this atlas.

  • WADAMESH BETAUnverifiedmesh
    Flash WADAMESH BETAguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

Notes

  • ESP32-S3FN16R8 dual-core LX7; 16 MB flash, 8 MB PSRAM
  • LoRa transceiver: SX1262 (chip-optional SKU), +22dBm, 433/868/915MHz
  • Onboard mini keyboard (shipped in a randomly-selected color/layout)
  • Wi-Fi 2.4GHz + Bluetooth 5 (LE)
  • io.gpio_exposed=4 QUOTED: the vendor firmware repo's own board pin-definition header (utilities.h) defines exactly 4 undocumented GPIOs -- BOARD_TBOX_G01=3, G02=2, G03=15, G04=1 -- claimed by no other onboard peripheral in that file; the official README confirms base T-Deck (non-Plus) ships a user-facing Grove HY2.0-4P interface that is free/unassigned (Plus variant reassigns it to GPS), matching this G01-G04 naming. io.gpio_free=3 DERIVED: subtracting esp32-s3's soc.reserved_pins -- GPIO3 (G01) is a strapping pin, GPIO2/15/1 are not strapping or usb_flash_tied -- gives 4 - 1 = 3

Verify my board

Reads the connected chip over USB and checks it against what esp-atlas cites for T-Deck — over Web Serial, no backend, nothing leaves your browser.

In-browser verify needs Web Serial: Chrome or Edge on a desktop. Safari, Firefox and phones cannot do it.

Serial monitor

Not connected.