1. Introduction
The LILYGO T-Display-S3 is a versatile development board featuring the ESP32-S3 microcontroller, a 1.43-inch AMOLED display, and integrated WiFi and Bluetooth capabilities. Designed for makers and developers, it offers a compact solution for projects requiring a vibrant display, wireless communication, and robust processing power. This manual provides essential information for setting up, operating, and maintaining your T-Display-S3 board.
2. Product Overview
The T-Display-S3 integrates a powerful ESP32-S3 dual-core LX7 microprocessor, 16MB Flash, and 8MB PSRAM, making it suitable for complex applications. It features a high-resolution 1.43-inch AMOLED display with capacitive touch functionality, an SD card slot for expanded storage, and a USB-C port for power and programming.
2.1 Key Features
- Microcontroller: ESP32-S3R8 Dual-core LX7 microprocessor
- Wireless Connectivity: 2.4 GHz Wi-Fi & Bluetooth 5 (LE)
- Display: 1.43-inch SH8601 AMOLED, 466x466 px resolution, QSPI Bus Interface, Capacitive Touch
- Memory: 16MB Flash, 8MB PSRAM
- Storage: Micro SD Card slot
- Power: USB-C for 5V 500mA charging, Bat Voltage Detection (I004)
- Development Environments: Arduino, PlatformIO-IDE, ESP-IDF
2.2 Components
The board includes the main ESP32-S3 module, the AMOLED display, a USB-C port, a Micro SD card slot, and various pin headers for external connections.


3. Specifications
| Feature | Specification |
|---|---|
| Model Number | T-Display-S3 |
| Chipset | ESP32-S3R8 (Dual-core LX7 microprocessor) |
| Wireless | 2.4 GHz Wi-Fi, Bluetooth 5 (LE) |
| Flash Memory | 16MB |
| PSRAM | 8MB (Octal SPI) |
| Display Type | 1.43-inch AMOLED |
| Display Resolution | 466x466 pixels |
| Display Driver IC | SH8601 |
| Bus Interface | QSPI |
| Touch Screen | Capacitive Touch |
| External Storage | Micro SD Card slot |
| USB Interface | USB-C (5V 500mA charging) |
| Dimensions | L: 45mm, H: 11mm |
| Compatible Development Style | Arduino, PlatformIO-IDE, ESP-IDF |

4. Setup Instructions
To begin using your LILYGO T-Display-S3, follow these steps:
- Unpack the Board: Carefully remove the T-Display-S3 board and included accessories (power cable, pin headers) from its packaging.
- Connect to Computer: Use a USB-C cable to connect the T-Display-S3 to your computer. The board should power on, and the display may show a default test pattern.
- Install Development Environment: Choose your preferred development environment:
- Arduino IDE: Install the Arduino IDE and add ESP32 board support.
- PlatformIO IDE: Install VS Code and the PlatformIO extension.
- ESP-IDF: Set up the Espressif IoT Development Framework.
- Install Drivers: Ensure your computer has the necessary USB-to-serial drivers installed for the ESP32-S3 (usually CP210x or CH340, depending on the specific board revision). These are often automatically installed or can be found on the Espressif website.
- Upload First Program: Open your chosen IDE, select the correct board (e.g., ESP32-S3 Dev Module) and COM port. Upload a simple example sketch, such as a 'Hello World' to the serial monitor or a basic graphics demo to the AMOLED display, to verify functionality.

5. Operating Instructions
The LILYGO T-Display-S3 is designed for custom programming and interaction. Its operation largely depends on the code you upload to it.
5.1 Programming and Uploading
Once your development environment is set up, you can write and upload your own code. The ESP32-S3 supports various programming languages and frameworks, including Arduino C++, MicroPython, and ESP-IDF.
- Write Code: Develop your application logic, display graphics, and handle sensor inputs using the chosen SDK/framework.
- Compile: Compile your code within the IDE.
- Upload: Connect the board via USB-C and upload the compiled firmware. The board will typically reset and run your new program.
5.2 Interacting with the Display and Touch
- The 1.43-inch AMOLED display can be programmed to show text, graphics, and animations.
- The capacitive touch screen allows for user input, enabling interactive applications. Refer to the display's driver library documentation for specific touch functions.
5.3 Using the Micro SD Card
The onboard Micro SD card slot allows for data logging, storing images, or loading configuration files. Ensure the SD card is formatted correctly (e.g., FAT32) and use appropriate libraries in your code to read and write data.
6. Pin Diagram
Understanding the pinout is crucial for connecting external components and sensors to your T-Display-S3. The following diagram illustrates the pin assignments for the ESP32-S3, AMOLED display, and other peripherals.

