LILYGO T-Display-S3-Pro

LILYGO T-Display-S3-Pro ESP32-S3 Touch Display User Manual

Model: T-Display-S3-Pro

1. Introduction

The LILYGO T-Display-S3-Pro is a versatile development board featuring an ESP32-S3 microcontroller, a 2.33-inch touch display, and integrated sensors. Designed for a wide range of applications, this module combines Wi-Fi and Bluetooth connectivity with a user-friendly display interface, making it suitable for IoT projects, embedded systems, and custom user interfaces.

2. Product Features

  • Display: 2.33-inch IPS TFT LCD with 222(H) x 480(V) resolution and capacitive touch.
  • Microcontroller: ESP32-S3R8 Dual-core LX7 microprocessor.
  • Wireless Connectivity: Wi-Fi 802.11 and Bluetooth 5 (BLE + BT mesh).
  • Memory: 16MB Flash, 8MB PSRAM.
  • Sensors: Integrated I2C Digital Light Sensor (LTR-553ALS-01) with ambient light and proximity sensing.
  • Power Management: SY6970 chip for mobile OTG, built-in 3.8V 470mA battery, and a battery power switch.
  • Expansion: Two integrated QWIIC ports, POGO pin for camera module extension, and optional MPU9250 IMU modules.
  • Programming Platforms: Supports Arduino-IDE and MicroPython.
  • Onboard Buttons: Boot, Reset, IO12, and IO16.

3. Package Contents

Verify that all items are present in your package:

  • 1 x LILYGO T-Display-S3-Pro Development Board
  • 2 x 13-pin Headers
LILYGO T-Display-S3-Pro and two 13-pin headers

Image: Contents of the LILYGO T-Display-S3-Pro package, showing the main board and two pin headers.

4. Hardware Overview

4.1. Device Layout and Dimensions

The T-Display-S3-Pro features a compact design with a 2.33-inch display on the front and various ports and labels on the sides and back.

LILYGO T-Display-S3-Pro with dimensions L:72mm, W:32mm, H:18mm

Image: Top-down view of the LILYGO T-Display-S3-Pro showing its approximate dimensions: Length (L) 72mm, Width (W) 32mm, Height (H) 18mm.

Front view of LILYGO T-Display-S3-Pro showing system information on screen

Image: Front view of the T-Display-S3-Pro with its screen displaying system information such as LILYGO 1.0.0, IDF v4.4.4, ESP32-S3 CPU, 16MB Memory, 2.33-inch screen size, USB connection status, and voltage readings.

Back view of LILYGO T-Display-S3-Pro showing FCC and CE labels

Image: Back view of the T-Display-S3-Pro, clearly showing the FCC ID (2ASYE-T-DISPLAY-PRO) and CE certification marks, along with the model number T-Display-S3 Pro.

4.2. Pinout and Internal Components

Understanding the pinout is crucial for advanced development and connecting external modules.

Internal Pinout Diagram of LILYGO T-Display-S3-Pro

Image: Detailed internal pinout diagram of the T-Display-S3-Pro, illustrating GPIO assignments, power pins (3V3, GND, BAT, USB), and connections for the display (ST7796 + CST226SE), I2C, and touch inputs. It also indicates the IPEX-1 connector for an external antenna.

T-Display-S3 Pro Pinmap with SD Card, LCD, I2C Light Sensor, and Capacitive Touch details

Image: Pinmap for the T-Display-S3 Pro, detailing connections for the SD Card (MISO, MOSI, SCLK, CS), IPS LCD (BL, DC, RST, CS, MISO, MOSI, SCLK), I2C Light Sensor (SDA, SCL), and Capacitive Touch (SCLK, MISO, MOSI, RST, IRQ, Touch Button). It also shows the display resolution of 222x480.

5. Specifications

FeatureDetail
BrandLILYGO
Model NameT-Display-S3-Pro
MCUESP32-S3R8 Dual-core LX7 microprocessor
RAMLPDDR4
Flash Memory16MB
PSRAM8MB
Display2.33-inch IPS TFT LCD, 222(H) x 480(V) resolution, Capacitive Touch
Display DriverST7796
Wireless TypeWi-Fi 802.11, Bluetooth 5 (BLE + BT mesh)
Connectivity TechnologyBluetooth, I2C, USB OTG
Operating SystemFreeRTOS (supports Arduino-IDE, MicroPython)
SensorsI2C Digital Light Sensor (LTR-553ALS-01)
BatteryBuilt-in 3.8V 470mA
Housing MaterialABS
Dimensions (L x W x H)72mm x 32mm x 18mm (approximate)

6. Setup and Getting Started

6.1. Initial Connection

To begin using your T-Display-S3-Pro, connect it to your computer using a USB-C cable. The device should power on and may display a preloaded demo or system information.

Angled view of LILYGO T-Display-S3-Pro showing USB-C port and side buttons

Image: Angled view of the T-Display-S3-Pro, highlighting the USB-C port for power and data connection, along with the side buttons.

6.2. Development Environment Setup

