1. Introduction
The LILYGO® T-Display-S3-Long is a versatile development board featuring a 3.4-inch capacitive touch TFT LCD and an ESP32-S3 microcontroller. Designed for various embedded applications, it integrates Wi-Fi and Bluetooth wireless connectivity, making it suitable for IoT projects, display interfaces, and more. This manual provides essential information for setting up, operating, and maintaining your T-Display-S3-Long development board.

2. Key Features
- Microcontroller: ESP32-S3R8 Dual-core LX7 microprocessor
- Wireless Connectivity: Wi-Fi 802.11, BLE 5 + BT mesh
- Memory: 16MB Flash, 8MB PSRAM
- Display: 3.4-inch Capacitive Touch TFT LCD
- Display Resolution: 180(H)RGB x 640(V)
- Display Interface: QSPI
- Onboard Functions: Boot Button, Reset Button, Battery Switch
- Battery Management: Battery voltage detection (IO08)
- Programming Platform: Arduino-IDE, VS Code

3. Package Contents
Verify that all items are present in your package:
- 1 x T-Display-S3-long-3.4-V1.0 Development Board
- 2 x STEMMA QT/Qwiic Interface Line [P352]
- 1 x Battery Cable
- 1 x 1.27mm Female PIN (2*15P)

4. Technical Specifications
| Feature | Specification |
|---|---|
| Model Number | T-Display-S3-Long |
| Brand Name | lilygo |
| Origin | Mainland China |
| Chipset | ESP32-S3 |
| MCU | ESP32-S3R8 Dual-core LX7 microprocessor |
| Wireless Connectivity | Wi-Fi 802.11, BLE 5 + BT mesh |
| Flash Memory | 16MB |
| PSRAM | 8MB |
| Display Type | 3.4 inch Capacitive Touch TFT LCD |
| Display Resolution | 180(H)RGB x 640(V) |
| Display Interface | QSPI |
| Onboard Functions | Boot Button, Reset Button, Battery Switch |
| Battery Voltage Detection | IO08 |
| Dimensions (L x W x H) | 9.2 cm x 2.8 cm x 1.4 cm |
| Weight | 0.05 kg |


5. Setup Guide
To begin using your LILYGO T-Display-S3-Long, follow these general steps:
- Connect to Computer: Use a USB-C cable to connect the development board to your computer. The board will draw power from the USB connection.
- Driver Installation: Depending on your operating system, you may need to install USB-to-serial drivers (e.g., CP210x or CH340 drivers) if the board is not recognized automatically.
- IDE Setup: Install your preferred development environment, such as Arduino IDE or VS Code with PlatformIO.
- Board Support Package: Add ESP32-S3 board support to your IDE. Refer to the official ESP-IDF or Arduino-ESP32 documentation for detailed instructions.
- Sample Code: Download sample code and libraries from the official LILYGO GitHub repository for the T-Display-S3-Long. This will provide examples for display initialization, Wi-Fi, Bluetooth, and other features.
- Upload Code: Compile and upload your desired firmware or example sketch to the board.
- Battery Connection (Optional): If using battery power, connect a compatible LiPo battery to the JST-GH 1.25mm connector. Ensure correct polarity.
- Qwiic/STEMMA QT Connection (Optional): Utilize the onboard Qwiic connectors for easy integration with compatible sensors and modules.
For detailed programming guides and up-to-date technical support, please refer to the official GitHub repository: T-Display-S3-Long GitHub.
6. Operating Instructions
Once the firmware is uploaded, the T-Display-S3-Long will execute the programmed logic. Key operational aspects include:
- Power On/Off: The board powers on when connected via USB or battery. Use the onboard battery switch to control power when running on battery.
- Display Interaction: The 3.4-inch capacitive touch display allows for user input and visual feedback. Your firmware will define how touch events are processed and what information is displayed.
- Wireless Communication: Leverage the integrated Wi-Fi and Bluetooth capabilities for network connectivity, data transfer, and communication with other devices.
- Boot/Reset Buttons: The Boot button is typically used during firmware upload (often in combination with the Reset button). The Reset button restarts the microcontroller.
- Expansion: The 2x15PIN header and Qwiic connectors provide access to GPIOs and I2C for connecting external components and expanding functionality.
7. Product Pin Diagram
Understanding the pinout is crucial for connecting external components and custom circuits. Refer to the diagram below for the pin assignments of the T-Display-S3-Long.

The diagram illustrates the connections for the TFT display (Backlight, QSPI pins) and other general-purpose input/output (GPIO) pins available for your projects.
8. Maintenance
- Cleaning: Use a soft, dry cloth to clean the display and PCB. Avoid using liquids or abrasive materials.
- Storage: Store the board in a dry, anti-static environment when not in use.
- Handling: Handle the board by its edges to avoid touching sensitive components, especially the display surface.
- Firmware Updates: Regularly check the official GitHub repository for firmware updates or new examples that may improve performance or add features.
9. Troubleshooting
- Board Not Detected: Ensure USB cable is properly connected. Install necessary USB-to-serial drivers. Try a different USB port or cable.
- Display Not Working: Check power supply. Verify display initialization code in your firmware. Ensure all display connections are secure.
- Wi-Fi/Bluetooth Issues: Double-check network credentials in your code. Ensure antenna is properly connected (if external). Verify that the Wi-Fi/Bluetooth module is enabled in your firmware.
- Firmware Upload Failure: Ensure the correct board is selected in your IDE. Press and hold the BOOT button while pressing and releasing the RESET button before uploading, then release BOOT. Check serial port selection.
- Random Resets: Ensure stable power supply. Check for short circuits or incorrect wiring of external components.
For more specific issues, consult the LILYGO T-Display-S3-Long GitHub repository's issues section or community forums for solutions.
10. User Tips
- Start with Examples: Begin with the provided example sketches from the GitHub repository to familiarize yourself with the board's functionalities before developing complex projects.
- Power Management: When running on battery, monitor battery voltage (via IO08) to prevent deep discharge and prolong battery life.
- Community Support: The open-source nature of ESP32-S3 boards means there's a large community. Utilize online forums and the GitHub repository for questions and project ideas.
11. Warranty and Support
For technical support, documentation, and community resources, please visit the official LILYGO GitHub repository for the T-Display-S3-Long: https://github.com/Xinyuan-LilyGO/T-Display-S3-Long.
For product-related inquiries or issues not covered by the documentation, please contact LILYGO Official Store customer service. Please check the package and the product in time after receiving it. If there is any unclear aspect or if the package is damaged due to external force, contact customer service for a satisfactory solution.