LILYGO T-Display-S3 AMOLED

Download PDF
Contents

LILYGO T-Display-S3 AMOLED Development Board User Manual

Model: T-Display-S3 AMOLED (Welded Pin Version)

1. Introduction

The LILYGO T-Display-S3 AMOLED is an advanced development board featuring the ESP32-S3 microcontroller and a vibrant 1.91-inch RM67162 AMOLED display. This board is designed for a wide range of applications requiring wireless connectivity (Wi-Fi and Bluetooth 5 LE) and a high-quality visual interface. It serves as an excellent platform for embedded system development, IoT projects, and custom display solutions.

This manual provides essential information for setting up, operating, maintaining, and troubleshooting your T-Display-S3 AMOLED development board.

2. Safety Information

  • Electrostatic Discharge (ESD) Precautions: Always handle the board by its edges and use anti-static measures (e.g., anti-static wrist strap, mat) to prevent damage from static electricity.
  • Power Supply: Use only appropriate power sources (e.g., USB-C port, battery connector) within the specified voltage range. Incorrect voltage can damage the board.
  • Environmental Conditions: Avoid exposing the board to extreme temperatures, humidity, dust, or corrosive substances. Operate within recommended temperature and humidity ranges.
  • Physical Handling: Do not apply excessive force to the board or its components. Avoid bending or dropping the board.
  • Soldering: If soldering is required (for unwelded pin versions or custom connections), ensure proper ventilation and use appropriate safety equipment.

3. Package Contents

Verify that all items are present in your package:

  • 1 x LILYGO T-Display-S3 AMOLED Development Board
  • 2 x 14-pin Headers (for welded pin version, these are pre-soldered)
  • 1 x Power Cable (JST-SH 1.0mm 4-Pin)
LILYGO T-Display-S3 AMOLED package contents including the board, two 14-pin headers, and a power cable.

Image: Contents of the LILYGO T-Display-S3 AMOLED package.

4. Product Overview

The T-Display-S3 AMOLED integrates an ESP32-S3R8 dual-core LX7 microprocessor with a 1.91-inch AMOLED display. Key features include:

  • Upgraded Display: Transition from LCD to AMOLED for superior color, contrast, and power efficiency.
  • Faster Interface: Upgraded from SPI to QSPI for improved display data transfer speeds.
  • Enhanced Wireless: Features a 3D antenna for better Wi-Fi and Bluetooth signal reception compared to onboard antennas.
  • Onboard Functions: Includes Boot (IO0), Reset, and IO21 buttons for easy interaction and programming.
  • Battery Management: Supports battery voltage detection (IO04) and includes a JST-SH 1.0mm 4-Pin connector for external battery.
Front view of the LILYGO T-Display-S3 AMOLED development board with its vibrant display.

Image: Front view of the T-Display-S3 AMOLED.

Back view of the LILYGO T-Display-S3 AMOLED development board, showing the ESP32-S3 chip and other components.

Image: Back view of the T-Display-S3 AMOLED.

Detailed pinout diagram of the LILYGO T-Display-S3 AMOLED board, showing GPIOs, power pins, and display connections.

Image: Pinout diagram of the T-Display-S3 AMOLED.

Comparison diagram illustrating the differences between SPI and QSPI interfaces, and LCD versus AMOLED display technologies.

Image: SPI vs QSPI and LCD vs AMOLED comparison.

5. Specifications

FeatureDetail
BrandLILYGO
Model NameT-Display-S3 AMOLED
MCUESP32-S3R8 Dual-core LX7 microprocessor
Display Type1.91 inch RM67162 AMOLED
Display Resolution240(W) x RGB x 536(H)
Display InterfaceQSPI
Wireless Connectivity2.4 GHz Wi-Fi & Bluetooth 5 (LE)
Flash Memory16MB PSRAM
RAM8MB
Operating SystemFreeRTOS (supports Arduino, PlatformIO-IDE, Micropython)
Product Dimensions2.36 x 1 x 0.39 inches (60 x 25.5 x 10 mm)
Item Model Number‎AMOLED

6. Setup Guide

6.1 Initial Connection

  1. Connect the T-Display-S3 AMOLED to your computer using a USB-C cable. The board should power on, and the display may show a default test pattern or remain blank if no firmware is loaded.
  2. If using an external battery, connect it to the JST-SH 1.0mm 4-Pin battery connector. Ensure correct polarity.

6.2 Software Environment Setup

