LilyGO T-Display S3 Setup and Example Tutorial

Project Introduction

The LilyGO T-Display S3 is a development board based on the ESP32-S3, equipped with a 1.9-inch TFT display. This project provides detailed setup guides and multiple example codes to help developers quickly get started and use this development board for development.

Lilygo T display 1
T-Display S3 | Image: LilyGO

T-Display S3 Project Example

Environment Preparation

Install Arduino IDE

Ensure you have the latest version of Arduino IDE installed.

Install ESP32 Board Support

  1. In Arduino IDE, go to File -> Preferences, and add the following URL to Additional Boards Manager URLs:
    
     https://dl.espressif.com/dl/package_esp32_index.json  
    
   
Arduino IDE Preferences window with ESP32 board manager URL configured
Configuring the ESP32 board manager URL in Arduino IDE's Preferences.
  1. Open Tools -> Boards -> Boards Manager, search for “esp32” and install the support.
Arduino IDE Boards Manager showing installed ESP32 board packages
Managing ESP32 board support in Arduino IDE's Boards Manager

Download Project Code:

Download via GitHub Webpage (for Beginners)
  1. Visit the project page: https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.
  2. Click the Code button (on the right), then select Download ZIP to get a compressed file.
GitHub repository page showing Download ZIP option for LilyGO T Display S3 project
Downloading the LilyGO T-Display S3 project code as a ZIP file from GitHub.
  1. Unzip the downloaded file to a local folder after completion.
Download via Git Command Line (for Developers)
Steps:
  1. Install Git:
    • Windows: Download Git for Windows and install it.
    • macOS/Linux: Git is usually pre-installed. If not, use a package manager (e.g., sudo apt install git on Linux).
  2. Open a Command Prompt/Terminal:
    • Windows: Launch Git Bash (included with Git installation).
    • macOS/Linux: Open the Terminal app.
  3. Run the Clone Command:
    
     git clone https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.git  
    
   

This will download the code to your current command-line directory.

Configure the Development Board

  • In Arduino IDE, select Tools -> Board -> ESP32 Arduino -> ESP32S3 Dev Module.
  • Select the correct port (usually /dev/cu.usbserial-* or COM3, etc.).
Arduino IDE Tools menu with ESP32S3 Dev Module selected
Configuring the ESP32S3 Dev Module in Arduino IDE's Tools menu

Upload Example Code

  • Open the LilyGO T-Display-S3 Setup.txt file in the project and follow the instructions.
  • Take the example code ESPNOW_for_T_Display as an example:
    
     // Example Code: ESPNOW_for_T_Display  
#include <esp_now.h>  
#include <WiFi.h>  

void setup() {  
  Serial.begin(115200);  
  WiFi.mode(WIFI_STA);  
  if (esp_now_init() != ESP_OK) {  
    Serial.println("Error initializing ESP-NOW");  
    return;  
  }  
}  

void loop() {  
  // Main loop code  
}  
    
   

Through this tutorial, you can quickly get started with the LilyGO T-Display S3 development board and leverage its abundant example codes for development. We hope you find fun and inspiration in this project!

note:

If you need the board, you can buy it from their site:  T-Display S3

Share to:

Scroll to Top

Instant Quote