T-Display-S3 examples and factory test

What you’re building

LILYGO’s T-Display-S3 repository is the manufacturer reference package for the ESP32-S3 display board and its touch variant. It contains Arduino and PlatformIO projects for the 170×320 LCD, graphics libraries, touch, battery voltage, I2C, serial, USB HID, OTA, SD accessories, LVGL, and a factory test, plus prebuilt factory firmware for hardware verification. The supported boards use an ESP32-S3R8 with 16 MB flash and 8 MB OPI PSRAM. Building or restoring the factory example should confirm that the screen, buttons, power controls, and variant-specific peripherals operate. Configuration matters: the Arduino instructions specify ESP32S3 Dev Module settings including 16 MB flash and OPI PSRAM, while external-power boots can block if USB CDC remains enabled; touch code is only appropriate for the touch model.

Key steps

1. Clone the manufacturer repository and choose the environment or example matching the exact T-Display-S3 variant.
2. For PlatformIO, open the repository, select the matching environment, clean stale artifacts, and compile.
3. For Arduino IDE, install the listed dependencies and apply the documented ESP32-S3 flash, PSRAM, partition, USB, and upload settings.
4. Upload the factory or a focused peripheral example; use BOOT plus RST to enter download mode if normal upload fails.
5. Verify the LCD and relevant peripherals, or flash the repository’s prebuilt factory firmware for a quick hardware check.