T-Display-S3/README.md

91 lines
4.8 KiB
Markdown
Raw Normal View History

2022-07-01 08:14:00 +00:00
<h1 align = "center"> 🌟T-Display-S3🌟</h1>
## Description
2023-01-31 14:29:59 +00:00
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.
2022-07-01 08:14:00 +00:00
2023-03-13 07:16:11 +00:00
## T-Display-S3 Pinout
2022-07-01 08:14:00 +00:00
2022-10-07 02:55:26 +00:00
![](image/T-DISPLAY-S3.jpg)
2022-07-01 08:14:00 +00:00
2023-03-13 07:16:11 +00:00
## T-Display-S3 TOUCH Pinout
![](image/T-DISPLAY-S3-TOUCH.png)
2023-02-05 10:02:45 +00:00
## Where to buy
2022-07-01 08:14:00 +00:00
2023-02-05 10:02:45 +00:00
T-Display-S3 is available from: [LILYGO](https://www.lilygo.cc/products/t-display-s3), [Amazon](https://www.amazon.com/dp/B0B7X5RVTH?ref=myi_title_dp) and [Aliexpress](https://www.aliexpress.com/item/3256804310228562.html).
2022-07-01 08:14:00 +00:00
## Quick Start
2023-01-31 14:29:59 +00:00
### Arduino
**Please use Arduino ESP32 version below 3.0. There are too many changes in version 3.0 and it has not been updated yet.**
2023-01-31 14:29:59 +00:00
1. In Arduino Preferences, on the Settings tab, enter the `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` URL in the `Additional boards manager URLs` input box.
2. Click OK and the software will install.
2023-02-17 19:58:43 +00:00
3. Search for ESP32 in Tools → Board Manager and install `esp32` (Arduino-ESP32)
2023-01-31 14:29:59 +00:00
4. Copy everything from this repository lib folder to [Arduino library folder](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries#manual-installation) (e.g. `C:\Users\YourName\Documents\Arduino\libraries`)
5. 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 |
### PlatformIO
2023-06-17 01:04:07 +00:00
1. Install [VisualStudioCode](https://code.visualstudio.com/) and [Python](https://www.python.org/)
2. Search for the `PlatformIO` plugin in the `VisualStudioCode` extension and install it.
3. After the installation is complete, you need to restart `VisualStudioCode`
4. After restarting `VisualStudioCode`, select `File` in the upper left corner of `VisualStudioCode` -> `Open Folder` -> select the `T-Display-S3` directory
5. Click on the `platformio.ini` file, and in the `platformio` column, cancel the sample line that needs to be used, please make sure that only one line is valid
6. Click the (✔) symbol in the lower left corner to compile
7. Connect the board to the computer USB
8. Click (→) to upload firmware
9. Click (plug symbol) to monitor serial output
2022-10-11 10:37:55 +00:00
2023-01-31 14:29:59 +00:00
### ESP-IDF
2022-07-01 08:14:00 +00:00
2023-02-05 10:05:40 +00:00
The installation method varies depending on the system, refer to the [official manual](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html) for installation.
2022-07-01 08:14:00 +00:00
- Using IDF version 4.4
2023-03-13 08:59:37 +00:00
### Micropython
2023-06-17 00:55:05 +00:00
- [russhughes/st7789s3_mpy](https://github.com/russhughes/st7789s3_mpy)
- [Micropython](https://github.com/Xinyuan-LilyGO/lilygo-micropython)
2023-03-13 08:59:37 +00:00
2023-06-17 01:04:07 +00:00
## FAQ
2022-07-01 08:14:00 +00:00
2023-06-17 01:04:07 +00:00
1. The program can be written normally, but there is still no display after writing
2023-04-04 01:41:33 +00:00
1. 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
2. Delete the <TFT_eSPI> in the libraries, and replace the <TFT_eSPI> in the <lib> folder of the main page to the libraries directory
2023-06-17 01:04:07 +00:00
3. 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
2. 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.
1. Connect the board via the USB cable
2. Press and hold the BOOT button , While still pressing the BOOT button, press RST
3. Release the RST
4. Release the BOOT button
2023-07-10 02:19:03 +00:00
5. Upload sketch
3. If the above is invalid, burn the [binary file](./firmware/README.MD) to check whether the hardware is normal
2023-07-10 02:57:33 +00:00
- [Video](https://youtu.be/L-W3dCMtEdo)