lilygo T-Display-S3

Contents

LILYGO T-Display-S3 ESP32-S3 1.43-inch AMOLED Development Board User Manual

Model: T-Display-S3 | Brand: LILYGO

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.

LILYGO T-Display-S3 board from multiple angles
Figure 1: LILYGO T-Display-S3 board from various perspectives.
Diagram of T-Display-S3 AMOLED 1.43-inch with specifications and onboard functions
Figure 2: Detailed diagram highlighting key specifications and onboard functions.

3. Specifications

FeatureSpecification
Model NumberT-Display-S3
ChipsetESP32-S3R8 (Dual-core LX7 microprocessor)
Wireless2.4 GHz Wi-Fi, Bluetooth 5 (LE)
Flash Memory16MB
PSRAM8MB (Octal SPI)
Display Type1.43-inch AMOLED
Display Resolution466x466 pixels
Display Driver ICSH8601
Bus InterfaceQSPI
Touch ScreenCapacitive Touch
External StorageMicro SD Card slot
USB InterfaceUSB-C (5V 500mA charging)
DimensionsL: 45mm, H: 11mm
Compatible Development StyleArduino, PlatformIO-IDE, ESP-IDF
Product dimensions: Length 45mm, Height 11mm
Figure 3: Physical dimensions of the T-Display-S3 board.

4. Setup Instructions

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

  1. Unpack the Board: Carefully remove the T-Display-S3 board and included accessories (power cable, pin headers) from its packaging.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
T-Display-S3 AMOLED 1.43-inch with touch test showing ID, fingers, and touch coordinates
Figure 4: Example of the display showing a touch test interface.

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.

  1. Write Code: Develop your application logic, display graphics, and handle sensor inputs using the chosen SDK/framework.
  2. Compile: Compile your code within the IDE.
  3. 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.

Detailed pin diagram for LILYGO T-Display-S3-AMOLED-1.43 showing ESP32-S3, AMOLED, Touch, RTC, and SD Card connections
Figure 5: Pinout diagram for the T-Display-S3-AMOLED-1.43 board.

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.
Customer service notes from LILYGO regarding product and package issues
Figure 6: LILYGO Customer Service Guidelines.

© 2023 LILYGO. All rights reserved.

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.