LILYGO T-RGB V1.0

Contents

LILYGO® T-RGB ESP32-S3 Development Board User Manual

Model: T-RGB V1.0

1. Introduction

The LILYGO® T-RGB is a compact development board featuring a circular touch display. It is designed for various embedded applications requiring a visual interface and wireless connectivity.

Key features include:

  • Main Control Chip: ESP32-S3R8 Tensilica Xtensa Dual Core LX7 Microprocessor.
  • Wireless Connectivity: Integrated Wi-Fi 802.11 b/g/n and Bluetooth 5.
  • Display: 2.1-inch ST7701S TFT LCD full-color circular touch screen.
  • Variants: Available with FT3267 (Half Circle) or CST820 (Full Circle) touch chips.
LILYGO T-RGB Development Board
Figure 1: LILYGO T-RGB Development Board

2. Package Contents

The standard package includes the following items:

  • 1 x LILYGO® T-RGB Development Board (FT3267 Half Circle or CST820 Full Circle variant)
  • 1 x JST 1.25mm 2P Power Cable

Note: Battery is not included.

Package Contents: T-RGB board and JST 1.25mm 2P cable
Figure 2: Package Contents

3. Specifications

T-RGB Specifications overview
Figure 3: T-RGB Specifications Overview
Feature Description
MCU ESP32-S3R8 Dual-core LX7 Microprocessor
Wireless Connectivity Wi-Fi 802.11 b/g/n, BLE 5 + BT mesh
Programming Platform Arduino-IDE, VS Code
Onboard PSRAM 16MB
Onboard Flash 8MB
TF-Card Slot Yes
Buttons Boot Button, Reset Button
Battery Detection Bat voltage detection (I004)
Screen Type 2.1 inch ST7701S IPS TFT LCD
Resolution 480(H) x 480(V) RGB Full Color
Interface 3-wire SPI + 18bit RGB interface
Drive IC ST7701S
Power Supply USB / Li-Po Battery Dual Power Supply

3.1. Dimensions

The T-RGB board comes in two main physical variants, "Half Circle" and "Full Circle", primarily differing in their touch chip and overall diameter.

Variant Touch Chip Length (L) Width (W) Height (H)
FT3267 Half Circle FT3267 63mm 59.5mm 18.28mm
CST820 Full Circle CST820 75mm N/A (Circular) 18.28mm
Dimensions for FT3267 Half Circle variant
Figure 4: FT3267 Half Circle Dimensions
Dimensions for CST820 Full Circle variant
Figure 5: CST820 Full Circle Dimensions

4. Pin Diagram

The following diagram illustrates the pinout of the LILYGO® T-RGB ESP32-S3 development board, including connections for the LCD, touch chips, and other peripherals.

Product Pin Diagram for T-RGB ESP32-S3
Figure 6: LILYGO T-RGB ESP32-S3 Pinout

Key Pin Assignments:

  • LCD Pins: LCD_BK (I046), LCD_HSYNC (I047), LCD_VSYNC (I041), LCD_DE (I045), LCD_PCLK (I042), LCD_DATA0-17 (I021, I018, I017, I016, I046, I015, I014, I013, I010, I009, I011, I007, I006, I005, I003, I002)
  • Touch Chip CST820: SDA_PIN (I008), SCL_PIN (I048), INT_PIN (I001)
  • Touch Chip FT3267: TP_RES (I001), PWR_EN (I002), LCD_CS (I003), LCD_SDA (I004), LCD_CLK (I005), LCD_RST (I006), SD_CS (I007)
  • TF Card: SD_CLK (I039), SD_CMD (I040), SD_DO (I038)
  • IIC/UART: SCL (I048), SDA (I008)
  • Power: G (GND), 3V3
  • Control: Reset, Boot
  • Interface: Type-C USB, 1.25mm JST connector

5. Setup

5.1. Initial Power-Up

  1. USB Connection: Connect the T-RGB board to your computer using a Type-C USB cable. This will provide power and enable communication for programming.
  2. Battery Connection (Optional): If using a Li-Po battery, connect it to the JST 1.25mm 2P connector. The board supports dual power supply from USB and battery.
  3. TF Card Insertion (Optional): If your application requires external storage, insert a TF card into the designated slot.