The T-Display-S3-Pro is designed for development using platforms like Arduino-IDE or MicroPython. For detailed instructions on setting up your development environment and accessing example code, refer to the official LILYGO GitHub repository:

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

This repository contains essential documentation, drivers, and sample sketches to help you get started with programming the device.

6.3. Battery Usage and Charging

The device includes a built-in 3.8V 470mA battery. To ensure proper charging and usage of the battery, it may be necessary to enable battery management features within your code. Consult the official GitHub documentation for specific code examples and configuration details related to battery operation.

7. Operating Instructions

The operation of the T-Display-S3-Pro largely depends on the firmware loaded onto it. The device features a capacitive touch display for user interaction and several physical buttons.

7.1. Basic Interaction

  • Touch Display: Interact with on-screen elements by tapping or swiping, similar to a smartphone.
  • Buttons: The onboard buttons (Boot, Reset, IO12, IO16) can be programmed for various functions within your application. The Reset button typically reboots the device.
Front and back view of LILYGO T-Display-S3-Pro, front showing settings menu

Image: Front view of the T-Display-S3-Pro showing a settings menu on the screen, alongside a back view of the device.

7.2. Custom Applications

The primary use of this device is for custom application development. You will need to write and upload your own code to utilize its full capabilities, including Wi-Fi, Bluetooth, sensor readings, and display functionalities. Refer to the GitHub repository for programming guides and examples.

8. Maintenance

Proper maintenance ensures the longevity and optimal performance of your T-Display-S3-Pro.

  • Cleaning: Use a soft, dry cloth to clean the display and housing. Avoid abrasive cleaners or solvents.
  • Storage: Store the device in a cool, dry place away from direct sunlight and extreme temperatures.
  • Handling: Handle the board with care to avoid damaging the sensitive electronic components or the display.
  • Firmware Updates: Regularly check the official LILYGO GitHub for firmware updates and new libraries to ensure your device has the latest features and bug fixes.

9. Troubleshooting

This section addresses common issues you might encounter.

9.1. Device Not Powering On

  • Ensure the USB-C cable is securely connected to both the device and a power source (computer USB port or wall adapter).
  • Verify the power source is functional.
  • If using the internal battery, ensure it is charged and the battery power switch is in the ON position.

9.2. Display Not Responding or Showing Blank Screen

  • Perform a hard reset by pressing the Reset button.
  • Ensure your uploaded code properly initializes and manages the display. Incorrect display initialization can lead to a blank or unresponsive screen.
  • Verify that the display driver (ST7796) is correctly configured in your software.

9.3. Issues with Uploading Code

  • Ensure you have installed the correct USB drivers for the ESP32-S3.
  • Select the correct board and COM port in your Arduino-IDE or other development environment.
  • Try holding down the Boot button while pressing and releasing the Reset button, then release the Boot button to enter bootloader mode for flashing.
  • Consult the LILYGO GitHub repository for specific flashing instructions and troubleshooting tips related to your operating system.

9.4. Battery Not Charging or Discharging Properly

  • As noted by users, proper battery charging and usage may require specific code implementation. Ensure your firmware includes the necessary code to enable and manage the SY6970 chip for battery functionality. Refer to the official LILYGO GitHub for examples.
  • Check the physical battery power switch on the device.

10. Support and Resources

For the most up-to-date information, technical support, and community discussions, please refer to the official LILYGO resources:

For warranty information, please refer to the terms and conditions provided by your retailer at the time of purchase.

Related Documents - T-Display-S3-Pro

Preview LILYGO T-Display-S3 User Guide
A user guide for the LILYGO T-Display-S3 development board, covering setup, Arduino IDE usage, and basic Wi-Fi commands.
Preview LILYGO T-BEAM-S3 User Guide: Setup and Development
This user guide provides comprehensive instructions for setting up the LILYGO T-BEAM-S3 development board. Learn how to configure the software environment using Arduino IDE, connect the board, and utilize its Wi-Fi, BLE, GPS, and LoRa capabilities for IoT projects.
Preview LILYGO T-Display-S3 Pro ESP32-S3 Development Board User Guide
Comprehensive user guide for the LILYGO T-Display-S3 Pro ESP32-S3 development board. Covers setup of the Arduino IDE, software installation, configuration, connecting the board, and a reference for common Wi-Fi SSC commands.
Preview LILYGO T-WATCH S3 User Guide: Setup and Development with Arduino
Learn to develop IoT applications with the LILYGO T-WATCH S3. This guide covers setting up the Arduino IDE, programming the ESP32-S3, and using SSC commands, provided by Xinyuan.
Preview LILYGO Mini E-Paper-S3 User Guide
Comprehensive user guide for the LILYGO Mini E-Paper-S3 development board. Covers setup, Arduino IDE integration, firmware development, and Wi-Fi command reference for IoT applications.
Preview LILYGO T-Dongle-S3 User Guide: Getting Started with ESP32-S3 Development
A comprehensive user guide for the LILYGO T-Dongle-S3 development board. Learn how to set up your Arduino development environment, program the ESP32-S3 module, and explore Wi-Fi and Bluetooth features.