LILYGO T-RGB ESP32-S3

Contents

LILYGO T-RGB ESP32-S3 Display User Manual

Model: T-RGB ESP32-S3 | Brand: LILYGO

1. Introduction

The LILYGO T-RGB ESP32-S3 is a versatile development board featuring an ESP32-S3R8 microcontroller and a round TFT LCD touch screen, available in 2.1-inch or 2.8-inch sizes. It integrates Wi-Fi and Bluetooth capabilities, making it suitable for a wide range of IoT and display-oriented projects. This manual provides essential information for setting up, operating, and maintaining your T-RGB ESP32-S3 board.

2. Product Overview

The LILYGO T-RGB ESP32-S3 combines a powerful microcontroller with a vibrant round display, offering a compact solution for interactive applications.

LILYGO T-RGB ESP32-S3 Display Module
Figure 2.1: LILYGO T-RGB ESP32-S3 Display Module
Video 2.1: Product demonstration showcasing the display and its features.
On-board interfaces of the LILYGO T-RGB ESP32-S3
Figure 2.2: Labeled diagram of the onboard interfaces including Grove 4PIN, TF Card slot, Type C port, and 3.7V Battery Holder.
ESP32-S3R8 chip highlighted on the board
Figure 2.3: The ESP32-S3R8 32-bit MCU with Wi-Fi and Bluetooth 5 (LE) capabilities.

3. Specifications

3.1 ESP32-S3R8 Microcontroller

  • Processor: Xtensa® Dual-Core 32-bit LX7 Microprocessor
  • Wi-Fi: 2.4 GHz Wi-Fi (802.11 b/g/n)
  • Bluetooth: Bluetooth® 5 (LE)
  • Clock Frequency: Main Frequency up to 240MHz
  • Peripheral Interfaces: I2C, SPI, UART, SDIO, I2S, CAN
  • Antenna: On-board PCB Antenna
  • Programming Platforms: C/C++, Arduino-IDE, Micropython, VS Code

3.2 Screen Parameters

  • Screen Size: 2.1-Inch or 2.8-Inch
  • Screen Type: TFT IPS LCD
  • Drive: ST7701S
  • Resolution: 480(H) * 480(V)
  • Screen Color: RGB Full Color
  • Interface 1: 3-Wire SPI
  • Interface 2: 18bit RGB
  • 2.1-Inch Touch Chip: CST820
  • 2.8-Inch Touch Chip: GT911

3.3 On-Board Functions

  • Flash: 8MB
  • PSRAM: 16MB
  • Battery Voltage Detection: IO04
  • Buttons: BOOT + Reset
  • Slots: TF-Card Slot, Grove 4PIN Slot, Type C, 3.7V Battery Slot

4. Setup and Getting Started

To begin using your LILYGO T-RGB ESP32-S3, follow these general steps:

  1. Connect to PC: Use a USB Type-C cable to connect the T-RGB board to your computer.
  2. Install Drivers: Ensure you have the necessary USB-to-serial drivers installed for your operating system. These are typically included with the ESP-IDF or Arduino IDE setup.
  3. Prepare Development Environment: Set up your preferred IDE (e.g., Arduino IDE, VS Code with PlatformIO, or ESP-IDF).
  4. Obtain Firmware: Download example code or the latest firmware from the official LILYGO GitHub repository: T-RGB GitHub.
  5. Upload Firmware: Follow the instructions provided in the GitHub repository to compile and upload the firmware to your board. You may need to press the BOOT button while connecting or during upload, depending on your setup.
  6. Power On: The board can be powered via the USB-C port or a 3.7V battery connected to the battery slot.

5. Operating Instructions

