T-Display-S3 is a ESP32-S3 development board. It is equipped with a color 1.9" LCD screen and two programmable buttons. Communication using I8080 interface. Retains the same layout design as T-Display. You can directly use ESP32S3 for USB communication or programming.
T-Display-S3 is available from: LILYGO, Amazon and Aliexpress.
Please use Arduino ESP32 version below 3.0. There are too many changes in version 3.0 and it has not been updated yet.
- In Arduino Preferences, on the Settings tab, enter the
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
URL in theAdditional boards manager URLs
input box. - Click OK and the software will install.
- Search for ESP32 in Tools β Board Manager and install
esp32
(Arduino-ESP32) - Copy everything from this repository lib folder to Arduino library folder (e.g.
C:\Users\YourName\Documents\Arduino\libraries
) - Select the correct settings in the Tools menu as shown below.
Setting | Value |
---|---|
USB CDC On Boot | Enabled |
CPU Frequency | 240MHz (WiFi) |
Core Debug Level | None |
USB DFU On Boot | Enabled |
Events Run On | Core 1 |
Flash Mode | QIO 80MHz |
Flash Size | 16MB (128Mb) |
JTAG Adapter | Integrated USB JTAG |
Arduino Runs On | Core 1 |
USB Firmware MSC On Boot | Disabled |
Partition Scheme | Huge APP (3MB No OTA/1MB SPIFFS) |
PSRAM | OPI PSRAM |
USB Mode | Hardware CDC and JTAG |
- When opening the Arduino IDE, you will be prompted that there are new libraries that can be updated. Please do not click update. There is no guarantee that it can be compiled, run, etc. after the update. Make sure that the board is running normally before deciding whether to update. You have to Know that problems may occur after updating due to library differences, or the default configuration (such as TFT_eSPI) will be overwritten.
- If it runs abnormally after the update, please follow Article 4 of the Arduino Quick Start to delete the directory in libraries, and drag the folder in lib into the libraries directory again.
- Install VisualStudioCode and Python
- Search for the
PlatformIO
plugin in theVisualStudioCode
extension and install it. - After the installation is complete, you need to restart
VisualStudioCode
- After restarting
VisualStudioCode
, selectFile
in the upper left corner ofVisualStudioCode
->Open Folder
-> select theT-Display-S3
directory - Click on the
platformio.ini
file, and in theplatformio
column, cancel the sample line that needs to be used, please make sure that only one line is valid - Click the (β) symbol in the lower left corner to compile
- Connect the board to the computer USB
- Click (β) to upload firmware
- Click (plug symbol) to monitor serial output
The installation method varies depending on the system, refer to the official manual for installation.
- Using IDF version 4.4
-
The program can be written normally, but there is still no display after writing
- There are factory test files in the firmware folder, which can be flashed into the board to check whether the board is normal. If there is still no display, then it can be judged that there is a problem with the board or the screen
- Delete the <TFT_eSPI> in the libraries, and replace the <TFT_eSPI> in the folder of the main page to the libraries directory
- When opening the Arduino IDE, it prompts whether to upgrade the library, please choose not to upgrade, otherwise it will overwrite the configuration of the <TFT_eSPI> display
-
The board uses USB as the JTAG upload port. When printing serial port information on USB_CDC_ON_BOOT configuration needs to be turned on. If the port cannot be found when uploading the program or the USB has been used for other functions, the port does not appear. Please enter the upload mode manually.
- Connect the board via the USB cable
- Press and hold the BOOT button , While still pressing the BOOT button, press RST
- Release the RST
- Release the BOOT button
- Upload sketch
-
If the above is invalid, burn the binary file to check whether the hardware is normal