5.2. Development Environment Setup

The LILYGO® T-RGB ESP32-S3 can be programmed using Arduino IDE or VS Code (with PlatformIO extension).

  1. Install Arduino IDE or VS Code: Download and install your preferred development environment.
  2. Install ESP32 Board Support: Follow the instructions for your chosen IDE to install the ESP32 board support package. For Arduino IDE, this typically involves adding the ESP32 board manager URL in preferences and installing the ESP32 boards.
  3. Install Libraries: Install necessary libraries for the display (ST7701S), touch controller (FT3267 or CST820), and other peripherals as required by your project. Refer to the LILYGO GitHub repository for examples and recommended libraries.
  4. Connect and Select Board: Connect the T-RGB board via USB. In your IDE, select the correct ESP32-S3 board and the corresponding COM port.

For detailed programming examples and library information, please visit the official LILYGO T-RGB GitHub repository:

Link to LILYGO T-RGB GitHub repository
Figure 7: LILYGO T-RGB GitHub Repository

6. Operating Instructions

6.1. Basic Operation

  1. Power On: The board powers on automatically when connected via USB or a Li-Po battery.
  2. Display: The 2.1-inch circular LCD will activate and display content as programmed.
  3. Touch Functionality: Interact with the display using touch gestures. Ensure your firmware includes the necessary touch driver initialization.
  4. Boot Button: Used for entering bootloader mode during firmware flashing.
  5. Reset Button: Resets the ESP32-S3 microcontroller, restarting the running program.

6.2. Power Management

The T-RGB supports dual power input:

  • USB Type-C: Primary power source and data interface.
  • Li-Po Battery: Connect a compatible 3.7V Li-Po battery to the JST 1.25mm 2P connector for portable operation. The board includes battery voltage detection on pin I004.

7. Maintenance

To ensure the longevity and optimal performance of your LILYGO® T-RGB development board, follow these maintenance guidelines:

  • Handle with Care: Avoid dropping the board or subjecting it to excessive force, especially the display.
  • Keep Dry: Protect the board from moisture and liquids.
  • Clean Gently: If necessary, clean the display with a soft, lint-free cloth. Do not use harsh chemicals.
  • Static Discharge: Take precautions against electrostatic discharge (ESD) when handling the board, especially the exposed components.
  • Firmware Updates: Regularly check the LILYGO GitHub repository for firmware updates and bug fixes.

8. Troubleshooting

  • Display Not Lighting Up:
    • Ensure the board is properly powered via USB or battery.
    • Verify that the display initialization code in your firmware is correct.
    • Check for any physical damage to the display ribbon cable.
  • Touch Screen Unresponsive:
    • Confirm that the correct touch chip (FT3267 or CST820) drivers are installed and initialized in your code.
    • Check the touch chip's pin connections (SDA, SCL, INT) as per the pin diagram.
  • Programming Errors:
    • Ensure the correct ESP32-S3 board is selected in your IDE.
    • Verify the correct COM port is selected.
    • Check USB cable integrity.
    • Hold down the Boot button while pressing and releasing Reset to enter bootloader mode if flashing fails.
  • Board Not Detected by Computer:
    • Try a different USB Type-C cable.
    • Ensure USB drivers for ESP32 are correctly installed on your operating system.
    • Test with a different USB port on your computer.

9. User Tips

  • Good Display Quality: Users report good color reproduction and responsive touch functionality.
  • Battery Connection: The board can be connected directly to a Li-Po battery for power, as it supports dual power supply.
  • Project Compatibility: Ensure you select the correct variant (FT3267 Half Circle or CST820 Full Circle) based on your project's physical and touch interface requirements.
  • Community Support: Leverage the LILYGO community and GitHub resources for project ideas and troubleshooting.

10. Warranty and Support

LILYGO products are known for their quality and support within the maker community. For technical assistance, documentation, and community resources, please refer to the following:

  • Official GitHub Repository: The primary source for code examples, libraries, and detailed technical documentation. LILYGO T-RGB GitHub
  • LILYGO Official Store: For customer service inquiries regarding product issues or defects, please contact the seller directly.

LILYGO is a highly-rated brand with low return rates, indicating reliable products and customer satisfaction.

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.