The LILYGO T-Display-S3 AMOLED can be programmed using various development environments. The most common are Arduino IDE, PlatformIO, and Micropython.

  • Arduino IDE: Install the ESP32 board package and necessary libraries (e.g., TFT_eSPI). Refer to the official LILYGO GitHub repository for specific board definitions and example code.
  • PlatformIO: Set up your PlatformIO environment and configure it for the ESP32-S3 board. Example projects are available on the LILYGO GitHub.
  • Micropython: Flash the Micropython firmware to the ESP32-S3 and use a serial terminal or IDE (like Thonny) to interact with the board.

Important: For detailed setup instructions, driver installation, and example code, always refer to the official LILYGO GitHub repository: github.com/Xinyuan-LilyGO/T-Display-S3-AMOLED

7. Operating Instructions

7.1 Uploading Firmware

Once your development environment is set up, you can upload your custom code or example sketches to the board.

  1. Select the correct board (ESP32-S3 Dev Module) and COM port in your IDE.
  2. Compile your code.
  3. Press the "Upload" button in your IDE. You may need to press and hold the Boot (IO0) button while pressing and releasing the Reset button to put the ESP32-S3 into download mode, then release the Boot button.

7.2 Using the AMOLED Display

The 1.91-inch AMOLED display offers vibrant colors and deep blacks. Libraries like TFT_eSPI are commonly used for graphics operations. Refer to the library documentation and LILYGO examples for drawing text, shapes, images, and managing display updates.

7.3 Wireless Connectivity

The ESP32-S3 supports 2.4 GHz Wi-Fi and Bluetooth 5 (LE). You can integrate network functionalities into your projects, such as connecting to Wi-Fi networks, hosting web servers, or communicating with Bluetooth devices. Standard ESP-IDF or Arduino Wi-Fi/Bluetooth libraries are compatible.

7.4 Onboard Buttons

  • Boot (IO0): Used to put the ESP32-S3 into firmware download mode.
  • Reset: Restarts the board.
  • IO21: A general-purpose input/output button that can be programmed for various functions within your application.

8. Maintenance

  • Cleaning: Use a soft, dry, anti-static cloth to clean the board and display. Avoid using liquids or abrasive materials.
  • Storage: Store the board in an anti-static bag in a cool, dry place when not in use.
  • Firmware Updates: Regularly check the LILYGO GitHub repository for updated firmware, libraries, and examples to ensure optimal performance and access to new features.
  • Protective Film: The display may come with a thin protective plastic film. This should be carefully peeled off before use to ensure clear viewing and prevent confusion with potential "dead pixels" as noted by some users.

9. Troubleshooting

ProblemPossible Cause / Solution
Display is blank or shows artifacts.
  • Check if the protective plastic film is still on the screen. Carefully peel it off.
  • Ensure correct display initialization code is running.
  • Verify power supply is stable.
  • Confirm correct display library and pin configurations are used in your code.
Cannot upload code to the board.
  • Ensure correct COM port is selected in your IDE.
  • Verify ESP32-S3 board package is installed and selected.
  • Try manually putting the board into download mode: hold Boot (IO0), press and release Reset, then release Boot.
  • Check USB cable and drivers.
Wi-Fi or Bluetooth not working.
  • Ensure correct libraries are included and initialized in your code.
  • Verify antenna connection (if external). The board has a 3D antenna by default.
  • Check for proper power supply.
Board not recognized by computer.
  • Install necessary USB-to-Serial drivers (e.g., CP210x or CH340, depending on the board's USB chip).
  • Try a different USB cable or port.

For more specific issues or advanced debugging, consult the LILYGO GitHub repository's issues section or community forums.

10. Warranty Information

LILYGO products are typically covered by a limited manufacturer's warranty against defects in materials and workmanship. The specific terms and duration of the warranty may vary. Please retain your proof of purchase for warranty claims.

For detailed warranty information and to initiate a claim, please contact the seller or refer to the official LILYGO website.

11. Support

For technical support, documentation, and community resources, please visit the official LILYGO GitHub repository:

github.com/Xinyuan-LilyGO/T-Display-S3-AMOLED

This repository contains:

  • Example code and libraries
  • Detailed schematics and datasheets
  • Firmware updates
  • Community discussion and issue tracking

For purchase-related inquiries, returns, or replacements, please contact Amazon customer service directly.

© 2023 LILYGO. All rights reserved.

This manual is subject to change without notice.

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.