LilyGO T-Display S3 Настройка и примеры использования

Введение в проект

LilyGO T-Display S3 — это плата разработчика на базе ESP32-S3, оснащенная 1,9-дюймовым TFT-дисплеем. В этом проекте представлены подробные инструкции по настройке и несколько примеров кода, которые помогут разработчикам быстро освоить эту плату и использовать ее для разработки.

Lilygo T display 1
T-Display S3 | Изображение: LilyGO

Пример проекта T-Display S3

Подготовка окружающей среды

Установите Arduino IDE

Убедитесь, что у вас установлена последняя версия Arduino IDE.

Установить поддержку платы ESP32

  1. В Arduino IDE перейдите в меню «Файл» -> «Настройки» и добавьте следующий URL-адрес в поле «Дополнительные URL-адреса менеджера плат»:
				
					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. Откройте «Инструменты» -> «Платы» -> «Менеджер плат», найдите «esp32» и установите поддержку.
Arduino IDE Boards Manager showing installed ESP32 board packages
Managing ESP32 board support in Arduino IDE's Boards Manager

Скачать код проекта:

Скачать через веб-страницу GitHub (для начинающих)
  1. Посетите страницу проекта: https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.
  2. Нажмите кнопку «Код» (справа), затем выберите «Скачать ZIP», чтобы получить сжатый файл.
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. После завершения распакуйте загруженный файл в локальную папку.
Загрузка через командную строку Git (для разработчиков)
Шаги:
  1. Установите Git:
    • Windows: Загрузите Git для Windows и установите его.
    • macOS/Linux: Git обычно предустановлен. Если нет, используйте менеджер пакетов (например, sudo apt install git в Linux).
  2. Откройте командную строку/терминал:
    • Windows: Запустите Git Bash (входит в состав установки Git).
    • macOS/Linux: Откройте приложение «Терминал».
  3. Запустите команду клонирования:
				
					git clone https://github.com/teastainGit/LilyGO-T-display-S3-setup-and-examples.git  
				
			

Это загрузит код в текущий каталог командной строки.

Настройка платы разработчика

  • В Arduino IDE выберите Tools -> Board -> ESP32 Arduino -> ESP32S3 Dev Module.
  • Выберите правильный порт (обычно /dev/cu.usbserial-* или COM3и т. д.).
Arduino IDE Tools menu with ESP32S3 Dev Module selected
Configuring the ESP32S3 Dev Module in Arduino IDE's Tools menu

Загрузить пример кода

  • Откройте файл LilyGO T-Display-S3 Setup.txt в проекте и следуйте инструкциям.
  • Возьмем в качестве примера код ESPNOW_for_T_Display:
				
					// 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  
}  
				
			

С помощью этого руководства вы сможете быстро освоить разработку на плате LilyGO T-Display S3 и воспользоваться ее богатым набором примеров кода для разработки. Мы надеемся, что этот проект доставит вам удовольствие и вдохновит вас!

Примечание:

Если вам нужна плата, вы можете купить ее на их сайте: T-Display S3

Настройка LILYGO T-Display S3 projects и GPIO checklist

В LILYGO T-Display S3 projects чаще всего мешают board package, TFT driver, USB CDC/JTAG, измерение батареи и конфликт GPIO с boot strapping pins. Проверьте это до Wi-Fi, BLE, LVGL, sensor или MQTT кода.

Проверки перед компиляцией примеров

ПунктПроверкаСимптом
Board profileESP32S3 Dev Module или профиль LILYGO, PSRAM если установленаSketch собирается, но падает при graphics или LVGL
Display driverST7789 pins, backlight, rotation, TFT_eSPI или Arduino_GFXБелый экран, зеркальная UI или неверные цвета
USB modeUSB CDC on boot, USB JTAG и права serial portUpload проходит один раз, затем serial monitor исчезает
Power и batteryVBAT divider, charging IC, sleep current, wake sourceНеверный процент батареи или высокий deep sleep current

Для custom PCB на ESP32-S3 резервируйте strapping pins, делайте display SPI короткими и проверяйте antenna keep-out.

Поделиться:

Прокрутить вверх

Мгновенный расчет

Instant Quote