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.



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:
- Connect to PC: Use a USB Type-C cable to connect the T-RGB board to your computer.
- 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.
- Prepare Development Environment: Set up your preferred IDE (e.g., Arduino IDE, VS Code with PlatformIO, or ESP-IDF).
- Obtain Firmware: Download example code or the latest firmware from the official LILYGO GitHub repository: T-RGB GitHub.
- 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.
- 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)

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

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

10.2 2.8-inch Product Size

11. Firmware and Software Resources
For the latest firmware, example code, and detailed documentation, please visit the official LILYGO 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.