T-Deck vs T-Deck Plus

The T-Deck and T-Deck Plus run identical firmware. The only hardware difference is the GPS module on the Plus. Everything else — display, keyboard, WiFi, Bluetooth, USB, SD card, speaker, audio — is the same.


Comparison

Feature T-Deck T-Deck Plus
Display (320×240 ST7789) ✅ ✅
Physical QWERTY keyboard ✅ ✅
WiFi 2.4 GHz ✅ ✅
Bluetooth 5 (BLE) ✅ ✅
I2S speaker + audio ✅ ✅
LoRa SX1262 ✅ ✅
microSD slot ✅ ✅
USB-C (flashing + USB gadget) ✅ ✅
Trackball ✅ ✅
Battery (with charge circuit) ✅ ✅
GPS module (L76K / u-blox M10Q) ✗ ✅

What GPS Unlocks

GPS affects only two commands:

trackme — Tracking Detection

Capability T-Deck T-Deck Plus
BLE advertisement scanning ✅ ✅
Baseline learning period ✅ ✅
Behaviour scoring (Gate 2) ✅ ✅
Time-path confirmation (Gate 3) — 5+ min, RSSI > −80 dBm ✅ ✅
GPS movement gate (Gate 3) — 200m physical movement ✗ ✅
WiFi probe sniff ✗ ✅

On the standard T-Deck, trackme still works and can reach WARNING/ALERT — it just uses the time-path for Gate 3 instead of GPS movement. The GPS path is faster and more reliable in a moving scenario.

GPS Commands

Command T-Deck T-Deck Plus
gps on — GPS background task + live status ✗ ✅
gps off — stop GPS task ✗ ✅
gps test — one-shot coordinate read ✗ ✅

Build Configuration

  T-Deck T-Deck Plus
PlatformIO environment env:T-Deck env:T-Deck-Plus
Compile flag — -DBOARD_TDECK_PLUS=1

The BOARD_TDECK_PLUS flag gates only the GPS task init and the WiFi probe-sniff phase of trackme. All other code compiles and runs identically on both.


GPS Cold Start

The GPS module needs approximately 4 minutes outdoors for a cold fix (first fix after a power cycle or long idle). Once fixed it stays warm for the session.

Recommended workflow for T-Deck Plus users:

CMD> gps on      # start GPS task before doing anything else

Leave it running in the background. By the time you finish scanning WiFi and want to run trackme, the fix is already acquired — trackme will skip its own warm-up and start immediately.

The satellite icon in the status bar shows the state:

Colour Meaning
Grey GPS off
Yellow Searching (no fix yet)
Green Fix acquired — location available