# LilyGo T-Deck Setup Guide

<div id="bkmrk-%E2%9A%A0-antenna-safety-%E2%80%94-a" style="background:#fff3cd;border:2px solid #ffc107;padding:12px 16px;margin-bottom:20px;">**⚠ ANTENNA SAFETY - GOOD PRACTICE:** Always connect an antenna **before** powering on or transmitting with any LoRa device. The T-Deck uses the SX1262, which has improved tolerance to antenna mismatch, so a brief accidental transmit without an antenna is unlikely to instantly destroy it - but operating without a proper antenna load is still bad practice and can stress the radio over time. Reserve "permanent damage from a brief transmit" concerns for PA/FEM-equipped boards (high-power front-end designs and amplifier builds). Connect the antenna first regardless. </div>## LilyGo T-Deck - Setup Guide

The T-Deck is a standalone LoRa communicator with a 2.8" touchscreen, physical QWERTY keyboard, trackball, speaker, and microphone - enabling full mesh network operation without a phone. Note that the base T-Deck does not include GPS; see the T-Deck Plus for GPS functionality.

### Specifications

<table id="bkmrk-attributevalue-mcues" style="border-collapse:collapse;width:100%;"> <tr><th style="background:#f0f0f0;width:35%;">Attribute</th><th>Value</th></tr> <tr><td>MCU</td><td>ESP32-S3</td></tr> <tr><td>Radio</td><td>SX1262</td></tr> <tr><td>Display</td><td>2.8" touchscreen</td></tr> <tr><td>Input</td><td>QWERTY keyboard + trackball</td></tr> <tr><td>Audio</td><td>Speaker + microphone</td></tr> <tr><td>GPS</td><td>Not included (requires T-Deck Plus)</td></tr> <tr><td>Price</td><td>~$50 - $53 (the base T-Deck typically retails around $52 and up; as of 2026-06-08)</td></tr> <tr><td>Strengths</td><td>Full standalone keyboard operation, touchscreen, speaker for alerts</td></tr> <tr><td>Weaknesses</td><td>No GPS; higher power draw</td></tr></table>

### Driver Installation

- **Windows:** A USB-serial driver (CP210x) may be required depending on the board's USB interface. If the board does not enumerate, install the CP210x driver from the Silicon Labs website; see the Meshtastic serial-driver docs (meshtastic.org/docs/getting-started/serial-drivers/) for guidance.
- **macOS &amp; Linux:** Built-in - no driver needed.

### Entering Bootloader / DFU Mode - UNIQUE METHOD

<div id="bkmrk-note%3A-the-t-deck-use" style="background:#cce5ff;border:1px solid #004085;padding:10px 14px;margin:10px 0;"> **Note:** The T-Deck uses a unique bootloader entry method using the trackball, not a traditional BOOT button. This power-switch method below is the authoritative T-Deck DFU procedure; if a flasher page gives an abbreviated "depress trackball while connecting USB" instruction, follow the power-switch steps here instead. </div>**Primary Method (Trackball):**

1. Flip the power switch to **OFF**.
2. Press and hold the **trackball** (physically depress it - it clicks).
3. While holding the trackball, flip the power switch to **ON**.
4. Continue holding the trackball for 2 - 3 seconds, then release.
5. **Confirmation:** The screen stays blank with the backlight off. Because a blank screen also looks like a powered-off or failed-to-boot device, confirm DFU mode the reliable way: the device should appear as a serial/USB device in your flasher's "Connect" / device-picker dialog (or in Device Manager on Windows). If it appears there, you are in DFU mode; if not, repeat the steps.

**Alternative Method (Side Reset):**

1. With the device powered on, press and hold the trackball.
2. While holding, press the side reset button briefly.
3. Release both. The screen goes blank with the backlight off; confirm by checking that the device shows up in the flasher's device picker / Device Manager rather than relying on the blank screen alone.

### Firmware Flashing

1. Enter DFU mode (see above).
2. Connect via USB-C to your computer.
3. Open Chrome or Edge and navigate to: 
    - **MeshCore:** [flasher.meshcore.io](https://flasher.meshcore.io)
    - **Meshtastic:** [flasher.meshtastic.org](https://flasher.meshtastic.org)
4. Select **T-Deck** from the device list.
5. Click **Flash** and grant serial port access.
6. Wait for completion. Device reboots automatically.

### Post-Flash Configuration

1. Set **region to US** via Bluetooth app or directly on the keyboard interface.
2. Both MeshCore and Meshtastic support standalone keyboard operation on this device.
3. Configure node name, channel settings, and alert preferences.

### Known Quirks

- Bootloader entry using the trackball can be unintuitive at first - ensure you press the trackball *before* turning on power.
- Higher power draw than simpler boards; plan battery capacity accordingly.
- For GPS functionality, the T-Deck Plus is required.