LILYGO T-RGB V1.0 (2.8 Inch)

Contents

LILYGO T-RGB ESP32-S3 2.8 inch LCD Touch Round Display User Manual

Your guide to setting up and operating your LILYGO T-RGB development board.

1. Introduction

The LILYGO T-RGB is a versatile circular touch display screen development board. It is designed for various embedded projects requiring a compact display with wireless connectivity.

At its core, the board features the ESP32-S3R8 Tensilica Xtensa Dual Core LX7 Microprocessor, providing robust processing power. This chip natively supports Wi-Fi 802.11 b/g/n and Bluetooth 5, enabling seamless wireless communication for your applications.

The integrated display is a 2.8-inch ST7701S TFT LCD full-color screen, offering a clear visual interface. The screen also boasts capacitive touch functionality, allowing for interactive user experiences.

Video: Overview of the LILYGO T-RGB 2.8 inch round screen with capacitive touch and ESP32-S3.

2. Specifications

The LILYGO T-RGB 2.8 inch development board comes with the following technical specifications:

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
PSRAM 8MB
Flash 16MB
Onboard Functions TF-Card Slot, Boot Button, Reset Button, Bat voltage detection: I004
Screen Type 2.8 inch ST7701S IPS TFT LCD
Screen Resolution 480(H) x 480(V) RGB Full Color
Screen Interface 3-wire SPI + 18bit RGB interface
Screen Driver IC ST7701S
Touch Chip GT911
T-RGB 2.8 inch Specifications

Image: Detailed specifications of the T-RGB 2.8 inch board.

3. Pin Diagram

Understanding the pinout is crucial for connecting external components and programming the board. Below is the pin diagram for the LILYGO T-RGB 2.8 inch board:

LILYGO T-RGB 2.8 inch PINMAP

Image: Pinout diagram for the LILYGO T-RGB 2.8 inch board, showing connections for LCD, Touch Chip, TF Card, and power.

Key pin assignments include:

  • LCD Pins: LCD_BK, LCD_HSYNC, LCD_VSYNC, LCD_DE, LCD_PCLK, LCD_DATA0-16.
  • Touch Chip (GT911) Pins: SDA_PIN: I048, SCL_PIN: I048, INT_PIN: I001, TP_RES: I001.
  • TF Card Pins: SD_CLK: I039, SD_CMD: I040, SD_DO: I038, SD_CS: I007.
  • Power & Control: Type-C (USB), Reset, Boot buttons, 1.25mm battery connector.

4. Dimensions

The physical dimensions of the LILYGO T-RGB 2.8 inch display board are as follows:

  • Overall Diameter: Approximately 77.59 mm
  • Visible Area (VA): 73.00 ± 0.15 mm
  • LCD Active Area (AA): 70.64 mm
  • Board Height (H): 1.8 cm (18 mm)
  • Board Length (L): 9.6 cm (96 mm)
  • Thickness of main board: 6.0 mm
Product dimensions with H:1.8CM and L:9.6CM labels

Image: Key dimensions of the LILYGO T-RGB board.

2.8 inch LCD Display Detailed Dimensions banner

Image: Detailed dimension diagrams for precise integration.

5. Package Contents

Upon receiving your LILYGO T-RGB, please verify that the package contains the following items:

  • 1 x LILYGO T-RGB Development Board
  • 1 x JST 1.25mm 2P Cable
Package contents showing 1 T-RGB board and 1 JST 1.25mm 2P cable

Image: Contents included in the LILYGO T-RGB package.

Note: Battery is not included in the package.

6. Setup

