LilyGO T-Display S3 Setup and Example Tutorial

Table of Contents

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

Subscribe

Join our subscribers list to get monthly blog updates, technology news, case studies. We will never send spam, and you can unsubscribe at any time.

Scroll to Top

Instant Quote