Once the firmware is uploaded, the T-RGB ESP32-S3 board will execute the programmed functions. Interaction typically involves:

  • Display Interaction: The TFT LCD will show visual output as programmed. The capacitive touch screen allows for user input through gestures or taps, depending on the application.
  • Buttons: The board includes BOOT and Reset buttons. The Reset button restarts the board, while the BOOT button is primarily used for entering firmware upload mode.
  • TF Card: Insert a TF card into the designated slot for data storage, logging, or loading assets for display. Ensure the card is formatted correctly (e.g., FAT32).
  • Battery Operation: For portable applications, connect a 3.7V LiPo battery to the battery holder. The board supports battery voltage detection via IO04, which can be monitored in your code.
  • Connectivity: Utilize the integrated Wi-Fi and Bluetooth 5 (LE) for network communication, data transfer, and IoT applications as defined by your firmware.

6. User Tips

  • Clock Setting: If your application displays a clock on startup, refer to the example code in the GitHub repository for instructions on how to set or synchronize the time. Many ESP32 projects use NTP (Network Time Protocol) for automatic time synchronization via Wi-Fi.
  • Power Management: When running on battery, consider implementing deep sleep modes for the ESP32-S3 to conserve power, especially for applications that do not require continuous operation.
  • Community Support: For advanced projects or specific programming questions, explore the LILYGO community forums or the ESP32 developer community for resources and assistance.

7. Troubleshooting

If you encounter issues with your LILYGO T-RGB ESP32-S3, consider the following:

  • Board Not Recognized:
    • Ensure the USB-C cable is functional and properly connected.
    • Verify that the correct USB-to-serial drivers are installed on your computer.
    • Check your IDE's serial port settings to ensure the correct port is selected.
  • Firmware Upload Failure:
    • Make sure the board is in bootloader mode (often by holding the BOOT button while pressing and releasing Reset, then releasing BOOT).
    • Confirm the correct board definition and serial port are selected in your IDE.
    • Try a different USB cable or port.
  • Display Not Working:
    • Check power supply to the board.
    • Verify that the display initialization code in your firmware is correct and matches the ST7701S driver.
    • Ensure the display ribbon cable is securely connected.
  • Touch Screen Unresponsive:
    • Confirm the correct touch chip driver (CST820 or GT911) is included and initialized in your firmware.
    • Check for any physical damage to the touch screen or its connections.
    • Some touch screens require calibration; refer to firmware examples for calibration routines.

8. What's in the Box

The standard package for the LILYGO T-RGB ESP32-S3 includes:

  • 1 X T-RGB Module (2.1-inch or 2.8-inch, depending on selection)
  • 1 X Power Cable (JST 1.25mm 2P)
Contents of the LILYGO T-RGB package
Figure 8.1: T-RGB module and included power cable.

9. Pinout Diagram

Understanding the pinout is crucial for connecting external components and sensors to your T-RGB ESP32-S3 board.

Detailed pinout diagram for LILYGO T-RGB ESP32-S3
Figure 9.1: LILYGO T-RGB Pinmap for ST7701S IPS LCD + ESP32-S3 + TF Card, showing LCD, Touch Chip, and other connections.

10. Dimensions

The LILYGO T-RGB ESP32-S3 is available in two display sizes, each with specific dimensions.

10.1 2.1-inch Product Size

Dimensional drawing for the 2.1-inch LILYGO T-RGB module
Figure 10.1: Dimensional drawing for the 2.1-inch T-RGB module.

10.2 2.8-inch Product Size

Dimensional drawing for the 2.8-inch LILYGO T-RGB module
Figure 10.2: Dimensional drawing for the 2.8-inch T-RGB module.

11. Firmware and Software Resources

For the latest firmware, example code, and detailed documentation, please visit the official LILYGO GitHub repository:

LILYGO T-RGB GitHub Repository

12. Warranty and Support

Your LILYGO T-RGB ESP32-S3 board comes with the following assurances:

  • Warranty: All products from our store include a 1-year warranty.
  • Returns: Enjoy 7 days to return if any quality problems are identified.
  • Customer Support: All messages and inquiries will be answered within 24 hours.

If you have any problems or questions regarding your product, please feel free to contact our support team.


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.