lilygo T-Display-S3-Long

Contents

LILYGO® T-Display-S3-Long Development Board User Manual

Model: T-Display-S3-Long

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.

LILYGO T-Display-S3-Long front and back view, showing the display and the PCB.
Figure 1: LILYGO T-Display-S3-Long Front and Back View

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
Image showing various LILYGO T-Display-S3 models, including 'With Shell Grey' and 'With Shell Black' versions, and 'Not Solder PIN' and 'Solder PIN' options. Also shows a MIDI board.
Figure 2: LILYGO T-Display-S3 Series Variants

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)
Shipping List / Package Contents image, detailing 1x T-Display-S3-long-3.4-V1.0, 2x STEMMA QT/Qwiic Interface lines, 1x Battery cable, 1x 1.27mm Female PIN (2*15P).
Figure 3: Package Contents

4. Technical Specifications

FeatureSpecification
Model NumberT-Display-S3-Long
Brand Namelilygo
OriginMainland China
ChipsetESP32-S3
MCUESP32-S3R8 Dual-core LX7 microprocessor
Wireless ConnectivityWi-Fi 802.11, BLE 5 + BT mesh
Flash Memory16MB
PSRAM8MB
Display Type3.4 inch Capacitive Touch TFT LCD
Display Resolution180(H)RGB x 640(V)
Display InterfaceQSPI
Onboard FunctionsBoot Button, Reset Button, Battery Switch
Battery Voltage DetectionIO08
Dimensions (L x W x H)9.2 cm x 2.8 cm x 1.4 cm
Weight0.05 kg
Detailed specifications and product function diagram, including MCU, wireless connectivity, programming platform, flash/PSRAM, battery detection, onboard functions, and 3.4-inch capacitive touch TFT LCD details. Also shows a simplified board diagram with key components.
Figure 4: T-Display-S3-Long Specifications and Product Function Diagram
Dimensions image, showing L: 9.2cm, W: 2.8cm, H: 1.4cm.
Figure 5: T-Display-S3-Long Dimensions

5. Setup Guide

To begin using your LILYGO T-Display-S3-Long, follow these general steps:

  1. 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.
  2. 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.
  3. IDE Setup: Install your preferred development environment, such as Arduino IDE or VS Code with PlatformIO.
  4. Board Support Package: Add ESP32-S3 board support to your IDE. Refer to the official ESP-IDF or Arduino-ESP32 documentation for detailed instructions.
  5. 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.
  6. Upload Code: Compile and upload your desired firmware or example sketch to the board.
  7. Battery Connection (Optional): If using battery power, connect a compatible LiPo battery to the JST-GH 1.25mm connector. Ensure correct polarity.
  8. 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.

Detailed pinout diagram for the T-Display-Long, showing TFT_Backlight, TFT_QSPI_SCK, TFT_QSPI_RST, TFT_QSPI_CS, TFT_QSPI_D0, TFT_QSPI_D1, TFT_QSPI_D2, TFT_QSPI_D3, and their corresponding IO numbers.
Figure 6: T-Display-S3-Long Pinout Diagram

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.

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.