Key Pin Assignments:
- Micro SD Card: CS (I038), MOSI (I039), MISO (I040), SCLK (I041)
- BAT VOL ADC: INT (I004)
- Touch I2C & RTC PCF8563: INT (I009), SDA (I007), SCL (I006)
- 1.43-inch AMOLED: LCD_SDI00 (I011), LCD_SDI01 (I013), LCD_SDI02 (I014), LCD_SDI03 (I015), LCD_SCLK (I012), LCD_CS (I010), LCD_RST (I017), LCD_EN (I016)
- QWIIC: Standard I2C interface for compatible modules.
- Type-C: USB data and power.
- BAT: Battery connection pins (BAT, G, 3V, 39, 40, 41, 42, 43, 44, 45, 46).
7. Maintenance
Proper care will ensure the longevity and reliable operation of your T-Display-S3 development board.
- Handle with Care: Avoid dropping the board or subjecting it to excessive force.
- Keep Dry: Protect the board from moisture and liquids, as these can cause short circuits and damage components.
- Clean Gently: If cleaning is necessary, use a soft, dry cloth. Avoid harsh chemicals or abrasive materials.
- Static Discharge: Take precautions against electrostatic discharge (ESD) when handling the board, especially when connecting or disconnecting components.
- Power Supply: Use a stable 5V power supply via the USB-C port. If using a battery, ensure it is compatible and correctly connected.
8. Troubleshooting
If you encounter issues with your T-Display-S3, consider the following troubleshooting steps:
- Board Not Powering On:
- Check the USB-C cable and power source. Try a different cable or USB port.
- Ensure the cable is a data-capable cable, not just a charging cable. - Unable to Upload Code:
- Verify that the correct board and COM port are selected in your IDE.
- Ensure USB-to-serial drivers are properly installed.
- Try pressing the 'BOOT' button (if available) while uploading, then the 'RESET' button after upload starts.
- Check for any error messages in the IDE's output window. - Display Not Working:
- Ensure the display ribbon cable is securely connected.
- Verify that your code initializes the display correctly with the appropriate driver (SH8601) and resolution. - Touch Screen Unresponsive:
- Check for proper initialization of the touch controller in your code.
- Ensure there are no physical obstructions or damage to the touch surface. - Wi-Fi/Bluetooth Connectivity Issues:
- Double-check your network credentials (SSID, password).
- Ensure the antenna (if external) is properly connected.
- Verify that your code correctly initializes and uses the Wi-Fi/Bluetooth modules.
9. User Tips
- Start with Examples: Begin by running official LILYGO or ESP32-S3 examples for the display, Wi-Fi, and Bluetooth to familiarize yourself with the board's capabilities and libraries.
- Power Management: For battery-powered projects, pay attention to power consumption. The ESP32-S3 has various low-power modes that can be utilized.
- Community Support: LILYGO products often have active communities. Search online forums and GitHub repositories for project ideas, code examples, and troubleshooting advice.
- Documentation: Refer to the official Espressif ESP32-S3 documentation for in-depth technical details on the microcontroller.
10. Warranty and Support
For technical support, product inquiries, or issues with your LILYGO T-Display-S3, please contact the official LILYGO support channels.
10.1 Customer Service Notes
LILYGO aims to provide excellent customer service. Please note the following:
- If there is any unclear aspect about your order or product, please do not hesitate to contact customer service for a satisfactory solution.
- If the package is damaged due to external force or transportation, provide clear pictures of the logistics label, carton/bag, and the damaged product. LILYGO will work with the Logistics Service Provider to offer a solution.
- For customized products, bulk orders, or any product-related questions, feel free to contact customer service.