To get started with your LILYGO T-RGB development board, follow these general steps:

  1. Connect to Computer: Use a USB Type-C cable to connect the T-RGB board to your computer. This will provide power and enable data communication for programming.
  2. Install Drivers: Ensure you have the necessary USB-to-serial drivers installed for your operating system. These are typically required for ESP32-S3 boards.
  3. Install Development Environment: Install your preferred development environment, such as Arduino IDE or VS Code with PlatformIO.
  4. Obtain Firmware/Code: Visit the official LILYGO GitHub repository for the T-RGB board to download example code, libraries, and detailed setup instructions. The GitHub link is provided in the 'More Information' section.
  5. Flash Firmware: Follow the instructions in the GitHub repository to compile and flash your desired firmware onto the ESP32-S3R8 chip.
  6. Insert TF Card (Optional): If your application requires external storage, insert a formatted TF card into the onboard TF card slot.

7. Operating Instructions

Once the firmware is successfully loaded, the LILYGO T-RGB board can be operated based on your programmed application. Here are some general operational aspects:

  • Power On: The board powers on automatically when connected via USB Type-C or an external battery (connected via the JST 1.25mm 2P connector).
  • Display Interaction: Interact with the 2.8-inch round LCD using its capacitive touch functionality as defined by your application's user interface.
  • Buttons: The board includes 'Boot' and 'Reset' buttons. The 'Reset' button restarts the ESP32-S3. The 'Boot' button is typically used in conjunction with the 'Reset' button to enter programming mode.
  • Wireless Communication: Utilize the onboard Wi-Fi and Bluetooth capabilities for network connectivity, data transfer, or device pairing as programmed.
  • TF Card Usage: If a TF card is inserted and supported by your firmware, it can be used for logging data, storing images, or loading configuration files.

For specific programming examples and advanced usage, refer to the LILYGO T-RGB GitHub repository.

8. User Tips

  • Development Focus: The LILYGO T-RGB is primarily a development board. Users looking for a production-ready device might need to integrate it into a larger system or enclosure and develop custom firmware.
  • Community Support: Leverage the open-source community and resources available on GitHub for project ideas, code examples, and troubleshooting assistance.

9. Troubleshooting

If you encounter issues with your LILYGO T-RGB board, consider the following troubleshooting steps:

  • No Power/Display:
    • Ensure the USB Type-C cable is securely connected and providing power.
    • If using a battery, check its charge level and connection to the JST port.
    • Verify that the display ribbon cable is properly seated.
  • Programming Issues:
    • Confirm that the correct board and port are selected in your IDE.
    • Check if the necessary drivers are installed.
    • Try holding the 'Boot' button while pressing and releasing 'Reset' to enter download mode before flashing.
  • Unresponsive Touch/Display Glitches:
    • Ensure your firmware includes the correct display and touch driver initializations.
    • Check for any physical damage to the screen or touch sensor.
  • Wi-Fi/Bluetooth Connectivity Problems:
    • Verify your code correctly initializes and uses the Wi-Fi/Bluetooth modules.
    • Check for interference from other wireless devices.

For more in-depth troubleshooting, consult the LILYGO T-RGB GitHub repository or relevant ESP32-S3 documentation.

10. Maintenance

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

  • Handle with Care: The board contains sensitive electronic components. Avoid dropping it or subjecting it to physical shock.
  • Keep Clean: Use a soft, dry cloth to gently clean the display and board. Avoid using liquids or abrasive cleaners.
  • Environmental Conditions: Avoid exposing the board to extreme temperatures, high humidity, or direct sunlight. Store it in a cool, dry place.
  • Power Supply: Use a stable and appropriate power supply (5V via USB-C or compatible battery) to prevent damage.
  • Firmware Updates: Regularly check the LILYGO GitHub repository for firmware updates or bug fixes that may improve performance or add new features.

11. Warranty and Support

LILYGO is committed to providing quality products and support for its users. For any questions or assistance, please refer to the following resources:

  • Official GitHub Repository: For technical documentation, code examples, and community support, visit the LILYGO T-RGB GitHub.
  • YouTube Channel: Find tutorials and demonstrations on the Useful Electronics YouTube channel.
  • Direct Support: If you have specific questions about the product, or encounter issues that cannot be resolved through the provided resources, please feel free to contact the LILYGO Official Store customer service.

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.