1. Introduction
The LILYGO T-Display-S3 is a compact and versatile development board featuring an ESP32-S3R8 dual-core LX7 microprocessor and a 1.9-inch ST7789 LCD. This version is shipped with unsolderd pins, offering flexibility for custom applications. It includes 16MB Flash and 8MB PSRAM, along with Wi-Fi and Bluetooth mesh connectivity. This manual provides essential information for setting up, operating, and maintaining your device.
Video 1: T-Display-S3 Product Introduction. This video provides an overview of the LILYGO T-Display-S3 development board, highlighting its features and potential applications.
2. Setup
This section guides you through the initial setup of your LILYGO T-Display-S3 board.
2.1. Package Contents
Verify that all components are present in your package:
- 1 x T-Display-S3 Board
- 2 x PH2.54 PIN (1*12P)
- 1 x JST 1.25mm 2P wire
- USB cable

Image 1: Components included with the LILYGO T-Display-S3. This image shows the main board, two sets of 12-pin headers, and a JST 1.25mm 2P wire.
2.2. Hardware Overview
The T-Display-S3 features a Type-C USB port in the middle for power and data communication. It has a boot button and a custom button on both sides, along with a reset button on the side. A JST-GH 1.25mm 2-pin battery interface is located on the back of the USB port for battery power. GPIO pins are available for extension, and a JST-SH 1.0mm 4-pin interface is reserved for STEMMA QT/Qwiic compatibility. The 1.9-inch ST7789 LCD uses an 8-bit interface.

Image 2: Front view of the LILYGO T-Display-S3, displaying a clock. This image highlights the integrated 1.9-inch LCD screen and the two side buttons.

Image 3: Back view of the LILYGO T-Display-S3, revealing the main electronic components and the battery connector.

Image 4: Detailed pinout diagram for the LILYGO T-Display-S3, showing GPIO assignments and connections.
2.3. Initial Power-Up and Firmware Flashing
To begin, connect the USB cable to the Type-C port on the board and to your computer. The board should power on and the display may show a default firmware. If you need to flash new firmware or factory test files, follow the instructions below. The board is available in both welded and non-welded versions.
Video 2: T-DISPLAY-S3 Flash Factory. This video demonstrates the process of flashing factory firmware onto the T-Display-S3 board.
To enter download mode for flashing:
- Connect the USB cable to the board and your computer.
- Press and hold the BOOT button (located near the USB port).
- While holding BOOT, press the RST (Reset) button.
- Release the RST button, then release the BOOT button.
Alternatively, you can enter download mode by:
- Press and hold the BOOT button before connecting the USB cable.
- Connect the USB cable. The board will enter download mode.
3. Operating Instructions
The LILYGO T-Display-S3 is designed for ease of use, especially for development and prototyping. Here are some key operational aspects:
3.1. Wi-Fi Connectivity
The board supports Wi-Fi (2.4G only) for network connectivity. Once connected, it can perform tasks like automatic time synchronization.

Image 5: The T-Display-S3 automatically synchronizing time via Wi-Fi.
For initial Wi-Fi configuration, you may need to use a mobile application like EspTouch (available on iOS and Android) to provision network credentials to the device. Ensure your phone is connected to a 2.4G Wi-Fi network.
3.2. Custom Buttons
The two custom buttons on the side of the board can be programmed for various functions, allowing for interactive control of your projects without external components.
4. Maintenance
To ensure the longevity and optimal performance of your LILYGO T-Display-S3, follow these maintenance guidelines:
- Keep Dry: Avoid exposing the board to moisture or liquids, as this can damage electronic components.
- Handle with Care: The board contains sensitive electronic parts. Avoid dropping it or subjecting it to strong impacts.
- Clean Gently: If cleaning is necessary, use a soft, dry cloth. Avoid using harsh chemicals or abrasive materials.
- Proper Storage: Store the board in a cool, dry place away from direct sunlight and extreme temperatures.
- Power Off When Not in Use: Disconnect the USB cable or battery when the board is not in use for extended periods to prevent unnecessary power consumption.
5. Troubleshooting
If you encounter issues with your LILYGO T-Display-S3, refer to the following common problems and solutions:
- Board not recognized by computer:
- Ensure the USB cable is properly connected.
- Try a different USB port or cable.
- Make sure the board is in download mode (refer to Setup section).
- Install the necessary USB drivers for ESP32-S3 if not already installed.
- Display not showing anything:
- Verify that the board is powered on (check for power indicator LEDs).
- Ensure the correct firmware is flashed onto the board. Factory test files can help verify hardware functionality.
- If you have replaced the TFT_eSPI library, ensure the configuration matches the T-Display-S3.
- Wi-Fi connection issues:
- Confirm that your Wi-Fi network is 2.4G, as 5G is not supported.
- Double-check your Wi-Fi password.
- Ensure the board is within range of your Wi-Fi router.
- Use the EspTouch app for initial Wi-Fi provisioning if needed.
- Board not responding after flashing:
- After burning firmware, you need to press the reset button once for the new firmware to run.
6. Specifications
| Feature | Specification |
|---|---|
| MCU | ESP32-S3R8 Dual-core LX7 microprocessor |
| Flash Memory | 16MB |
| PSRAM | 8MB |
| Display Size | 1.9 Inches |
| Display Type | ST7789 LCD (170(H)RGB x 320(V) Resolution) |
| Wireless Connectivity | Wi-Fi 802.11, BLE 5 + BT mesh |
| Programming Platform | Arduino-IDE, Micropython |
| USB Interface | Type-C USB |
| Battery Interface | JST-GH 1.25mm 2-pin |
| Additional Interfaces | GPIO Pin extensions, JST-SH 1.0mm 4-pin (STEMMA QT/Qwiic) |
| Operating System | Micropython |
| Item Weight | 1.06 ounces |
| Product Dimensions | 2.44 x 1.02 x 0.39 inches |

Image 6: Detailed specifications and features of the T-Display-S3.
7. Warranty and Support
LILYGO is committed to providing high-quality products and excellent customer service. If you have any questions or suggestions regarding your T-Display-S3, please do not hesitate to contact us. We will respond to your inquiries as soon as possible to ensure your satisfaction.