Tutorial de configuração e exemplos do LilyGO T-Display S3

Introdução ao projeto

O LilyGO T-Display S3 é uma placa de desenvolvimento baseada no ESP32-S3, equipada com um ecrã TFT de 1,9 polegadas. Este projeto fornece guias de configuração detalhados e vários códigos de exemplo para ajudar os programadores a começar rapidamente e a utilizar esta placa de desenvolvimento para o desenvolvimento.

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

Configuração de projetos LILYGO T-Display S3 e checklist GPIO

Em projetos LILYGO T-Display S3, os problemas comuns são perfil da placa, driver TFT, USB CDC/JTAG, medição da bateria e conflitos GPIO com boot strapping pins. Verifique isso antes de Wi-Fi, BLE, LVGL, sensores ou MQTT.

Checagens antes de compilar exemplos

ItemChecagem recomendadaSintoma típico
Board profileESP32S3 Dev Module ou perfil LILYGO, PSRAM ativada se existirCompila, mas falha em gráficos ou LVGL
Display driverPinos ST7789, backlight, rotation, TFT_eSPI ou Arduino_GFXTela branca, UI espelhada ou cores erradas
USB modeUSB CDC on boot, USB JTAG e permissões da serialUpload funciona uma vez e o serial monitor some
Power e bateriaVBAT divider, charging IC, sleep current, wake sourcePercentual errado ou consumo alto em deep sleep

Para PCB custom com ESP32-S3, reserve strapping pins, mantenha SPI do display curto e teste o antenna keep-out.

Exemplo de projeto T-Display S3

Preparação do ambiente

Instalar o Arduino IDE

Certifique-se de que tem a versão mais recente do Arduino IDE instalada.

Instalar suporte para placa ESP32

  1. No Arduino IDE, vá para Arquivo -> Preferências e adicione o seguinte URL a URLs adicionais do Gerenciador de placas:
				
					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. Abra Ferramentas -> Placas -> Gerenciador de placas, procure por "esp32" e instale o suporte.
Arduino IDE Boards Manager showing installed ESP32 board packages
Managing ESP32 board support in Arduino IDE's Boards Manager

Baixar código do projeto:

Baixar pela página do GitHub (para iniciantes)
  1. Visite a página do projeto: https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.
  2. Clique no botão Código (à direita) e selecione Baixar ZIP para obter um arquivo compactado.
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. Descompacte o arquivo baixado em uma pasta local após a conclusão.
Baixar via linha de comando Git (para desenvolvedores)
Passos:
  1. Instale o Git:
    • Windows: Baixe o Git para Windows e instale-o.
    • macOS/Linux: O Git geralmente vem pré-instalado. Caso contrário, use um gerenciador de pacotes (por exemplo, sudo apt install git no Linux).
  2. Abra um prompt de comando/terminal:
    • Windows: Inicie o Git Bash (incluído na instalação do Git).
    • macOS/Linux: Abra o aplicativo Terminal.
  3. Execute o comando Clone:
				
					git clone https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.git  
				
			

Isso baixará o código para o diretório atual da linha de comando.

Configurar a placa de desenvolvimento

  • No Arduino IDE, selecione Ferramentas -> Placa -> ESP32 Arduino -> Módulo de desenvolvimento ESP32S3.
  • Selecione a porta correta (geralmente /dev/cu.usbserial-* ou COM3, etc.).
Arduino IDE Tools menu with ESP32S3 Dev Module selected
Configuring the ESP32S3 Dev Module in Arduino IDE's Tools menu

Carregar código de exemplo

  • Abra o arquivo LilyGO T-Display-S3 Setup.txt no projeto e siga as instruções.
  • Use o código de exemplo ESPNOW_for_T_Display como exemplo:
				
					// 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  
}  
				
			

Através deste tutorial, você pode começar rapidamente a usar a placa de desenvolvimento LilyGO T-Display S3 e aproveitar seus abundantes códigos de exemplo para desenvolvimento. Esperamos que você se divirta e se inspire neste projeto!

nota:

Se você precisar da placa, pode comprá-la no site deles: T-Display S3

Compartilhar em:

Rolar para cima

Cotação instantânea

Instant Quote