Repository navigation
LilyGo T Display S3
github-actions[bot] edited this page Aug 28, 2026
·
7 revisions
Part of Claude Usage Stick. The biggest small-format screen in the lineup — a 1.9" LCD driven over a fast 8-bit parallel bus, with two front buttons and a battery connector.
| MCU | ESP32-S3 (dual-core, WiFi, 8 MB PSRAM) |
| Display | 1.9" ST7789 LCD, 320×170, 8-bit parallel |
| Battery | External via JST connector (not included) |
| Buttons | Button A (BOOT, GPIO 0) · Button B (KEY, GPIO 14) |
| Firmware | ✨ Dust (v3.0.3) — display tier L (reference board) |
| PlatformIO env | tdisplay-s3 |
| Buy | aliexpress.com |
Easiest: open the web flasher in Chrome, Edge or Firefox, pick this board, and plug it in over USB-C.
From source, with the PlatformIO CLI:
pio run -e tdisplay-s3 -t upload # firmwareThis env is for the regular LCD variant. For the 1.91" AMOLED version, use
tdisplay-s3-amoled.
| Context | Gesture | Action |
|---|---|---|
| PIN entry | A tap / B tap | Cycle the current digit / confirm it — or unlock from a browser instead |
| Screens | A tap | Next screen (dashboard → chart → news → clock) |
| Screens | A held ≥ 0.6 s | Flip screen 180° (saved) |
| Screens | B tap | Cycle brightness (saved) |
| Screens | A+B together | Force refresh |
| On boot | Hold A+B | Factory reset (wipes all stored data) |
Refresh happens automatically on the poll interval. Everything else — display mode, timezone, refresh interval, token rotation, WiFi — lives in the web panel.
- As the tier L reference board, the dashboard shows the 5H/7D reset countdowns in large type on their own row below the bars, and the MODELS section shows a row of labelled Clawd mascots (Haiku / Sonnet / Opus / Fable), each blinking while healthy — see Display tiers.
- Dust adds three more screens — 7-day chart, Anthropic news, and a desk clock — plus the web panel and mDNS (
claude-usage-stick.local). - v3 uses the board's full 16 MB flash (the app partition grew 5×) and enables the 8 MB PSRAM. Updating from v2 via the web flasher keeps your settings; a clean erase re-runs setup.
- During setup, the WiFi AP password is shown on the device screen. If the device can't reach your WiFi at boot (moved house, new router), it opens a recovery AP after ~1 min where you fix the WiFi without losing token, PIN or settings.
LilyGo T Display S3 · env tdisplay-s3 · All boards · Flashing · Setup and daily use · Troubleshooting
Using it
Hardware
- Supported boards
- M5StickC Plus
- M5StickC Plus2
- LilyGo T-Display S3
- LilyGo T8 ESP32-S2
- CrowPanel Advance 3.5"
- T-Display S3 AMOLED
- TTGO T-Display
- ESP32-C3-OLED
Under the hood