1. Product Overview
The LILYGO T-Display-S3 is a compact and versatile development board featuring an ESP32-S3 microcontroller and a 1.9-inch ST7789 LCD display. It is designed for various embedded projects, offering Wi-Fi and Bluetooth connectivity, ample memory, and pre-soldered pin headers for ease of use. This manual provides essential information for setting up, operating, and maintaining your T-Display-S3 board.

Front view of the LILYGO T-Display-S3 Development Board, showcasing the 1.9-inch LCD display and USB-C port.
2. What's in the Box
Upon unboxing your LILYGO T-Display-S3, you should find the following components:
- LILYGO T-Display-S3 ESP32-S3 Development Board with 1.9 inch ST7789 LCD Display and Pre-soldered Pin Headers

Image showing the LILYGO T-Display-S3 board inside its protective case, along with a small foam insert and a JST connector cable.
3. Features and Specifications
Key Features:
- Flash Memory: 16MB
- PSRAM: 8MB
- Onboard Functions: Boot, Reset, and IO14 Buttons
- Pin Headers: Pre-soldered for convenience
- Display: 1.9 inch ST7789 LCD Display
- Connectivity: Wi-Fi and Bluetooth Low Energy (BLE)
- Processor: ESP32-S3 Dual-core LX7 microprocessor
- Power Supply: Supports USB and Li-Po Battery Dual Power Supply (JST GH 1.25mm connector)
Technical Specifications:
| Specification | Value |
|---|---|
| Standing screen display size | 1.9 Inches |
| Processor | MediaTek_MT8125 (Note: ESP32-S3 is the actual MCU) |
| RAM | PSRAM |
| Wireless Type | Bluetooth, Wi-Fi |
| Item model number | T-Display-S3 |
| Item Weight | 1.13 ounces |
| Product Dimensions (LxWxH) | 2.44 x 1.02 x 0.39 inches |
| Flash Memory Installed Size | 16 MB |
| Number of Processors | 2 (Dual-core) |

Detailed pinout diagram for the LILYGO T-Display-S3, showing GPIOs, power pins, and display connections.
4. Setup Guide
To begin using your LILYGO T-Display-S3, follow these general steps:
- Connect to Power: Connect the T-Display-S3 to your computer using a USB-C cable. The board will draw power from the USB connection. Alternatively, you can connect a Li-Po battery to the JST GH 1.25mm connector for portable operation.
- Install Drivers: Depending on your operating system, you may need to install USB-to-serial drivers (e.g., CP210x or CH340 drivers) to allow your computer to communicate with the ESP32-S3.
- Prepare Development Environment:
- For Arduino IDE: Install the ESP32 board package. You will need to add the ESP32 board manager URL to your Arduino IDE preferences.
- For PlatformIO: Set up PlatformIO in your preferred IDE (e.g., VS Code) and configure it for ESP32-S3 development.
- Obtain Sample Code: LILYGO provides example code and libraries on their GitHub repository. It is highly recommended to visit the official GitHub page for the latest resources.

The LILYGO T-Display-S3 board with a USB-C cable connected, ready for programming and power.
5. Operating Instructions
The LILYGO T-Display-S3 is a development board, and its operation is primarily driven by the code you upload to it. Here are general guidelines:
- Programming: Use your chosen development environment (Arduino IDE, PlatformIO) to write and upload your programs (sketches) to the ESP32-S3. Ensure the correct board and port are selected.
- Display Usage: The 1.9-inch ST7789 LCD display can be controlled via libraries provided by LILYGO or the open-source community. Refer to the sample code for display initialization and drawing functions.
- Button Functions: The onboard Boot, Reset, and IO14 buttons can be used for various purposes:
- Reset Button: Restarts the ESP32-S3.
- Boot Button: Used in conjunction with the Reset button to put the ESP32-S3 into bootloader mode for flashing new firmware.
- IO14 Button: A general-purpose input button that can be programmed for custom functions within your application.
- Connectivity: Utilize the Wi-Fi and Bluetooth capabilities of the ESP32-S3 to connect to networks, other devices, or cloud services as per your project requirements.
6. Maintenance
To ensure the longevity and optimal performance of your LILYGO T-Display-S3, consider the following maintenance tips:
- Handle with Care: The board contains sensitive electronic components. Avoid dropping it or subjecting it to excessive force.
- Keep Dry: Protect the board from moisture and liquids, which can cause short circuits and damage.
- Clean Gently: If cleaning is necessary, use a soft, dry cloth. Avoid using harsh chemicals or abrasive materials.
- Proper Storage: When not in use, store the board in an anti-static bag or its original packaging to prevent static discharge damage.
- Power Management: Always ensure correct voltage and current are supplied to the board. Incorrect power can lead to irreversible damage.
7. Troubleshooting
If you encounter issues with your LILYGO T-Display-S3, consider the following troubleshooting steps:
- Board Not Detected:
- Ensure USB-C cable is fully connected and functional.
- Verify that the correct USB-to-serial drivers are installed on your computer.
- Try a different USB port or cable.
- Upload Errors:
- Confirm the correct board type (ESP32-S3 Dev Module) and COM port are selected in your IDE.
- Ensure no other applications are using the serial port.
- Press and hold the Boot button, then press and release the Reset button, then release the Boot button to enter flashing mode before uploading.
- Check your code for syntax errors.
- Display Not Working:
- Verify that the display initialization code in your program is correct for the ST7789 driver.
- Ensure power is supplied to the display (usually handled by the board itself).
- Check for any physical damage to the display or its connection.
- Unexpected Behavior:
- Review your code logic carefully.
- Check power supply stability.
- Consult the LILYGO GitHub repository or community forums for similar issues.
8. Support and Resources
For further assistance, detailed documentation, and community support, please refer to the following resources:
- Official GitHub Repository: github.com/Xinyuan-LilyGO/T-Display-S3 - This is the primary source for code examples, libraries, and technical documentation.
- LILYGO Store: LILYGO Amazon Store - For product information and purchasing.
- Product Service: If you have any questions or suggestions about the product, please feel free to contact LILYGO directly.